取得報表的中繼資料

如要檢查報表的範圍和指標等設定，或查看報表的到期時間，請使用 App Optimize API 取得報表的中繼資料。

這項 API 要求不會傳回報表中的實際資料列。如要下載這項資訊，請閱讀報表資料。

事前準備

  1. 登入 Google Cloud 帳戶。如果您是 Google Cloud新手，歡迎 建立帳戶，親自評估產品在實際工作環境中的成效。新客戶還能獲得價值 $300 美元的免費抵免額，可用於執行、測試及部署工作負載。

  2. 安裝 Google Cloud CLI。

  3. 若您採用的是外部識別資訊提供者 (IdP)，請先使用聯合身分登入 gcloud CLI。

  4. 執行下列指令，初始化 gcloud CLI：

    gcloud init

  5. 確認您具備完成本指南所需的權限。

  6. 安裝 Google Cloud CLI。

  7. 若您採用的是外部識別資訊提供者 (IdP)，請先使用聯合身分登入 gcloud CLI。

  8. 執行下列指令，初始化 gcloud CLI：

    gcloud init

  9. 確認您具備完成本指南所需的權限。

    10.

必要的角色

如要取得讀取報表的中繼資料所需的權限，請要求系統管理員授予您報表資源所屬專案的「應用程式最佳化檢視者 」(roles/appoptimize.viewer) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

您或許也能透過自訂角色或其他預先定義的角色，取得必要權限。

取得報表中繼資料

如要使用 REST API 擷取報表的中繼資料，請將 HTTP GET 要求傳送至報表的資源端點。

使用下列 curl 指令取得報表的中繼資料：

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

更改下列內容：

  • PROJECT_ID：擁有要擷取報表資源的 Google Cloud 專案 ID。
  • REPORT_ID：要擷取的報表 ID。這個 ID 是在建立報表時指定，可透過列出報表取得。

如果要求成功，API 會傳回包含報表中繼資料的 JSON 回應。

以下是成功回應的範例，包括所選維度和指標、專案範圍，以及報表預計到期時間：

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

後續步驟