将来の予約リクエストを変更する


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

将来の予約リクエストは、キャンセルされていないか、承認待ちでない場合、開始時間より前であればいつでも変更できます。将来の予約リクエストの変更は、容量のニーズが変化した場合に役立ちます。たとえば、予約済みの仮想マシン(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
    2. Set a default region and zone.
    3. 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 ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

この事前定義ロールには、将来の予約リクエストの変更に必要な compute.futureReservations.update 権限が含まれています。

カスタムロールや他の事前定義ロールを使用して、この権限を取得することもできます。

変更可能なプロパティ

将来の予約リクエストには、予約を定義して、その動作を決定し、予約するリソースを指定するプロパティがいくつかあります。これらのプロパティは、次のセクションで説明するように変更できます。

作成後

将来の予約リクエストを作成した後で、次のプロパティを変更することはできません。

  • 将来の予約リクエストの名前。

  • 将来の予約リクエストが作成されたプロジェクト。

  • 将来の予約リクエストが存在するゾーン。

  • 使用するインスタンス テンプレートと、インスタンス テンプレートで指定された VM プロパティ。

将来の予約リクエストがロック時間に入る前にこれらのプロパティを変更するには、新しいリクエストを作成します。

送信前

将来の予約リクエストを Google Cloud に送信して審査を受ける前、または将来の予約リクエストを送信して審査を受けた後でリクエストが拒否された場合は、次のプロパティを変更できます。

  • 自動削除オプション

  • 説明

  • GPU と GPU のタイプ

  • ローカル SSD ディスクとディスク インターフェースのタイプ

  • マシンシリーズとマシンタイプ

  • 最小 CPU プラットフォーム

  • 名前の接頭辞

  • 共有設定

  • 予約期間の開始時刻と終了時刻

  • 合計数(VM の数)

将来の予約リクエストの下書きのステータスの変更はすぐに行われます。変更可能な回数に制限はありません。不承認(DECLINED)の将来の予約リクエストを変更する場合は、審査のためにリクエストを再度送信した場合にのみ、リクエストを変更できます。

承認後

Google Cloud が将来の予約を承認した後、将来の予約が調達ステータスのプロビジョニング中(PROVISIONING)になる前に変更できます。具体的には、次のプロパティを変更できます。

  • 任意の時点で将来の予約を変更する:

    • 自動削除オプション

    • 説明

    • 名前の接頭辞

  • 開始時間の 72 時間前までに変更リクエストを送信する:

    • GPU と GPU タイプ*

    • ローカル SSD ディスクとディスク インターフェースのタイプ*

    • マシンシリーズとマシンタイプ*

    • 最小 CPU プラットフォーム*

    • 共有設定

    • 予約期間の開始時間と終了時間

    • 合計数(VM の数)*

* 将来の予約の開始時間から 14 日以内に、VM プロパティの変更、または合計数の大幅な増減をリクエストした場合、Google Cloud は変更リクエストを不承認とする可能性があります。

将来の予約リクエストを変更する

将来の予約リクエストを変更する前に、変更可能なプロパティを確認します(まだ確認していない場合)。

インスタンス テンプレートを使用して作成された単一プロジェクトの将来の予約リクエストを共有の将来の予約リクエストに変更する場合、同じテンプレートを使用して、共有の将来の予約リクエストを作成したプロジェクトの外部で自動作成された予約を使用する VM を作成することはできません。将来の予約が共有されているプロジェクトでは、それらのプロジェクトに同じインスタンス テンプレートを作成するか、プロパティを直接指定して VM を作成する必要があります。

将来の予約リクエストを変更するには、次のいずれかのオプションを選択します。

コンソール

  1. Google Cloud コンソールの [予約] ページに移動します。

    [予約] に移動

  2. [将来の予約] タブをクリックします。

  3. [名前] 列で、変更する将来の予約リクエストの名前をクリックします。

    選択した将来の予約リクエストの詳細ページが開きます。

  4. 承認済みの将来の予約の自動削除オプション、説明、名前の接頭辞を変更する場合は、次のいずれかを行います。

    • 自動削除オプションを変更するには、[自動作成された予約の自動削除日時] 行で、[ 編集] をクリックし、次の操作を行います。

      1. 自動削除オプションの有効化、無効化、変更を行うかどうかを指定するには、次のいずれかを行います。

        • 自動削除オプションを有効にするか、Compute Engine が自動作成された予約を自動的に削除する時間を変更するには、次の操作を行います。

          1. [自動削除を有効にする] をクリックしてオンにします。

          2. 省略可: [自動削除日時] に、自動作成された予約を削除する新しい日時を入力します。日時は予約期間の終了日より後にする必要があります。このフィールドを空のままにすると、自動作成された予約は予約期間の終了時間から 2 時間以内に削除されます。

        • 自動削除しない場合は、[自動削除を有効にする] をクリックしてオフにします。

      2. [送信] をクリックします。

    • 名前の接頭辞を変更するには、[接頭辞] 行で [ 編集] をクリックし、次の操作を行います。

      1. [接頭辞] に、新しい接頭辞を入力します。

      2. [送信] をクリックします。

    • 説明を変更するには、[説明] 行で [ 編集] をクリックし、次の操作を行います。

      1. [説明] に新しい説明を入力します。

      2. [送信] をクリックします。

  5. [ 編集] または [ 下書きを編集] をクリックします。

    選択した将来の予約リクエストを編集するページが開きます。

  6. 将来の予約リクエストを変更して Google Cloud に送信して審査を受けるか、下書きリクエストを保存するには、次のいずれかを行います。

    • [接頭辞] に、この将来の予約リクエスト用にプロビジョニングされる自動作成予約の新しい名前の接頭辞を入力します。

    • [説明] に新しい説明を入力します。

    • 将来の予約リクエストの開始時間または終了時間を変更します。以下のことを確認してください。

      • 開始時間は、審査を受けるために将来の予約リクエストを送信した日時から 1 年以内にしてください。

      • 将来の予約がロック時間に入る前に十分な時間を確保できるように、開始時間の推奨値を指定します。

      • 審査を受けるために送信したリクエストが Google Cloud で承認される可能性を高めるために、推奨の最小予約期間を指定します。

    • [共有タイプ] セクションで、[ローカル] または [共有] を選択できます。[共有] を選択すると、将来の予約のリクエストを共有するプロジェクトを追加または削除できます。最大 100 個のプロジェクトを指定できます。

    • [VM インスタンスの数] に、予約する VM の合計数を入力します。

    • インスタンス テンプレートを使用して作成されていない将来の予約を変更する場合は、[マシンの構成] セクションで次の設定を変更できます。

      • 予約済み VM で使用されるマシンシリーズとマシンタイプ。

      • 予約済み VM に接続する GPU。

      • 予約済み VM のローカル SSD ディスクとディスク インターフェースのタイプ。

    • [自動生成された予約の自動削除] セクションで、将来の予約のリクエストに対して自動作成された予約の自動削除を有効または無効にできます。

  7. 変更する将来の予約リクエストの調達ステータスに応じて、次のいずれかを行います。

    • 将来の予約リクエストの下書きを変更する場合は、次のいずれかを行います。

      • 変更を保存するには、[下書きを保存] をクリックします。

      • 将来の予約リクエストの下書きを Google Cloud に送信して審査を受けるには、[送信] をクリックします。

    • それ以外の場合は、[送信] をクリックします。

変更リクエストを送信すると、[予約] ページが開きます。それ以外の場合は、将来の予約の詳細ページが開きます。

gcloud

将来の予約リクエストを変更するには、gcloud beta compute future-reservations update コマンドを使用します。

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --accelerator=count=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \
    --description="DESCRIPTION" \
    --local-ssd=size=375,interface=INTERFACE \
    --machine-type=MACHINE_TYPE \
    --min-cpu-platform=MIN_CPU_PLATFORM \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --share-setting=SHARE_SETTING \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

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

  • FUTURE_RESERVATION_NAME: 将来の予約リクエストの名前。

  • PLANNING_STATUS: 将来の予約リクエストの計画ステータス。次のいずれかの値を指定します。

    • 審査のために送信せずに将来の予約リクエストの下書きを変更する場合: DRAFT

    • 将来の予約リクエストを審査のために送信する場合: SUBMITTED

  • ZONE: 将来の予約リクエストが存在するゾーン。

次のプレースホルダを 1 つ以上置き換えるか、対応するフラグとともに削除します。

  • 予約期間の終了時間の後に Compute Engine が自動作成された予約を自動的に削除するには、次のいずれかを行います。

    • デフォルトの設定どおり、終了時間から 2 時間以内に予約を削除するには、--auto-delete-auto-created-reservations フラグを指定します。

      gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
          --auto-delete-auto-created-reservations \
          --planning-status=PLANNING_STATUS \
          --zone=ZONE
      
    • 自動作成された予約を予約期間の終了時間後の特定の時間に削除するには、--auto-delete-auto-created-reservations フラグと --auto-created-reservations-delete-time フラグを指定します。

      gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
          --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \
          --auto-delete-auto-created-reservations \
          --planning-status=PLANNING_STATUS \
          --zone=ZONE
      

      AUTO_CREATED_RESERVATIONS_DELETE_TIME は、RFC 3339 タイムスタンプ形式の日時に置き換えます。

    • 自動作成された予約を予約期間の終了時間から特定の時間が経過した後に削除するには、--auto-delete-auto-created-reservations フラグと --auto-created-reservations-duration フラグを指定します。

      gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
          --auto-created-reservations-duration=DURATION_BEFORE_DELETE \
          --auto-delete-auto-created-reservations \
          --planning-status=PLANNING_STATUS \
          --zone=ZONE
      

      DURATION_BEFORE_DELETE は、期間(日、時間、分、秒)に置き換えます。たとえば、30 分の場合は 30m を指定し、1 日、2 時間、3 分、4 秒の場合は 1d2h3m4s を指定します。

  • この将来の予約リクエスト用にプロビジョニングされた自動作成予約を Compute Engine が自動的に削除しないようにするには、--no-auto-delete-auto-created-reservations フラグを指定します。

    gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
        --no-auto-delete-auto-created-reservations \
        --planning-status=PLANNING_STATUS \
        --zone=ZONE
    
  • 予約済みの N1 VM に接続されている GPU を追加または削除するか、GPU タイプを更新するには、次のいずれかを行います。

    • GPU の数とタイプを変更するには、次のように置き換えます。

      • NUMBER_OF_ACCELERATORS: 予約済みの VM 1 台あたりに追加する GPU の数。

      • ACCELERATOR_TYPE: 予約済みの VM に追加する GPU のタイプ。将来の予約リクエストが存在するゾーンで GPU を使用できることを確認します。一致していない場合、リクエストの変更は失敗します。

    • 予約済みの N1 VM に接続されているすべての GPU を削除するには、--accelerator フラグを --clear-accelerator フラグに置き換えます。

  • DESCRIPTION: 将来の予約リクエストの新しい説明。

  • 予約済み VM にローカル SSD ディスクを追加または削除するか、ローカル SSD ディスクのインターフェース タイプを編集するには、次のいずれかを行います。

    • ローカル SSD ディスクを追加するか、ディスク インターフェース タイプを編集するには、INTERFACE を次のいずれかの値に置き換えます。

      追加するローカル SSD ディスクごとに --local-ssd フラグを指定します。ローカル SSD ディスクは最大 24 個まで指定できます。

    • 予約済み VM にアタッチされているすべてのローカル SSD ディスクを削除するには、すべての --local-ssd フラグを削除し、--clear-local-ssd フラグを指定します。

  • MACHINE_TYPE: 予約済みの各 VM に使用する新しいマシンタイプ。マシンタイプを変更する場合は、新しいマシンシリーズの推奨の最小予約期間も指定してください。そうしないと、Google Cloud で変更リクエストが承認されない可能性があります。

  • MINIMUM_CPU_PLATFORM: 予約済み VM ごとに使用する新しい最小 CPU プラットフォーム。

  • NAME_PREFIX: 将来の予約リクエスト用にプロビジョニングされる自動作成予約の新しい名前の接頭辞。

  • SHARE_SETTING: 将来の予約リクエストの新しい共有タイプ。次のいずれかの値を指定します。

    • 単一プロジェクトの将来の予約リクエストを作成する場合: localエラーを回避するには、--share-with フラグを --clear-share-settings フラグに置き換える必要があります。

    • 共有の将来の予約リクエストの場合: projects。エラーを回避するには、--share-with フラグにユーザー プロジェクトを少なくとも 1 つ指定する必要があります。

  • CONSUMER_PROJECT_IDS: 将来の予約リクエストを共有するプロジェクトの ID のカンマ区切りリスト(例: project-1,project-2)。最大 100 個のユーザー プロジェクトを指定できます。

  • START_TIME: 予約期間の新しい開始時間(RFC 3339 タイムスタンプの形式)。開始時間は、審査を受けるために変更リクエストを送信した日時から 1 年以内にしてください。将来の予約が承認された後またはロック時間になるまでに、キャンセル、削除、変更するために十分な時間を確保するには、推奨の開始時間を指定してください。

  • END_TIME: 予約期間の終了日時(RFC 3339 タイムスタンプの形式)。予約期間は 24 時間以上にする必要があります。また、--end-time フラグを --duration=END_DURATION フラグに置き換えることもできます。END_DURATION は、予約期間の長さ(秒単位)に置き換えます。審査を受けるために送信した将来の予約リクエストが Google Cloud で承認される可能性を高めるために、推奨の予約期間を指定します。

  • TOTAL_COUNT: この将来の予約リクエストで指定された期間、VM 構成、プロジェクトに対して予約する VM の合計数。合計数を増やす場合は、予約するリソースに十分な割り当てがあることを確認してください。十分な割り当てがないと、Google Cloud で変更リクエストが承認されません。

たとえば、ゾーン us-central1-a に、fr-03 という共有の将来の予約リクエストの下書きがあるとします。この共有の将来の予約リクエストを次のように変更するとします。

  • リクエストを単一プロジェクトの将来の予約リクエストに変換します。

  • 自動削除オプションを無効にします。

  • 100 個の VM を予約します。

  • 審査を受けるため、将来の予約リクエストを Google Cloud に送信します。

fr-03 を変更するには、次のコマンドを実行します。

gcloud beta compute future-reservations update fr-03 \
    --clear-share-settings \
    --no-auto-delete-auto-created-reservations \
    --planning-status=SUBMITTED \
    --share-setting=local \
    --total-count=100 \
    --zone=us-central1-a

REST

将来の予約リクエストを変更するには、beta.futureReservations.update メソッドPATCH リクエストを送信します。

PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=UPDATE_FIELDS

{
  "autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS",
  "description": "DESCRIPTION",
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "planningStatus": "PLANNING_STATUS",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SHARE_TYPE"
  },
  "specificSkuProperties": {
    "instanceProperties": {
      "guestAccelerators": [
        {
          "acceleratorCount": NUMBER_OF_ACCELERATORS,
          "acceleratorType": "ACCELERATOR_TYPE"
        }
      ],
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_1"
        },
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_2"
        }
      ],
      "machineType": "MACHINE_TYPE",
      "minCpuPlatform": "MINIMUM_CPU_PLATFORM"
    },
    "totalCount": "TOTAL_COUNT"
  },
  "timeWindow": {
    "endTime": "END_TIME",
    "startTime": "START_TIME"
  }
}

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

  • PROJECT_ID: 将来の予約リクエストが存在するプロジェクトの ID。

  • ZONE: 将来の予約リクエストが存在するゾーン。

  • FUTURE_RESERVATION_NAME: 将来の予約リクエストの名前。

  • UPDATE_FIELDS: リクエスト本文で更新するフィールドのカンマ区切りリスト。カンマは %2C としてエンコードする必要があります。updateMask クエリ パラメータとリクエスト本文でフィールドを指定すると、フィールドの値が更新されます。それ以外の場合、updateMask クエリ パラメータでのみフィールドを指定すると、フィールドが削除されます。

    たとえば、将来の予約リクエストで autoDeleteAutoCreatedReservationstotalCountendTime フィールドを更新するには、次のように指定します。

    autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
    
  • PLANNING_STATUS: 将来の予約リクエストの計画ステータス。次のいずれかの値を指定します。

    • 審査のために送信せずに将来の予約リクエストの下書きを変更する場合: DRAFT

    • 審査のために変更リクエストを送信する場合: SUBMITTED

次のプレースホルダを 1 つ以上置き換えるか、対応するフィールドとともに削除します。

  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS: このフィールドを true に設定すると、将来の予約リクエスト用にプロビジョニングされた自動作成予約は、Compute Engine によって自動的に削除されます。デフォルトでは、削除は予約期間の終了時間から 2 時間以内に行われます。これを変更するには、次のいずれかの操作を行います。

    • 自動作成された予約を予約期間の終了後の特定の時間に削除するには、autoDeleteAutoCreatedReservationstrue に設定し、autoCreatedReservationsDeleteTime フィールドを指定します。

      PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime%2CplanningStatus
      
      {
        "autoDeleteAutoCreatedReservations": "true",
        "autoCreatedReservationsDeleteTime": "DELETE_TIME",
        "name": "FUTURE_RESERVATION_NAME",
        "planningStatus": "PLANNING_STATUS"
      }
      

      DELETE_TIME は、Compute Engine が予約を削除する日時に置き換えます。日時は RFC 3339 タイムスタンプの形式で指定する必要があります。

    • 自動作成された予約を予約期間の開始時間から特定の時間が経過した後に削除するには、autoDeleteAutoCreatedReservationstrue に設定し、autoCreatedReservationsDuration フィールドを指定します。

      PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration%2CplanningStatus
      
      {
        "autoDeleteAutoCreatedReservations": "true",
        "autoCreatedReservationsDuration": {
          "seconds": "DURATION_BEFORE_DELETE"
        },
        "name": "FUTURE_RESERVATION_NAME",
        "planningStatus": "PLANNING_STATUS"
      }
      

      DURATION_BEFORE_DELETE は期間(秒単位)に置き換えます。たとえば、604,800 秒(7 日)の場合は 604800 を指定します。

  • DESCRIPTION: 将来の予約リクエストの新しい説明。

  • NAME_PREFIX: 将来の予約リクエスト用にプロビジョニングされる自動作成予約の新しい名前の接頭辞。

  • CONSUMER_PROJECT_ID_1CONSUMER_PROJECT_ID_2: 将来の予約リクエストを共有するプロジェクトの ID。このプロジェクトは、オーナー プロジェクトと同じ組織に存在している必要があります。最大 100 個のユーザー プロジェクトを指定できます。

  • SHARE_TYPE: 将来の予約リクエストの新しい共有タイプ。次のいずれかを行います。

    • 単一プロジェクトの将来の予約リクエストを指定するには、次の操作を行います。

      • LOCAL を指定します。

      • shareSettings.projects フィールドを削除します。

    • 将来の共有予約リクエストを指定するには、次の操作を行います。

      • SPECIFIC_PROJECTS を指定します。

      • shareSettings.projects フィールドに、ユーザー プロジェクトを少なくとも 1 つ指定します。ユーザー プロジェクトは、オーナー プロジェクトと同じ組織に存在する必要があります。最大 100 個のユーザー プロジェクトを指定できます。

  • 予約済みの N1 VM にアタッチする GPU の数とタイプを変更するには、次のように置き換えます。

    • NUMBER_OF_ACCELERATORS: 予約済みの VM 1 台あたりに追加する GPU の数。

    • ACCELERATOR_TYPE: 予約済みの VM に追加する GPU のタイプ。将来の予約リクエストが存在するゾーンで GPU を使用できることを確認します。一致していない場合、リクエストの変更は失敗します。

  • INTERFACE_1INTERFACE_2: 予約済みの各 VM にアタッチされているローカル SSD ディスクのディスク インターフェースのタイプ。次のいずれかの値を指定します。

  • MACHINE_TYPE: 予約済みの各 VM に使用する新しいマシンタイプ。マシンタイプを変更する場合は、新しいマシンシリーズの推奨の最小予約期間も指定してください。そうしないと、Google Cloud で変更リクエストが承認される可能性が低くなります。

  • MINIMUM_CPU_PLATFORM: 予約済み VM ごとに使用する新しい最小 CPU プラットフォーム。

  • TOTAL_COUNT: この将来の予約リクエストで指定された期間、VM 構成、プロジェクトに対して予約する VM の合計数。合計数を増やす場合は、予約するリソースに十分な割り当てがあることを確認してください。十分な割り当てがないと、Google Cloud で変更リクエストが承認されません。

  • START_TIME: 予約期間の新しい開始時間(RFC 3339 タイムスタンプの形式)。開始時間は、審査を受けるために変更リクエストを送信した日時から 1 年以内にしてください。将来の予約が承認された後またはロック時間になるまでに、キャンセル、削除、変更するために十分な時間を確保するには、推奨の開始時間を指定してください。

  • END_TIME: 予約期間の終了日時(RFC 3339 タイムスタンプの形式)。予約期間は 24 時間以上にする必要があります。また、endTime フィールドを duration フィールドに置き換えて、予約期間の開始時間から特定の期間を指定することもできます。

    PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=timeWindow.duration%2CplanningStatus
    
    {
      "name": "FUTURE_RESERVATION_NAME",
      "planningStatus": "PLANNING_STATUS",
      "timeWindow": {
        "duration": {
          "seconds": "END_DURATION"
        }
      }
    }
    

    END_DURATION は期間(秒単位)に置き換えます。たとえば、1,209,600 秒(14 日)の場合は 1209600 を指定します。審査を受けるために送信した将来の予約リクエストが Google Cloud で承認される可能性を高めるために、推奨の予約期間を指定します。

たとえば、ゾーン us-central1-a に、fr-03 という共有の将来の予約リクエストの下書きがあるとします。この共有の将来の予約リクエストを次のように変更するとします。

  • リクエストを単一プロジェクトの将来の予約リクエストに変換します。

  • 自動削除オプションを無効にします。

  • 100 個の VM を予約します。

  • 審査を受けるため、将来の予約リクエストを Google Cloud に送信します。

fr-03 を変更するには、次のように PATCH リクエストを送信します。

PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-03?updateMask=autoDeleteAutoCreatedReservations%2CplanningStatus%2CshareSettings.shareType%2CspecificSkuProperties.totalCount

{
  "autoDeleteAutoCreatedReservations": false,
  "name": "fr-03",
  "planningStatus": "SUBMITTED",
  "shareSettings": {
    "shareType": "LOCAL"
  },
  "specificSkuProperties": {
    "totalCount": "100"
  }
}

将来の予約リクエストを変更した後、将来の予約リクエストの詳細を表示して、調達ステータスまたは更新ステータスをモニタリングできます。

将来の予約リクエストの他のプロパティを変更する

将来の予約リクエストの作成後、リクエストが承認されてロック時間に入る前に、変更できないプロパティを変更するには、次の操作を行います。

  1. プロジェクト(または将来の予約リクエストが共有されているプロジェクト)で作成できる将来の予約リクエストの種類が、将来の予約リクエストで制限されないようにするには、将来の予約リクエストを削除します。

  2. 必要な更新を行い、新しい単一プロジェクトまたは共有の将来の予約リクエストを作成します。

トラブルシューティング

将来の予約リクエストの変更時にエラーが発生した場合は、将来の予約リクエストのトラブルシューティングをご覧ください。

トラブルシューティングを行っても問題が解決しない場合は、アカウント担当者または Google Cloud サポートにお問い合わせください。

次のステップ