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

インスタンススケジュールを使用すると、仮想マシン（VM）インスタンスの起動と停止を自動的に実行できます。インスタンススケジュールを使用するには、起動と停止の動作の詳細を指定したリソースポリシーを作成し、ポリシーを 1 つ以上の VM インスタンスに接続します。

インスタンススケジュールを使用して VM インスタンスのデプロイを自動化することで、費用を最適化し、VM インスタンスをさらに効率的に管理できます。インスタンススケジュールは、繰り返しのワークロードと 1 回限りのワークロードの両方に使用できます。たとえば、インスタンススケジュールを使用して、VM インスタンスを業務時間中にのみ実行したり、1 回限りのイベントに容量を指定したりすることができます。

VM を自動的にスケジュールするその他のオプションについては、次のページをご覧ください。

スケジュールに基づくスケーリング: マネージドインスタンスグループ（MIG）でワークロードを実行する場合、スケーリングスケジュールを使用して、繰り返し発生するイベントまたは 1 回限りのイベントに対して必要な数の仮想マシン（VM）インスタンスをスケジュールできます。
VM の実行時間を制限する: リソースポリシーを作成しない場合、特定の時間または期間に達したときに自動的に停止または削除するように VM を直接構成できます。

始める前に

まだ設定していない場合は、認証を設定します。認証とは、Google Cloud サービスと API にアクセスするために ID を確認するプロセスです。ローカル開発環境からコードまたはサンプルを実行するには、次のように Compute Engine に対する認証を行います。

Select the tab for how you plan to use the samples on this page:
Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
1. Install the Google Cloud CLI, then initialize it by running the following command:
  gcloud init
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

必要なロール

インスタンススケジュールを使用するには、そのために必要な Identity and Access Management（IAM）ロールを、次のプリンシパルに付与する必要があります。

プロジェクトの Compute Engine サービスエージェント。これは、インスタンススケジュールを VM 上で実行するために必要です。

インスタンススケジュールの作成後にこれらの権限を取り消すと、インスタンススケジュールが通知なしに機能しなくなる可能性があります。インスタンススケジュールが正常に実行されたことを確認するには、定期的に監査ログを確認する必要があります。
インスタンススケジュールを作成、管理、または使用するユーザーアカウントまたはサービスアカウント。

Compute Engine サービスエージェントに必要なロール

Compute Engine サービスエージェントにインスタンススケジュールの実行に必要な権限が付与されるようにするには、Compute Engine サービスエージェントにプロジェクトに対する Compute インスタンス管理者（v1）（roles/compute.instanceAdmin.v1）の IAM ロールを付与するよう管理者に依頼します。ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

この事前定義ロールには、インスタンススケジュールを実行するために必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

インスタンススケジュールを実行するには、次の権限が必要です。

compute.instances.start
compute.instances.stop

管理者は、Compute Engine サービスエージェントにカスタムロールや他の事前定義ロールでこれらの権限を付与することもできます。

ロールが必要なユーザーまたはサービスアカウント

ユーザーまたはユーザーのサービスアカウントにインスタンススケジュールの作成と管理に必要な権限を付与されるようにするには、プロジェクトまたは組織に対する Compute インスタンス管理者（v1）（roles/compute.instanceAdmin.v1）の IAM ロールをユーザーまたはユーザーのサービスアカウントに付与するよう管理者に依頼します。ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

この事前定義ロールには、インスタンススケジュールを作成、管理するために必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

インスタンススケジュールを作成、管理するには、次の権限が必要です。

インスタンススケジュールを作成する: compute.resourcePolicies.create
インスタンススケジュールを一覧取得する: compute.resourcePolicies.list
インスタンススケジュールの説明を取得する: compute.resourcePolicies.get
インスタンススケジュールを削除する: compute.resourcePolicies.delete
新しい VM にインスタンススケジュールを適用する:
- compute.instances.create
- compute.resourcePolicies.use
- compute.instances.addResourcePolicies
既存の VM にインスタンススケジュールを適用する:
- compute.resourcePolicies.use
- compute.instances.addResourcePolicies
VM からインスタンススケジュールを削除する:
- compute.resourcePolicies.use
- compute.instances.removeResourcePolicies

管理者は、ユーザーまたはユーザーのサービスアカウントに、カスタムロールまたは他の事前定義ロールでこれらの権限を付与することもできます。

制限事項

インスタンススケジュールは、インスタンススケジュールと同じリージョンにある VM インスタンスにのみ接続できます。
インスタンススケジュールを使用して、ローカル SSD ディスクがあるインスタンスを停止することはできません。
各 VM インスタンスに接続できるのは 1 つのインスタンススケジュールのみですが、各インスタンススケジュールは最大 1,000 個の VM インスタンスに接続できます。
インスタンススケジュールでは容量が保証されないため、スケジュールした VM インスタンスに必要なリソースがスケジュールした時間に使用できない場合、VM インスタンスがスケジュールされた時間に起動しない可能性があります。起動前に VM インスタンスを予約して容量を確保することもできますが、予約を自動的にスケジュールすることはできません。
インスタンススケジュールは、指定された時間にしか VM インスタンスの起動および停止を行いませんが、VM インスタンスはいつでも手動で起動および停止できます。たとえば、毎日午前 8 時に起動し、毎日午後 5 時に停止するようにスケジュールが設定されているとします。午後 4 時に停止された VM インスタンスにそのスケジュールを接続した場合、その前に手動で起動しない限り、翌日の午前 8 時までその VM インスタンスは起動しません。
スケジュールされた VM インスタンスは、起動オペレーションまたは停止オペレーションを開始するスケジュール時刻よりも最大 15 分遅れることがあります。特定の時間に VM インスタンスを起動または停止する必要がある場合は、目的の時間の 15 分前までにオペレーションのスケジュールを設定し、各オペレーションは少なくとも 15 分以上の間隔を空けてスケジュールします。
起動オペレーションと停止オペレーションの間隔が 15 分未満の場合、スケジューラが失敗する可能性があります。これは、停止オペレーションが起動オペレーションより前に実行されて、起動オペレーションを実行できなくなる可能性があるためです。
各インスタンススケジュールでは、1 時間あたり最大 1 つの起動オペレーションおよび停止オペレーションを設定できます。
インスタンスのスケジュールを変更するには、インスタンススケジュールポリシーにパッチオペレーションを使用します。

インスタンススケジュールを管理する

Google Cloud コンソール、Google Cloud CLI、Compute Engine API のいずれかを使用して、インスタンススケジュールの作成、一覧表示、記述、削除を行います。

インスタンススケジュールを作成する

VM インスタンスが自動的に起動または停止する時間を示すインスタンススケジュールを作成します。作成するインスタンススケジュールはリソースポリシーであり、VM インスタンスに対する接続または削除に使用できます。

コンソール

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

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

注: このオプションが表示されない場合は、最初に VM インスタンスを作成してください。
[ スケジュールを作成] をクリックします。[スケジュールの作成] ペインが開きます。
[名前] を入力します。
（省略可）[説明] を入力します。
[リージョン] プルダウンメニューで、このインスタンススケジュールのロケーションを選択します。
インスタンススケジュールが、接続された VM インスタンスの起動と停止を行う時間を定義します。特定の時間に VM インスタンスを起動または停止する必要がある場合は、目的の時間の 15 分前までにオペレーションのスケジュールを設定します。起動と停止の各オペレーション間には、少なくとも 15 分の間隔を設けてください。

デフォルトの [起動時間]、[停止時間]、および [頻度] を使用するか、より複雑なスケジュールの構成をする場合は、cron 式を使用します。
- デフォルトのフィールド:
  1. [起動時間] と [停止時間] のいずれか、または両方を入力します。
    - [起動時間] に「」と入力またはクリックして、VM インスタンスの起動時間を選択します。
    - [停止時間] に「」と入力またはクリックして、VM インスタンスの停止時間を選択します。
  2. パネルの下部にある [頻度] プルダウンメニューで、[起動時間] と [停止時間] を繰り返す頻度を選択します。
- cron 式:
  1. cron 式を有効にするには、ペインの上部にある [CRON 式を使用する] 切り替えボタンをクリックします。
  2. [CRON 式を開始] と [CRON 式を停止] の一方または両方を入力します。
    - [CRON 式を開始] フィールドに、VM インスタンスを起動する時間を記述する cron 式を入力します。
    - [CRON 式を停止] フィールドに、VM インスタンスを停止する時間を記述する cron 式を入力します。
[タイムゾーン] プルダウンメニューで、[起動時間] と [停止時間] のタイムゾーンを選択します。
省略可: [開始日] フィールドで、を入力またはクリックして、このインスタンスのスケジュールを開始する日時を選択します。省略すると、スケジュールはすぐに有効になります。
省略可: [終了日] フィールドにを入力またはクリックして、このインスタンスのスケジュールを終了する日時を選択します。省略すると、スケジュールは無期限に有効になります。
[送信] をクリックします。

gcloud

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

gcloud compute resource-policies create instance-schedule SCHEDULE_NAME \
    [--description='SCHEDULE_DESCRIPTION'] \
    [--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: 新しいインスタンススケジュールの名前。
SCHEDULE_DESCRIPTION: 省略可。新しいインスタンススケジュールの説明。
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",
  "description": "SCHEDULE_DESCRIPTION",
  "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: 新しいインスタンススケジュールの名前。
SCHEDULE_DESCRIPTION: 省略可。新しいインスタンススケジュールの説明。
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 タイムスタンプの形式で表されます。省略すると、スケジュールは無期限に有効になります。詳しくは、終了日をご覧ください。

各インスタンススケジュールには次の設定があります。

起動オペレーションのスケジュールと、停止オペレーションのスケジュール

インスタンススケジュールが、接続された VM インスタンスの起動と停止を行う時間を示すスケジュール。インスタンススケジュールには、これらのスケジュールのいずれか、または両方を設定できます。

Google Cloud コンソールを使用してインスタンススケジュールを作成する場合は、[開始時間]、[停止時間]、[頻度] を選択できます。または、各スケジュールを cron 式の形式で表します。gcloud CLI または Compute Engine API を使用してインスタンススケジュールを作成する場合は、各スケジュールを cron 式の形式で表す必要があります。

次の表に、cron 式のフィールドと各フィールドでサポートされる値を示します。

分	時間	日	月	曜日
0～59	0-23	1-31 29～31 は、対象月にのみ有効	1～12	0～6 または `SUN-SAT`（日曜日～土曜日）ここで、0=`SUN`、1=`MON`、… 6=`SAT` です。

これらの値に加えて、cron 式のすべてのフィールドで次の特殊文字を使用することもできます。

特殊文字	意味	例
`*`	任意	日付、月、曜日フィールドがすべて `*` に設定されている場合、スケジュールは毎日繰り返されます。
`-`	範囲	曜日フィールドが `MON-FRI`（または `1-5`）に設定されている場合、スケジュールは毎週月曜日～金曜日で繰り返されます。
`,`	リスト	月フィールドが `1-6,8-12` に設定されている場合、スケジュールは 7 月を除き毎月繰り返されます。

cron 式を記述する場合は、次の点を考慮してください。

空白文字は、cron 式のフィールドを区切るために使用されます。特殊文字を使用するフィールドに余分なスペースを追加しないでください。
曜日と日付の両方（フィールドが * に設定されていない場合）を指定した場合は、これらの値の共通部分ではなく、ユニオンが使用されます。たとえば、スケジュール 0 8 1 * MON は、毎週月曜日と毎月 1 日の午前 8 時に開始します。1 日が月曜日の場合にのみ午前 8 時に開始するわけではありません。

タイムゾーン

起動オペレーションスケジュールと停止オペレーションスケジュールのロケーションベースの IANA タイムゾーン。IANA タイムゾーンデータベースでは、使用可能な値のリストが定義されています。このタイムゾーンは、起動オペレーションと停止オペレーションのスケジュールの参考用としてのみ使用されます。開始日と終了日には使用されません。gcloud CLI または Compute Engine API を使用する場合、タイムゾーンは省略可能です。省略した場合、デフォルト値の UTC が使用されます。

一部の IANA タイムゾーンでは、夏時間（DST）が実施され、インスタンススケジュールに影響を与える可能性があります。DST の詳細（開始時と終了時、スキップや繰り返しの時間など）は、各タイムゾーンによって異なります。

注: DST が開始し、終了すると、インスタンススケジュールは次のように動作します。

DST の開始時、およびスキップされた時刻にスケジュールされているオペレーションは、オフセットを経て引き続き実行されます。たとえば、オペレーションのスケジュールが午前 2 時 15 分に設定されているものの、DST が午前 2 時をスキップする場合、その日のオペレーションは代わりに午前 3 時 15 分に始まります。このスキップされる時間により、VM インスタンスの実行時間がスキップされなかった場合よりも短くなる可能性があります。スキップされる時間により、起動オペレーションと停止オペレーションが同時にスケジュールされる場合、停止オペレーションが優先され、起動オペレーションは無視されます。
DST の終了時でスケジュールされており、時間が繰り返されるオペレーションは、最初にその時間になった時点で実行されます。この繰り返しの時間により、VM インスタンスの実行時間が繰り返しがない場合よりも長くなることがあります。

開始日と終了日

インスタンススケジュールが有効になる期間です。どちらの値も任意です。これらの値を指定して、スケジュールを 1 年に制限しない限り、オペレーションは毎年繰り返されます。

Google Cloud コンソールを使用してインスタンスのスケジュールを作成する場合は、[開始日] フィールドと [終了日] フィールドを使用して日付、時刻、タイムゾーンを選択します。

gcloud CLI または Compute Engine API を使用してインスタンススケジュールを作成する場合、これらの値は 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 タイムゾーン）を使用する場合、Z で表記されます。

インスタンススケジュールの一覧表示

インスタンスのスケジュールを一覧表示して、プロジェクトの既存のインスタンススケジュールをすべて表示します。

コンソール

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

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

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: 一覧表示するインスタンススケジュールが配置されているリージョン。

インスタンススケジュールの記述

インスタンススケジュールを記述して、説明、タイミング、オペレーション、接続されているすべての VM インスタンスのリストを表示します。

コンソール

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

[VM インスタンス] に移動
ページ上部にある [インスタンススケジュール] タブをクリックします。これにより、このプロジェクトのすべてのインスタンススケジュールのリストが表示されます。
記述するインスタンススケジュールの名前をクリックします。これにより、そのスケジュールの [インスタンススケジュールの詳細] ページが開きます。

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"
    }
  },
  ...
}

インスタンススケジュールを削除する

接続された VM インスタンスとリソースポリシーを削除することで、不要になったインスタンススケジュールを削除します。

コンソール

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

[VM インスタンス] に移動
ページ上部にある [インスタンススケジュール] タブをクリックします。これにより、このプロジェクトのすべてのインスタンススケジュールのリストが表示されます。
削除するインスタンススケジュールのチェックボックスをオンにします。
ページの上部にある [削除] をクリックします。これにより、この操作を確認する新しいダイアログが開きます。
ダイアログで [削除] をクリックします。

gcloud

このインスタンススケジュールが VM インスタンスに接続されている場合は、それらを削除します。
1. このスケジュールが接続されている VM インスタンスを確認するには、インスタンススケジュールを記述します。
2. このスケジュールが接続されている VM インスタンスごとに、インスタンススケジュールを削除します。
gcloud CLI を使用してインスタンススケジュールを削除するには、gcloud compute resource-policies delete コマンドを使用します。
```
gcloud compute resource-policies delete SCHEDULE_NAME \
   [--region=REGION]
```
次のように置き換えます。
- SCHEDULE_NAME: 削除するインスタンススケジュールの名前。
- REGION: 省略可。インスタンススケジュールが配置されているリージョン。

REST

このインスタンススケジュールが VM インスタンスに接続されている場合は、それらを削除します。
1. このスケジュールが接続されている VM インスタンスを確認するには、インスタンススケジュールを記述します。
2. このスケジュールが接続されている VM インスタンスごとに、インスタンススケジュールを削除します。
Compute Engine API を使用してインスタンススケジュールを削除するには、resourcePolicies.delete メソッドを使用してリクエストを行います。
```
DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/resourcePolicies/SCHEDULE_NAME
```
次のように置き換えます。
- PROJECT: 実際のプロジェクト ID。
- REGION: インスタンススケジュールが配置されているリージョン。
- SCHEDULE_NAME: 削除するインスタンススケジュールの名前。

VM インスタンスでインスタンススケジュールを使用する

インスタンススケジュールを使用するには、そのスケジュールを実行する 1 つ以上の VM インスタンスに接続します。インスタンススケジュールは、既存の VM インスタンスまたは新しい VM インスタンスの作成時に接続できます。VM インスタンスによる接続されたインスタンススケジュールの実行を停止するには、その VM インスタンスからスケジュールを削除します。

新しい VM インスタンスの作成時にインスタンススケジュールを接続する

インスタンススケジュールを新しい VM インスタンスに接続するには、使用するインスタンススケジュールと同じリージョンに VM インスタンスを作成する必要があります。詳細については、VM インスタンスの作成をご覧ください。

コンソール

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: 接続するインスタンススケジュールの名前。

インスタンススケジュールのリソースポリシーと、接続されている VM インスタンスの監査ログを調べると、インスタンススケジュールが正常に実行されているかどうかを確認できます。各オペレーションにスケジュールされた時刻から最大 15 分待つことが必要な場合があります。

インスタンススケジュールを既存の VM インスタンスに接続する

インスタンススケジュールは、インスタンススケジュールと同じリージョンにある既存の VM インスタンスに接続できます。

コンソール

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

[VM インスタンス] に移動
ページ上部にある [インスタンススケジュール] タブをクリックします。これにより、このプロジェクトのすべてのインスタンススケジュールのリストが表示されます。
接続するインスタンススケジュールの名前をクリックします。[インスタンススケジュールの詳細] ページが開きます。
[スケジュールにインスタンスを追加] をクリックします。[スケジュールにインスタンスを追加] ペインが開きます。
このスケジュールを接続する各 VM インスタンスのチェックボックスを選択します。
[追加] をクリックします。

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://www.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/instances/VM_NAME/addResourcePolicies
{
  "resourcePolicies": "https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/resourcePolicies/SCHEDULE_NAME"
}

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

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

VM インスタンスからインスタンススケジュールを削除する

VM インスタンスによるインスタンススケジュールの実行を停止するには、その VM インスタンスからインスタンススケジュールを削除します。

コンソール

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

[VM インスタンス] に移動
ページ上部にある [インスタンススケジュール] タブをクリックします。このプロジェクトのすべてのインスタンススケジュールが一覧表示されます。
削除するインスタンススケジュールの名前をクリックします。[インスタンススケジュールの詳細] ページが開きます。
[接続されているインスタンス] セクションで、このスケジュールから削除する各 VM インスタンスのチェックボックスをオンにします。
[ スケジュールからインスタンスを削除] をクリックします。これにより、この操作を確認する新しいダイアログが開きます。
ダイアログで [削除] をクリックします。

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://www.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/instances/VM_NAME/removeResourcePolicies
{
  "resourcePolicies": "https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/resourcePolicies/SCHEDULE_NAME"
}

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

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

次のステップ

VM のスケジューリングのための Compute Engine のその他の機能について学習する。
- VM のランタイムの制限
- スケジュールに基づく MIG のスケーリング

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

始める前に

Console

gcloud

REST

必要なロール

Compute Engine サービス エージェントに必要なロール

必要な権限

ロールが必要なユーザーまたはサービス アカウント

必要な権限

制限事項

インスタンス スケジュールを管理する

インスタンス スケジュールを作成する

コンソール

gcloud

REST

インスタンス スケジュールの一覧表示

コンソール

gcloud

REST

インスタンス スケジュールの記述

コンソール

gcloud

REST

インスタンス スケジュールを削除する

コンソール

gcloud

REST

VM インスタンスでインスタンス スケジュールを使用する

新しい VM インスタンスの作成時にインスタンス スケジュールを接続する

コンソール

gcloud

REST

インスタンス スケジュールを既存の VM インスタンスに接続する

コンソール

gcloud

REST

VM インスタンスからインスタンス スケジュールを削除する

コンソール

gcloud

REST

次のステップ

Compute Engine サービスエージェントに必要なロール

ロールが必要なユーザーまたはサービスアカウント

インスタンススケジュールを管理する

インスタンススケジュールを作成する

インスタンススケジュールの一覧表示

インスタンススケジュールの記述

インスタンススケジュールを削除する

VM インスタンスでインスタンススケジュールを使用する

新しい VM インスタンスの作成時にインスタンススケジュールを接続する

インスタンススケジュールを既存の VM インスタンスに接続する

VM インスタンスからインスタンススケジュールを削除する