API を使用してリソースのメンテナンスを表示する

Unified Maintenance API を使用すると、リソースのメンテナンスに関する情報を取得できます。

このドキュメントでは、Cloud Shell を使用して Unified Maintenance API を呼び出し、リソース メンテナンスを返す方法について説明します。

Cloud Hub で今後のメンテナンス アクティビティと過去のメンテナンス アクティビティを表示するには、メンテナンス アクティビティを表示するをご覧ください。

始める前に

Unified Maintenance を使用してリソースのメンテナンスを表示する前に、Unified Maintenance がリソースタイプをサポートしていることを確認します。

フィルタ

複数のパラメータを使用して、返されるメンテナンス アクティビティをフィルタできます。

  • 状態（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: リソースの完全なリソース名。

次のステップ