このドキュメントでは、単一プロジェクトの将来の予約リクエストを作成する方法について説明します。
Trusted Cloud by S3NS が単一プロジェクトの将来の予約リクエストを承認すると、リクエストで指定された開始時間に Compute Engine が予約を自動的に作成します。この予約は、同じプロジェクトに作成された仮想マシン(VM)インスタンスのみが使用できます。
始める前に
- 将来の予約の仕組みをまだ確認していない場合は確認します。
- 割り当てを確認して、予約するリソースに十分な割り当てがあることを確認します。
-
まだ設定していない場合は、認証を設定します。認証とは、 Trusted Cloud by S3NS サービスと API にアクセスするために ID を確認するプロセスです。ローカル開発環境からコードまたはサンプルを実行するには、次のいずれかのオプションを選択して Compute Engine に対する認証を行います。
Select the tab for how you plan to use the samples on this page:
Console
When you use the Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.
gcloud
-
After installing the Google Cloud CLI, sign in to the gcloud CLI with your federated identity and then initialize it by running the following command:
gcloud init
- Set a default region and zone.
-
将来の予約リクエストを作成する: プロジェクトに対する
compute.futureReservations.create
権限 -
Compute Engine で予約を自動作成できるようにする: プロジェクトに対する
compute.reservations.create
権限 - インスタンス テンプレートを指定するには: インスタンス テンプレートに対する
compute.instanceTemplates.useReadOnly
-
既存のインスタンス テンプレートを使用して、将来の予約リクエストのプロパティを定義できます。インスタンス テンプレートを使用すると、将来の予約のプロパティと、同じ場所で自動作成された予約を使用できる VM のプロパティを定義できます。
-
既存の VM を使用して、将来の予約リクエストのプロパティを定義できます。既存の VM のプロパティを使用して、参照用 VM と一致するプロパティを持つ VM を作成することで、将来の予約用にプロビジョニングされる自動作成予約を使用できます。
-
将来の予約リクエストのプロパティを直接定義できます。この方法では、VM のプロパティと自動作成された予約のプロパティが正確に一致することを手動で確認する必要があります。一致しないプロパティは使用できません。
将来の予約リクエストは、インスタンス テンプレート内のリソースと同じリージョンとゾーンに作成する必要があります。インスタンス テンプレートで指定されているリージョン リソースやゾーンリソース(マシンタイプ、Persistent Disk など)によって、テンプレートの使用はそれらのリソースが存在するロケーションに限定されます。たとえば、インスタンス テンプレートで
us-central1-a
ゾーンの既存の Persistent Disk が指定されている場合、同じゾーンに将来の予約リクエストを作成する必要があります。そうしないと、将来の予約リクエストは作成されません。既存のテンプレートで、特定のリージョンまたはゾーンにテンプレートをバインドするリソースが指定されているかどうかを確認するには、テンプレートの詳細を表示してリージョン リソースまたはゾーンリソースへの参照を探します。
将来の予約用にプロビジョニングされ、自動的に作成された予約をコミットメントに関連付ける場合は、自動削除オプションを無効にする必要があります。詳細については、作成後の制限事項をご覧ください。
Trusted Cloud コンソールで、[予約] ページに移動します。
[将来の予約] タブをクリックします。
[
将来の予約を作成] をクリックします。[将来の予約を作成] ページが開きます。
[名前] に、将来の予約リクエストの名前を入力します。
[接頭辞] に、名前の接頭辞を入力します。将来の予約リクエストから自動作成された各予約の名前は、この接頭辞で始まります。
[リージョン] と [ゾーン] で、リソースを予約するリージョンとゾーンを選択します。
[開始時刻] に、予約期間の開始時間を入力します。開始時間は、審査を受けるために将来の予約リクエストを送信した日時から 1 年以内にしてください。ロック時間になる前に、将来の予約を変更、キャンセル、削除するために十分な時間を確保するには、開始時間の推奨値を指定します。
[終了時刻] に、予約期間の終了時間を入力します。[期間の概要] セクションで、予約期間の長さを確認できます。審査を受けるために送信した将来の予約リクエストが Trusted Cloud で承認される可能性を高めるために、予約期間の推奨値を指定します。
[共有タイプ] セクションで、[ローカル] を選択します(まだ選択されていない場合)。
[必要な総容量] に、将来の予約リクエストで指定された期間、VM 構成、プロジェクトに予約する VM の合計数を入力します。
[マシンの構成] セクションで、次の操作を行います。
[インスタンス テンプレートを使用] を選択します。
[インスタンス テンプレート] で、任意のインスタンス テンプレートを選択します。リージョン インスタンス テンプレートを指定する場合は、テンプレートのリージョンと同じリージョン内のリソースのみを予約できます。
[自動生成された予約の自動削除] セクションで、次のいずれかを行います。
将来の予約リクエスト用に自動作成された予約を Compute Engine が自動的に削除できるようにするには、次の手順を実施します。
[自動削除を有効にする] がオンになっていない場合は、クリックしてオンにします。
省略可: [自動削除日時] に、自動作成された予約を削除する日時を入力します。日時は予約期間の終了日より後にする必要があります。このフィールドを空のままにすると、自動作成された予約は予約期間の終了時間から 2 時間以内に削除されます。
自動削除しない場合は、[自動削除を有効にする] をクリックしてオフにします。
将来の予約リクエストのドラフトの作成を完了するには、[ドラフトを保存] をクリックします。
FUTURE_RESERVATION_NAME
: 将来の予約リクエストの名前。MACHINE_TYPE
: 各予約 VM に使用するマシンタイプ。PROJECT_ID
: リソースを予約するプロジェクトとインスタンス テンプレートが配置されているプロジェクトの ID。LOCATION
: インスタンス テンプレートのロケーション。次のいずれかの値を指定します。リージョン インスタンス テンプレートの場合:
regions/REGION
REGION
は、インスタンス テンプレートが配置されているリージョンに置き換えます。リージョン インスタンス テンプレートを指定した場合、将来の予約リクエストはテンプレートのリージョンと同じリージョン内にのみ作成できます。グローバル インスタンス テンプレートの場合:
global
INSTANCE_TEMPLATE_NAME
: 既存のインスタンス テンプレートの名前。START_TIME
: RFC 3339 タイムスタンプとしてフォーマットされた予約期間の開始時間。次の形式にする必要があります。YYYY-MM-DDTHH:MM:SSOFFSET
次のように置き換えます。
YYYY-MM-DD
: 4 桁の年、2 桁の月、その月の 2 桁の日をハイフン(-
)で区切った日付。HH:MM:SS
: 24 時間制の 2 桁の時間、2 桁の分、2 桁の秒をコロン(:
)で区切った時刻。OFFSET
: 協定世界時(UTC)のオフセット形式で示されるタイムゾーン。たとえば、太平洋標準時(PST)を使用する場合は-08:00
を指定します。オフセットを使用しない場合は、Z
を指定します。
開始時間は、審査を受けるために将来の予約リクエストを送信した日時から 1 年以内にしてください。将来の予約リクエストが承認された後またはロック時間になるまでに、キャンセル、削除、変更するために十分な時間を確保するには、開始時間の推奨値を指定してください。
END_TIME
: 予約期間の終了日時(RFC 3339 タイムスタンプの形式)。送信したリクエストがTrusted Cloud で承認される可能性を高めるには、最小予約期間を指定します。終了時間ではなく所要時間を指定するには、--end-time
フラグを--duration=END_DURATION
フラグに置き換えます。END_DURATION
は期間(秒単位)に置き換えます。たとえば、1,209,600 秒(14 日)の場合は1209600
を指定します。審査を受けるために送信した将来の予約リクエストが Trusted Cloud で承認される可能性を高めるため、推奨の最小期間を指定します。
TOTAL_COUNT
: 予約する VM の合計数。ZONE
: リソースを予約するゾーン。予約期間は 2024 年 11 月 10 日(UTC)の深夜 0 時から 2024 年 12 月 10 日(UTC)の深夜 0 時までです。
合計 80 台の VM。
- リージョン
us-central1
のリージョン インスタンス テンプレート。 - 自動削除オプションが有効。自動作成された予約は、予約期間の終了時に削除されます。
自動作成された予約を予約期間の終了時間後に削除するには、次のいずれかの方法を選択します。
自動作成された予約を予約期間の終了時間後の特定の日時に削除するには、
--auto-created-reservations-delete-time
フラグを指定します。gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \ --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \ --auto-delete-auto-created-reservations \ --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \ --start-time=START_TIME \ --end-time=END_TIME \ --total-count=TOTAL_COUNT \ --zone=ZONE
AUTO_CREATED_RESERVATIONS_DELETE_TIME は、RFC 3339 タイムスタンプ形式の日時に置き換えます。
自動作成された予約を予約期間の終了時間から特定の時間が経過した後に削除するには、
--auto-created-reservations-duration
フラグを指定します。gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \ --auto-created-reservations-duration=DURATION_BEFORE_DELETE \ --auto-delete-auto-created-reservations \ --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \ --start-time=START_TIME \ --end-time=END_TIME \ --total-count=TOTAL_COUNT \ --zone=ZONE
DURATION_BEFORE_DELETE は、期間(日、時、分、秒)に置き換えます。たとえば、30 分の場合は
30m
を指定し、1 日と 2 時間 3 分 4 秒の場合は1d2h3m4s
を指定します。
自動作成された予約の自動削除オプションを無効にするには、
--auto-delete-auto-created-reservations
フラグを--no-auto-delete-auto-created-reservations
フラグに置き換えます。gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \ --no-auto-delete-auto-created-reservations \ --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \ --start-time=START_TIME \ --end-time=END_TIME \ --total-count=TOTAL_COUNT \ --zone=ZONE
自動作成予約の名前の接頭辞を指定するには、
--name-prefix
フラグを含めます。gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \ --auto-delete-auto-created-reservations \ --name-prefix=NAME_PREFIX \ --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \ --start-time=START_TIME \ --end-time=END_TIME \ --total-count=TOTAL_COUNT \ --zone=ZONE
NAME_PREFIX
は、自動作成される各予約の名前の接頭辞に置き換えます。この将来の予約リクエスト用に自動作成された予約を見つけやすくするため、 Trusted Cloud では一意の名前の接頭辞を指定することが推奨されます。PROJECT_ID
: リソースを予約するプロジェクトとインスタンス テンプレートが配置されているプロジェクトの ID。ZONE
: リソースを予約するゾーン。AUTO_DELETE_AUTO_CREATED_RESERVATIONS
: このフィールドをtrue
に設定すると、将来の予約用に自動作成された予約は、予約期間の終了時間から 2 時間以内に Compute Engine によって自動的に削除されます。自動作成された予約をコミットメントに関連付ける場合は、このフィールドをfalse
に設定します。LOCATION
: インスタンス テンプレートのロケーション。次のいずれかの値を指定します。リージョン インスタンス テンプレートの場合:
regions/REGION
REGION
は、インスタンス テンプレートが配置されているリージョンに置き換えます。リージョン インスタンス テンプレートを指定した場合、将来の予約リクエストはテンプレートのリージョンと同じリージョン内にのみ作成できます。グローバル インスタンス テンプレートの場合:
global
INSTANCE_TEMPLATE_NAME
: 既存のインスタンス テンプレートの名前。TOTAL_COUNT
: 予約する VM の合計数。START_TIME
: RFC 3339 タイムスタンプとしてフォーマットされた予約期間の開始時間。次の形式にする必要があります。YYYY-MM-DDTHH:MM:SSOFFSET
次のように置き換えます。
YYYY-MM-DD
: 4 桁の年、2 桁の月、その月の 2 桁の日をハイフン(-
)で区切った日付。HH:MM:SS
: 24 時間制の 2 桁の時間、2 桁の分、2 桁の秒をコロン(:
)で区切った時刻。OFFSET
: 協定世界時(UTC)のオフセット形式で示されるタイムゾーン。たとえば、太平洋標準時(PST)を使用する場合は-08:00
を指定します。オフセットを使用しない場合は、Z
を指定します。
開始時間は、審査を受けるために将来の予約リクエストを送信した日時から 1 年以内にしてください。将来の予約リクエストが承認された後またはロック時間になるまでに、キャンセル、削除、変更するために十分な時間を確保するには、開始時間の推奨値を指定してください。
END_TIME
: 予約期間の終了日時(RFC 3339 タイムスタンプの形式)。送信したリクエストがTrusted Cloud で承認される可能性を高めるには、最小予約期間を指定します。終了時間の代わりに期間を指定するには、endTime
フィールドをduration
フィールドに置き換えます。"duration": { "seconds": END_DURATION }
END_DURATION
は期間(秒単位)に置き換えます。たとえば、1,209,600 秒(14 日)の場合は1209600
を指定します。予約期間は 2024 年 11 月 10 日(UTC)の深夜 0 時から 2024 年 12 月 10 日(UTC)の深夜 0 時までです。
合計 80 台の VM。
- リージョン
us-central1
のリージョン インスタンス テンプレート。 - 自動削除オプションが有効。自動作成された予約は、予約期間の終了時に削除されます。
自動作成予約の名前の接頭辞を指定するには、
namePrefix
フィールドを含めます。POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations { "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS, "name": "FUTURE_RESERVATION_NAME", "namePrefix": "NAME_PREFIX", "specificSkuProperties": { "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME", "totalCount": TOTAL_COUNT }, "timeWindow": { "startTime": "START_TIME", "endTime": "END_TIME" } }
NAME_PREFIX
は、自動作成される各予約の名前の接頭辞に置き換えます。この将来の予約リクエスト用に自動作成された予約を見つけやすくするため、 Trusted Cloud では一意の名前の接頭辞を指定することが推奨されます。自動作成された予約を予約期間の終了時間後に削除するには、次のいずれかの方法を選択します。
自動作成された予約を予約期間の終了後の特定の時間に削除するには、
autoDeleteAutoCreatedReservations
をtrue
に設定し、autoCreatedReservationsDeleteTime
フィールドを含めます。POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations { "autoCreatedReservationsDeleteTime": "DELETE_TIME", "autoDeleteAutoCreatedReservations": true, "name": "FUTURE_RESERVATION_NAME", "specificSkuProperties": { "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME", "totalCount": TOTAL_COUNT }, "timeWindow": { "startTime": "START_TIME", "endTime": "END_TIME" } }
DELETE_TIME
を、自動作成された予約が Compute Engine によって削除される日時に置き換えます。日時は RFC 3339 タイムスタンプの形式で指定する必要があります。自動作成された予約を予約期間の開始時間から特定の時間が経過した後に削除するには、
autoDeleteAutoCreatedReservations
をtrue
に設定し、autoCreatedReservationsDuration
フィールドを含めます。POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations { "autoCreatedReservationsDuration": { "seconds": "DURATION_BEFORE_DELETE" }, "autoDeleteAutoCreatedReservations": true, "name": "FUTURE_RESERVATION_NAME", "specificSkuProperties": { "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME", "totalCount": TOTAL_COUNT }, "timeWindow": { "startTime": "START_TIME", "endTime": "END_TIME" } }
DURATION_BEFORE_DELETE
は期間(秒単位)に置き換えます。たとえば、604,800 秒(7 日)の場合は604800
を指定します。
次のようにインスタンス テンプレートを作成して使用します。
参照用 VM のプロパティをオーバーライドせずに、参照用 VM に基づいてインスタンス テンプレートを作成します。
次のいずれかまたは両方を行うと、新しく作成されたテンプレートを使用して VM を作成できます。
新しい VM と参照用 VM のプロパティが完全に一致するように、参照用 VM に基づいて VM を作成します。
Trusted Cloud コンソールで、[予約] ページに移動します。
[将来の予約] タブをクリックします。
[
将来の予約を作成] をクリックします。[将来の予約を作成] ページが開きます。
[名前] に、将来の予約リクエストの名前を入力します。
[接頭辞] に、名前の接頭辞を入力します。将来の予約リクエストから自動作成された各予約の名前は、この接頭辞で始まります。
[リージョン] と [ゾーン] で、リソースを予約するリージョンとゾーンを選択します。
[開始時刻] に、予約期間の開始時間を入力します。開始時間は、審査を受けるために将来の予約リクエストを送信した日時から 1 年以内にしてください。ロック時間になる前に、将来の予約を変更、キャンセル、削除するために十分な時間を確保するには、開始時間の推奨値を指定します。
[終了時刻] に、予約期間の終了時間を入力します。[期間の概要] セクションで、予約期間の長さを確認できます。審査を受けるために送信した将来の予約リクエストが Trusted Cloud で承認される可能性を高めるために、予約期間の推奨値を指定します。
[共有タイプ] セクションで、[ローカル] を選択します(まだ選択されていない場合)。
[必要な総容量] に、将来の予約リクエストで指定された期間、VM 構成、プロジェクトに予約する VM の合計数を入力します。
[マシンの構成] セクションで、次の操作を行います。
[既存の VM を使用] を選択します。
[既存の VM] で、予約の作成に使用するプロパティを持つ VM を選択します。
[自動生成された予約の自動削除] セクションで、次のいずれかを行います。
将来の予約リクエスト用に自動作成された予約を Compute Engine が自動的に削除できるようにするには、次の手順を実施します。
[自動削除を有効にする] がオンになっていない場合は、クリックしてオンにします。
省略可: [自動削除日時] に、自動作成された予約を削除する日時を入力します。日時は予約期間の終了日より後にする必要があります。このフィールドを空のままにすると、自動作成された予約は予約期間の終了時間から 2 時間以内に削除されます。
自動削除しない場合は、[自動削除を有効にする] をクリックしてオフにします。
将来の予約リクエストのドラフトの作成を完了するには、[ドラフトを保存] をクリックします。
Trusted Cloud コンソールで、[予約] ページに移動します。
[将来の予約] タブをクリックします。
[
将来の予約を作成] をクリックします。[将来の予約を作成] ページが開きます。
[名前] に、将来の予約リクエストの名前を入力します。
[接頭辞] に、名前の接頭辞を入力します。将来の予約リクエストから自動作成された各予約の名前は、この接頭辞で始まります。
[リージョン] と [ゾーン] で、リソースを予約するリージョンとゾーンを選択します。
[開始時刻] に、予約期間の開始時間を入力します。開始時間は、審査を受けるために将来の予約リクエストを送信した日時から 1 年以内にしてください。ロック時間になる前に、将来の予約を変更、キャンセル、削除するために十分な時間を確保するには、開始時間の推奨値を指定します。
[終了時刻] に、予約期間の終了時間を入力します。[期間の概要] セクションで、予約期間の長さを確認できます。審査を受けるために送信した将来の予約リクエストが Trusted Cloud で承認される可能性を高めるために、予約期間の推奨値を指定します。
[共有タイプ] セクションで、[ローカル] を選択します(まだ選択されていない場合)。
[必要な総容量] に、将来の予約リクエストで指定された期間、VM 構成、プロジェクトに予約する VM の合計数を入力します。
[マシンの構成] セクションで、次の操作を行います。
[マシンタイプを指定] を選択します(まだ選択されていない場合)。
予約済み VM に使用するマシンタイプを指定します。
[自動生成された予約の自動削除] セクションで、次のいずれかを行います。
将来の予約リクエスト用に自動作成された予約を Compute Engine が自動的に削除できるようにするには、次の手順を実施します。
[自動削除を有効にする] がオンになっていない場合は、クリックしてオンにします。
省略可: [自動削除日時] に、自動作成された予約を削除する日時を入力します。日時は予約期間の終了日より後にする必要があります。このフィールドを空のままにすると、自動作成された予約は予約期間の終了時間から 2 時間以内に削除されます。
自動削除しない場合は、[自動削除を有効にする] をクリックしてオフにします。
将来の予約リクエストのドラフトの作成を完了するには、[ドラフトを保存] をクリックします。
FUTURE_RESERVATION_NAME
: 将来の予約リクエストの名前。MACHINE_TYPE
: 各予約 VM に使用するマシンタイプ。START_TIME
: RFC 3339 タイムスタンプとしてフォーマットされた予約期間の開始時間。次の形式にする必要があります。YYYY-MM-DDTHH:MM:SSOFFSET
次のように置き換えます。
YYYY-MM-DD
: 4 桁の年、2 桁の月、その月の 2 桁の日をハイフン(-
)で区切った日付。HH:MM:SS
: 24 時間制の 2 桁の時間、2 桁の分、2 桁の秒をコロン(:
)で区切った時刻。OFFSET
: 協定世界時(UTC)のオフセット形式で示されるタイムゾーン。たとえば、太平洋標準時(PST)を使用する場合は-08:00
を指定します。オフセットを使用しない場合は、Z
を指定します。
開始時間は、審査を受けるために将来の予約リクエストを送信した日時から 1 年以内にしてください。将来の予約リクエストが承認された後またはロック時間になるまでに、キャンセル、削除、変更するために十分な時間を確保するには、開始時間の推奨値を指定してください。
END_TIME
: 予約期間の終了日時(RFC 3339 タイムスタンプの形式)。送信したリクエストがTrusted Cloud で承認される可能性を高めるには、最小予約期間を指定します。終了時間ではなく所要時間を指定するには、--end-time
フラグを--duration=END_DURATION
フラグに置き換えます。END_DURATION
は期間(秒単位)に置き換えます。たとえば、1,209,600 秒(14 日)の場合は1209600
を指定します。審査を受けるために送信した将来の予約リクエストが Trusted Cloud で承認される可能性を高めるため、推奨の最小期間を指定します。
TOTAL_COUNT
: 予約する VM の合計数。ZONE
: リソースを予約するゾーン。予約期間は 2024 年 11 月 10 日(UTC)の深夜 0 時から 2024 年 12 月 10 日(UTC)の深夜 0 時までです。
合計 80 台の VM。
- 4 個の vCPU を備えた事前定義の N2 マシンタイプ。
- 自動削除オプションが有効。自動作成された予約は、予約期間の終了時に削除されます。
予約済みの N1 VM に GPU を接続するには、
--accelerator
フラグを指定します。gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \ --accelerator=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \ --auto-delete-auto-created-reservations \ --machine-type=MACHINE_TYPE \ --start-time=START_TIME \ --end-time=END_TIME \ --total-count=TOTAL_COUNT \ --zone=ZONE
次のように置き換えます。
NUMBER_OF_ACCELERATORS
: 予約済みの VM 1 台あたりに追加する GPU の数。ACCELERATOR_TYPE
: N1 VM でサポートされている GPU モデル。エラーを回避するには、選択した GPU モデルが、将来の予約リクエストを作成するゾーンで使用できることを確認してください。
自動作成された予約を予約期間の終了時間後に削除するには、次のいずれかの方法を選択します。
自動作成された予約を予約期間の終了時間後の特定の日時に削除するには、
--auto-created-reservations-delete-time
フラグを指定します。gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \ --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \ --auto-delete-auto-created-reservations \ --machine-type=MACHINE_TYPE \ --start-time=START_TIME \ --end-time=END_TIME \ --total-count=TOTAL_COUNT \ --zone=ZONE
AUTO_CREATED_RESERVATIONS_DELETE_TIME は、RFC 3339 タイムスタンプ形式の日時に置き換えます。
自動作成された予約を予約期間の終了時間から特定の時間が経過した後に削除するには、
--auto-created-reservations-duration
フラグを指定します。gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \ --auto-created-reservations-duration=DURATION_BEFORE_DELETE \ --auto-delete-auto-created-reservations \ --machine-type=MACHINE_TYPE \ --start-time=START_TIME \ --end-time=END_TIME \ --total-count=TOTAL_COUNT \ --zone=ZONE
DURATION_BEFORE_DELETE は、期間(日、時、分、秒)に置き換えます。たとえば、30 分の場合は
30m
を指定し、1 日と 2 時間 3 分 4 秒の場合は1d2h3m4s
を指定します。
自動作成された予約の自動削除オプションを無効にするには、
--auto-delete-auto-created-reservations
フラグを--no-auto-delete-auto-created-reservations
フラグに置き換えます。gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \ --no-auto-delete-auto-created-reservations \ --machine-type=MACHINE_TYPE \ --start-time=START_TIME \ --end-time=END_TIME \ --total-count=TOTAL_COUNT \ --zone=ZONE
デフォルトでローカル SSD ディスクが含まれていないマシンタイプにローカル SSD ディスクをアタッチするには、
--local-ssd
フラグを追加します。アタッチできるのは 375 GB のローカル SSD ディスクのみです。gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \ --auto-delete-auto-created-reservations \ --local-ssd=count=NUMBER_OF_LOCAL_SSD_DISKS,size=375,interface=INTERFACE_TYPE \ --machine-type=MACHINE_TYPE \ --start-time=START_TIME \ --end-time=END_TIME \ --total-count=TOTAL_COUNT \ --zone=ZONE
次のように置き換えます。
NUMBER_OF_LOCAL_SSD_DISKS
: アタッチするローカル SSD ディスクの数。INTERFACE_TYPE
: ローカル SSD ディスクで使用し、指定したマシンタイプがサポートしているディスク インターフェースのタイプ。次のいずれかの値を指定します。NVME ディスク インターフェースの場合:
nvme
SCSI ディスク インターフェースの場合:
scsi
予約する VM でゾーンのデフォルトの CPU プラットフォームではなく、特定の最小 CPU プラットフォームを使用するには、
--min-cpu-platform
フラグを指定します。gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \ --auto-delete-auto-created-reservations \ --machine-type=MACHINE_TYPE \ --min-cpu-platform="MIN_CPU_PLATFORM" \ --start-time=START_TIME \ --end-time=END_TIME \ --total-count=TOTAL_COUNT \ --zone=ZONE
MIN_CPU_PLATFORM は、最小 CPU プラットフォームに置き換えます。リソースを予約するゾーンで CPU プラットフォームが使用可能であることを確認するには、ゾーンごとに使用可能な CPU プラットフォームを表示します。
自動作成予約の名前の接頭辞を指定するには、
--name-prefix
フラグを含めます。gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \ --auto-delete-auto-created-reservations \ --machine-type=MACHINE_TYPE \ --name-prefix=NAME_PREFIX \ --start-time=START_TIME \ --end-time=END_TIME \ --total-count=TOTAL_COUNT \ --zone=ZONE
NAME_PREFIX
は、自動作成される各予約の名前の接頭辞に置き換えます。この将来の予約リクエスト用に自動作成された予約を見つけやすくするため、 Trusted Cloud では一意の名前の接頭辞を指定することが推奨されます。PROJECT_ID
: リソースを予約するプロジェクトの ID。ZONE
: リソースを予約するゾーン。AUTO_DELETE_AUTO_CREATED_RESERVATIONS
: このフィールドをtrue
に設定すると、将来の予約用に自動作成された予約は、予約期間の終了時間から 2 時間以内に Compute Engine によって自動的に削除されます。自動作成された予約をコミットメントに関連付ける場合は、このフィールドをfalse
に設定します。TOTAL_COUNT
: 予約する VM の合計数。START_TIME
: RFC 3339 タイムスタンプとしてフォーマットされた予約期間の開始時間。次の形式にする必要があります。YYYY-MM-DDTHH:MM:SSOFFSET
次のように置き換えます。
YYYY-MM-DD
: 4 桁の年、2 桁の月、その月の 2 桁の日をハイフン(-
)で区切った日付。HH:MM:SS
: 24 時間制の 2 桁の時間、2 桁の分、2 桁の秒をコロン(:
)で区切った時刻。OFFSET
: 協定世界時(UTC)のオフセット形式で示されるタイムゾーン。たとえば、太平洋標準時(PST)を使用する場合は-08:00
を指定します。オフセットを使用しない場合は、Z
を指定します。
開始時間は、審査を受けるために将来の予約リクエストを送信した日時から 1 年以内にしてください。将来の予約リクエストが承認された後またはロック時間になるまでに、キャンセル、削除、変更するために十分な時間を確保するには、開始時間の推奨値を指定してください。
END_TIME
: 予約期間の終了日時(RFC 3339 タイムスタンプの形式)。送信したリクエストがTrusted Cloud で承認される可能性を高めるには、最小予約期間を指定します。終了時間の代わりに期間を指定するには、endTime
フィールドをduration
フィールドに置き換えます。"duration": { "seconds": END_DURATION }
END_DURATION
は期間(秒単位)に置き換えます。たとえば、1,209,600 秒(14 日)の場合は1209600
を指定します。予約期間は 2024 年 11 月 10 日(UTC)の深夜 0 時から 2024 年 12 月 10 日(UTC)の深夜 0 時までです。
合計 80 台の VM。
- 4 個の vCPU を備えた事前定義の N2 マシンタイプ。
- 自動削除オプションが有効。自動作成された予約は、予約期間の終了時に削除されます。
自動作成予約の名前の接頭辞を指定するには、
namePrefix
フィールドを含めます。POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations { "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS, "name": "FUTURE_RESERVATION_NAME", "namePrefix": "NAME_PREFIX", "specificSkuProperties": { "instanceProperties": { "machineType": "MACHINE_TYPE" }, "totalCount": TOTAL_COUNT }, "timeWindow": { "startTime": "START_TIME", "endTime": "END_TIME" } }
NAME_PREFIX
は、自動作成される各予約の名前の接頭辞に置き換えます。この将来の予約リクエスト用に自動作成された予約を見つけやすくするため、 Trusted Cloud では一意の名前の接頭辞を指定することが推奨されます。予約済みの N1 VM に GPU を接続するには、
guestAccelerators
フィールドを指定します。POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations { "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS, "name": "FUTURE_RESERVATION_NAME", "specificSkuProperties": { "instanceProperties": { "guestAccelerators": [ { "acceleratorCount": NUMBER_OF_ACCELERATORS, "acceleratorType": "ACCELERATOR_TYPE" } ], "machineType": "MACHINE_TYPE" }, "totalCount": TOTAL_COUNT }, "timeWindow": { "startTime": "START_TIME", "endTime": "END_TIME" } }
次のように置き換えます。
NUMBER_OF_ACCELERATORS
: 予約済みの VM 1 台あたりに追加する GPU の数。ACCELERATOR_TYPE
: N1 VM でサポートされている GPU モデル。エラーを回避するには、選択した GPU モデルが、将来の予約リクエストを作成するゾーンで使用できることを確認してください。
デフォルトでローカル SSD ディスクを含まないマシンタイプにローカル SSD ディスクをアタッチするには、リクエスト本文に
localSsds
フィールドを配置します。アタッチできるのは 375 GB のローカル SSD ディスクのみです。たとえば、将来の予約リクエストの下書きを作成するときに 2 つのローカル SSD ディスクを指定するには、次のように
POST
リクエストを作成します。POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations { "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS, "name": "FUTURE_RESERVATION_NAME", "specificSkuProperties": { "instanceProperties": { "localSsds": [ { "diskSizeGb": "375", "interface": "INTERFACE_TYPE" }, { "diskSizeGb": "375", "interface": "INTERFACE_TYPE" } ], "machineType": "MACHINE_TYPE" }, "totalCount": TOTAL_COUNT }, "timeWindow": { "startTime": "START_TIME", "endTime": "END_TIME" } }
INTERFACE_TYPE
は、ローカル SSD ディスクで使用し、指定したマシンタイプがサポートしているディスク インターフェースのタイプに置き換えます。次のいずれかの値を指定します。NVME ディスク インターフェースの場合:
NVME
SCSI ディスク インターフェースの場合:
SCSI
予約する VM でゾーンのデフォルトの CPU プラットフォームではなく、特定の最小 CPU プラットフォームを使用するには、
minCpuPlatform
を指定します。POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations { "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS, "name": "FUTURE_RESERVATION_NAME", "specificSkuProperties": { "instanceProperties": { "machineType": "MACHINE_TYPE", "minCpuPlatform": "MINIMUM_CPU_PLATFORM" }, "totalCount": TOTAL_COUNT }, "timeWindow": { "startTime": "START_TIME", "endTime": "END_TIME" } }
MIN_CPU_PLATFORM は、最小 CPU プラットフォームに置き換えます。リソースを予約するゾーンで CPU プラットフォームが使用可能であることを確認するには、ゾーンごとに使用可能な CPU プラットフォームを表示します。
自動作成された予約を予約期間の終了時間後に削除するには、次のいずれかの方法を選択します。
自動作成された予約を予約期間の終了後の特定の時間に削除するには、
autoDeleteAutoCreatedReservations
をtrue
に設定し、autoCreatedReservationsDeleteTime
フィールドを含めます。POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations { "autoCreatedReservationsDeleteTime": "DELETE_TIME", "autoDeleteAutoCreatedReservations": true, "name": "FUTURE_RESERVATION_NAME", "specificSkuProperties": { "instanceProperties": { "machineType": "MACHINE_TYPE" }, "totalCount": TOTAL_COUNT }, "timeWindow": { "startTime": "START_TIME", "endTime": "END_TIME" } }
DELETE_TIME
を、自動作成された予約が Compute Engine によって削除される日時に置き換えます。日時は RFC 3339 タイムスタンプの形式で指定する必要があります。自動作成された予約を予約期間の開始時間から特定の時間が経過した後に削除するには、
autoDeleteAutoCreatedReservations
をtrue
に設定し、autoCreatedReservationsDuration
フィールドを含めます。POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations { "autoCreatedReservationsDuration": { "seconds": "DURATION_BEFORE_DELETE" }, "autoDeleteAutoCreatedReservations": true, "name": "FUTURE_RESERVATION_NAME", "specificSkuProperties": { "instanceProperties": { "machineType": "MACHINE_TYPE" }, "totalCount": TOTAL_COUNT }, "timeWindow": { "startTime": "START_TIME", "endTime": "END_TIME" } }
DURATION_BEFORE_DELETE
は期間(秒単位)に置き換えます。たとえば、604,800 秒(7 日)の場合は604800
を指定します。
プロジェクトの既存の予約または将来の予約では、作成可能な将来の予約リクエストの共有設定が制限されます。将来の予約リクエストを正常に作成し、将来の予約リクエストまたは予約を共有する他のプロジェクトでリクエストによる問題が生じないようにするには、制限事項をご覧ください。
自動作成された予約が使用されたかどうかに関係なく、予約期間全体にわたって Compute Engine がプロビジョニングする予約済みリソースの支払いを確約する必要があります。詳しくは、お支払いをご覧ください。
Trusted Cloud コンソールで、[予約] ページに移動します。
[将来の予約] タブをクリックします。
[名前] 列で、調達ステータスが「ドラフト作成中」になっている将来の予約リクエストの名前をクリックします。
[将来の予約] ページが開き、将来の予約リクエストの詳細が表示されます。
[
下書きを編集] をクリックします。将来の予約リクエストの下書きを更新するページが開きます。
審査を受けるために将来の予約リクエストの下書きを送信するには、[送信] をクリックします。
FUTURE_RESERVATION_NAME
: 既存の将来の予約リクエストのドラフトの名前。ZONE
: 将来の予約リクエストが存在するゾーン。PROJECT_ID
: 将来の予約リクエストが存在するプロジェクトの ID。ZONE
: 将来の予約リクエストが存在するゾーン。FUTURE_RESERVATION_NAME
: 既存の将来の予約リクエストのドラフトの名前。リクエストの調達ステータスをモニタリングして、Trusted Cloud がリクエストを承認したか不承認としたかを確認するには、将来の予約リクエストの詳細を表示します。
Trusted Cloud によるリクエストの審査を停止し、Compute Engine がリクエストされた容量をプロビジョニングできないようにするには、将来の予約リクエストをキャンセルまたは削除します。
将来の予約リクエストを表示する方法を学習する。
将来の予約リクエストを変更する方法を学習する。
将来の予約リクエストをキャンセルまたは削除する方法を学習する。
予約期間の開始時間になったら、自動作成された予約を使用する方法を学習する。
REST
このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。
After installing the Google Cloud CLI, sign in to the gcloud CLI with your federated identity and then initialize it by running the following command:
gcloud init
詳細については、 Trusted Cloud 認証ドキュメントの REST を使用して認証するをご覧ください。
必要なロール
単一プロジェクトの将来の予約リクエストを作成するのに必要な権限を取得するには、プロジェクトに対する Compute の将来の予約ユーザー(
roles/compute.futureReservationUser
)IAM ロールを付与するよう管理者に依頼します。ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。この事前定義ロールには、単一プロジェクトの将来の予約リクエストを作成するのに必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。
必要な権限
単一プロジェクトの将来の予約リクエストを作成するには、次の権限が必要です。
カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。
ドラフト リクエストを作成する
将来の予約リクエストを作成するときに、リクエストをドラフトとして保存して後で Trusted Cloud に送信して審査を受けるか、リクエストを直接送信して審査を受けるかを選択できます。最初にドラフト リクエストを作成することをおすすめします。これにより、手動で推定するのではなく、Compute Engine がリクエストに対してプロビジョニングする VM の数を決定できます。必要であれば、審査のために送信する前に、リクエストで予約された VM の数を変更することもできます。
自動作成された予約を将来の予約に使用するには、VM と予約のプロパティが正確に一致している必要があります。将来の予約リクエストを作成して予約をリクエストする VM のプロパティを指定するには、次のいずれかの方法を使用します。
将来の予約用に自動作成された予約は、プロパティが一致する VM で自動的に使用されます。VM が自動作成された予約を使用しないようにするには、予約を使用せずに VM を作成する方法をご覧ください。
インスタンス テンプレートを指定する
インスタンス テンプレートを指定して将来の予約リクエストを作成する場合は、次の点に注意してください。
将来の予約リクエストを作成した後で、将来の予約リクエストを変更してテンプレートの VM プロパティをオーバーライドしたり、別のテンプレートを指定することはできません。その場合は、新しい将来の予約リクエストを作成する必要があります。
既存のインスタンス テンプレートを指定して単一プロジェクトの将来の予約を作成するには、次のいずれかのオプションを選択します。
コンソール
[予約] ページが開きます。将来の予約リクエストの作成が完了するまでに 1 分ほどかかることがあります。
gcloud
インスタンス テンプレートを指定して単一プロジェクトの将来の予約リクエストを作成するには、
gcloud beta compute future-reservations create
コマンドを使用します。オプションのフラグを使用せずにインスタンス テンプレートを指定して将来の予約リクエストの下書きを作成し、予約期間の終了時に自動作成された予約を自動的に削除するには、次のコマンドを実行します。
gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \ --auto-delete-auto-created-reservations \ --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \ --start-time=START_TIME \ --end-time=END_TIME \ --total-count=TOTAL_COUNT \ --zone=ZONE
次のように置き換えます。
たとえば、ゾーン
us-central1-a
で、次のプロパティを持つ将来の予約リクエストの下書きをfr-01
という名前で作成するとします。fr-01
を作成するには、次のコマンドを実行します。gcloud beta compute future-reservations create fr-01 \ --auto-delete-auto-created-reservations \ --source-instance-template=projects/example-project/regions/us-central1/instanceTemplates/example-template \ --start-time=2024-11-10T00:00:00Z \ --end-time=2024-12-10T00:00:00Z \ --total-count=80 \ --zone=us-central1-a
必要に応じて、以下の 1 つ以上の操作を行うことができます。
REST
インスタンス テンプレートを指定して単一プロジェクトの将来の予約リクエストを作成するには、
beta.futureReservations.insert
メソッドにPOST
リクエストを送信します。オプションのフィールドを含めずにインスタンス テンプレートを指定して、将来の予約リクエストの下書きを作成するには、次のように
POST
リクエストを送信します。POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations { "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS, "name": "FUTURE_RESERVATION_NAME", "specificSkuProperties": { "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME", "totalCount": TOTAL_COUNT }, "timeWindow": { "startTime": "START_TIME", "endTime": "END_TIME" } }
次のように置き換えます。
たとえば、ゾーン
us-central1-a
で、次のプロパティを持つ将来の予約リクエストの下書きをfr-01
という名前で作成するとします。fr-01
を作成するには、次のようにPOST
リクエストを送信します。POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations { "autoDeleteAutoCreatedReservations": true, "name": "fr-01", "specificSkuProperties": { "sourceInstanceTemplate": "projects/example-project/regions/us-central1/instanceTemplates/example-template", "totalCount": 80 }, "timeWindow": { "startTime": "2024-11-10T00:00:00Z", "endTime": "2024-12-10T00:00:00Z" } }
必要に応じて、以下の 1 つ以上の操作を行うことができます。
将来の予約リクエストの下書きを作成したら、Compute Engine がリクエスト用にプロビジョニングする VM の数を決定できます。
既存の VM を指定する
将来の予約リクエストのドラフトは、VM と同じゾーンにある既存の VM に基づいてのみ作成できます。
将来の予約リクエストが Trusted Cloud によって承認され、予約期間に入ったら、参照用 VM と一致するプロパティを持つ VM を作成し、自動作成された予約を使用できます。そのために、次のいずれかを行います。
既存の VM のプロパティを使用する単一プロジェクトの将来の予約リクエストを作成するには、次の操作を行います。
[予約] ページが開きます。将来の予約リクエストの作成が完了するまでに 1 分ほどかかることがあります。
将来の予約リクエストの下書きを作成したら、Compute Engine がリクエスト用にプロビジョニングする VM の数を決定できます。
プロパティを直接指定する
将来の予約用にプロビジョニングされ、自動的に作成された予約をコミットメントに関連付ける場合は、自動削除オプションを無効にする必要があります。詳細については、作成後の制限事項をご覧ください。
プロパティを直接指定して単一プロジェクトの将来の予約を作成するには、次のいずれかの方法を選択します。
コンソール
[予約] ページが開きます。将来の予約リクエストの作成が完了するまでに 1 分ほどかかることがあります。
gcloud
プロパティを直接指定して単一プロジェクトの将来の予約リクエストを作成するには、
gcloud beta compute future-reservations create
コマンドを使用します。オプションのフラグを使用せずにプロパティを直接指定して将来の予約リクエストの下書きを作成し、予約期間の終了時に自動作成された予約を自動的に削除するには、次のコマンドを実行します。
gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \ --auto-delete-auto-created-reservations \ --machine-type=MACHINE_TYPE \ --start-time=START_TIME \ --end-time=END_TIME \ --total-count=TOTAL_COUNT \ --zone=ZONE
次のように置き換えます。
たとえば、ゾーン
us-central1-a
で、次のプロパティを持つ将来の予約リクエストの下書きをfr-01
という名前で作成するとします。fr-01
を作成するには、次のコマンドを実行します。gcloud beta compute future-reservations create fr-01 \ --auto-delete-auto-created-reservations \ --machine-type=n2-standard-4 \ --start-time=2024-11-10T00:00:00Z \ --end-time=2024-12-10T00:00:00Z \ --total-count=80 \ --zone=us-central1-a
必要に応じて、以下の 1 つ以上の操作を行うことができます。
REST
プロパティを直接指定して単一プロジェクトの将来の予約リクエストを作成するには、
beta.futureReservations.insert
メソッドにPOST
リクエストを送信します。オプションのフィールドを使用せずにプロパティを直接指定し、将来の予約リクエストの下書きを作成するには、次のように
POST
リクエストを送信します。POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations { "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS, "name": "FUTURE_RESERVATION_NAME", "specificSkuProperties": { "instanceProperties": { "machineType": "MACHINE_TYPE" }, "totalCount": TOTAL_COUNT }, "timeWindow": { "startTime": "START_TIME", "endTime": "END_TIME" } }
次のように置き換えます。
たとえば、ゾーン
us-central1-a
で、次のプロパティを持つ将来の予約リクエストの下書きをfr-01
という名前で作成するとします。fr-01
を作成するには、次のようにPOST
リクエストを送信します。POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations { "autoDeleteAutoCreatedReservations": true, "name": "fr-01", "specificSkuProperties": { "instanceProperties": { "machineType": "n2-standard-4" }, "totalCount": 80 }, "timeWindow": { "startTime": "2024-11-10T00:00:00Z", "endTime": "2024-12-10T00:00:00Z" } }
必要に応じて、以下の 1 つ以上の操作を行うことができます。
将来の予約リクエストの下書きを作成したら、Compute Engine がリクエスト用にプロビジョニングする VM の数を決定できます。
ドラフト リクエストを送信する
将来の予約リクエストが送信され、 Trusted Cloudの承認を得て、ロック時刻を過ぎたら、将来の予約の予約期間が終了した後にのみ将来の予約と自動作成された予約を削除できます。既存の将来の予約の削除は、同じプロパティを持つ別の将来の予約を作成する必要がある場合に便利です。そのため、将来の予約リクエストを作成する前に次のことを確認してください。
審査を受けるために将来の予約リクエストのドラフトを送信するときに 1 つ以上のプロパティを変更する場合は、将来の予約リクエストを変更するをご覧ください。
審査のために将来の予約リクエストのドラフトを Trusted Cloud に送信するには、次のいずれかのオプションを選択します。
コンソール
[予約] ページが開きます。先ほど送信した将来の予約リクエストの [ステータス] 列で、調達ステータスが「承認待ち」に設定されます。
gcloud
審査を受けるために将来の予約リクエストの下書きを送信するには、
--planning-status
フラグをSUBMITTED
に設定してgcloud beta compute future-reservations update
コマンドを使用します。gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \ --planning-status=SUBMITTED \ --zone=ZONE
次のように置き換えます。
REST
審査を受けるために将来の予約リクエストの下書きを送信するには、
beta.futureReservations.update
メソッドにPATCH
リクエストを送信します。リクエストの本文にplanningStatus
フィールドを含め、SUBMITTED
に設定します。PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=planningStatus { "name": "FUTURE_RESERVATION_NAME", "planningStatus": "SUBMITTED" }
次のように置き換えます。
審査を受けるために将来の予約リクエストのドラフトを送信した後、次の操作を行うことができます。
トラブルシューティング
将来の予約リクエストの作成時にエラーが発生した場合は、将来の予約リクエストのトラブルシューティングをご覧ください。
トラブルシューティングを行っても問題が解決しない場合は、Google のアカウント担当者またはセールスチームにお問い合わせください。
次のステップ
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-21 UTC。
[[["わかりやすい","easyToUnderstand","thumb-up"],["問題の解決に役立った","solvedMyProblem","thumb-up"],["その他","otherUp","thumb-up"]],[["必要な情報がない","missingTheInformationINeed","thumb-down"],["複雑すぎる / 手順が多すぎる","tooComplicatedTooManySteps","thumb-down"],["最新ではない","outOfDate","thumb-down"],["翻訳に関する問題","translationIssue","thumb-down"],["サンプル / コードに問題がある","samplesCodeIssue","thumb-down"],["その他","otherDown","thumb-down"]],["最終更新日 2025-07-21 UTC。"],[[["This document guides you through creating single-project future reservation requests in Google Cloud, allowing you to reserve capacity for virtual machine (VM) instances to be automatically provisioned at a specified future date."],["To initiate a future reservation request, you must have the `roles/compute.futureReservationUser` IAM role and ensure adequate resource quota, and there are three methods to configure the properties of your reservation: by using an instance template, by specifying an existing VM, or by directly defining the VM properties."],["You can save a future reservation request as a draft to review the number of VMs Compute Engine will provision and then modify it if needed, prior to submitting it to Google Cloud for approval, and you must select the start and end time of the reservation period, with a minimum duration of 24 hours, and a start time no later than one year in the future."],["The auto-delete feature can be enabled to automatically delete auto-created reservations after the reservation period ends, or disabled if you want to attach these reservations to a commitment, and after creation, the reservation requests can't have their template or VM properties changed, you must create a new request instead."],["Once submitted, Google Cloud reviews the request, and if approved, Compute Engine will automatically create reservations at the specified start time, which are consumable by VMs created in the same project with exactly matching properties."]]],[]] -