このドキュメントでは、カレンダー モードで将来の予約リクエストをキャンセルまたは完全に削除する方法について説明します。
カレンダー モードで将来の予約リクエストが不要になった場合は、次のいずれかまたは両方を行うことができます。
予約リクエストをキャンセルする: リクエストをキャンセルすると、Compute Engine がリクエストされたリソースをプロビジョニングして料金が発生することを防ぐことができます。リクエストをキャンセルした後、リクエストを後で参照できるように保持するか、削除できます。
予約リクエストを削除する: リクエストをキャンセルした後、またはリクエストが終了時間に達した後、リクエストを完全に削除して、プロジェクトからレコードを削除できます。
共有リクエストをキャンセルまたは削除できるのは、オーナー プロジェクト(リクエストが存在するプロジェクト)のみです。カレンダー モードでリクエストをキャンセルまたは削除するときに適用する要件と制限事項の詳細については、カレンダー モードでの将来の予約リクエストについてをご覧ください。
始める前に
-
まだ設定していない場合は、認証を設定します。認証では、 Cloud de Confiance by S3NS サービスと API にアクセスするための ID が確認されます。ローカル開発環境からコードまたはサンプルを実行するには、次のいずれかのオプションを選択して Compute Engine に対する認証を行います。
このページのサンプルをどのように使うかに応じて、タブを選択してください。
コンソール
Cloud de Confiance コンソールを使用して Cloud de Confiance by S3NS サービスと API にアクセスする場合、認証を設定する必要はありません。
gcloud
-
Google Cloud CLI をインストールし、 フェデレーション ID を使用して gcloud CLI にログインします。ログイン後、次のコマンドを実行して Google Cloud CLI を初期化します。
gcloud init
-
- デフォルトのリージョンとゾーンを設定します。
REST
このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。
Google Cloud CLI をインストールし、 フェデレーション ID を使用して gcloud CLI にログインします。
詳細については、 Cloud de Confiance 認証ドキュメントの REST を使用して認証するをご覧ください。
必要なロール
カレンダー モードで将来の予約リクエストをキャンセルまたは削除するために必要な権限を取得するには、プロジェクトに対する Compute 将来の予約管理者 (roles/compute.futureReservationAdmin)IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。
この事前定義ロールには、カレンダー モードで将来の予約リクエストをキャンセルまたは削除するために必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。
必要な権限
カレンダー モードで将来の予約リクエストをキャンセルまたは削除するには、次の権限が必要です。
-
将来の予約リクエストをキャンセルする: プロジェクトに対する
compute.futureReservations.cancel -
将来の予約リクエストを削除する: プロジェクトに対する
compute.futureReservations.delete
カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。
カレンダー モードで将来の予約リクエストをキャンセルする
カレンダー モードで将来の予約リクエストをキャンセルできるのは、次のいずれかの条件を満たしている場合です。
開始時間が 30 日以上先である。
承認後 24 時間以内にリクエストをキャンセルし、開始時刻が 4 日以上先である。
リクエストをキャンセルすると、Compute Engine はリクエスト用に作成された空の予約を削除します。リクエストの詳細を表示したり、リクエストを削除したりできます。
カレンダー モードで複数の将来の予約リクエストをキャンセルするには、Cloud de Confiance コンソールを使用します。1 件のリクエストをキャンセルするには、次のいずれかのオプションを選択します。
コンソール
Cloud de Confiance コンソールで、[予約] ページに移動します。
[将来の予約] タブをクリックします。
カレンダー モードで、キャンセルする将来の予約リクエストを選択します。
[キャンセル] をクリックします。
[キャンセル] をクリックして確定します。予約リクエストのキャンセルが完了するまでに数分かかることがあります。
gcloud
カレンダー モードで将来の予約リクエストをキャンセルするには、gcloud compute future-reservations cancel コマンドを使用します。
gcloud compute future-reservations cancel FUTURE_RESERVATION_NAME \
--zone=ZONE
次のように置き換えます。
FUTURE_RESERVATION_NAME: カレンダー モードの将来の予約リクエストの名前。ZONE: リクエストが存在するゾーン。
REST
カレンダー モードで将来の予約リクエストをキャンセルするには、futureReservations.cancel メソッドに POST リクエストを送信します。
POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME/cancel
次のように置き換えます。
PROJECT_ID: カレンダー モードの将来の予約リクエストが存在するプロジェクトの ID。ZONE: リクエストが存在するゾーン。FUTURE_RESERVATION_NAME: リクエストの名前。
カレンダー モードで将来の予約リクエストを削除する
カレンダー モードで将来の予約リクエストを削除できるのは、次のいずれかが発生した後のみです。
リクエストは
CANCELLED状態です。リクエストが終了時間に達しました。
カレンダー モードで複数の将来の予約リクエストを同時に削除するには、 Cloud de Confiance コンソールを使用します。1 件のリクエストを削除するには、次のいずれかのオプションを選択します。
コンソール
Cloud de Confiance コンソールで、[予約] ページに移動します。
[将来の予約] タブをクリックします。
削除するカレンダー モードでの将来の予約リクエストを選択します。
[削除] をクリックします。
[削除] をクリックして確定します。リクエストの削除が完了するまでに 1 分ほどかかることがあります。
gcloud
カレンダー モードで将来の予約リクエストを削除するには、gcloud compute future-reservations delete コマンドを使用します。
gcloud compute future-reservations delete FUTURE_RESERVATION_NAME \
--zone=ZONE
次のように置き換えます。
FUTURE_RESERVATION_NAME: カレンダー モードの将来の予約リクエストの名前。ZONE: リクエストが存在するゾーン。
REST
カレンダー モードで将来の予約リクエストを削除するには、futureReservations.delete メソッドに DELETE リクエストを送信します。
DELETE https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME
次のように置き換えます。
PROJECT_ID: カレンダー モードの将来の予約リクエストが存在するプロジェクトの ID。ZONE: リクエストが存在するゾーン。FUTURE_RESERVATION_NAME: リクエストの名前。