获取报告的元数据

如需检查报告的设置（例如范围和指标）或检查报告的过期时间，请使用 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.

所需的角色

如需获得读取报告元数据所需的权限，请让您的管理员为您授予拥有报告资源的App Optimize Viewer (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"
  ]
}

后续步骤