Compute Engine インスタンスで正常なシャットダウンを表示する

コンソール

1. Google Cloud コンソールで、[VM インスタンス] ページに移動します。

   [VM インスタンス] に移動

2. [名前] 列で、インスタンスの名前をクリックします。

   インスタンスの詳細ページが、[詳細] タブに開きます。

3. 正常なシャットダウンの設定を確認するには、[可用性ポリシー] セクションで [正常なシャットダウンの最大時間] フィールドの値を確認します。このフィールドには、正常なシャットダウン期間が表示されます。ハイフン（-）が表示されている場合は、正常なシャットダウンが無効になっています。

gcloud

インスタンスの正常なシャットダウン設定を表示するには、gcloud beta compute instances describe コマンドを使用します。

gcloud beta compute instances describe INSTANCE_NAME \
    --zone=ZONE

次のように置き換えます。

• INSTANCE_NAME: インスタンスの名前。

• ZONE: インスタンスが存在するゾーン。

正常なシャットダウンが有効になっている場合、出力は次のようになります。

...
scheduling:
  ...
  gracefulShutdown:
    enabled: true
    maxDuration:
      seconds: 'MAX_DURATION'
  ...
...

出力には MAX_DURATION の値が含まれます。この値は、正常なシャットダウン期間の長さを秒単位で示します。インスタンスで正常なシャットダウンを有効にしたときにカスタム シャットダウン期間を指定していない場合、Compute Engine は maxDuration フィールドを省略し、正常なシャットダウン期間を 10 分に設定します。

REST

インスタンスの正常なシャットダウン設定を表示するには、ベータ版の instances.get メソッドに GET リクエストを送信します。

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME

次のように置き換えます。

• PROJECT_ID: インスタンスが作成されたプロジェクトの ID。

• ZONE: インスタンスが存在するゾーン。

• INSTANCE_NAME: インスタンスの名前。

正常なシャットダウンが有効になっている場合、出力は次のようになります。

{
  ...
  "scheduling": {
    ...
    "gracefulShutdown": {
      "enabled": true,
      "maxDuration": {
        "seconds": "MAX_DURATION"
      }
    }
  },
  ...
}

出力には MAX_DURATION の値が含まれます。この値は、正常なシャットダウン期間の長さを秒単位で示します。インスタンスで正常なシャットダウンを有効にしたときにカスタム シャットダウン期間を指定していない場合、Compute Engine は maxDuration フィールドを省略し、正常なシャットダウン期間を 10 分に設定します。

コンソール

1. Google Cloud コンソールで、[VM インスタンス] ページに移動します。

   [VM インスタンス] に移動

2. [名前] 列で、インスタンスの名前をクリックします。

   インスタンスの詳細ページが、[詳細] タブに開きます。

3. 正常なシャットダウンが進行中の場合は、[基本情報] セクションで次のフィールドを確認します。

   • ステータス: このフィールドには、インスタンスの状態が表示されます。正常なシャットダウン中、このフィールドには [保留中の停止] とカウントダウン タイマーが表示されます。タイマーは、正常なシャットダウンが終了するまでの時間をカウントダウンします。

   • 目標とする状態: このフィールドには、Compute Engine がインスタンスを停止（停止済み）しているか、削除（削除済み）しているかが表示されます。

gcloud

インスタンスで進行中の正常なシャットダウンをモニタリングするには、gcloud beta compute instances describe コマンドを使用します。

gcloud beta compute instances describe INSTANCE_NAME \
    --zone=ZONE

次のように置き換えます。

• INSTANCE_NAME: インスタンスの名前。

• ZONE: インスタンスが存在するゾーン。

正常なシャットダウンが進行中の場合、出力は次のようになります。

...
resourceStatus:
  ...
  shutdownDetails:
    maxDuration:
      seconds: 'MAX_DURATION'
    requestTimestamp: 'REQUEST_TIMESTAMP'
    stopState: STOP_STATE
    targetState: TARGET_STATE
...
status: PENDING_STOP
...

この出力には次の値が含まれます。

• MAX_DURATION: 正常なシャットダウン期間の長さ（秒単位）。Compute Engine は、STOP_STATE を STOPPING に設定した後、maxDuration フィールドを削除します。

• REQUEST_TIMESTAMP: STOP_STATE の開始時のタイムスタンプ。

• STOP_STATE: インスタンスの停止フェーズ。値は次のいずれかになります。

  • PENDING_STOP: Compute Engine が正常なシャットダウンを開始しました。インスタンスは、手動で正常なシャットダウンを終了するか、正常なシャットダウン期間がタイムアウトするまで、この状態のままになります。

  • STOPPING: 正常なシャットダウンが終了し、Compute Engine は停止オペレーションまたは削除オペレーションを続行します。

• TARGET_STATE: Compute Engine がインスタンスを停止（STOPPED）しているか、削除（DELETED）しているか。

停止オペレーションが実行されている場合、Compute Engine は status フィールドを TERMINATE に設定した後、shutdownDetails フィールドを削除します。

REST

インスタンスで進行中の正常なシャットダウンをモニタリングするには、ベータ版の instances.get メソッドに GET リクエストを送信します。

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME

次のように置き換えます。

• PROJECT_ID: インスタンスが作成されたプロジェクトの ID。

• ZONE: インスタンスが存在するゾーン。

• INSTANCE_NAME: インスタンスの名前。

正常なシャットダウンが進行中の場合、出力は次のようになります。

{
  ...
  "resourceStatus": {
    ...
    "shutdownDetails": {
      "maxDuration": {
        "seconds": "MAX_DURATION"
      },
      "requestTimestamp": "REQUEST_TIMESTAMP",
      "stopState": "STOP_STATE",
      "targetState": "TARGET_STATE"
    }
  },
  ...
  "status": "PENDING_STOP",
  ...
}

この出力には次の値が含まれます。

• MAX_DURATION: 正常なシャットダウン期間の長さ（秒単位）。Compute Engine は、STOP_STATE を STOPPING に設定した後、maxDuration フィールドを削除します。

• REQUEST_TIMESTAMP: STOP_STATE の開始時のタイムスタンプ。

• STOP_STATE: インスタンスの停止フェーズ。値は次のいずれかになります。

  • PENDING_STOP: Compute Engine が正常なシャットダウンを開始しました。インスタンスは、手動で正常なシャットダウンを終了するか、正常なシャットダウン期間がタイムアウトするまで、この状態のままになります。

  • STOPPING: 正常なシャットダウンが終了し、Compute Engine は停止オペレーションまたは削除オペレーションを続行します。

• TARGET_STATE: Compute Engine がインスタンスを停止（STOPPED）しているか、削除（DELETED）しているか。

停止オペレーションが実行されている場合、Compute Engine は status フィールドを TERMINATE に設定した後、shutdownDetails フィールドを削除します。

メタデータ サーバー

1. インスタンスに接続します。

2. メタデータ サーバーにクエリします。

   curl "http://metadata.google.internal/computeMetadata/v1/instance/shutdown-details/?recursive=true?alt=json" \-H "Metadata-Flavor: Google"
   

   正常なシャットダウンが進行中の場合、出力は次のようになります。

   {
     "maxDuration": "MAX_DURATION",
     "requestTimestamp": "REQUEST_TIMESTAMP",
     "stopState": "STOP_STATE",
     "targetState": "TARGET_STATE"
   }
   

   出力には次の値が含まれます。

   • MAX_DURATION: 正常なシャットダウン期間の長さ（秒単位）。Compute Engine は、STOP_STATE を STOPPING に設定した後、maxDuration フィールドを削除します。

   • REQUEST_TIMESTAMP: STOP_STATE の開始時のタイムスタンプ。

   • STOP_STATE: インスタンスの停止フェーズ。 値は次のいずれかになります。

     • PENDING_STOP: Compute Engine が正常なシャットダウンを開始しました。インスタンスは、手動で正常なシャットダウンを終了するか、正常なシャットダウン期間がタイムアウトするまで、この状態のままになります。

     • STOPPING: 正常なシャットダウンが終了し、Compute Engine は停止オペレーションまたは削除オペレーションを続行します。

   • TARGET_STATE: Compute Engine がインスタンスを停止（STOPPED）しているか、削除（DELETED）しているか。