Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

修改預訂

本文說明如何在 Compute Engine 中修改預留項目。如要修改附加至承諾使用合約的預留項目，請參閱「更換附加至承諾使用合約的預留項目」。

如果容量需求有變，或是想更新可使用預留容量的工作負載，請修改預留項目。

限制

修改預留項目時，請注意下列限制：

您只能從預留項目所在的專案修改共用預留項目。
您可以隨時修改自動建立的預留項目 (自動建立)，包括日曆模式的未來預留項目，以及容量區塊的未來預留項目，但只能透過下列方式修改：
您只能透過下列方式，修改為未來預留項目自動建立的預留項目：
- 開始時間過後，你可以執行下列操作：
- 結束時間過後，你可以執行下列操作：
  - 修改預留項目中預留的 Compute Engine 執行個體數量
  - 修改預留項目的自動刪除設定

事前準備

如果尚未設定驗證，請先完成設定。驗證程序會確認您的身分，以便授予 Google Cloud 服務和 API 的存取權。如要從本機開發環境執行程式碼或範例，您可以選取下列其中一個選項，向 Compute Engine 進行驗證：
請根據您打算如何使用本頁範例，選取對應的分頁標籤：
控制台

使用 Google Cloud 控制台存取 Google Cloud 服務和 API 時，您不需要設定驗證機制。
gcloud
1. 安裝 Google Cloud CLI。安裝完成後，請執行下列指令，初始化 Google Cloud CLI：
  gcloud init
  如果您使用外部識別資訊提供者 (IdP)，請先使用聯合身分登入 gcloud CLI。
  
  注意：如果您已經安裝 gcloud CLI，請務必執行 gcloud components update，確認您安裝的是最新版本。
設定預設區域和可用區。

REST

如要在本機開發環境中使用本頁的 REST API 範例，請使用您提供給 gcloud CLI 的憑證。

安裝 Google Cloud CLI。

若您採用的是外部識別資訊提供者 (IdP)，請先使用聯合身分登入 gcloud CLI。

詳情請參閱 Google Cloud 驗證說明文件中的「使用 REST 進行驗證」。

必要的角色

如要取得修改預留項目所需的權限，請要求管理員授予您專案的 Compute 管理員 (roles/compute.admin) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備修改預訂所需的權限。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：

所需權限

如要修改預訂，必須具備下列權限：

如要修改預留項目的自動刪除選項、預留項目的使用類型或共用類型，或是 Vertex AI 工作是否可使用附加 GPU 的運算執行個體預留項目，請按照下列步驟操作： compute.reservations.update 在專案中
如要修改預訂中的 Compute Engine 執行個體數量，請按照下列步驟操作： compute.reservations.resize 在專案中

您或許還可透過自訂角色或其他預先定義的角色取得這些權限。

修改預留項目

請根據您要在預留項目中修改的屬性，使用下列其中一種方法。如要變更下列清單未提及的房源，請建立含有選定更新內容的新預訂，然後刪除不再需要的原始預訂。

如要增加或減少預訂中的預留運算執行個體數量，請修改預訂中的預留運算執行個體數量。
如要在單一專案預留項目和共用預留項目之間切換，請修改預留項目的共用類型。
如要新增或移除可使用共用預留項目的用戶專案，請修改共用預留項目中的用戶專案。
如要允許或禁止 Vertex AI 中的自訂訓練工作或預測工作使用 GPU 執行個體的預留項目，請修改預留項目的共用政策。
如要啟用或停用預留項目的自動刪除功能，或變更 Compute Engine 自動刪除預留項目的日期和時間，請修改預留項目的自動刪除功能。

修改預留項目中的預留運算執行個體數量

您可以增加或減少預留項目中的預留運算執行個體數量。不過，修改運算執行個體數量前，請考量下列事項，以免發生錯誤：

如要增加任何預訂中的運算執行個體數量，請確認您符合下列條件：
- 您不得超過預留項目的運算執行個體數量上限。
- 專案必須有足夠的未使用配額，才能預留額外資源。如要提高配額，請參閱「查看及管理配額」。
- 預留項目所在的可用區必須有足夠的可用資源。如果沒有，修改要求就會失敗，並顯示資源可用性錯誤。如要排解這類錯誤，請參閱「排解資源可用性錯誤」。
注意： 即使符合上述條件，修改要求仍可能因可用區的機器家族預留容量限制而失敗。如果可用區已達上限，您的要求就會失敗並傳回 RESERVATION_CAPACITY_LIMIT_EXCEEDED 錯誤。如要排解這項錯誤，請參閱「超出預留容量限制」。
如要減少特定目標預訂中的運算執行個體數量，請確認使用預訂的運算執行個體數量未超過新的較小數量。如果超過，請對超出新數量上限的運算執行個體執行下列其中一項操作：
- 刪除運算執行個體
- 停止或暫停運算執行個體
  
  注意：如果您停止或暫停超出的執行個體，而不是將其刪除，則這些執行個體就不會再計入預留項目，您可以繼續修改預留項目。不過，修改預訂後，除非增加預訂中的執行個體數量，或刪除其他使用預訂的執行個體，否則無法重新啟動或繼續執行個體。

如要修改預留項目中預留的運算執行個體數量，請選取下列其中一個選項：

控制台

前往 Google Cloud 控制台的「Reservations」(預留項目) 頁面。

前往「Reservations」(預留項目) 頁面
在「On-demand reservations」(隨需預留項目) 分頁 (預設) 的「Name」(名稱) 欄中，按一下要修改的預留項目名稱。系統會開啟預訂詳細資料頁面。
按一下「Edit」(編輯)。
在「Number of VM instances」(VM 執行個體數量) 欄位中，輸入要預留的更新運算執行個體數量。
按一下「儲存」確認操作。

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：要預留的運算執行個體數量。

您可以將單一專案預留項目轉換為共用預留項目，或將共用預留項目轉換為單一專案預留項目。修改預留項目的共用類型時，您最多可以與組織中的 100 項專案共用預留資源，也可以限制只有擁有者專案可以存取。

為避免在修改預留項目的共用類型時發生錯誤，請在開始修改前考量下列事項：

如要將單一專案預留項目轉換為共用預留項目，請確認下列事項：
- 專案權限：確認專案可以建立共用預留項目。如需操作說明，請參閱「允許或限制專案建立共用預留項目」。
- 配額限制：如果預留類型需要配額，您可能需要預留資源的額外配額。共用預留項目和單一專案預留項目的配額需求不同。詳情請參閱「共用預留項目的額外配額規定」。
如要將共用預留項目轉換為單一專案預留項目，請確認下列事項：
- 消費者運算執行個體：如要修改指定預留項目，您必須停止、暫停或刪除任何運算執行個體，這些執行個體會在使用預留項目的每個消費者專案中，耗用預留項目。這項規定不適用於擁有者專案中的運算執行個體。
  
  注意： 如果您停止或暫停用戶專案中指定共用預留項目的運算執行個體，則必須先建立替代預留項目，才能重新啟動或恢復這些運算執行個體。如要重新啟動或繼續執行運算執行個體，您必須在相同的擁有者專案和可用區中建立新的預留項目，並使用與原始預留項目相同的名稱和相符的屬性。

如要修改預留項目的共用類型，請選取下列其中一個選項：

gcloud

如要修改預留項目的共用類型，請使用 gcloud compute reservations update 指令。

請根據要如何修改預訂，加入下列其中一個旗標：

如要將單一專案預留項目轉換為共用預留項目，請加入 --add-share-with 和 --share-setting=projects 旗標：

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

如要將共用預留項目轉換為單一專案預留項目，請加入 --share-setting=local 旗標：

gcloud compute reservations update RESERVATION_NAME \
    --share-setting=local \
    --zone=ZONE

更改下列內容：

RESERVATION_NAME：要修改的預留項目名稱。
CONSUMER_PROJECT_IDS：以半形逗號分隔的專案 ID 清單，用於指定要與哪些專案共用預留項目，例如 project-1,project-2。您最多可以與 100 個專案共用預留項目，這些專案必須與擁有者專案位於同一個組織。
ZONE：預留項目所在的可用區。

REST

如要修改預留項目的共用類型，請向 reservations.update 方法發出 PATCH 要求。

請根據您要如何修改預留項目，提出下列其中一項要求：

如要將單一專案預留項目轉換為共用預留項目，請按照下列步驟提出要求。在要求網址中，為要共用預留項目的每個專案加入 paths=shareSettings.projectMap.PROJECT_ID_OR_NUMBER 查詢參數。

舉例來說，如要與兩項專案共用預留項目，請提出下列要求。您最多可以與 100 個專案共用預留項目，這些專案必須與擁有者專案位於同一個組織。

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=shareSettings.shareType&paths=shareSettings.projectMap.CONSUMER_PROJECT_NUMBER_1&paths=shareSettings.projectMap.CONSUMER_PROJECT_NUMBER_2

{
  "name": "RESERVATION_NAME",
  "shareSettings": {
    "shareType": "SPECIFIC_PROJECTS",
    "projectMap": {
      "CONSUMER_PROJECT_ID_OR_NUMBER_1": {
        "projectId": "CONSUMER_PROJECT_ID_OR_NUMBER_1"
      },
      "CONSUMER_PROJECT_ID_OR_NUMBER_2": {
        "projectId": "CONSUMER_PROJECT_ID_OR_NUMBER_2"
      }
    }
  }
}

如要將共用預留項目轉換為單一專案預留項目，請按照下列步驟提出要求：

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=shareSettings.shareType

{
  "name": "RESERVATION_NAME",
  "shareSettings": {
    "shareType": "LOCAL"
  }
}

更改下列內容：

PROJECT_ID：預留項目所在專案 (擁有者專案) 的 ID。
ZONE：預留項目所在的可用區。
RESERVATION_NAME：要修改的預留項目名稱。
CONSUMER_PROJECT_ID_OR_NUMBER_1 和CONSUMER_PROJECT_ID_OR_NUMBER_2：要共用預留項目的兩個專案 ID 或編號。

修改共用預留項目中的用戶專案

如要避免修改可使用共用預留項目的消費者專案時發生錯誤，請注意下列事項：

移除專案：只有在這些專案中沒有任何運算執行個體使用保留項目時，您才能禁止個人專案使用共用保留項目。如要停止運算執行個體耗用預留項目，請停止、暫停或刪除運算執行個體。

注意： 如果停止或暫停專為指定預留項目建立的運算執行個體，則必須建立替代預留項目，才能重新啟動或恢復這些運算執行個體。如要重新啟動或繼續執行運算執行個體，您必須在相同的擁有者專案和可用區中，建立新的特定目標預留項目，並使用與原始預留項目相同的名稱和相符屬性。
新增專案：只有在用戶專案與擁有者專案位於同一機構時，您才能允許用戶專案使用共用預留項目。如要將專案遷移至擁有者專案的組織，請參閱「在組織資源之間遷移專案」。

修改共用預留項目的用戶專案後，預留項目的用量可能會變更。舉例來說，如果您將預留項目設為允許任何相符的運算執行個體使用 (預設設定)，則任何新加入的取用者專案可能會立即開始使用預留項目。如要進一步瞭解哪些相符的預留項目專案會優先使用，請參閱預留項目使用順序。

如要修改可使用共用預留項目的消費者專案，請選取下列其中一個選項：

控制台

前往 Google Cloud 控制台的「Reservations」(預留項目) 頁面。

前往「Reservations」(預留項目) 頁面
在「On-demand reservations」(隨需預留項目) 分頁 (預設) 的「Name」(名稱) 欄中，按一下要描述的預留項目名稱。

系統會開啟預留項目的詳細資料頁面。
按一下「Edit」(編輯)。
在「Selected projects」(所選專案) 部分，執行下列任一操作：
- 如要停止與特定消費者專案共用預留項目，請按一下「Delete」(刪除)。
- 如要開始與一或多個特定專案共用預留項目，請按照下列步驟操作：
  1. 按一下「新增專案」。
  2. 在擁有者專案的組織中，找出要共用預留項目的各項專案，並勾選對應的核取方塊。共用預留項目最多可與 100 個用戶專案共用。
  3. 按一下「選取」。
如要確認變更，請按一下「儲存」。

修改預訂可能需要幾秒鐘才能完成。

gcloud

修改共用預留項目的消費者專案時，您必須指定以半形逗號分隔的專案 ID 清單，允許或停止允許這些專案使用共用預留項目。所有用戶專案都必須與擁有者專案屬於同一個組織。請勿指定擁有者專案；根據預設，共用預留項目的擁有者專案一律可以取用該預留項目。

如要修改共用預留項目的用戶專案，請執行下列任一操作：

如要允許一或多項專案使用共用預留項目，請使用 gcloud compute reservations update 指令並搭配 --add-share-with 旗標。
```
gcloud compute reservations update RESERVATION_NAME \
    --add-share-with=CONSUMER_PROJECT_IDS \
    --zone=ZONE
```
更改下列內容：
- RESERVATION_NAME：現有共用預留項目的名稱。
- CONSUMER_PROJECT_IDS：以半形逗號分隔的專案 ID 清單，用於指定要與哪些專案共用預留項目，例如 project-1,project-2。共用預留項目最多可與 100 個用戶專案共用。
- ZONE：共用預留項目所在的可用區。
如要停止允許一或多項專案使用共用預留項目，請使用 gcloud compute reservations update 指令並搭配 --remove-share-with 旗標。
```
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：共用預留項目所在的可用區。
如要取代可使用共用預留項目的專案清單，請使用 gcloud beta compute reservations update 指令和 --share-with 旗標。

預覽

這項產品或功能適用《服務專屬條款》中「一般服務條款」一節的《正式發布前產品條款》。正式發布前的產品和功能是按照「原樣」提供，支援範圍可能有限。詳情請參閱推出階段說明。
```
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。共用預留項目最多可與 100 個用戶專案共用。

REST

修改共用預留項目的用戶專案時，必須指定要新增或移除的專案。如要允許專案使用預留項目，請指定專案 ID 或專案編號。如要禁止專案使用預留項目，請指定專案編號。所有消費者專案都必須與擁有者專案屬於同一個機構。請勿指定擁有者專案；根據預設，共用預留項目的擁有者專案一律可以取用該預留項目。

如要修改共用預留項目的消費者專案，請執行下列任一操作：

如要允許一或多個專案使用共用預留項目，請對 reservations.update 方法發出 PATCH 要求。在要求網址中，為要共用預留項目的每個專案加入 paths=shareSettings.projectMap.PROJECT_ID_OR_NUMBER 查詢參數。

舉例來說，如要允許兩項專案使用共用預留項目，請按照下列方式提出 PATCH 要求。共用預留項目最多可與 100 個用戶專案共用。
```
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=shareSettings.projectMap.CONSUMER_PROJECT_NUMBER_1&paths=shareSettings.projectMap.CONSUMER_PROJECT_NUMBER_2

{
  "name": "RESERVATION_NAME",
  "shareSetting": {
    "projectMap": {
      "CONSUMER_PROJECT_ID_OR_NUMBER_1": {
        "projectId": "CONSUMER_PROJECT_ID_OR_NUMBER_1"
      },
      "CONSUMER_PROJECT_ID_OR_NUMBER_2": {
        "projectId": "CONSUMER_PROJECT_ID_OR_NUMBER_2"
      }
    }
  }
}
```
更改下列內容：
- PROJECT_ID：共用預留資源所在的專案 ID (擁有者專案)。
- ZONE：共用預留項目所在的可用區。
- RESERVATION_NAME：現有共用預留項目的名稱。
- CONSUMER_PROJECT_ID_OR_NUMBER_1 和 CONSUMER_PROJECT_ID_OR_NUMBER_2：要共用預留項目的兩個專案 ID 或編號。
如要停止允許一或多個專案使用共用預留項目，請向 reservations.update 方法發出 PATCH 要求。在要求網址中，為每個要停止分享預訂的專案加入 paths=shareSettings.projectMap.PROJECT_NUMBER 查詢參數。此外，您必須從要求主體中省略 shareSetting 欄位。

舉例來說，如要停止允許兩項專案使用共用預留項目，請按照下列方式提出 PATCH 要求：
```
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=shareSettings.projectMap.CONSUMER_PROJECT_NUMBER_1&paths=shareSettings.projectMap.CONSUMER_PROJECT_NUMBER_2

{
  "name": "RESERVATION_NAME"
}
```
更改下列內容：
- PROJECT_ID：共用預留資源所在的專案 ID (擁有者專案)。
- ZONE：共用預留項目所在的可用區。
- RESERVATION_NAME：現有共用預留項目的名稱。
- CONSUMER_PROJECT_NUMBER_1 和 CONSUMER_PROJECT_NUMBER_2：要停止共用預留項目的兩個專案編號。

修改 GPU 運算執行個體預留項目的共用政策，即可控管 Vertex AI 訓練或預測工作是否使用預留項目。

在禁止 Vertex AI 工作使用預留項目之前，請先停止使用該預留項目的所有 Vertex AI 工作。否則會發生錯誤。

如要修改 GPU 執行個體預留的共用政策，請選取下列任一選項：

控制台

前往 Google Cloud 控制台的「Reservations」(預留項目) 頁面。

前往「Reservations」(預留項目) 頁面
在「On-demand reservations」(隨需預留項目) 分頁 (預設) 的「Name」(名稱) 欄中，按一下要修改的 GPU 執行個體預留項目名稱。系統會顯示預留項目的詳細資料頁面。
在「Share with other Google Cloud services」(與其他 Google Cloud 服務共用) 列中，按一下「Edit service sharing settings」(編輯服務共用設定)。
在「分享預訂資訊」窗格中，執行下列任一操作：
- 如要允許 Vertex AI 工作使用預留項目，請選取「共用預留項目」。
- 如要禁止 Vertex AI 工作使用預留項目，請選取「Don't share reservation」(不共用預留項目)。
按一下 [儲存]。

預留項目可能需要幾秒鐘才能修改完成。

gcloud

如要修改 GPU 執行個體預留項目的共用政策，請使用 gcloud compute reservations update 指令，並加上 --reservation-sharing-policy 旗標。

gcloud 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 執行個體預留項目的共用政策，請向 reservations.update 方法傳送 PATCH 要求。在要求網址中，加入設為 reservationSharingPolicy.serviceShareType 的 paths 查詢參數。

PATCH https://compute.googleapis.com/compute/v1/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

修改預留項目的自動刪除設定

如要修改 Compute Engine 自動刪除現有預留項目的時間，請執行下列任一操作：

啟用自動刪除選項，或變更自動刪除預留項目的時間。
停用自動刪除選項。

如要修改預留項目的自動刪除設定，請選取下列任一選項：

控制台

前往 Google Cloud 控制台的「Reservations」(預留項目) 頁面。

前往「Reservations」(預留項目) 頁面
在「On-demand reservations」(隨需預留項目) 分頁 (預設) 的「Name」(名稱) 欄中，按一下要修改的預留項目名稱。

預訂詳細資料頁面隨即開啟。
在「自動刪除時間」列中，按一下「編輯自動刪除時間」。
在「更新預訂」窗格中，執行下列任一操作：
- 如要在特定日期和時間刪除預留項目，請按照下列步驟操作：
  1. 如果尚未啟用自動刪除選項，請點按「啟用自動刪除功能」切換鈕，將切換鈕設為開啟。
  2. 在「Auto-delete time」(自動刪除時間) 欄位中，輸入 Compute Engine 自動刪除預留項目的日期和時間。
- 否則，請按一下「Enable auto-delete」(啟用自動刪除功能) 切換鈕，將切換鈕設為關閉。
按一下「提交」。

修改預訂可能需要幾秒鐘才能完成。

gcloud

在預留項目中啟用自動刪除選項時，您可以指定刪除預留項目的日期和時間，或指定刪除預留項目的時間長度。

如要啟用自動刪除選項，或變更預留項目的刪除時間，請執行下列任一操作：

如要在特定日期和時間刪除預留項目，請使用 gcloud beta compute reservations update 指令和 --delete-at-time 旗標。
```
gcloud beta compute reservations update RESERVATION_NAME \
    --delete-at-time=DELETE_AT_TIME \
    --zone=ZONE
```
更改下列內容：
- RESERVATION_NAME：現有預留項目的名稱。
- DELETE_AT_TIME：日期和時間，格式為 RFC 3339 時間戳記。
- ZONE：預留項目所在的可用區。
如要在特定時間後刪除預訂，請使用 gcloud beta compute reservations update 指令，並加上 --delete-after-duration 旗標。
```
gcloud beta compute reservations update RESERVATION_NAME \
    --delete-after-duration=DELETE_AFTER_DURATION \
    --zone=ZONE
```
更改下列內容：
- RESERVATION_NAME：現有預留項目的名稱。
- DELETE_AFTER_DURATION：預留項目自動刪除前的時間長度，以天、小時、分鐘或秒為單位。例如，指定 30m 代表 30 分鐘，或指定 1d2h3m4s 代表 1 天 2 小時 3 分鐘 4 秒。
- ZONE：預留項目所在的可用區。

如要停用自動刪除選項，請使用 gcloud beta compute reservations update 指令，並加上 --disable-auto-delete 旗標。

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

更改下列內容：

RESERVATION_NAME：現有預訂的名稱。
ZONE：預留項目所在的可用區。

REST

在預留項目中啟用自動刪除選項後，您可以指定預留項目的刪除日期和時間，也可以指定預留項目的保留期限。

如要啟用自動刪除選項，或變更預留項目的刪除時間，請執行下列任一操作：

如要在特定日期和時間刪除預留項目，請向 beta.reservations.update 方法發出 PATCH 要求。在要求網址中，加入設為 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 要求。在要求網址中，加入設為 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：預留項目自動刪除前的時間長度，以秒為單位。例如，指定 86400 代表 86,400 秒 (1 天)。

如要停用自動刪除選項，請對 beta.reservations.update 方法提出 PATCH 要求。在要求中，指定 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：現有預留項目的名稱。

後續步驟

瞭解如何查看預訂資訊。
瞭解如何排解預訂更新問題。
瞭解如何使用預留項目。
瞭解如何刪除預留項目。

修改預訂 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

限制

事前準備

控制台

gcloud

REST

必要的角色

所需權限

修改預留項目

修改預留項目中的預留運算執行個體數量

控制台

gcloud

REST

修改預留項目的共用類型

gcloud

REST

修改共用預留項目中的用戶專案

控制台

gcloud

REST

修改預留項目的共用政策

控制台

gcloud

REST

修改預留項目的自動刪除設定

控制台

gcloud

REST

後續步驟

修改預訂