VM インスタンスの起動と停止をスケジュールする

コンソール

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

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

2. ページ上部にある [インスタンス スケジュール] タブをクリックします。

3. [date_range スケジュールを作成] をクリックします。[スケジュールの作成] ペインが開きます。

4. [名前] を入力します。

5. [リージョン] プルダウン メニューで、このインスタンス スケジュールのロケーションを選択します。

6. インスタンス スケジュールが、接続された VM インスタンスの起動と停止を行う時間を定義します。特定の時間に VM インスタンスを起動または停止する必要がある場合は、目的の時間の 15 分前までにオペレーションのスケジュールを設定します。起動と停止の各オペレーション間には、少なくとも 15 分の間隔を設けてください。

   デフォルトの [起動時間]、[停止時間]、および [頻度] を使用するか、より複雑なスケジュールの構成をする場合は、cron 式を使用します。

   • デフォルトのフィールド:

     1. [起動時間] と [停止時間] のいずれか、または両方を入力します。
        • [起動時間] に「access_time」と入力またはクリックして、VM インスタンスの起動時間を選択します。
        • [停止時間] に「access_time」と入力またはクリックして、VM インスタンスの停止時間を選択します。
     2. パネルの下部にある [頻度] プルダウン メニューで、[起動時間] と [停止時間] を繰り返す頻度を選択します。

   • cron 式:

     1. cron 式を有効にするには、ペインの上部にある [CRON 式を使用する] 切り替えボタンをクリックします。
     2. [CRON 式を開始] と [CRON 式を停止] の一方または両方を入力します。
        • [CRON 式を開始] フィールドに、VM インスタンスを起動する時間を記述する cron 式を入力します。
        • [CRON 式を停止] フィールドに、VM インスタンスを停止する時間を記述する cron 式を入力します。

7. [タイムゾーン] プルダウン メニューで、[起動時間] と [停止時間] のタイムゾーンを選択します。

8. 省略可: [開始日] フィールドで、date_range を入力またはクリックして、このインスタンスのスケジュールを開始する日時を選択します。省略すると、スケジュールはすぐに有効になります。

9. 省略可: [終了日] フィールドに date_range を入力またはクリックして、このインスタンスのスケジュールを終了する日時を選択します。省略すると、スケジュールは無期限に有効になります。

10. [送信] をクリックします。

gcloud

gcloud CLI を使用してインスタンス スケジュールを作成するには、gcloud compute resource-policies create instance-schedule コマンドを使用します。

gcloud compute resource-policies create instance-schedule SCHEDULE_NAME \
    --region=REGION \
    [--vm-start-schedule='START-OPERATION_SCHEDULE'] \
    [--vm-stop-schedule='STOP-OPERATION_SCHEDULE'] \
    [--timezone=TIME_ZONE] \
    [--initiation-date=INITIATION_DATE] \
    [--end-date=END_DATE]

以下を置き換えます。

• SCHEDULE_NAME: 新しいインスタンス スケジュールの名前。
• REGION: このインスタンス スケジュールに接続する VM インスタンスが配置されているリージョン。
• 次のうち少なくとも 1 つを指定します。
  • START-OPERATION_SCHEDULE: 接続された VM インスタンスが起動する時間を示すスケジュール。cron 式の形式で表されます。特定の時間に VM インスタンスを起動する必要がある場合は、目的の時間の 15 分前までにオペレーションのスケジュールを設定します。詳細については、起動オペレーションのスケジュールをご覧ください。
  • STOP-OPERATION_SCHEDULE: 接続された VM インスタンスが停止する時間を示すスケジュール。cron 式の形式で表されます。特定の時間に VM インスタンスを停止する必要がある場合は、目的の時間の 15 分前までにオペレーションのスケジュールを設定します。詳細については、停止オペレーションのスケジュールをご覧ください。
• TIME_ZONE: 省略可。このインスタンス スケジュールに対するロケーションベースの IANA タイムゾーン。省略した場合は、デフォルト値の UTC が使用されます。詳細については、タイムゾーンをご覧ください。
• INITIATION_DATE: 省略可。インスタンス スケジュールが有効になる最初の日。RFC 3339 の形式で表されます。省略すると、スケジュールはすぐに有効になります。詳細については、開始日をご覧ください。
• END_DATE: 省略可。インスタンス スケジュールが有効な最後の日。RFC 3339 タイムスタンプの形式で表されます。省略すると、スケジュールは無期限に有効になります。詳しくは、終了日をご覧ください。

REST

Compute Engine API を使用してインスタンス スケジュールを作成するには、resourcePolicies.insert メソッドを使用してリクエストを行います。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/resourcePolicies
{
  "name": "SCHEDULE_NAME",
  "instanceSchedulePolicy": {
    "vmStartSchedule": {
      "schedule": "START-OPERATION_SCHEDULE"
    },
    "vmStopSchedule": {
      "schedule": "STOP-OPERATION_SCHEDULE"
    },
    "timeZone": "TIME_ZONE",
    "startTime":"INITIATION_DATE",
    "expirationTime":"END_DATE"
  }
}

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

• PROJECT: 実際のプロジェクト ID。
• REGION: このインスタンス スケジュールに接続する VM インスタンスが配置されているリージョン。
• SCHEDULE_NAME: 新しいインスタンス スケジュールの名前。
• START-OPERATION_SCHEDULE または STOP-OPERATION_SCHEDULE: 少なくとも次のいずれかを指定します。
  • START-OPERATION_SCHEDULE: 接続された VM インスタンスが起動する時間を示すスケジュール。cron 式の形式で表されます。特定の時間に VM インスタンスを起動する必要がある場合は、目的の時間の 15 分前までにオペレーションのスケジュールを設定します。詳しくは、起動オペレーションのスケジュールをご覧ください。
  • STOP-OPERATION_SCHEDULE: 接続された VM インスタンスが停止する時間を示すスケジュール。cron 式の形式で表されます。特定の時間に VM インスタンスを停止する必要がある場合は、目的の時間の 15 分前までにオペレーションのスケジュールを設定します。詳細については、停止オペレーションのスケジュールをご覧ください。
• TIME_ZONE: このインスタンス スケジュールに対するロケーションベースの IANA タイムゾーン。詳細については、タイムゾーンをご覧ください。
• INITIATION_DATE: 省略可。インスタンス スケジュールが有効になる最初の日。RFC 3339 の形式で表されます。省略すると、スケジュールはすぐに有効になります。詳細については、開始日をご覧ください。
• END_DATE: 省略可。インスタンス スケジュールが有効な最後の日。RFC 3339 タイムスタンプの形式で表されます。省略すると、スケジュールは無期限に有効になります。詳しくは、終了日をご覧ください。

コンソール

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

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

2. ページ上部にある [インスタンス スケジュール] タブをクリックします。これにより、このプロジェクトのすべてのインスタンス スケジュールのリストが表示されます。

gcloud

gcloud CLI を使用して、インスタンス スケジュールを含むすべてのリソース ポリシーのリストを表示するには、gcloud compute resource-policies list コマンドを使用します。必要に応じて、結果を特定のリージョンに制限するには、--filter フラグを含めます。

gcloud compute resource-policies list \
    [--filter="region:(REGION)"]

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

• REGION: 省略可。一覧取得するインスタンス スケジュールが配置されているリージョン。

REST

Compute Engine API を使用して、特定のリージョンにおけるインスタンス スケジュールを含むすべてのリソース ポリシーのリストを表示するには、resourcePolicies.list メソッドを使用してリクエストを行います。

GET https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/resourcePolicies

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

• PROJECT: 実際のプロジェクト ID。
• REGION: 一覧表示するインスタンス スケジュールが配置されているリージョン。

コンソール

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

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

2. ページ上部にある [インスタンス スケジュール] タブをクリックします。これにより、このプロジェクトのすべてのインスタンス スケジュールのリストが表示されます。

3. 記述するインスタンス スケジュールの名前をクリックします。これにより、そのスケジュールの [インスタンス スケジュールの詳細] ページが開きます。

gcloud

gcloud CLI を使用してインスタンス スケジュールを記述するには、gcloud compute resource-policies describe コマンドを使用します。

gcloud compute resource-policies describe SCHEDULE_NAME \
    --region=REGION

以下を置き換えます。

• SCHEDULE_NAME: 記述するインスタンス スケジュールの名前。
• REGION: インスタンス スケジュールが配置されているリージョン。

出力は次のようになります。

...
description: Every Monday to Friday in 2022, start VMs at 8 AM and stop VMs at 5 PM.
...
instanceSchedulePolicy:
 expirationTime: '2022-12-31T23:59:59Z'
 startTime: '2022-01-01T00:00:00Z'
 timeZone: UTC
 vmStartSchedule:
   schedule: 0 8 * * MON-FRI
 vmStopSchedule:
   schedule: 0 17 * * MON-FRI
...
name: example-instance-schedule
region: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-west1
resourceStatus:
 instanceSchedulePolicy:
   nextRunStartTime: '2022-01-03T08:00:00Z'
...
status: READY

REST

Compute Engine API を使用してインスタンス スケジュールを記述するには、resourcePolicies.get メソッドを使用してリクエストを行います。

GET https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/resourcePolicies/SCHEDULE_NAME

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

• PROJECT: 実際のプロジェクト ID。
• REGION: インスタンス スケジュールが配置されているリージョン。
• SCHEDULE_NAME: 記述するインスタンス スケジュールの名前。

出力は次のようになります。

{
  ...
  "description": "Every Monday to Friday in 2022, start VMs at 8 AM and stop VMs at 5 PM.",
  "name": "example-instance-schedule",
  "instanceSchedulePolicy": {
    "vmStartSchedule": {
      "schedule": "0 8 * * MON-FRI"
    },
    "vmStopSchedule": {
      "schedule": "0 17 * * MON-FRI"
    },
    "timeZone": "UTC",
    "startTime": "2022-01-01T00:00:00Z",
    "expirationTime": "2022-12-31T23:59:59Z"
  },
  "status": "READY",
  "resourceStatus": {
    "instanceSchedulePolicy": {
      "nextRunStartTime": "2022-01-03T08:00:00Z"
    }
  },
  ...
}

コンソール

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

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

2. ページ上部にある [インスタンス スケジュール] タブをクリックします。これにより、このプロジェクトのすべてのインスタンス スケジュールのリストが表示されます。

3. 削除するインスタンス スケジュールのチェックボックスをオンにします。

4. ページの上部にある delete [削除] をクリックします。これにより、この操作を確認する新しいダイアログが開きます。

5. ダイアログで [削除] をクリックします。

gcloud

1. このインスタンス スケジュールが VM インスタンスに接続されている場合は、それらを削除します。
   1. このスケジュールが接続されている VM インスタンスを確認するには、インスタンス スケジュールを記述します。
   2. このスケジュールが接続されている VM インスタンスごとに、インスタンス スケジュールを削除します。

2. gcloud CLI を使用してインスタンス スケジュールを削除するには、gcloud compute resource-policies delete コマンドを使用します。

   gcloud compute resource-policies delete SCHEDULE_NAME \
      --region=REGION
   

   以下を置き換えます。

   • SCHEDULE_NAME: 削除するインスタンス スケジュールの名前。
   • REGION: インスタンス スケジュールが配置されているリージョン。

REST

1. このインスタンス スケジュールが VM インスタンスに接続されている場合は、それらを削除します。
   1. このスケジュールが接続されている VM インスタンスを確認するには、インスタンス スケジュールを記述します。
   2. このスケジュールが接続されている VM インスタンスごとに、インスタンス スケジュールを削除します。

2. Compute Engine API を使用してインスタンス スケジュールを削除するには、resourcePolicies.delete メソッドを使用してリクエストを行います。

   DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/resourcePolicies/SCHEDULE_NAME
   

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

   • PROJECT: 実際のプロジェクト ID。
   • REGION: インスタンス スケジュールが配置されているリージョン。
   • SCHEDULE_NAME: 削除するインスタンス スケジュールの名前。

コンソール

Google Cloud コンソール を使用してインスタンスを作成している間、インスタンス スケジュールを接続することはできません。Google Cloud コンソール を使用してインスタンス スケジュールを新しい VM インスタンスに接続するには、VM インスタンスを作成してから、VM インスタンスにスケジュールを接続します。

gcloud

gcloud CLI を使用して VM インスタンスにインスタンス スケジュールを接続するには、--resource-policies フラグを指定して gcloud compute instances create コマンドを使用します。たとえば、公開イメージからインスタンス スケジュールが接続された VM インスタンスを作成するには、次のコマンドを使用します。

gcloud compute instances create VM_NAME \
    --resource-policies=SCHEDULE_NAME \
    --zone=ZONE \
    [--image IMAGE | --image-family IMAGE_FAMILY] \
    [--image-project IMAGE_PROJECT]

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

• VM_NAME: インスタンス スケジュールを接続する VM インスタンスの名前。
• SCHEDULE_NAME: 接続するインスタンス スケジュールの名前。
• ZONE: VM インスタンスが配置されているゾーン。
• 省略可: 公開イメージから VM インスタンスを作成します。
  • IMAGE または IMAGE_FAMILY: 次のいずれかを指定します。
  • IMAGE: 公開イメージの必須バージョン。例: --image debian-10-buster-v20200309
  • IMAGE_FAMILY: イメージ ファミリー。これにより、非推奨ではない最新の OS イメージから VM が作成されます。たとえば、--image-family debian-10 を指定すると、Compute Engine は Debian 10 イメージ ファミリーの OS イメージの最新バージョンから VM を作成します。
  • IMAGE_PROJECT: イメージを含むプロジェクト。

REST

Compute Engine API を使用して VM インスタンスにインスタンス スケジュールを接続するには、instances.insert メソッドを使用してリクエストを行い、resourcePolicies 属性を指定します。たとえば、公開イメージからインスタンス スケジュールが接続された VM インスタンスを作成するには、次のリクエストを行います。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
  "machineType": "zones/MACHINE_TYPE_ZONE/machineTypes/MACHINE_TYPE",
  "name": "VM_NAME",
  "disks": [
    {
      "initializeParams": {
        "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
      },
      "boot": true
    }
  ],
  "resourcePolicies": [
    "https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/resourcePolicies/SCHEDULE_NAME"
  ]
}

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

• PROJECT_ID: VM を作成するプロジェクトの ID。
• ZONE: VM を作成するゾーン。
• MACHINE_TYPE_ZONE: 新しい VM に使用するマシンタイプを含むゾーン。
• MACHINE_TYPE: 新しい VM のマシンタイプ（事前定義またはカスタム）。
• VM_NAME: 新しい VM の名前。
• 省略可: 公開イメージから VM インスタンスを作成します。
  • IMAGE_PROJECT: イメージを含むプロジェクト。たとえば、イメージ ファミリーとして family/debian-10 を指定する場合は、イメージ プロジェクトとして debian-cloud を指定します。
  • IMAGE または IMAGE_FAMILY: 次のいずれかを指定します。
  • IMAGE: 公開イメージの必須バージョン。例: "sourceImage": "projects/debian-cloud/global/images/debian-10-buster-v20200309"
  • IMAGE_FAMILY: イメージ ファミリー。これにより、非推奨ではない最新の OS イメージから VM が作成されます。たとえば、"sourceImage": "projects/debian-cloud/global/images/family/debian-10" を指定すると、Compute Engine は Debian 10 イメージ ファミリーの OS イメージの最新バージョンから VM を作成します。
• REGION: インスタンス スケジュールが配置されているリージョン。
• SCHEDULE_NAME: 接続するインスタンス スケジュールの名前。

コンソール

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

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

2. ページ上部にある [インスタンス スケジュール] タブをクリックします。これにより、このプロジェクトのすべてのインスタンス スケジュールのリストが表示されます。

3. 接続するインスタンス スケジュールの名前をクリックします。[インスタンス スケジュールの詳細] ページが開きます。

4. [スケジュールにインスタンスを追加] をクリックします。[スケジュールにインスタンスを追加] ペインが開きます。

5. このスケジュールを接続する各 VM インスタンスのチェックボックスを選択します。

6. [追加] をクリックします。

gcloud

gcloud CLI を使用して VM インスタンスにインスタンス スケジュールを接続するには、gcloud compute instances add-resource-policies コマンドを使用します。

gcloud compute instances add-resource-policies VM_NAME \
    --resource-policies=SCHEDULE_NAME \
    --zone=ZONE

以下を置き換えます。

• VM_NAME: インスタンス スケジュールを接続する VM インスタンスの名前。
• SCHEDULE_NAME: 接続するインスタンス スケジュールの名前。
• ZONE: VM インスタンスが配置されているゾーン。

REST

Compute Engine API を使用して VM インスタンスにインスタンス スケジュールを接続するには、instances.addResourcePolicies メソッドを使用してリクエストを行います。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/instances/VM_NAME/addResourcePolicies
{
  "resourcePolicies": "projects/PROJECT/regions/REGION/resourcePolicies/SCHEDULE_NAME"
}

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

• PROJECT: 実際のプロジェクト ID。
• ZONE: VM インスタンスが配置されているゾーン。
• VM_NAME: インスタンス スケジュールを接続する VM インスタンスの名前。
• REGION: インスタンス スケジュールが配置されているリージョン。
• SCHEDULE_NAME: 接続するインスタンス スケジュールの名前。

コンソール

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

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

2. ページ上部にある [インスタンス スケジュール] タブをクリックします。このプロジェクトのすべてのインスタンス スケジュールが一覧表示されます。

3. 削除するインスタンス スケジュールの名前をクリックします。[インスタンス スケジュールの詳細] ページが開きます。

4. [接続されているインスタンス] セクションで、このスケジュールから削除する各 VM インスタンスのチェックボックスをオンにします。

5. [delete スケジュールからインスタンスを削除] をクリックします。これにより、この操作を確認する新しいダイアログが開きます。

6. ダイアログで [削除] をクリックします。

gcloud

gcloud CLI を使用して VM インスタンスからインスタンス スケジュールを削除するには、gcloud compute instances remove-resource-policies コマンドを使用します。

gcloud compute instances remove-resource-policies VM_NAME \
    --resource-policies=SCHEDULE_NAME \
    --zone=ZONE

以下を置き換えます。

• VM_NAME: インスタンス スケジュールを削除する VM インスタンスの名前。
• SCHEDULE_NAME: 削除するインスタンス スケジュールの名前。
• ZONE: VM インスタンスが配置されているゾーン。

REST

Compute Engine API を使用して VM インスタンスからインスタンス スケジュールを削除するには、instances.removeResourcePolicies メソッドを使用してリクエストを行います。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/instances/VM_NAME/removeResourcePolicies
{
  "resourcePolicies": "projects/PROJECT/regions/REGION/resourcePolicies/SCHEDULE_NAME"
}

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

• PROJECT: 実際のプロジェクト ID。
• ZONE: VM インスタンスが配置されているゾーン。
• VM_NAME: インスタンス スケジュールを削除する VM インスタンスの名前。
• REGION: インスタンス スケジュールが配置されているリージョン。
• SCHEDULE_NAME: 削除するインスタンス スケジュールの名前。