使用 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)
  • 資源名稱
  • 資源地區
  • 資源類型
  • 維護作業名稱
  • 維護作業開始時間
  • 維護作業結束時間

詳情請參閱「統一維護 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：資源的完整資源名稱。

後續步驟