予約を変更する

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

コンソール

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

   [予約] に移動

2. [オンデマンド予約] タブ（デフォルト）の [名前] 列で、変更する予約の名前をクリックします。

   予約の詳細ページが開きます。

3. [自動削除日時] 行で、[edit 自動削除日時を編集] をクリックします。

4. [予約の更新] ペインで、次のいずれかを行います。

   • 特定の日時に予約を削除するには、次のようにします。

     1. 自動削除オプションが有効になっていない場合は、[自動削除を有効にする] 切り替えをクリックしてオンにします。

     2. [自動削除日時] フィールドに、Compute Engine が予約を自動的に削除する日時を入力します。

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

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

   予約の変更には数秒かかることがあります。

gcloud

予約の自動削除オプションを有効にすると、予約を削除する日時を指定するほか、特定の期間の経過後に予約を削除するよう指定できます。

自動削除オプションを有効にする、または予約を削除するタイミングを変更するには、次のいずれかを行います。

• 特定の日時に予約を削除するには、--delete-at-time フラグを指定して gcloud beta compute reservations update コマンドを使用します。

  gcloud beta compute reservations update RESERVATION_NAME \
      --delete-at-time=DELETE_AT_TIME \
      --zone=ZONE
  

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

  • RESERVATION_NAME: 既存の予約の名前。

  • DELETE_AT_TIME: RFC 3339 タイムスタンプ形式の日時。

  • ZONE: 予約が配置されているゾーン。

• 特定の期間の経過後に予約を削除するには、--delete-after-duration フラグを指定して gcloud beta compute reservations update コマンドを使用します。

  gcloud beta compute reservations update RESERVATION_NAME \
      --delete-after-duration=DELETE_AFTER_DURATION \
      --zone=ZONE
  

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

  • RESERVATION_NAME: 既存の予約の名前。

  • DELETE_AFTER_DURATION: 予約が自動的に削除されるまでの期間（日、時、分、秒）。たとえば、30 分の場合は 30m と指定し、1 日 2 時間 3 分 4 秒の場合は 1d2h3m4s と指定します。

  • ZONE: 予約が配置されているゾーン。

自動削除オプションを無効にするには、--disable-auto-delete フラグを指定して gcloud beta compute reservations update コマンドを使用します。

gcloud beta compute reservations update RESERVATION_NAME \
    --disable-auto-delete \
    --zone=ZONE

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

• RESERVATION_NAME: 既存の予約の名前。

• ZONE: 予約が配置されているゾーン。

REST

予約の自動削除オプションを有効にすると、予約を削除する日時を指定するほか、特定の期間の経過後に予約を削除するよう指定できます。

自動削除オプションを有効にする、または予約を削除するタイミングを変更するには、次のいずれかを行います。

• 特定の日時の予約を削除するには、beta.reservations.update メソッドに PATCH リクエストを送信します。リクエスト URL に、deleteAtTime に設定された paths クエリ パラメータを含めます。

  PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=deleteAtTime
  
  {
    "name": "RESERVATION_NAME",
    "deleteAtTime": "DELETE_AT_TIME"
  }
  

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

  • PROJECT_ID: 予約が配置されているプロジェクトの ID。

  • ZONE: 予約が配置されているゾーン。

  • RESERVATION_NAME: 既存の予約の名前。

  • DELETE_AT_TIME: RFC 3339 タイムスタンプ形式の日時。

• 特定の期間の経過後に予約を削除するには、beta.reservations.update メソッドに PATCH リクエストを送信します。リクエスト URL に、deleteAfterDuration.seconds に設定された paths クエリ パラメータを含めます。

  PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=deleteAfterDuration.seconds
  
  {
    "name": "RESERVATION_NAME",
    "deleteAfterDuration": {
      "seconds": "DELETE_AFTER_DURATION"
    }
  }
  

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

  • PROJECT_ID: 予約が配置されているプロジェクトの ID。

  • ZONE: 予約が配置されているゾーン。

  • RESERVATION_NAME: 既存の予約の名前。

  • DELETE_AFTER_DURATION: 予約が自動的に削除されるまでの期間（秒）。たとえば、86,400 秒（1 日）の場合は 86400 を指定します。

自動削除オプションを無効にするには、PATCH リクエストを beta.reservations.update メソッドに送信します。リクエストでは paths=deleteAtTime&paths=deleteAfterDuration クエリ パラメータを指定し、リクエスト本文を省略します。

PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=deleteAtTime&paths=deleteAfterDuration

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

• PROJECT_ID: 予約が配置されているプロジェクトの ID。

• ZONE: 予約が配置されているゾーン。

• RESERVATION_NAME: 既存の予約の名前。

コンソール

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

   [予約] に移動

2. [オンデマンド予約] タブ（デフォルト）の [名前] 列で、記述する予約の名前をクリックします。

   予約の詳細ページが表示されます。

3. [edit 編集] をクリックします。

4. [選択したプロジェクト] セクションで、次のいずれかの操作を行います。

   • 特定のコンシューマー プロジェクトとの予約の共有を停止するには、[delete 削除] をクリックします。

   • 1 つ以上の特定のプロジェクトと予約の共有を開始するには、次の操作を行います。

     1. [add プロジェクトを追加] をクリックします。

     2. 予約を共有するオーナー プロジェクトの組織の各プロジェクトのチェックボックスをオンにします。

     3. [選択] をクリックします。

5. 変更を確定するには、[保存] をクリックします。

   予約の変更には数秒かかることがあります。

gcloud

共有予約を使用するコンシューマー プロジェクトを変更する場合は、共有予約の使用を許可するプロジェクとの ID、許可を停止するプロジェクトの ID のカンマ区切りのリストを指定する必要があります。これらのプロジェクトは、オーナー プロジェクトと同じ組織に存在している必要があります。リスト内でオーナー プロジェクトを指定しないでください。デフォルトでは、共有予約の使用があらかじめ許可されています。

共有予約を使用するコンシューマー プロジェクトを変更するには、次のいずれかの方法を選択します。

• 1 つ以上のプロジェクトによる共有予約の使用を許可するには、--add-share-with フラグを指定して gcloud compute reservations update コマンドを使用します。

  gcloud compute reservations update RESERVATION_NAME \
      --add-share-with=CONSUMER_PROJECT_IDS \
      --zone=ZONE
  

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

  • RESERVATION_NAME: 既存の共有予約の名前。

  • CONSUMER_PROJECT_IDS: 予約を共有するプロジェクトの ID のカンマ区切りリスト。たとえば、project-1,project-2 を指定します。

  • ZONE: 共有予約が配置されているゾーン。

• 1 つ以上のプロジェクトによる共有予約の使用の許可を停止するには、--remove-share-with フラグを指定して gcloud compute reservations update コマンドを使用します。

  gcloud compute reservations update RESERVATION_NAME \
      --remove-share-with=CONSUMER_PROJECT_IDS \
      --zone=ZONE
  

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

  • RESERVATION_NAME: 既存の共有予約の名前。

  • CONSUMER_PROJECT_IDS: 予約の共有を停止するプロジェクトの ID のカンマ区切りリスト。たとえば、project-1,project-2 を指定します。

  • ZONE: 共有予約が配置されているゾーン。

• 共有予約を使用できるプロジェクトのリストを置き換えるには、--share-with フラグを指定して gcloud beta compute reservations update コマンドを使用します。

  gcloud beta compute reservations update RESERVATION_NAME \
      --share-with=CONSUMER_PROJECT_IDS \
      --zone=ZONE
  

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

  • RESERVATION_NAME: 既存の共有予約の名前。

  • ZONE: 共有予約が配置されているゾーン。

  • CONSUMER_PROJECT_IDS: 予約を共有するプロジェクトの ID のカンマ区切りリスト。たとえば、project-1,project-2 を指定します。

REST

共有予約を使用するコンシューマー プロジェクトを変更する場合は、共有予約の使用を許可するプロジェクトの ID または許可を停止するプロジェクトの ID を指定する必要があります。これらのプロジェクトは、オーナー プロジェクトと同じ組織に存在している必要があります。オーナー プロジェクトを指定しないでください。デフォルトでは、共有予約の使用があらかじめ許可されています。

共有予約を使用するコンシューマー プロジェクトを変更するには、次のいずれかの方法を選択します。

• 1 つ以上のプロジェクトによる共有予約の使用を許可するには、reservations.update メソッドに PATCH リクエストを送信します。リクエスト URL に、予約を共有する各プロジェクトの paths=shareSettings.projectMap.PROJECT_ID クエリ パラメータを含めます。

  たとえば、2 つのプロジェクトの共有予約の使用を許可するには、次の PATCH リクエストを行います。

  PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=shareSettings.projectMap.CONSUMER_PROJECT_ID_1&paths=shareSettings.projectMap.CONSUMER_PROJECT_ID_2
  
  {
    "name": "RESERVATION_NAME",
    "shareSetting": {
      "projectMap": {
        "CONSUMER_PROJECT_ID_1": {
          "projectId": "CONSUMER_PROJECT_ID_1"
        },
        "CONSUMER_PROJECT_ID_2": {
          "projectId": "CONSUMER_PROJECT_ID_2"
        }
      }
    }
  }
  

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

  • PROJECT_ID: オーナー プロジェクト（共有予約の作成に使用されているプロジェクト）の ID。

  • ZONE: 共有予約が配置されているゾーン。

  • RESERVATION_NAME: 既存の共有予約の名前。

  • CONSUMER_PROJECT_ID_1 と CONSUMER_PROJECT_ID_2: 予約を共有する 2 つのプロジェクトの ID。

• 1 つ以上のプロジェクトによる共有予約の使用の許可を停止するには、reservations.update メソッドに PATCH リクエストを送信します。リクエスト URL に、予約の共有を停止する各プロジェクトの paths=shareSettings.projectMap.PROJECT_ID クエリ パラメータを含めます。また、リクエスト本文から shareSetting フィールドを削除する必要があります。

  たとえば、2 つのプロジェクトによる共有予約の使用の許可を停止するには、次の PATCH リクエストを行います。

  PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=shareSettings.projectMap.CONSUMER_PROJECT_ID_1&paths=shareSettings.projectMap.CONSUMER_PROJECT_ID_2
  
  {
    "name": "RESERVATION_NAME"
  }
  

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

  • PROJECT_ID: オーナー プロジェクト（共有予約の作成に使用されているプロジェクト）の ID。

  • ZONE: 共有予約が配置されているゾーン。

  • RESERVATION_NAME: 既存の共有予約の名前。

  • CONSUMER_PROJECT_ID_1 と CONSUMER_PROJECT_ID_2: 予約の共有を停止する 2 つのプロジェクトの ID。

コンソール

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

   [予約] に移動

2. [オンデマンド予約] タブ（デフォルト）の [名前] 列で、変更する予約の名前をクリックします。

   予約の詳細ページが表示されます。

3. [edit 編集] をクリックします。

4. [VM インスタンスの数] フィールドに、予約するインスタンスの更新した数を入力します。

5. [保存] をクリックして確定します。

   予約の変更には数秒かかることがあります。

gcloud

予約内の予約済みインスタンスの数を変更するには、gcloud compute reservations update コマンドを使用します。

gcloud compute reservations update RESERVATION_NAME \
    --vm-count=NUMBER_OF_VMS \
    --zone=ZONE

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

• RESERVATION_NAME: 既存の予約の名前。

• NUMBER_OF_VMS: 予約するインスタンスの新しい数。

• ZONE: 予約が配置されているゾーン。

REST

予約内の予約済みインスタンスの数を変更するには、reservations.resize メソッドに POST リクエストを送信します。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/resize

{
  "specificSkuCount": "NUMBER_OF_VMS"
}

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

• PROJECT_ID: 予約が配置されているプロジェクトの ID。

• ZONE: 予約が配置されているゾーン。

• RESERVATION_NAME: 既存の予約の名前。

• NUMBER_OF_VMS: 予約するインスタンスの新しい数。

コンソール

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

   [予約] に移動

2. [オンデマンド予約] タブ（デフォルト）の [名前] 列で、変更する GPU インスタンスの予約の名前をクリックします。

   予約の詳細ページが開きます。

3. [Share with other Google Cloud services] 行で、[edit サービス共有設定を編集する] をクリックします。

4. [予約の共有] ペインで、次のいずれかを行います。

   • Vertex AI が予約を使用できるようにするには、[予約を共有] を選択します。

   • Vertex AI が予約を使用することを禁止するには、[予約を共有しない] を選択します。

5. [保存] をクリックします。

   予約の変更には数秒かかることがあります。

gcloud

GPU インスタンスの予約の共有ポリシーを変更するには、--reservation-sharing-policy フラグを指定して gcloud beta compute reservations update コマンドを使用します。

gcloud beta compute reservations update RESERVATION_NAME \
    --reservation-sharing-policy=SHARING_POLICY \
    --zone=ZONE

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

• RESERVATION_NAME: 既存の予約の名前。

• SHARING_POLICY: 予約の共有ポリシー。次のいずれかの値を指定します。

  • Vertex AI が予約を使用できるようにするには: ALLOW_ALL

  • Vertex AI が予約を使用することを禁止するには: DISALLOW_ALL

• ZONE: 予約が配置されているゾーン。

REST

GPU インスタンスの予約の共有ポリシーを変更するには、beta.reservations.update メソッドに PATCH リクエストを送信します。リクエスト URL に、reservationSharingPolicy.serviceShareType に設定された paths クエリ パラメータを含めます。

PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=reservationSharingPolicy.serviceShareType

{
  "name": "RESERVATION_NAME",
  "reservationSharingPolicy": {
    "serviceShareType": "SHARING_POLICY"
  }
}

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

• PROJECT_ID: 予約が配置されているプロジェクトの ID。

• ZONE: 予約が配置されているゾーン。

• RESERVATION_NAME: 既存の予約の名前。

• SHARING_POLICY: 予約の共有ポリシー。次のいずれかの値を指定します。

  • Vertex AI が予約を使用できるようにするには: ALLOW_ALL

  • Vertex AI が予約を使用することを禁止するには: DISALLOW_ALL