Membuat daftar laporan

Kelola laporan App Optimize API secara efektif dengan mencantumkan semua konfigurasi laporan dalam project Anda. Google Cloud Hal ini membantu Anda mengidentifikasi laporan tertentu untuk membaca datanya atau menghapusnya sebelum tanggal habis masa berlakunya jika tidak lagi diperlukan.

Operasi daftar menampilkan metadata laporan, termasuk nama resource, cakupan, dimensi, metrik, dan waktu habis masa berlaku untuk setiap laporan. Untuk mendownload informasi biaya dan penggunaan yang diminta, Anda harus membaca data laporan.

Sebelum memulai

  1. Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

  2. Instal Google Cloud CLI.

  3. Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

  4. Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut: 

    gcloud init

  5. Pastikan Anda memiliki izin yang diperlukan untuk menyelesaikan panduan ini.

  6. Instal Google Cloud CLI.

  7. Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

  8. Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut: 

    gcloud init

  9. Pastikan Anda memiliki izin yang diperlukan untuk menyelesaikan panduan ini.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk mencantumkan resource laporan project, minta administrator untuk memberi Anda peran IAM App Optimize Viewer (roles/appoptimize.viewer) di project. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Membuat daftar laporan

Untuk mencantumkan laporan dalam project, menggunakan REST API, kirim permintaan HTTP GET ke endpoint kumpulan laporan.

Gunakan perintah curl berikut untuk mencantumkan laporan untuk suatu project:

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://appoptimize.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/reports?pageSize=PAGE_SIZE"

Ganti kode berikut:

  • PROJECT_ID: ID Google Cloud project yang memiliki resource laporan yang ingin Anda lihat dalam daftar.
  • PAGE_SIZE: jumlah maksimum laporan yang akan ditampilkan per halaman. Jika tidak ada, API akan menggunakan nilai default. Server mungkin menampilkan lebih sedikit laporan daripada yang diminta.

Jika permintaan berhasil, API akan menampilkan respons JSON yang berisi daftar resource laporan. Berikut adalah contoh respons panggilan yang berhasil:

{
  "reports": [
    {
      "name": "projects/PROJECT_ID/locations/global/reports/my-first-report",
      "dimensions": [
        "location",
        "product_display_name",
        "project",
        "sku"
      ],
      "scopes": [
        {
          "project": "projects/PROJECT_ID"
        }
      ],
      "filter": "hour \u003e= now - duration(\"168h\")",
      "expireTime": "2026-02-05T18:30:39.907639266Z",
      "metrics": [
        "cost"
      ]
    },
    {
      "name": "projects/PROJECT_ID/locations/global/reports/my-second-report",
      "dimensions": [
        "location",
        "product_display_name",
        "project",
        "resource",
        "resource_type"
      ],
      "scopes": [
        {
          "project": "projects/PROJECT_ID"
        }
      ],
      "filter": "hour \u003e= now - duration(\"168h\")",
      "expireTime": "2026-02-05T18:50:25.273833857Z",
      "metrics": [
        "cost",
        "cpu_mean_utilization"
      ]
    }
  ]
}

Array reports berisi metadata untuk setiap laporan. Jika permintaan tidak berhasil, tinjau pesan error yang ditampilkan oleh API.

Jika respons menyertakan string nextPageToken, berarti ada laporan lain yang dapat diambil.

Periksa kolom nextPageToken dalam respons. Jika token ada, jalankan permintaan curl berikut untuk mengambil halaman berikutnya, termasuk parameter kueri pageToken. Anda dapat terus menggunakan parameter pageSize.

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://appoptimize.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/reports?pageToken=NEXT_PAGE_TOKEN&pageSize=PAGE_SIZE"

Ganti kode berikut:

  • NEXT_PAGE_TOKEN: nilai nextPageToken yang diterima dalam respons sebelumnya.
  • PAGE_SIZE: ukuran halaman yang Anda inginkan untuk permintaan ini.

Ulangi proses ini hingga respons tidak lagi berisi nextPageToken, yang menunjukkan bahwa Anda telah mengambil semua laporan.

Langkah berikutnya