本文說明如何修改日後的預訂要求。
只要未取消或待核准，你隨時可以在預訂時間前修改未來的預訂要求。當容量需求變更時，修改未來的預留要求就很有用，例如想增加預留的虛擬機器 (VM) 執行個體數量，或變更預留期間。如要修改共用的未來預訂要求，必須使用擁有者專案修改要求。
如要在預留期間結束後修改自動建立的預留項目，請參閱「修改預留項目」。
事前準備
-
如果尚未設定驗證，請先完成設定。
驗證可確認您的身分，以便存取 Google Cloud 服務和 API。如要從本機開發環境執行程式碼或範例，可以選取下列任一選項，向 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
-
安裝 Google Cloud CLI。 安裝完成後，執行下列指令初始化 Google Cloud CLI：
gcloud init如果您使用外部識別資訊提供者 (IdP)，請先 使用聯合身分登入 gcloud CLI。
- Set a default region and zone.
REST
如要在本機開發環境中使用本頁的 REST API 範例，請使用您提供給 gcloud CLI 的憑證。
安裝 Google Cloud CLI。 安裝完成後，執行下列指令初始化 Google Cloud CLI：
gcloud init如果您使用外部識別資訊提供者 (IdP)，請先 使用聯合身分登入 gcloud CLI。
詳情請參閱 Google Cloud 驗證說明文件中的「Authenticate for using REST」。
必要的角色
如要取得修改未來預留項目要求所需的權限，請要求管理員授予您專案的 Compute Future Reservation Admin (
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 數量)*
* 如果您要求變更任何 VM 屬性，或在預訂開始時間的 14 天內大幅增加或減少總數， Google Cloud 可能會拒絕您的修改要求。
修改未來預訂要求
修改未來預留項目要求前，請先查看可修改的屬性 (如果尚未查看)。
如果您想將透過執行個體範本建立的單一專案未來預留項目要求，修改為共用未來預留項目要求，就無法使用相同範本建立 VM，在建立共用未來預留項目要求的專案外部，使用自動建立的預留項目。對於未來預留項目共用的專案，您必須在這些專案中建立類似的執行個體範本，或直接指定屬性來建立 VM。
如要修改未來的預留要求，請選取下列其中一個選項：
主控台
在 Google Cloud 控制台，前往「Reservations」(預留項目) 頁面。
點按「Future reservations」(未來預留項目) 分頁標籤。
在「名稱」欄中，按一下要修改的預訂要求名稱。
系統會開啟所選未來預留要求詳細資料頁面。
如要修改已核准未來預留項目的自動刪除選項、說明或名稱前置字元，請採取下列一或多項做法：
如要修改自動刪除選項，請在「自動建立的預留項目自動刪除時間」列中，按一下 「編輯」，然後執行下列操作：
如要啟用、停用或修改自動刪除選項，請執行下列其中一項操作：
如要啟用自動刪除選項，或變更 Compute Engine 自動刪除自動建立預留項目的時間，請按照下列步驟操作：
按一下「啟用自動刪除功能」切換鈕，將其設為開啟。
選用：如要變更自動刪除時間，請輸入新的日期和時間，系統會在該時間刪除自動建立的預留項目。日期和時間必須晚於預訂期間的結束時間。如果將這個欄位留空，自動建立的預留項目就會在預留期間結束後的兩小時內刪除。
否則，請將「啟用自動刪除功能」切換鈕設為關閉。
按一下「提交」。
如要修改名稱前置字元，請在「前置字元」列中按一下「編輯」，然後執行下列操作：
在「前置字串」部分，輸入新的名稱前置字串。
按一下「提交」。
如要修改說明，請在「說明」列中按一下「編輯」，然後執行下列操作：
在「說明」中，輸入新的說明。
按一下「提交」。
按一下「編輯」或「編輯草稿」。
系統會開啟頁面，供您編輯所選的未來預留要求。
如要修改未來預留項目要求並提交給Google Cloud 審查，或儲存草稿要求，請執行下列一或多項操作：
在「Prefix」(前置字串) 欄位中，輸入為這項未來預留項目要求佈建的自動建立預留項目，指定新的名稱前置字串。
在「說明」中，輸入新的說明。
修改未來預訂要求的開始時間或結束時間。請確認您做到了以下各項：
在「Share type」(共用類型) 部分，選取「Local」(本機) 或「Shared」(共用)。如果選取「共用」，您可以新增或移除專案，與這些專案共用未來預留項目要求。最多可納入 100 個專案。
在「Number of VM instances」(VM 執行個體數量) 欄位中，輸入要預留的 VM 總數。
如果您要修改的預訂項目並非透過執行個體範本建立，則可以在「機器設定」部分變更下列項目：
預留 VM 中使用的機器系列和機器類型。
要附加至預留 VM 的 GPU。
預留 VM 的本機 SSD 磁碟和磁碟介面類型。
在「自動刪除系統自動產生的預留項目」部分，您可以啟用或停用未來預留項目要求的自動刪除功能。
視您要修改的未來預訂要求採購狀態而定，請執行下列其中一項操作：
如要修改未來預留項目要求草稿，請採取下列任一做法：
如要儲存變更，請按一下「儲存草稿」。
如要將草稿未來預留項目要求提交給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：未來預訂要求所在的區域。
替換下列一或多個預留位置，或移除這些預留位置和對應的旗標：
如要讓 Compute Engine 在預留項目期限結束後，自動刪除自動建立的預留項目，請採取下列任一做法：
如要在結束時間後的兩小時內刪除預留項目 (預設)，請加入
--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替換為天數、時數、分鐘數或秒數。舉例來說，指定30m代表 30 分鐘，指定1d2h3m4s則代表 1 天 2 小時 3 分鐘 4 秒。
如要禁止 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 要新增的 GPU 數量。ACCELERATOR_TYPE：要新增至預留 VM 的 GPU 類型。確認該區域提供 GPU，且未來預留項目要求位於該區域。否則修改要求會失敗。
如要移除所有已連結至預留 N1 VM 的 GPU，請將
--accelerator旗標替換為--clear-accelerator旗標。
DESCRIPTION：日後預訂要求的新說明。如要從預留 VM 新增或移除本機 SSD 磁碟，或編輯本機 SSD 磁碟介面類型，請執行下列其中一項操作：
如要新增本機 SSD 磁碟或編輯磁碟介面類型，請將
INTERFACE替換為下列其中一個值：如果開機磁碟映像檔具有最佳化 NVMe 驅動程式：
nvme。否則請說出「
scsi」。
加入
--local-ssd旗標，新增所需數量的本機 SSD 磁碟。最多可以指定 24 個本機 SSD 磁碟。如要移除所有附加至預留 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標記中指定至少一個消費者專案。
CONSUMER_PROJECT_IDS：以逗號分隔的專案 ID 清單，用於指定要與哪些專案分享日後的預訂要求，例如project-1,project-2。最多可指定 100 個消費者專案。START_TIME：預訂期間的新開始時間，格式為 RFC 3339 時間戳記。開始時間不得晚於您提交修改要求以供審查的日期和時間後一年。如要確保有足夠時間在未來預訂項目獲得核准後，以及進入鎖定時間前，選擇取消、刪除或修改預訂項目，請指定建議開始時間。END_TIME：預訂期間的新結束時間，格式為 RFC 3339 時間戳記。為提高Google Cloud 在您提交要求後核准要求的可能性，請指定建議的最短預訂時間。如要指定時間長度而非結束時間，請將--end-time旗標換成--duration=END_DURATION旗標。將END_DURATION替換為預訂期間長度 (以秒為單位)。例如，如要指定 1,209,600 秒 (14 天)，請使用1209600。TOTAL_COUNT：您希望在指定期間、VM 設定和專案中預留的 VM 總數。如要增加總數，請確認您有足夠的配額，可預留需要的資源。否則 Google Cloud 會拒絕你的修改要求。
舉例來說，假設您有名為
fr-03的共用未來預留項目要求草稿，位於us-central1-a區域。假設您想修改這項共用未來預留項目要求，進行下列變更：將要求轉換為單一專案的未來預留項目要求。
停用自動刪除選項。
預留 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-aREST
如要修改未來預留項目要求，請對
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查詢參數中指定欄位，系統就會刪除該欄位。舉例來說，如要更新未來預留要求中的
autoDeleteAutoCreatedReservations、totalCount和endTime欄位，請指定下列項目：autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTimePLANNING_STATUS：未來預訂要求的規劃狀態。請指定下列其中一個值：如要修改草稿未來預留項目要求，但暫不提交審查：
DRAFT。如要提交修改要求以供審查，請按照
SUBMITTED操作。
替換下列一或多個預留位置，或移除預留位置和對應的欄位：
AUTO_DELETE_AUTO_CREATED_RESERVATIONS：如果將這個欄位設為true，Compute Engine 會自動刪除為您日後的預訂要求佈建的自動建立預訂。預設情況下，系統會在預訂時間結束後的兩小時內刪除資料。如要變更這項設定，請採取下列任一做法：如要在預留期間結束後的特定時間刪除自動建立的預留項目，請將
autoDeleteAutoCreatedReservations設為true，並指定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 時間戳記。如要在預留期間開始後的特定時間刪除自動建立的預留項目，請將
autoDeleteAutoCreatedReservations設為true，並指定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_1和CONSUMER_PROJECT_ID_2：您要與之共用未來預留項目要求的專案 ID。專案必須與擁有者專案位於相同機構。最多可指定 100 個消費者專案。SHARE_TYPE：未來預訂要求的新分享類型。執行下列其中一個步驟：如要指定單一專案的未來預留項目要求，請執行下列步驟：
指定
LOCAL。移除
shareSettings.projects欄位。
如要指定共用的未來預留項目要求，請按照下列步驟操作：
指定
SPECIFIC_PROJECTS。在
shareSettings.projects欄位中指定至少一個消費端專案。消費者專案必須與擁有者專案位於同一個機構。最多可指定 100 個消費者專案。
如要變更要附加至預留 N1 VM 的 GPU 數量和類型，請替換下列項目：
NUMBER_OF_ACCELERATORS：每個預留 VM 要新增的 GPU 數量。ACCELERATOR_TYPE：要新增至預留 VM 的 GPU 類型。確認該區域提供 GPU，且未來預留項目要求位於該區域。否則修改要求會失敗。
INTERFACE_1和INTERFACE_2：附加至每個預留 VM 的本機 SSD 磁碟介面類型。請指定下列其中一個值：如果開機磁碟映像檔具有最佳化 NVMe 驅動程式：
NVME。否則請說出「
SCSI」。最多可以指定 24 個本機 SSD 磁碟。
MACHINE_TYPE：每個預留 VM 要使用的新機器類型。如果變更機器類型，請一併指定建議的最低預訂期限，適用於新的機器系列。否則 Google Cloud 不太可能核准您的修改要求。MINIMUM_CPU_PLATFORM：每個預留 VM 的新 CPU 平台基本要求。TOTAL_COUNT：您希望在指定期間、VM 設定和專案中預留的 VM 總數。如要增加總數，請確認您有足夠的配額，可預留需要的資源。否則 Google Cloud 會拒絕你的修改要求。START_TIME：預訂期間的新開始時間，格式為 RFC 3339 時間戳記。開始時間不得晚於您提交修改要求以供審查的日期和時間後一年。如要確保有足夠時間在未來預訂項目獲得核准後，以及進入鎖定時間前，選擇取消、刪除或修改預訂項目，請指定建議開始時間。END_TIME：預訂期間的新結束時間，格式為 RFC 3339 時間戳記。為提高Google Cloud 在提交要求後核准要求的可能性，請指定最短預訂時間。如要指定時間長度而非結束時間，請將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。
舉例來說，假設您有名為
fr-03的共用未來預留項目要求草稿，位於us-central1-a區域。假設您想修改這項共用未來預留項目要求，進行下列變更：將要求轉換為單一專案的未來預留項目要求。
停用自動刪除選項。
預留 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" } }修改未來預留項目要求後，您可以查看未來預留項目要求的詳細資料，監控採購或更新狀態。
變更未來預留項目要求的其他屬性
如要變更建立未來預留項目要求後無法修改的屬性，且要求尚未獲得核准並進入鎖定時間，請按照下列步驟操作：
如要停止未來預留項目要求，限制您在專案中或與未來預留項目要求共用的專案中建立的未來預留項目要求類型，請刪除未來預留項目要求。
建立新的單一專案或共用未來預留項目要求，並加入所需更新。
疑難排解
如果修改未來預留項目要求時發生錯誤，請參閱如何排解未來預留項目要求的問題。
如果排解問題後仍遇到問題，請與您的帳戶代表或Google Cloud 支援團隊聯絡。
後續步驟
瞭解如何查看未來預留項目要求。
瞭解如何取消或刪除未來的預訂要求。
預留項目期間開始後，請參閱這篇文章，瞭解如何耗用自動建立的預留項目。
預留項目期限結束後，請參閱這篇文章，瞭解如何修改自動建立的預留項目。
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-09-04 (世界標準時間)。
-