将来の予約リクエストをキャンセルまたは削除する

このドキュメントでは、将来の予約リクエストをキャンセルまたは削除する方法について説明します。

将来の予約リクエストがロック時間に達する前に、次のいずれかを行うと、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

  1. Install the Google Cloud CLI, then initialize it by running the following command:

     gcloud init

  2. Set a default region and zone.

  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 beta compute future-reservations cancel FUTURE_RESERVATION_NAME \
    --zone=ZONE

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME/cancel

将来の予約リクエストを削除する

将来の予約リクエストを削除できるのは、次のいずれかの場合のみです。

• リクエストのロック時間がまだ到来しておらず、承認待ちではありません。

• リクエストが処理され、予約期間が終了しました。

承認待ちの将来の予約リクエストを削除するには、削除する前にリクエストをキャンセルする必要があります。

満了した将来の予約を削除しても、自動作成された予約は削除されません。予約期間の終了後に自動作成された予約を削除するには、予約を削除するをご覧ください。

複数の将来の予約リクエストを同時に削除するには、Google Cloud コンソールを使用します。それ以外の場合は、1 件の将来の予約リクエストを削除するには、次のいずれかのオプションを選択します。

gcloud beta compute future-reservations delete FUTURE_RESERVATION_NAME \
    --zone=ZONE

DELETE https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME

次のステップ

• 将来の予約リクエストを表示する方法を学習する。