インスタンスのホスト メンテナンス ポリシーを設定する

コンソール

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

   [インスタンスの作成] に移動

2. インスタンスの名前を指定します。

3. インスタンスの [リージョン] と [ゾーン] を選択します。

4. [マシンの構成] セクションで、次の操作を行います。

   1. インスタンスのマシンタイプの詳細を指定します。
   2. [VM プロビジョニング モデルの詳細設定] メニューを開きます。
   3. [ホスト メンテナンス時] メニューで、次のいずれかの手順を選択します。
      1. メンテナンス イベント中に VM を移行するには、[VM インスタンスを移行] を選択します。
      2. メンテナンス イベント中にインスタンスを停止するには、[VM インスタンスを終了] を選択します。

5. インスタンスを作成するには、[作成] をクリックします。

gcloud

新しいインスタンスのホスト メンテナンス ポリシーを設定するには、gcloud compute instances create コマンドを使用します。

--host-error-timeout-seconds プロパティ（プレビュー）を設定するには、gcloud beta compute instances create コマンドを使用する必要があります。

次のコマンドを使用して、新しいインスタンスのホスト メンテナンス ポリシーを設定できます。いずれかのフラグを省略すると、フラグのデフォルト値が使用されます。

  gcloud compute instances create INSTANCE_NAME \
      --zone=ZONE \
      --maintenance-policy=MAINTENANCE_BEHAVIOR \
      --RESTART_ON_FAILURE_BEHAVIOR \
      --local-ssd-recovery-timeout=SSD_RECOVERY_TIMEOUT \
      --host-error-timeout-seconds=ERROR_DETECTION_TIMEOUT

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

• INSTANCE_NAME: インスタンス名。
• ZONE: インスタンスが配置されているゾーン。
• MAINTENANCE_BEHAVIOR: インスタンスのメンテナンス イベントの動作（TERMINATE または MIGRATE）。ほとんどのマシンタイプでは、このプロパティを省略すると、VM はデフォルトで移行されます。Z3 インスタンスとベアメタル インスタンスが終了します。
• RESTART_ON_FAILURE_BEHAVIOR: 終了したインスタンスまたは応答しないインスタンスの再起動動作。restart-on-failure（デフォルト）または no-restart-on-failure に設定します。
• SSD_RECOVERY_TIMEOUT: 終了したインスタンスまたは応答しないインスタンスにアタッチされたローカル SSD ディスクの復元に費やす時間数。有効な値は 0 から 168 で、1 時間単位で指定します。
• ERROR_DETECTION_TIMEOUT: 応答しないインスタンスを再起動するまで Compute Engine が待機する秒数（90 ～ 330 秒（5.5 分））。30 秒単位で指定します。

REST

REST を使用して新しいインスタンスのホスト メンテナンス ポリシーを設定するには、instances.insert メソッドを使用します。

次のコマンドを使用して、新しいインスタンスのホスト メンテナンス ポリシーを設定できます。いずれかのフィールドを省略すると、そのフィールドのデフォルト値が使用されます。

      POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances

      {
        "name": "INSTANCE_NAME",

        "scheduling": {
          "onHostMaintenance": "MAINTENANCE_BEHAVIOR",
          "automaticRestart": "RESTART_POLICY,
          "localSsdRecoveryTimeout": SSD_RECOVERY_TIMEOUT
        }
      }

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

• PROJECT_ID: インスタンスのプロジェクト。
• ZONE: インスタンスを作成するゾーン。
• INSTANCE_NAME: インスタンス名。
• MAINTENANCE_BEHAVIOR: インスタンスのメンテナンス イベントの動作（TERMINATE または MIGRATE）。ほとんどのマシンタイプでは、このフィールドを省略すると、VM はデフォルトで移行されます。Z3 インスタンスとベアメタル インスタンスが終了します。
• RESTART_POLICY: メンテナンス イベントまたはホストエラー後にインスタンスを自動的に再起動するかどうか。true（デフォルト）または false のいずれか。
• SSD_RECOVERY_TIMEOUT: 応答しないインスタンスまたは終了したインスタンスにアタッチされたローカル SSD ディスクの復元に Compute Engine が費やす時間数。有効な値は 0 ～ 168 で、1 時間単位で指定します。Z3 のデフォルト値は 6 時間で、他のすべての VM のデフォルト値は 1 時間です。

ホストエラー検出のタイムアウトを設定する

Compute Engine が応答しないインスタンスの再起動や終了を待機する最大時間を設定するには、ベータ版 instances.insert メソッドを使用します。このオプションはプレビュー版であるためです。

リクエスト本文の scheduling オブジェクトに hostErrorTimeoutSeconds プロパティを追加します。ここで、HOST_ERROR_TIMEOUT は、Compute Engine が応答しないインスタンスを再起動または終了するまで待機する秒数です。有効な値は 90 ～ 330（5.5 分）で、30 秒単位で指定します。

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

   {
      "name": "INSTANCE_NAME",

      "scheduling": {
        "onHostMaintenance": "MAINTENANCE_BEHAVIOR",
        "automaticRestart": "RESTART_POLICY,
        "localSsdRecoveryTimeout": SSD_RECOVERY_TIMEOUT
        "hostErrorTimeoutSeconds": HOST_ERROR_TIMEOUT,
      }
    }

コンソール

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

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

2. 設定を変更するインスタンスの名前をクリックします。インスタンスの詳細ページが表示されます。

3. [詳細] タブを選択して、次の手順を完了します。

   1. ページの上部にある [編集] ボタンをクリックします。
   2. [管理] セクションに移動します。[可用性ポリシー] セクションで、ホスト メンテナンス オプションを変更できます。
   3. [保存] をクリックします。

gcloud

gcloud compute instances set-scheduling コマンドを使用して、既存のインスタンスのホスト メンテナンス ポリシーを更新します。前のセクションのインスタンス作成コマンドと同じパラメータを使用します。

Compute Engine が応答しないインスタンスの再起動または終了を待機する最大時間を更新するには（プレビュー）、gcloud beta compute instances set-scheduling コマンドを使用して --host-error-timeout-seconds=NUMBER_OF_SECONDS を含めます。

    gcloud compute instances set-scheduling INSTANCE_NAME \
      --maintenance-policy=MAINTENANCE_BEHAVIOR \
      --RESTART_ON_FAILURE_BEHAVIOR \
      --local-ssd-recovery-timeout=SSD_RECOVERY_TIMEOUT

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

• NUMBER_OF_SECONDS: 応答しない VM を再起動または終了するまで Compute Engine が待機する秒数（90 ～ 330（5.5 分））。30 秒単位で指定します。
  • INSTANCE_NAME: インスタンス名。
  • MAINTENANCE_BEHAVIOR: インスタンスのメンテナンス イベントの動作（TERMINATE または MIGRATE）。ほとんどのマシンタイプでは、このプロパティを省略すると、VM はデフォルトで移行されます。Z3 インスタンスとベアメタル インスタンスが終了します。
  • RESTART_ON_FAILURE_BEHAVIOR: 終了したインスタンスまたは応答しないインスタンスの再起動動作。restart-on-failure（デフォルト）または no-restart-on-failure に設定します。
  • SSD_RECOVERY_TIMEOUT: 終了したインスタンスまたは応答しないインスタンスにアタッチされたローカル SSD ディスクの復元に費やす時間数。有効な値は 0 から 168 で、1 時間単位で指定します。
  • NUMBER_OF_SECONDS: 応答しないインスタンスを再起動するまで Compute Engine が待機する秒数（90 ～ 330 秒（5.5 分））。30 秒単位で指定します。

REST

instances.setScheduling メソッドへの POST リクエストを使用して、既存のインスタンスのホスト メンテナンス ポリシーを更新します。

    POST https://compute.googleapis.com/compute/v1projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/setScheduling

    {
      "onHostMaintenance": "MAINTENANCE_BEHAVIOR",
      "automaticRestart": RESTART_POLICY,
      "localSsdRecoveryTimeout": SSD_RECOVERY_TIMEOUT
    }

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

• PROJECT_ID: インスタンスのプロジェクト。
• ZONE: インスタンスが配置されているゾーン。
• INSTANCE_NAME: インスタンス名。
• MAINTENANCE_BEHAVIOR: このインスタンスのメンテナンス イベントの動作（TERMINATE または MIGRATE）。
• RESTART_POLICY: インスタンスを自動的に再起動するかどうか（true または false）。
  • SSD_RECOVERY_TIMEOUT: インスタンスにアタッチされたローカル SSD ディスクの復元に費やす時間数。有効な値は 0 から 168 で、1 時間単位で指定します。

ホストエラー検出タイムアウトを更新する

Compute Engine が応答しない VM の再起動や終了を待機する最大時間を更新するには、ベータ版 instances.setScheduling メソッドを使用する必要があります。この機能はプレビューで利用可能なためです。

hostErrorTimeoutSeconds プロパティをリクエスト本文に追加します。ここで、HOST_ERROR_TIMEOUT は、Compute Engine が応答しないインスタンスを再起動または終了するまで待機する秒数です。有効な値は 90 ～ 330（5.5 分）で、30 秒単位で指定します。

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

  {
    ...
    "hostErrorTimeoutSeconds": NUMBER_OF_SECONDS
  }

コンソール

1. [VM インスタンス] ページに移動します。

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

2. 設定を表示するインスタンスの名前をクリックします。インスタンスの詳細ページが開きます。

3. [管理] セクションに移動します。[可用性ポリシー] サブセクションには、次の現在の設定が表示されます。

   • ホスト メンテナンス時
   • 自動再起動
   • ホストエラーのタイムアウト

gcloud

gcloud compute instances describe コマンドを使用して、インスタンスのホスト メンテナンス オプションの設定を表示します。

hostErrorTimeoutSeconds 設定の現在の値（プレビュー）を表示するには、gcloud beta compute instances describe コマンドを使用します。

 gcloud compute instances describe INSTANCE_NAME \
 --zone ZONE --format="yaml(scheduling)"

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

• INSTANCE_NAME: インスタンスの名前
• ZONE: インスタンスが配置されているゾーン

出力には、ホスト メンテナンス ポリシーの現在の設定が含まれます。次に例を示します。

scheduling:
  automaticRestart: true
  hostErrorTimeoutSeconds: 120
  localSsdRecoveryTimeout:
    nanos: 0
    seconds: '10800'
  onHostMaintenance: MIGRATE
  preemptible: false
  provisioningModel: STANDARD

REST

インスタンスのホスト メンテナンス設定を表示するには、instances.get メソッドを使用します。

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

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

• PROJECT_ID: インスタンスが配置されているプロジェクト。
• ZONE: インスタンスが配置されているゾーン。
• INSTANCE_NAME: インスタンス名。

出力の scheduling オブジェクトには、インスタンスのホスト メンテナンス ポリシーの設定が含まれます。次に例を示します。

{
...
  "scheduling": {
      "onHostMaintenance": "MIGRATE",
      "automaticRestart": true,
      "preemptible": false,
      "provisioningModel": "STANDARD",
      "localSsdRecoveryTimeout": {
        "seconds": "10800",
        "nanos": 0
      }
    },
...
}

ホストエラー タイムアウトの設定を表示する

ベータ版の instances.get メソッドを使用して GET リクエストを作成して、現在の hostErrorTimeoutSeconds 設定を表示します。

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

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

• PROJECT_ID: インスタンスのプロジェクト。
• ZONE: インスタンスが配置されているゾーン。
• INSTANCE_NAME: インスタンス名。

出力の scheduling オブジェクトには、インスタンスのホストエラー検出タイムアウトが含まれます。次に例を示します。

{
...
  "scheduling": {
    "onHostMaintenance": "MIGRATE",
    "automaticRestart": true,
    "preemptible": false,
    "provisioningModel": "STANDARD",
    "hostErrorTimeoutSeconds": 120,
    "localSsdRecoveryTimeout": {
      "seconds": "10800",
      "nanos": 0
    }
  },
...
}