VM の実行時間を制限する

コンソール

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

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

2. [可用性ポリシー] セクションで、[VM プロビジョニング モデルの詳細設定] を開きます。

3. [VM の制限時間を設定する] チェックボックスをオンにします。[制限時間のタイプ] フィールドが表示されます。

4. [制限時間のタイプ] フィールドで [時間]（デフォルト）を選択して、制限時間を指定します。次のフィールドに、期間を時間単位で入力します。

5. [VM の終了時] リストで、VM の実行時間が指定の制限に達したときの動作を選択します。

   • VM を自動的に停止するには、[停止]（デフォルト）を選択します。
   • VM を削除するには、[削除] を選択します。

6. 省略可: その他の VM オプションを指定します。詳しくは、VM インスタンスの作成と起動をご覧ください。

7. VM を作成して起動するには、[作成] をクリックします。

gcloud

gcloud CLI で VM を作成するには、gcloud compute instances create コマンドを使用します。

• 特定の期間が経過した後に自動的に終了する VM を作成するには、--max-run-duration フラグを含める必要があります。
• 終了アクションを指定するには、--instance-termination-action フラグを含めます。
• --discard-local-ssds-at-termination-timestamp フラグを構成します。
  • VM にローカル SSD があり、終了アクション（TERMINATION_ACTION）が停止（STOP）の場合は、--discard-local-ssds-at-termination-timestamp=true フラグを指定する必要があります。
  • それ以外の場合は、--discard-local-ssds-at-termination-timestamp フラグを省略します。

gcloud compute instances create VM_NAME \
    --max-run-duration=DURATION \
    --instance-termination-action=TERMINATION_ACTION

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

• VM_NAME: 新しい VM の名前。
• DURATION: この VM が自動的に終了するまでの実行時間。期間を、日数、時間、分、秒としてフォーマットし、その後に d、h、m、s を続けて指定します。たとえば、期間を 30 分にする場合は 30m を指定します。期間を 1 日、2 時間、3 分、4 秒にする場合は 1d2h3m4s を指定します。最小期間は 30 秒（30s）、最大期間は 120 日間（120d）です。
• TERMINATION_ACTION: この VM の終了アクション。停止（STOP）または削除（DELETE）のいずれかです。このフィールドが必須か、デフォルト値かは VM のプロビジョニング モデルによって異なります。
  • これが Spot VM の場合（VM が --provisioning-model=SPOT フラグを使用している場合）、--instance-termination-action=TERMINATION_ACTION フラグは省略可能です。このフラグを省略すると、デフォルトの終了アクションは停止です。
  • それ以外の場合（デフォルト）は、--instance-termination-action=TERMINATION_ACTION フラグが必要です。

VM の作成時に指定できる他のオプションの詳細については、VM インスタンスの作成と起動をご覧ください。

Terraform

Terraform を使用して VM を作成するには、google_compute_instance リソースを使用します。

• 特定の期間が経過した後に自動的に終了する VM を作成するには、max_run_duration 引数を含める必要があります。
• 終了アクションを指定するには、instance_termination_action 引数を含めます。. Spot VM を作成する場合を除き、instance_termination_action 引数を含める必要があります（provisioning_model 引数を SPOT に設定）。デフォルトは停止（STOP）です。
• on_instance_stop_action 引数を構成します。
  • VM にローカル SSD があり、終了アクション（instance_termination_action 引数）が停止（STOP）の場合、on_instance_stop_action 引数を true（true）に設定する必要があります。
  • それ以外の場合は、on_instance_stop_action 引数を省略します。

詳細については、google_compute_instance リソースの Terraform ドキュメントをご覧ください。

REST

Compute Engine API で VM を作成するには、instances.insert メソッドを使用します。VM の名前、マシンタイプ、ブートディスクを指定する必要があります。

特定の期間が経過した後に自動的に終了する VM を作成するには、maxRunDuration フィールドを含める必要があります。終了アクションを指定するには、instanceTerminationAction フィールドを指定します。これは Spot VM では省略可能です。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
  "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
  "name": "VM_NAME",
  "disks": [
    {
      "initializeParams": {
        "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
      },
      "boot": true
    }
  ]
  "scheduling":
  {
    "maxRunDuration":
    {
      "seconds": DURATION
    },
    "instanceTerminationAction": "TERMINATION_ACTION"
  },
}

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

• PROJECT_ID: VM を作成するプロジェクトの ID。
• ZONE: VM を作成するゾーン。ゾーンは、新しい VM に使用するマシンタイプもサポートしている必要があります。
• MACHINE_TYPE: 新しい VM の事前定義またはカスタム マシンタイプ。
• VM_NAME: 新しい VM の名前。
• IMAGE_PROJECT: イメージを含むプロジェクト。たとえば、イメージとして family/debian-10 を指定する場合は、イメージ プロジェクトとして debian-cloud を指定します。
• IMAGE: 新しい VM のイメージ。特定のバージョンの公開イメージまたはイメージ ファミリーのいずれかを指定できます。たとえば、イメージとして family/debian-10 を指定し、イメージ プロジェクトとして debian-cloud を指定すると、Compute Engine は Debian 10 イメージ ファミリーの最新バージョンの OS イメージから VM を作成します。
• DURATION: この VM を自動的に終了するまでの実行期間の秒数。最小期間は 30 秒（30s）、最大期間は 120 日間（120d）です。
• TERMINATION_ACTION: この VM の終了アクション。停止（STOP）または削除（DELETE）のいずれかです。このフィールドが必須か、デフォルト値かは VM のプロビジョニング モデルによって異なります。
  • これが Spot VM の場合（VM が "provisioningModel": "SPOT" フィールドを使用している場合）、"instanceTerminationAction": "TERMINATION_ACTION" フィールドは省略可能です。このフィールドを省略すると、デフォルトの終了アクションは終了です。
  • それ以外の場合（デフォルト）、"instanceTerminationAction": "TERMINATION_ACTION" フィールドが必要です。

VM の作成時に指定できるオプションの詳細については、VM インスタンスの作成と起動をご覧ください。

コンソール

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

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

2. [可用性ポリシー] セクションで、[VM プロビジョニング モデルの詳細設定] を開きます。

3. [VM の制限時間を設定する] チェックボックスをオンにします。[制限時間のタイプ] フィールドが表示されます。

4. [制限時間のタイプ] フィールドで、[日付] を選択して、制限時間を時間と日付で指定します。次のフィールドで date_range [日時を選択] をクリックして、制限時間の日付、時間、タイムゾーンを選択します。

5. [VM の終了時] リストで、VM の実行時間が指定の制限に達したときの動作を選択します。

   • VM を自動的に停止するには、[停止]（デフォルト）を選択します。
   • VM を削除するには、[削除] を選択します。

6. 省略可: その他の VM オプションを指定します。詳しくは、VM インスタンスの作成と起動をご覧ください。

7. VM を作成して起動するには、[作成] をクリックします。

gcloud

gcloud CLI で VM を作成するには、gcloud compute instances create コマンドを使用します。

• 特定の時刻に自動的に終了する VM を作成するには、--termination-time フラグを含める必要があります。
• 終了アクションを指定するには、--instance-termination-action フラグを含めます。このフラグは Spot VM では省略可能です。
• --discard-local-ssds-at-termination-timestamp フラグを構成します。
  • VM にローカル SSD があり、終了アクション（TERMINATION_ACTION）を停止（STOP）に設定する場合は、--discard-local-ssds-at-termination-timestamp=true フラグを指定する必要があります。
  • それ以外の場合は、--discard-local-ssds-at-termination-timestamp フラグを省略します。

gcloud compute instances create VM_NAME \
    --termination-time=TIME \
    --instance-termination-action=TERMINATION_ACTION

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

• VM_NAME: 新しい VM の名前。

• TIME: この VM を自動的に終了する時刻。指定する時刻は、少なくとも 30 秒先の未来とし、120 日以内にする必要があります。時刻を RFC 3339 タイムスタンプとしてフォーマットします。

  YYYY-MM-DDTHH:MM:SSOFFSET
  

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

  • YYYY-MM-DD: 4 桁の年、2 桁の月、その月の 2 桁の日をハイフンで区切った日付。
  • HH:MM:SS: 24 時間における 2 桁の時間、2 桁の分、2 桁の秒をコロンで区切った時刻。
  • OFFSET: 協定世界時（UTC）のオフセット形式で示されるタイムゾーン。たとえば、UTC よりも 8 時間早い太平洋標準時（PST）を使用するには、-08:00 を指定します。オフセットなし（UTC+0）を使用する場合は、Z を指定します。

• TERMINATION_ACTION: この VM の終了アクション。停止（STOP）または削除（DELETE）のいずれかです。このフィールドが必須か、デフォルト値かは VM のプロビジョニング モデルによって異なります。

  • これが Spot VM の場合（VM が --provisioning-model=SPOT フラグを使用している場合）、--instance-termination-action=TERMINATION_ACTION フラグは省略可能です。このフラグを省略すると、デフォルトの終了アクションは停止です。
  • それ以外の場合（デフォルト）は、--instance-termination-action=TERMINATION_ACTION フラグが必要です。

VM の作成時に指定できる他のオプションの詳細については、VM インスタンスの作成と起動をご覧ください。

REST

Compute Engine API で VM を作成するには、instances.insert メソッドを使用します。VM の名前、マシンタイプ、ブートディスクを指定する必要があります。

特定の時刻に自動的に終了する VM を作成するには、terminationTime フィールドを含める必要があります。終了アクションを指定するには、instanceTerminationAction フィールドを指定します。これは Spot VM では省略可能です。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
  "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
  "name": "VM_NAME",
  "disks": [
    {
      "initializeParams": {
        "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
      },
      "boot": true
    }
  ]
  "scheduling":
  {
    "terminationTime": "TIME",
    "instanceTerminationAction": "TERMINATION_ACTION"
  },
}

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

• PROJECT_ID: VM を作成するプロジェクトの ID。
• ZONE: VM を作成するゾーン。ゾーンは、新しい VM に使用するマシンタイプもサポートしている必要があります。
• MACHINE_TYPE: 新しい VM の事前定義またはカスタム マシンタイプ。
• VM_NAME: 新しい VM の名前。
• IMAGE_PROJECT: イメージを含むプロジェクト。たとえば、イメージとして family/debian-10 を指定する場合は、イメージ プロジェクトとして debian-cloud を指定します。
• IMAGE: 新しい VM のイメージ。特定のバージョンの公開イメージまたはイメージ ファミリーのいずれかを指定できます。たとえば、イメージとして family/debian-10 を指定し、イメージ プロジェクトとして debian-cloud を指定すると、Compute Engine は Debian 10 イメージ ファミリーの最新バージョンの OS イメージから VM を作成します。

• TIME: この VM を自動的に終了する時刻。指定する時刻は、少なくとも 30 秒先の未来とし、120 日以内にする必要があります。時刻を RFC 3339 タイムスタンプとしてフォーマットします。

  YYYY-MM-DDTHH:MM:SSOFFSET
  

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

  • YYYY-MM-DD: 4 桁の年、2 桁の月、その月の 2 桁の日をハイフンで区切った日付。
  • HH:MM:SS: 24 時間における 2 桁の時間、2 桁の分、2 桁の秒をコロンで区切った時刻。
  • OFFSET: 協定世界時（UTC）のオフセット形式で示されるタイムゾーン。たとえば、UTC よりも 8 時間早い太平洋標準時（PST）を使用するには、-08:00 を指定します。オフセットなし（UTC+0）を使用する場合は、Z を指定します。

• TERMINATION_ACTION: この VM の終了アクション。停止（STOP）または削除（DELETE）のいずれかです。このフィールドが必須か、デフォルト値かは VM のプロビジョニング モデルによって異なります。

  • これが Spot VM の場合（VM が "provisioningModel": "SPOT" フィールドを使用している場合）、"instanceTerminationAction": "TERMINATION_ACTION" フィールドは省略可能です。このフィールドを省略すると、デフォルトの終了アクションは終了です。
  • それ以外の場合（デフォルト）、"instanceTerminationAction": "TERMINATION_ACTION" フィールドが必要です。

VM の作成時に指定できるオプションの詳細については、VM インスタンスの作成と起動をご覧ください。

コンソール

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

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

2. [名前] 列で、更新する VM の名前をクリックします。

3. [VM インスタンスの詳細] ページで、次の手順を行います。

   1. VM が実行されている場合は、[停止] をクリックして VM を停止します。
   2. VM を編集するには、edit [編集] をクリックします。

   3. [インスタンスの編集] ページで、次の手順を行います。

      1. [可用性ポリシー] セクションで、[VM の制限時間を設定する] チェックボックスと、必要に応じてその下のフィールドを変更します。

         制限時間のプロパティを構成する方法については、新しい VM の実行時間を制限するをご覧ください。

      2. 変更を保存するには、[保存] をクリックします。

   4. 省略可: VM の実行をすぐに開始する場合は、[開始] をクリックします。

gcloud

gcloud CLI を使用して VM のタイムアウトを更新するには、次の操作を行います。

1. VM が実行されている場合は、gcloud compute instances stop コマンドを使用して VM を停止します。

   gcloud compute instances stop VM_NAME
   

   VM_NAME は、更新する VM の名前に置き換えます。

2. gcloud compute instances set-scheduling コマンドを使用して、VM のタイムアウトを更新します。

   gcloud compute instances set-scheduling VM_NAME \
       --max-run-duration=DURATION \
       --termination-time=TIME \
       --instance-termination-action=TERMINATION_ACTION \
       --discard-local-ssds-at-termination-timestamp=true
   

   次のフラグを構成します。

   • 制限時間を時間または期間で設定するには、--max-run-duration フラグまたは --termination-time フラグを省略する必要があります。
   • --instance-termination-action フラグを指定して終了アクションを設定します。
   • VM にローカル SSD があり、終了アクション（TERMINATION_ACTION）を停止（STOP）に設定する場合は、--discard-local-ssds-at-termination-timestamp=true フラグを指定する必要があります。それ以外の場合は、--discard-local-ssds-at-termination-timestamp=true フラグを省略します。

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

   • VM_NAME: 更新する VM の名前。
   • DURATION: この VM が自動的に終了するまでの実行時間。期間を、日数、時間、分、秒としてフォーマットし、その後に d、h、m、s を続けて指定します。たとえば、期間を 30 分にする場合は 30m を指定します。期間を 1 日、2 時間、3 分、4 秒にする場合は 1d2h3m4s を指定します。最小期間は 30 秒（30s）、最大期間は 120 日間（120d）です。

   • TIME: この VM を自動的に終了する時刻。指定する時刻は、少なくとも 30 秒先の未来とし、120 日以内にする必要があります。時刻を RFC 3339 タイムスタンプとしてフォーマットします。

     YYYY-MM-DDTHH:MM:SSOFFSET
     

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

     • YYYY-MM-DD: 4 桁の年、2 桁の月、その月の 2 桁の日をハイフンで区切った日付。
     • HH:MM:SS: 24 時間における 2 桁の時間、2 桁の分、2 桁の秒をコロンで区切った時刻。
     • OFFSET: 協定世界時（UTC）のオフセット形式で示されるタイムゾーン。たとえば、UTC よりも 8 時間早い太平洋標準時（PST）を使用するには、-08:00 を指定します。オフセットなし（UTC+0）を使用する場合は、Z を指定します。

   • TERMINATION_ACTION: この VM の終了アクション。停止（STOP）または削除（DELETE）のいずれかです。このフィールドが必須か、デフォルト値かは VM のプロビジョニング モデルによって異なります。

     • これが Spot VM の場合（VM が --provisioning-model=SPOT フラグを使用している場合）、--instance-termination-action=TERMINATION_ACTION フラグは省略可能です。このフラグを省略すると、デフォルトの終了アクションは停止です。
     • それ以外の場合（デフォルト）は、--instance-termination-action=TERMINATION_ACTION フラグが必要です。

3. VM の実行を開始するには、gcloud compute instances start コマンドを使用して VM を起動します。

   gcloud compute instances start VM_NAME
   

   VM_NAME は VM の名前で置き換えます。

REST

Compute Engine API を使用して VM のタイムアウトを更新するには、次の操作を行います。

1. VM が実行されている場合は、instances.stop メソッドを使用して VM を停止します。

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

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

   • PROJECT_ID: VM を含むプロジェクトのプロジェクト ID。
   • ZONE: VM が配置されているゾーン。
   • VM_NAME: 更新する VM の名前。

2. instances.setScheduling メソッドを使用して、VM の制限時間のフィールドを含む VM の scheduling プロパティを更新します。maxRunDuration フィールドまたは terminationTime フィールドを含めて、それぞれ期間制限または時間制限を設定します。

   • 期間を設定するには、次のリクエストを使用します。

     POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/setScheduling
     {
       "maxRunDuration":
       {
         "seconds": DURATION
       },
       "instanceTerminationAction": "TERMINATION_ACTION"
     }
     

   • 時間を設定するには、次のリクエストを使用します。

     POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/setScheduling
     {
       "terminationTime": "TIME",
       "instanceTerminationAction": "TERMINATION_ACTION"
     }
     

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

   • PROJECT_ID: VM を作成するプロジェクトの ID。
   • ZONE: VM を作成するゾーン。ゾーンは、新しい VM に使用するマシンタイプもサポートしている必要があります。
   • MACHINE_TYPE: 新しい VM の事前定義またはカスタム マシンタイプ。
   • VM_NAME: 新しい VM の名前。
   • IMAGE_PROJECT: イメージを含むプロジェクト。たとえば、イメージとして family/debian-10 を指定する場合は、イメージ プロジェクトとして debian-cloud を指定します。
   • IMAGE: 新しい VM のイメージ。特定のバージョンの公開イメージまたはイメージ ファミリーのいずれかを指定できます。たとえば、イメージとして family/debian-10 を指定し、イメージ プロジェクトとして debian-cloud を指定すると、Compute Engine は Debian 10 イメージ ファミリーの最新バージョンの OS イメージから VM を作成します。
   • DURATION: この VM を自動的に終了するまでの実行期間の秒数。最小期間は 30 秒（30s）、最大期間は 120 日間（120d）です。

   • TIME: この VM を自動的に終了する時刻。指定する時刻は、少なくとも 30 秒先の未来とし、120 日以内にする必要があります。時刻を RFC 3339 タイムスタンプとしてフォーマットします。

     YYYY-MM-DDTHH:MM:SSOFFSET
     

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

     • YYYY-MM-DD: 4 桁の年、2 桁の月、その月の 2 桁の日をハイフンで区切った日付。
     • HH:MM:SS: 24 時間における 2 桁の時間、2 桁の分、2 桁の秒をコロンで区切った時刻。
     • OFFSET: 協定世界時（UTC）のオフセット形式で示されるタイムゾーン。たとえば、UTC よりも 8 時間早い太平洋標準時（PST）を使用するには、-08:00 を指定します。オフセットなし（UTC+0）を使用する場合は、Z を指定します。

   • TERMINATION_ACTION: この VM の終了アクション。停止（STOP）または削除（DELETE）のいずれかです。このフィールドが必須か、デフォルト値かは VM のプロビジョニング モデルによって異なります。

     • これが Spot VM の場合（VM が "provisioningModel": "SPOT" フィールドを使用している場合）、"instanceTerminationAction": "TERMINATION_ACTION" フィールドは省略可能です。このフィールドを省略すると、デフォルトの終了アクションは終了です。
     • それ以外の場合（デフォルト）、"instanceTerminationAction": "TERMINATION_ACTION" フィールドが必要です。

3. VM の実行を開始する場合は、instances.start メソッドを使用して VM を起動します。

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

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

   • PROJECT_ID: VM を含むプロジェクトのプロジェクト ID。
   • ZONE: VM が配置されているゾーン。
   • VM_NAME: VM の名前。