使用 API 查看资源维护

您可以使用 Unified Maintenance API 返回有关资源维护的信息。

本文档介绍了如何使用 Cloud Shell 调用 Unified Maintenance API 以返回资源维护信息。

如需在 Cloud Hub 中查看即将进行和已完成的维护活动，请参阅查看维护活动。

准备工作

在使用 Unified Maintenance 查看资源维护信息之前，请验证 Unified Maintenance 是否支持您的资源类型。

如需查看 App Hub 应用（预览版）的维护活动，您必须在 App Hub 中使用现有 Google Cloud 资源定义应用，或者使用App Design Center创建并部署应用。

过滤条件

您可以使用多个参数来过滤返回的维护活动：

  • 状态（例如 SUCCEEDED 或 STARTED）
  • 资源名称
  • 资源位置
  • 资源类型
  • 维护名称
  • 维护开始时间
  • 维护结束时间

如需了解详情，请参阅Unified Maintenance API 文档。

查看资源维护

您可以使用 Unified Maintenance API 返回 Google Cloud 项目的维护活动信息。如果您在文件夹级边界内管理应用，请使用文件夹的管理项目。

如需列出所有维护活动，请执行以下操作：

  1. 转到 Cloud Shell。

    转到 Cloud Shell

  2. 运行以下命令：

    curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type:
application/json" \
https://maintenance.googleapis.com/v1beta/projects/PROJECT_ID/locations/LOCATION/resourceMaintenances

    将

    • PROJECT_ID：您的项目的项目 ID。
    • LOCATION：包含项目的区域或可用区。设置为 global、region 或 -（以匹配所有位置）。

  3. Unified Maintenance 会返回有关指定项目的资源维护的信息。

查看资源的维护

您可以使用 Unified Maintenance API 返回指定资源的维护信息。

如需过滤并打印指定资源的维护信息，请执行以下操作：

  1. 转到 Cloud Shell。

    转到 Cloud Shell

  2. 运行以下命令：

    curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type:
application/json" \
https://maintenance.googleapis.com/v1beta/projects/PROJECT_ID/locations/LOCATION/resourceMaintenances?filter=FILTER=%22RESOURCE_NAME%22

    将

    • PROJECT_ID：您的项目的项目 ID。
    • LOCATION：包含项目的区域或可用区。设置为 global、region 或 -（以匹配所有位置）。
    • RESOURCE_NAME：资源的完整资源名称。

后续步骤