このドキュメントでは、将来の予約リクエストをキャンセルまたは削除する方法について説明します。
将来の予約リクエストがロック時間に達する前に次のいずれかを行うと、Compute Engine がリクエストされたリソースをプロビジョニングしないようにできます。
将来の予約リクエストをキャンセルする。これは、新しいリクエストを作成するときに、キャンセルされたリクエストを参照用として維持する場合に役立ちます。ただし、キャンセルされた将来の予約リクエストを削除するまでは、プロジェクト内またはリクエストが共有されているプロジェクト内で、キャンセルされたリクエストと一致するプロパティを持つ新しいリクエストを作成できなくなります。詳細については、作成の制限をご覧ください。
将来の予約リクエストを削除する。これは、リクエストが不要になった場合に便利です。将来の予約リクエストを削除すると、リクエストは完全に削除され、新しいリクエストの作成に関する制限がなくなります。
完了した将来の予約の予約期間が終了した後、その予約を削除すると、新しいリクエストの作成に関する制限を解除できます。ただし、完了した将来の予約を削除しても、自動作成された予約は削除されません。予約期間の終了後に自動作成された予約を削除するには、予約を削除するをご覧ください。
始める前に
-
まだ設定していない場合は、認証を設定します。認証とは、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
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
-
将来の予約をキャンセルする場合: プロジェクトに対する
compute.futureReservations.cancel
-
将来の予約を削除する場合: プロジェクトに対する
compute.futureReservations.delete
リクエストが承認保留中、または不承認。
リクエストは承認済みだが、まだロック時間に到達していない。
FUTURE_RESERVATION_NAME
: 既存の将来の予約リクエストの名前。ZONE
: 将来の予約リクエストが存在するゾーン。PROJECT_ID
: 将来の予約リクエストが存在するプロジェクトの ID。ZONE
: 将来の予約リクエストが存在するゾーン。FUTURE_RESERVATION_NAME
: 将来の予約リクエストの名前。まだリクエストのロック時間に到達しておらず、承認保留中でない。
リクエストが完了し、予約期間が終了した。
Google Cloud コンソールの [予約] ページに移動します。
[将来の予約] タブをクリックします。
削除する将来の予約リクエストを選択します。
[
予約を削除] をクリックします。[削除] をクリックして確定します。
将来の予約リクエストが削除されるまでに 1 分ほどかかることがあります。
FUTURE_RESERVATION_NAME
: 既存の将来の予約リクエストの名前。ZONE
: 将来の予約リクエストが存在するゾーン。PROJECT_ID
: 将来の予約リクエストが存在するプロジェクトの ID。ZONE
: 将来の予約リクエストが存在するゾーン。FUTURE_RESERVATION_NAME
: 既存の将来の予約リクエストの名前。- 将来の予約リクエストを表示する方法を学習する。
REST
このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
詳細については、Google Cloud 認証ドキュメントの REST を使用して認証するをご覧ください。
必要なロール
将来の予約リクエストのキャンセルまたは削除に必要な権限を取得するには、プロジェクトに対する Compute 将来の予約管理者(
roles/compute.futureReservationAdmin
)IAM ロールを付与するよう管理者に依頼してください。 ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。この事前定義ロールには、将来の予約リクエストのキャンセルまたは削除に必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。
必要な権限
将来の予約リクエストのキャンセルまたは削除には、次の権限が必要です。
カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。
将来の予約リクエストをキャンセルする
将来の予約をキャンセルできるのは、次のいずれかの場合のみです。
将来の予約リクエストをキャンセルした後に可能な操作は、そのリクエストの詳細の表示と削除だけです。
将来の予約リクエストをキャンセルするには、次のいずれかのオプションを選択します。
gcloud
将来の予約リクエストをキャンセルするには、
gcloud beta compute future-reservations cancel
コマンドを使用します。gcloud beta compute future-reservations cancel FUTURE_RESERVATION_NAME \ --zone=ZONE
次のように置き換えます。
REST
将来の予約リクエストをキャンセルするには、
beta.futureReservations.cancel
メソッドにPOST
リクエストを送信します。POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME/cancel
次のように置き換えます。
将来の予約リクエストを削除する
将来の予約リクエストを削除できるのは、次のいずれかの場合のみです。
承認保留中の将来の予約リクエストを削除するには、削除する前にリクエストをキャンセルする必要があります。
完了した将来の予約を削除しても、自動作成された予約は削除されません。予約期間の終了後に自動作成された予約を削除するには、予約を削除するをご覧ください。
複数の将来の予約リクエストを同時に削除するには、Google Cloud コンソールを使用します。1 件の将来の予約リクエストを削除するには、次のいずれかのオプションを選択します。
コンソール
gcloud
将来の予約リクエストを削除するには、
gcloud beta compute future-reservations delete
コマンドを使用します。gcloud beta compute future-reservations delete FUTURE_RESERVATION_NAME \ --zone=ZONE
次のように置き換えます。
REST
将来の予約リクエストを削除するには、
beta.futureReservations.delete
メソッドにDELETE
リクエストを送信します。DELETE https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME
次のように置き換えます。
次のステップ
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2024-12-23 UTC。
-