本頁面由 Cloud Translation API 翻譯而成。

建立共用的未來預留項目要求
透過集合功能整理內容你可以依據偏好儲存及分類內容。

本文說明如何建立共用未來預留項目要求。

如果 Google Cloud 核准共用未來預留要求，Compute Engine 就會在要求中指定的開始時間自動建立共用於多個專案的預留項目。這些自動建立的共用預留項目會由相符的 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
1. After installing the Google Cloud CLI, initialize it by running the following command:
  gcloud init
  If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
  
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.
REST

To use the REST API samples on this page in a local development environment, you use the credentials you provide to the gcloud CLI.
For more information, see Authenticate for using REST in the Google Cloud authentication documentation.

必要的角色

如要取得建立共用未來預留項目要求所需的權限，請要求管理員為您授予專案的 Compute Future Reservation User (roles/compute.futureReservationUser) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。

這個預先定義的角色包含建立共用未來預留項目要求所需的權限。如要查看確切的必要權限，請展開「必要權限」部分：

所需權限

如要建立共用未來預留項目要求，必須具備下列權限：

如要建立未來預留項目要求，請按照下列步驟操作： compute.futureReservations.create 在專案中
如要讓 Compute Engine 自動建立訂位，請按照下列步驟操作： compute.reservations.create 在專案中
如要指定執行個體範本：在執行個體範本中使用 compute.instanceTemplates.useReadOnly

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

限制

除了一般未來預留項目的限制外，建立共用未來預留項目要求時，還須遵守下列限制：

您用來建立共用未來預留項目要求的專案 (擁有者專案)，必須由組織政策管理員新增至「共用預留項目擁有者專案」 (compute.sharedReservationsOwnerProjects) 組織政策限制的許可清單。詳情請參閱 Compute Engine 預留資源說明文件中的「允許及限制專案建立及修改共用預留資源」。
如果您將建立共用未來預留項目要求的專案移至其他組織，系統會刪除共用未來預留項目。系統不會自動將專案從「共用保留項目擁有者專案」(compute.sharedReservationsOwnerProjects) 機構政策限制中移除，但您可以視需要從這項限制中移除專案。
每項共用未來預留要求最多可與 100 個用戶專案共用。
針對每個組織，您最多可為每個 VM 屬性組合建立 100 個共用未來預留要求。

建立草稿要求

建立未來預留要求時，您可以將要求儲存為草稿，稍後再提交給 Google Cloud 進行審查，也可以直接提交審查要求。Google 建議您先建立草稿要求，這樣您就能決定 Compute Engine 為您的要求配置的 VM 數量，而非手動估算這項數量，並視需要修改要求中的保留 VM 數量，再提交審查。

如要使用系統自動建立的未來預留項目，VM 必須具備與該預留項目「完全相符」的屬性。如要透過建立未來預留項目要求草稿來指定要保留的 VM 屬性，請使用下列任一方法：

建議做法：指定執行個體範本

您可以使用現有的執行個體範本，定義未來預留要求的草稿屬性。使用執行個體範本，您可以定義未來預留要求的屬性，以及可在同一位置使用自動建立的預留項目的 VM。不過，由於範本是專屬於專案，因此您無法使用相同的範本，在建立未來預留要求的專案以外建立可使用自動建立的預留項目的 VM。針對未來預留項目共用到的專案，您必須在這些專案中建立類似的範本，或直接指定屬性來建立 VM。
指定現有 VM

您可以使用現有的 VM 定義未來預留要求的屬性。您可以使用現有 VM 的屬性，建立屬性與參考 VM 相符的 VM，藉此使用為未來預留項目自動建立的預留項目。
直接指定屬性

您可以直接定義未來預留項目要求的草稿屬性。使用這個方法時，您必須手動確認 VM 的屬性與自動建立的預留項目「完全相符」，否則任何不相符的屬性都會導致無法使用。

任何具有相符屬性的 VM 都能自動使用自動建立的未來預留項目。如果您不希望 VM 使用任何自動建立的預留項目，請參閱不使用預留項目建立 VM。

指定執行個體範本

透過指定執行個體範本建立共用未來預留項目要求時，請考量以下事項：

執行個體範本包含專案專屬設定，因此您只能在同一個專案中存取及使用執行個體範本。如果您透過指定執行個體範本建立共用未來預留要求，則必須建立類似的範本來建立 VM，或是直接指定相符的屬性來建立 VM，以便在每個使用者專案中使用自動建立的預留項目。
您必須在執行個體範本中的資源所在的區域和可用區中，建立未來預留要求。在執行個體範本中指定的任何區域或區域資源 (例如機器類型或永久磁碟)，都會將範本的使用限制在這些資源所在的位置。舉例來說，如果執行個體範本指定 us-central1-a 區域中現有的永久磁碟，您就必須在同一個區域中建立未來的預留要求。否則，建立未來預留項目要求會失敗。

如要確認現有範本是否指定任何資源，將範本與特定區域或可用區綁定，請查看範本的詳細資料，並尋找其中的區域或可用區資源參照。
如果您想將自動建立的預留項目附加至承諾產品，以便為未來預留項目提供佈建資源，則必須停用自動刪除選項。詳情請參閱「建立後的限制」。

建立未來預留要求後，您就無法修改未來預留要求，以覆寫範本的 VM 屬性或指定其他範本。相反地，如果您需要變更要求中指定的 VM 屬性，則必須建立新的未來預留要求。

如要透過指定現有執行個體範本建立共用的未來預留項目，請選取下列任一選項：

主控台

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

前往「預留項目」
點按「Future reservations」(未來預留項目) 分頁標籤。
點按 「Create future reservation」(建立未來預留項目)。

「Create a future reservation」(建立未來預留項目) 頁面會隨即開啟。
在「名稱」部分，輸入未來預留要求的名稱。
在「Prefix」中輸入名稱前置字串。這項未來預留項目要求中自動建立的每個預留項目名稱，開頭都會加上這個前置字串。
在「區域」和「可用區」部分，選取要保留資源的區域和可用區。
在「Start time」(開始時間) 中，輸入預訂期間的開始時間。開始時間不得晚於您提交未來預留要求的審查日期和時間的一年後。如要讓使用者有充足的時間選擇修改、取消或刪除未來預留項目，請在該預留項目進入鎖定時間前，指定建議的開始時間值。
在「結束時間」中，輸入預訂期間的結束時間，最少為 14 天。在「Duration summary」部分，您可以查看預訂期間的長度。為提高 Google Cloud審查未來預訂要求後核准的可能性，請務必指定預訂期間的建議值。
在「分享類型」專區，執行以下操作：
1. 如要指定共用的未來預留項目要求，請選取「共用」。
2. 按一下「新增專案」，然後從目前專案的機構中選取要共用未來預訂要求的專案。最多可選取 100 個專案。
在「所需總容量」部分，輸入您想在未來預留項目要求中指定的期間、VM 設定和專案的 VM 總數。

重要事項： 請確認您有足夠的配額，可以預留所要求的資源。否則，如果您提交未來預留要求以供審查， Google Cloud 會拒絕該要求。
在「機器設定」專區中，執行下列操作：
1. 選取「使用執行個體範本」。
2. 在「Instance template」(執行個體範本) 中，選取所需的執行個體範本。如果您選取區域執行個體範本，則只能預留範本所在區域內的資源。
在「自動刪除系統自動產生的預留項目」部分，執行下列任一操作：
- 如要讓 Compute Engine 自動刪除自動建立的未來預留要求預留項目，請按照下列步驟操作：
  
  警告： 如果啟用自動刪除選項，無論自動建立的預留項目是否用盡，都會在指定的刪除時間刪除。
  1. 如果尚未設定「啟用自動刪除」切換鈕，請將其設為開啟。
  2. 選用：在「自動刪除時間」中，輸入自動建立的預留項目刪除日期和時間。日期和時間必須晚於預訂期結束時間。如果您將這個欄位留空，自動建立的預留項目就會在預留期間結束後的兩小時內刪除。
- 否則請將「啟用自動刪除功能」切換鈕設為關閉。
如要完成建立未來預留項目要求草稿，請點按「Save a draft」(儲存草稿)。

「Reservations」(保留項目) 頁面隨即開啟。建立未來預留項目要求可能需要一分鐘的時間。

gcloud

如要透過指定執行個體範本建立共用未來保留要求，請使用 gcloud beta compute future-reservations create 指令搭配 --share-setting=projects 和 --share-with 標記。

如要透過指定執行個體範本建立未來預留項目要求，且不包含任何選用標記，並在預留期間結束時自動刪除自動建立的預留項目，請執行下列指令：

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

更改下列內容：

FUTURE_RESERVATION_NAME：未來預訂要求的名稱。
MACHINE_TYPE：每個保留的 VM 所使用的機器類型。

CONSUMER_PROJECT_IDS：以半形逗號分隔的清單，列出您要允許使用此未來預訂要求自動建立的預訂項目的專案 ID，例如 project-1,project-2。您最多可以指定 100 個專案。這些專案必須屬於與建立未來預留項目的專案 (擁有者專案) 相同的機構。請勿指定擁有者專案。根據預設，系統已允許使用自動建立的預留項目，以便處理這個未來預留要求。

PROJECT_ID：您要保留資源的專案 ID，以及執行個體範本所在位置。
LOCATION：執行個體範本的位置。請指定下列任一值：
- 區域執行個體範本： regions/REGION。將 REGION 替換為執行個體範本所在的區域。如果您指定區域執行個體範本，則只能在範本所在區域內建立未來預留要求。
- 全域執行個體範本：global。
INSTANCE_TEMPLATE_NAME：現有執行個體範本的名稱。

START_TIME：預留期間的開始時間，以 RFC 3339 時間戳記格式表示，格式必須如下：
```
YYYY-MM-DDTHH:MM:SSOFFSET
```
更改下列內容：
- YYYY-MM-DD：以 4 位數年份、2 位數月份和 2 位數日的格式儲存資料，並以連字號分隔 (-)。
- HH:MM:SS：以 24 小時制時間、2 位數分鐘和 2 位數秒的格式表示時間，並以冒號 (:) 分隔。
- OFFSET：時區以世界標準時間 (UTC) 為基準的偏移值。舉例來說，如要使用太平洋標準時間 (PST)，請指定 -08:00。或者，如要使用無偏移，請指定 Z。
開始時間不得晚於您提交未來預留要求的日期和時間的一年後。為確保有足夠的時間，可在未來預訂要求獲得核准後，在進入鎖定時間前，視需要取消、刪除或修改該要求，請指定建議的開始時間值。
END_TIME：預留期間的結束時間，格式為 RFC 3339 時間戳記。為提高Google Cloud 在您提交後核准要求的可能性，請指定最短預訂期。如要指定時間長度而非結束時間，請將 --end-time 標記替換為 --duration=END_DURATION 標記。將 END_DURATION 替換為以秒為單位的時間長度。例如，指定 1209600 為 1,209,600 秒 (14 天)。

如要提高 Google Cloud 核准未來預訂要求的可能性，請在提交審查前指定建議的最短時間長度。

重要事項： 為避免在建立未來預留要求時發生錯誤，請確認預留期間不會與其他現有未來預留要求的預留期間重疊，且該要求與 VM 屬性和區域相符，並且是在您目前專案中建立或與該專案共用。如要概略瞭解未來預留項目要求的預留期間，請查看未來預留項目要求清單。
TOTAL_COUNT：您要保留的 VM 總數。
ZONE：預留資源的所在區域。

舉例來說，假設您想在區域 us-central1-a 中建立名為 fr-02 的未來預留項目草稿要求，並使用以下屬性：

預訂期間從 2024 年 11 月 10 日 (世界標準時間) 午夜開始，至 2024 年 12 月 10 日 (世界標準時間) 午夜結束。
VM 總數為 80 個。

來自區域 us-central1 的區域執行個體範本。

已啟用自動刪除選項。系統會在預留期間結束時刪除自動建立的預留項目。

未來預留項目要求會與 project-1 和 project-2 共用。

如要建立 fr-02，請執行下列指令：

gcloud beta compute future-reservations create fr-02 \
    --auto-delete-auto-created-reservations \
    --share-setting=projects \
    --share-with=project-1,project-2 \
    --source-instance-template=projects/example-project/regions/us-central1/instanceTemplates/example-template \
    --start-time=2024-11-10T00:00:00Z \
    --end-time=2024-12-10T00:00:00Z \
    --total-count=80 \
    --zone=us-central1-a

您也可以選擇執行下列一或多項操作：

如要在預留期間結束後刪除自動建立的預留項目，請選取下列任一方法：

如要在預留期間結束時間過後的特定日期和時間，刪除自動建立的預留項目，請納入 --auto-created-reservations-delete-time 標記。

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \
    --auto-delete-auto-created-reservations \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

將 AUTO_CREATED_RESERVATIONS_DELETE_TIME 替換為以 RFC 3339 時間戳記格式設定的日期和時間。

如要在保留期間結束時間後的特定時間內刪除自動建立的預留項目，請加入 --auto-created-reservations-duration 標記。

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-created-reservations-duration=DURATION_BEFORE_DELETE \
    --auto-delete-auto-created-reservations \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

將 DURATION_BEFORE_DELETE 替換為以天、小時、分鐘或秒為單位的時間長度。例如，指定 30m 為 30 分鐘，或 1d2h3m4s 為 1 天、2 小時、3 分鐘和 4 秒。

如要停用自動建立的預留項目的自動刪除選項，請將 --auto-delete-auto-created-reservations 標記替換為 --no-auto-delete-auto-created-reservations 標記。

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --no-auto-delete-auto-created-reservations \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

如要為自動建立的預留項目指定名稱前置字串，請加入 --name-prefix 標記。

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --name-prefix=NAME_PREFIX \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

將 NAME_PREFIX 替換為每個自動建立的預留項目名稱前置字串。為協助您識別這項未來預留要求的自動建立預留項目， Google Cloud 建議您指定不重複的名稱前置字串。

REST

如要透過指定執行個體範本建立共用未來預留要求，請對 beta.futureReservations.insert 方法發出 POST 要求。

如要透過指定執行個體範本建立未來預留項目草稿，且不包含任何選用欄位，請發出 POST 要求，如下所示：

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME",
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

更改下列內容：

PROJECT_ID：您要保留資源的專案 ID，以及執行個體範本所在位置。
ZONE：預留資源的所在區域。
AUTO_DELETE_AUTO_CREATED_RESERVATIONS：如果您將這個欄位設為 true，Compute Engine 就會在預留期間結束後的兩小時內，自動刪除這項未來預留項目的預留項目。如要將自動建立的保留項目附加至承諾，請將這個欄位設為 false。

CONSUMER_PROJECT_ID_1 和 CONSUMER_PROJECT_ID_2：這項未來預留要求可共用哪些專案的 ID。您最多可以指定 100 個專案。這些專案必須屬於與建立未來預留項目的專案 (擁有者專案) 相同的機構。請勿指定擁有者專案。根據預設，系統已允許使用自動建立的預留項目，以便處理這個未來預留要求。

LOCATION：執行個體範本的位置。請指定下列任一值：
- 區域執行個體範本： regions/REGION。將 REGION 替換為執行個體範本所在的區域。如果您指定區域執行個體範本，則只能在範本所在區域內建立未來預留要求。
- 全域執行個體範本：global。
INSTANCE_TEMPLATE_NAME：現有執行個體範本的名稱。

TOTAL_COUNT：您要保留的 VM 總數。
START_TIME：預留期間的開始時間，以 RFC 3339 時間戳記格式表示，格式必須如下：
```
YYYY-MM-DDTHH:MM:SSOFFSET
```
更改下列內容：
- YYYY-MM-DD：以 4 位數年份、2 位數月份和 2 位數日的格式儲存資料，並以連字號分隔 (-)。
- HH:MM:SS：以 24 小時制時間、2 位數分鐘和 2 位數秒的格式表示時間，並以冒號 (:) 分隔。
- OFFSET：時區以世界標準時間 (UTC) 為基準的偏移值。舉例來說，如要使用太平洋標準時間 (PST)，請指定 -08:00。或者，如要使用無偏移，請指定 Z。
開始時間不得晚於您提交未來預留要求的日期和時間的一年後。為確保有足夠的時間，可在未來預訂要求獲得核准後，在進入鎖定時間前，視需要取消、刪除或修改該要求，請指定建議的開始時間值。
END_TIME：預留期間的結束時間，格式為 RFC 3339 時間戳記。為提高Google Cloud 在您提交後核准要求的可能性，請指定最短預訂期。如要指定時間長度，而非結束時間，您可以將 endTime 欄位替換為 duration 欄位：
```
"duration": {
  "seconds": END_DURATION
}
```
將 END_DURATION 替換為以秒為單位的時間長度。例如，將 1209600 指定為 1,209,600 秒 (14 天)。

重要事項： 為避免在建立未來預留要求時發生錯誤，請確認預留期間不會與其他現有未來預留要求的預留期間重疊，且該要求與 VM 屬性和區域相符，並且是在您目前專案中建立或與該專案共用。如要概略瞭解未來預留項目要求的預留期間，請查看未來預留項目要求清單。

舉例來說，假設您想在區域 us-central1-a 中建立名為 fr-02 的未來預留項目草稿要求，並使用以下屬性：

預訂期間從 2024 年 11 月 10 日 (世界標準時間) 午夜開始，至 2024 年 12 月 10 日 (世界標準時間) 午夜結束。
VM 總數為 80 個。

來自區域 us-central1 的區域執行個體範本。

已啟用自動刪除選項。系統會在預留期間結束時刪除自動建立的預留項目。

未來預留項目要求會與 project-1 和 project-2 共用。

如要建立 fr-02，請發出 POST 要求，如下所示：

POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations

{
  "autoDeleteAutoCreatedReservations": true,
  "name": "fr-02",
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/example-project/regions/us-central1/instanceTemplates/example-template",
    "totalCount": 80
  },
  "shareSettings": {
    "projects": [
      "project-1",
      "project-2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "timeWindow": {
    "startTime": "2024-11-10T00:00:00Z",
    "endTime": "2024-12-10T00:00:00Z"
  }
}

您也可以選擇執行下列一或多項操作：

如要為自動建立的預留項目指定名稱前置字串，請加入 namePrefix 欄位。

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME",
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

如要在預留期間結束後刪除自動建立的預留項目，請選取下列任一方法：

如要在預留期間結束後的特定時間後刪除自動建立的預留項目，請將 autoDeleteAutoCreatedReservations 設為 true，並加入 autoCreatedReservationsDeleteTime 欄位。

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoCreatedReservationsDeleteTime": "DELETE_TIME",
  "autoDeleteAutoCreatedReservations": true,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME",
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

將 DELETE_TIME 替換為 Compute Engine 刪除自動建立的預留項目的日期和時間。日期和時間必須採用 RFC 3339 時間戳記格式。

如要在預留期間開始時間的特定時間後刪除自動建立的預留項目，請將 autoDeleteAutoCreatedReservations 設為 true，並納入 autoCreatedReservationsDuration 欄位。

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoCreatedReservationsDuration": {
    "seconds": "DURATION_BEFORE_DELETE"
  },
  "autoDeleteAutoCreatedReservations": true,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME",
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

將 DURATION_BEFORE_DELETE 替換為秒數。例如，指定 604800 為 604,800 秒 (7 天)。

建立未來預留要求草稿後，您可以決定 Compute Engine 為要求配置的 VM 數量。

指定現有的 VM

您只能根據與 VM 位於相同專案和區域的現有 VM，建立未來預留項目要求草稿。

當未來預留要求獲得 Google Cloud 核准並進入預留期間後，您可以建立屬性與參考 VM 相符的 VM，以便使用自動建立的預留項目。方法如下：

建立並使用執行個體範本，步驟如下：
1. 根據參照 VM 建立執行個體範本，而不覆寫參照 VM 的屬性。
  
  注意： 您無法在 VM 專案以外的環境中，根據參考 VM 建立執行個體範本。對於與預留項目共用的專案，您必須在這些專案中建立類似的執行個體範本。
2. 如要使用新建立的範本建立 VM，請執行下列一項或兩項操作：
  - 建立單一 VM
  - 建立可用區代管執行個體群組 (MIG)
建立 VM 時，請使用與參考 VM 完全相符的屬性，如下所示：
- 在擁有者專案中，根據參考 VM 建立 VM，但不要變更要建立的 VM 屬性。
- 在消費者專案中建立 VM，並手動確認其屬性和參照 VM 的屬性相符。

如要建立使用現有 VM 屬性的共用未來預留要求，請執行下列操作：

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

前往「預留項目」
點按「Future reservations」(未來預留項目) 分頁標籤。
點按 「Create future reservation」(建立未來預留項目)。

「Create a future reservation」(建立未來預留項目) 頁面會隨即開啟。
在「名稱」部分，輸入未來預留要求的名稱。
在「Prefix」中輸入名稱前置字串。這項未來預留項目要求中自動建立的每個預留項目名稱，開頭都會加上這個前置字串。
在「區域」和「可用區」部分，選取要保留資源的區域和可用區。
在「Start time」(開始時間) 中，輸入預訂期間的開始時間。開始時間不得晚於您提交未來預留要求的審查日期和時間的一年後。如要讓使用者有充足的時間選擇修改、取消或刪除未來預留項目，請在該預留項目進入鎖定時間前，指定建議的開始時間值。
在「結束時間」中，輸入預訂期間的結束時間，最少為 14 天。在「Duration summary」部分，您可以查看預訂期間的長度。為提高 Google Cloud審查未來預訂要求後核准的可能性，請務必指定預訂期間的建議值。
在「分享類型」專區，執行以下操作：
1. 如要指定共用的未來預留項目要求，請選取「共用」。
2. 按一下「新增專案」，然後從目前專案的機構中選取要共用未來預訂要求的專案。最多可選取 100 個專案。
在「所需總容量」部分，輸入您想在未來預留項目要求中指定的期間、VM 設定和專案的 VM 總數。

重要事項： 請確認您有足夠的配額，可以預留所要求的資源。否則，如果您提交未來預留要求以供審查， Google Cloud 會拒絕該要求。
在「機器設定」專區中，執行下列操作：
1. 選取「Use existing VM」。
2. 針對「現有 VM」，選取要用來建立預留項目的 VM 屬性。
在「自動刪除系統自動產生的預留項目」部分，執行下列任一操作：
- 如要讓 Compute Engine 自動刪除自動建立的未來預留要求預留項目，請按照下列步驟操作：
  
  警告： 如果啟用自動刪除選項，無論自動建立的預留項目是否用盡，都會在指定的刪除時間刪除。
  1. 如果尚未設定「啟用自動刪除」切換鈕，請將其設為開啟。
  2. 選用：在「自動刪除時間」中，輸入自動建立的預留項目刪除日期和時間。日期和時間必須晚於預訂期結束時間。如果您將這個欄位留空，自動建立的預留項目就會在預留期間結束後的兩小時內刪除。
- 否則請將「啟用自動刪除功能」切換鈕設為關閉。
如要完成建立未來預留項目要求草稿，請點按「Save a draft」(儲存草稿)。

「Reservations」(保留項目) 頁面隨即開啟。建立未來預留項目要求可能需要一分鐘的時間。

建立未來預留要求草稿後，您可以決定 Compute Engine 為要求配置的 VM 數量。

直接指定屬性

如果您想將自動建立的預留項目附加至承諾產品，以便為未來預留項目提供佈建資源，則必須停用自動刪除選項。詳情請參閱「建立後的限制」。

如要直接指定屬性來建立共用的未來預留要求，請選取下列其中一個選項：

主控台

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

前往「預留項目」
點按「Future reservations」(未來預留項目) 分頁標籤。
點按 「Create future reservation」(建立未來預留項目)。

「Create a future reservation」(建立未來預留項目) 頁面會隨即開啟。
在「名稱」部分，輸入未來預留要求的名稱。
在「Prefix」中輸入名稱前置字串。這項未來預留項目要求中自動建立的每個預留項目名稱，開頭都會加上這個前置字串。
在「區域」和「可用區」部分，選取要保留資源的區域和可用區。
在「Start time」(開始時間) 中，輸入預訂期間的開始時間。開始時間不得晚於您提交未來預留要求的審查日期和時間的一年後。如要讓使用者有充足的時間選擇修改、取消或刪除未來預留項目，請在該預留項目進入鎖定時間前，指定建議的開始時間值。
在「結束時間」中，輸入預訂期間的結束時間，最少為 14 天。在「Duration summary」部分，您可以查看預訂期間的長度。為提高 Google Cloud審查未來預訂要求後核准的可能性，請務必指定預訂期間的建議值。
在「分享類型」專區，執行以下操作：
1. 如要指定共用的未來預留項目要求，請選取「共用」。
2. 按一下「新增專案」，然後從目前專案的機構中選取要共用未來預訂要求的專案。最多可選取 100 個專案。
在「所需總容量」部分，輸入您想在未來預留項目要求中指定的期間、VM 設定和專案的 VM 總數。

重要事項： 請確認您有足夠的配額，可以預留所要求的資源。否則，如果您提交未來預留要求以供審查， Google Cloud 會拒絕該要求。
在「機器設定」專區中，執行下列操作：
1. 如果尚未選取「指定機器類型」，請選取這個選項。
2. 指定要用於保留 VM 的機器類型。
在「自動刪除系統自動產生的預留項目」部分，執行下列任一操作：
- 如要讓 Compute Engine 自動刪除自動建立的未來預留要求預留項目，請按照下列步驟操作：
  
  警告： 如果啟用自動刪除選項，無論自動建立的預留項目是否用盡，都會在指定的刪除時間刪除。
  1. 如果尚未設定「啟用自動刪除」切換鈕，請將其設為開啟。
  2. 選用：在「自動刪除時間」中，輸入自動建立的預留項目刪除日期和時間。日期和時間必須晚於預訂期結束時間。如果您將這個欄位留空，自動建立的預留項目就會在預留期間結束後的兩小時內刪除。
- 否則請將「啟用自動刪除功能」切換鈕設為關閉。
如要完成建立未來預留項目要求草稿，請點按「Save a draft」(儲存草稿)。

「Reservations」(保留項目) 頁面隨即開啟。建立未來預留項目要求可能需要一分鐘的時間。

gcloud

如要直接指定屬性來建立共用未來預訂要求，請使用 gcloud beta compute future-reservations create 指令搭配 --share-setting=projects 和 --share-with 標記。

如要直接指定屬性建立未來預留項目草稿，且不包含任何選用標記，並在預留期間結束時自動刪除自動建立的預留項目，請執行下列指令：

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

更改下列內容：

FUTURE_RESERVATION_NAME：未來預訂要求的名稱。
MACHINE_TYPE：每個保留的 VM 所使用的機器類型。

CONSUMER_PROJECT_IDS：以半形逗號分隔的清單，列出您要允許使用此未來預訂要求自動建立的預訂項目的專案 ID，例如 project-1,project-2。您最多可以指定 100 個專案。這些專案必須屬於與建立未來預留項目的專案 (擁有者專案) 相同的機構。請勿指定擁有者專案。根據預設，系統已允許使用自動建立的預留項目，以便處理這個未來預留要求。

START_TIME：預留期間的開始時間，以 RFC 3339 時間戳記格式表示，格式必須如下：
```
YYYY-MM-DDTHH:MM:SSOFFSET
```
更改下列內容：
- YYYY-MM-DD：以 4 位數年份、2 位數月份和 2 位數日的格式儲存資料，並以連字號分隔 (-)。
- HH:MM:SS：以 24 小時制時間、2 位數分鐘和 2 位數秒的格式表示時間，並以冒號 (:) 分隔。
- OFFSET：時區以世界標準時間 (UTC) 為基準的偏移值。舉例來說，如要使用太平洋標準時間 (PST)，請指定 -08:00。或者，如要使用無偏移，請指定 Z。
開始時間不得晚於您提交未來預留要求的日期和時間的一年後。為確保有足夠的時間，可在未來預訂要求獲得核准後，在進入鎖定時間前，視需要取消、刪除或修改該要求，請指定建議的開始時間值。
END_TIME：預留期間的結束時間，格式為 RFC 3339 時間戳記。為提高Google Cloud 在您提交後核准要求的可能性，請指定最短預訂期。如要指定時間長度而非結束時間，請將 --end-time 標記替換為 --duration=END_DURATION 標記。將 END_DURATION 替換為以秒為單位的時間長度。例如，指定 1209600 為 1,209,600 秒 (14 天)。

如要提高 Google Cloud 核准未來預訂要求的可能性，請在提交審查前指定建議的最短時間長度。

重要事項： 為避免在建立未來預留要求時發生錯誤，請確認預留期間不會與其他現有未來預留要求的預留期間重疊，且該要求與 VM 屬性和區域相符，並且是在您目前專案中建立或與該專案共用。如要概略瞭解未來預留項目要求的預留期間，請查看未來預留項目要求清單。
TOTAL_COUNT：您要保留的 VM 總數。
ZONE：預留資源的所在區域。

舉例來說，假設您想在區域 us-central1-a 中建立名為 fr-02 的未來預留項目草稿要求，並使用以下屬性：

預訂期間從 2024 年 11 月 10 日 (世界標準時間) 午夜開始，至 2024 年 12 月 10 日 (世界標準時間) 午夜結束。
VM 總數為 80 個。

具有 4 個 vCPU 的 N2 預先定義機器類型。

已啟用自動刪除選項。系統會在預留期間結束時刪除自動建立的預留項目。

未來預留項目要求會與 project-1 和 project-2 共用。

如要建立 fr-02，請執行下列指令：

gcloud beta compute future-reservations create fr-02 \
    --auto-delete-auto-created-reservations \
    --machine-type=n2-standard-4 \
    --share-setting=projects \
    --share-with=project-1,project-2 \
    --start-time=2024-11-10T00:00:00Z \
    --end-time=2024-12-10T00:00:00Z \
    --total-count=80 \
    --zone=us-central1-a

您也可以選擇執行下列一或多項操作：

如要將 GPU 附加至預留的 N1 VM，請加入 --accelerator 標記。

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --accelerator=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

更改下列內容：

NUMBER_OF_ACCELERATORS：每個預留 VM 要新增的 GPU 數量。
ACCELERATOR_TYPE：N1 VM 支援的 GPU 型號。為避免發生錯誤，請確認所選 GPU 型號適用於您建立未來預留要求的區域。

如要在預留期間結束後刪除自動建立的預留項目，請選取下列任一方法：

如要在預留期間結束時間過後的特定日期和時間，刪除自動建立的預留項目，請納入 --auto-created-reservations-delete-time 標記。

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

將 AUTO_CREATED_RESERVATIONS_DELETE_TIME 替換為以 RFC 3339 時間戳記格式設定的日期和時間。

如要在保留期間結束時間後的特定時間內刪除自動建立的預留項目，請加入 --auto-created-reservations-duration 標記。

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-created-reservations-duration=DURATION_BEFORE_DELETE \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

將 DURATION_BEFORE_DELETE 替換為以天、小時、分鐘或秒為單位的時間長度。例如，指定 30m 為 30 分鐘，或 1d2h3m4s 為 1 天、2 小時、3 分鐘和 4 秒。

如要停用自動建立的預留項目的自動刪除選項，請將 --auto-delete-auto-created-reservations 標記替換為 --no-auto-delete-auto-created-reservations 標記。

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --no-auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

如要將本機 SSD 磁碟連接至預設不包含本機 SSD 磁碟的機器類型，請加入 --local-ssd 標記。您只能連接 375 GB 的本機 SSD 磁碟。
```
gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --local-ssd=count=NUMBER_OF_LOCAL_SSD_DISKS,size=375,interface=INTERFACE_TYPE \
    --machine-type=MACHINE_TYPE \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE
```
更改下列內容：
- NUMBER_OF_LOCAL_SSD_DISKS：要附加的本機 SSD 磁碟數量。
- INTERFACE_TYPE：您希望本機 SSD 磁碟使用的磁碟介面類型，且您指定的機器類型支援。請指定下列其中一個值：
  - 針對 NVMe 磁碟介面：nvme
  - 針對 SCSI 磁碟介面：scsi

如要讓保留的 VM 使用特定最低 CPU 平台，而非區域的預設 CPU 平台，請加入 --min-cpu-platform 標記。

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --min-cpu-platform="MIN_CPU_PLATFORM" \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

將 MIN_CPU_PLATFORM 替換為最低 CPU 平台。如要確保您在預留資源的區域中可使用 CPU 平台，請依區域查看可用的 CPU 平台。

如要為自動建立的預留項目指定名稱前置字串，請加入 --name-prefix 標記。

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --name-prefix=NAME_PREFIX \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

REST

如要直接指定屬性來建立共用未來預訂要求，請對 beta.futureReservations.insert 方法發出 POST 要求。

如要直接指定屬性建立未來預留項目草稿，且不包含任何選用欄位，請發出以下 POST 要求：

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

更改下列內容：

PROJECT_ID：您要保留資源的專案 ID。
ZONE：預留資源的所在區域。
AUTO_DELETE_AUTO_CREATED_RESERVATIONS：如果您將這個欄位設為 true，Compute Engine 就會在預留期間結束後的兩小時內，自動刪除這項未來預留項目的預留項目。如要將自動建立的保留項目附加至承諾，請將這個欄位設為 false。

CONSUMER_PROJECT_ID_1 和 CONSUMER_PROJECT_ID_2：這項未來預留要求可共用哪些專案的 ID。您最多可以指定 100 個專案。這些專案必須屬於與建立未來預留項目的專案 (擁有者專案) 相同的機構。請勿指定擁有者專案。根據預設，系統已允許使用自動建立的預留項目，以便處理這個未來預留要求。

TOTAL_COUNT：您要保留的 VM 總數。
START_TIME：預留期間的開始時間，以 RFC 3339 時間戳記格式表示，格式必須如下：
```
YYYY-MM-DDTHH:MM:SSOFFSET
```
更改下列內容：
- YYYY-MM-DD：以 4 位數年份、2 位數月份和 2 位數日的格式儲存資料，並以連字號分隔 (-)。
- HH:MM:SS：以 24 小時制時間、2 位數分鐘和 2 位數秒的格式表示時間，並以冒號 (:) 分隔。
- OFFSET：時區以世界標準時間 (UTC) 為基準的偏移值。舉例來說，如要使用太平洋標準時間 (PST)，請指定 -08:00。或者，如要使用無偏移，請指定 Z。
開始時間不得晚於您提交未來預留要求的日期和時間的一年後。為確保有足夠的時間，可在未來預訂要求獲得核准後，在進入鎖定時間前，視需要取消、刪除或修改該要求，請指定建議的開始時間值。
END_TIME：預留期間的結束時間，格式為 RFC 3339 時間戳記。為提高Google Cloud 在您提交後核准要求的可能性，請指定最短預訂期。如要指定時間長度，而非結束時間，您可以將 endTime 欄位替換為 duration 欄位：
```
"duration": {
  "seconds": END_DURATION
}
```
將 END_DURATION 替換為以秒為單位的時間長度。例如，將 1209600 指定為 1,209,600 秒 (14 天)。

重要事項： 為避免在建立未來預留要求時發生錯誤，請確認預留期間不會與其他現有未來預留要求的預留期間重疊，且該要求與 VM 屬性和區域相符，並且是在您目前專案中建立或與該專案共用。如要概略瞭解未來預留項目要求的預留期間，請查看未來預留項目要求清單。

舉例來說，假設您想在區域 us-central1-a 中建立名為 fr-02 的未來預留項目草稿要求，並使用以下屬性：

預訂期間從 2024 年 11 月 10 日 (世界標準時間) 午夜開始，至 2024 年 12 月 10 日 (世界標準時間) 午夜結束。
VM 總數為 80 個。

具有 4 個 vCPU 的 N2 預先定義機器類型。

已啟用自動刪除選項。系統會在預留期間結束時刪除自動建立的預留項目。

未來預留項目要求會與 project-1 和 project-2 共用。

如要建立 fr-02，請發出 POST 要求，如下所示：

POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations

{
  "autoDeleteAutoCreatedReservations": true,
  "name": "fr-02",
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "n2-standard-4"
    },
    "totalCount": 80
  },
  "shareSettings": {
    "projects": [
      "project-1",
      "project-2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "timeWindow": {
    "startTime": "2024-11-10T00:00:00Z",
    "endTime": "2024-12-10T00:00:00Z"
  }
}

您也可以選擇執行下列一或多項操作：

如要為自動建立的預留項目指定名稱前置字串，請加入 namePrefix 欄位。

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

如要將 GPU 附加至已保留的 N1 VM，請加入 guestAccelerators 欄位。

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": {
    "instanceProperties": {
      "guestAccelerators": [
        {
          "acceleratorCount": NUMBER_OF_ACCELERATORS,
          "acceleratorType": "ACCELERATOR_TYPE"
        }
      ],
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

更改下列內容：

NUMBER_OF_ACCELERATORS：每個預留 VM 要新增的 GPU 數量。
ACCELERATOR_TYPE：N1 VM 支援的 GPU 型號。為避免發生錯誤，請確認所選 GPU 型號適用於您建立未來預留要求的區域。

如要將本機 SSD 磁碟連結至預設不包含本機 SSD 磁碟的機器類型，請在要求主體中加入 localSsds 欄位。您只能連接 375 GB 的本機 SSD 磁碟。

舉例來說，如要在建立未來預留要求草稿時指定兩個本機 SSD 磁碟，請提出以下 POST 要求：

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": {
    "instanceProperties": {
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_TYPE"
        },
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_TYPE"
        }
      ],
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

將 INTERFACE_TYPE 替換為您希望本機 SSD 磁碟使用的磁碟介面類型，且您指定的機器類型支援。請指定下列其中一個值：

針對 NVMe 磁碟介面：NVME
針對 SCSI 磁碟介面：SCSI

如要讓保留的 VM 使用特定最低 CPU 平台，而非區域的預設 CPU 平台，請加入 minCpuPlatform。

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": {
    "instanceProperties": {
      "machineType": "MACHINE_TYPE",
      "minCpuPlatform": "MINIMUM_CPU_PLATFORM"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

將 MIN_CPU_PLATFORM 替換為最低 CPU 平台。為確保您預留資源的區域提供 CPU 平台，請依區域查看可用的 CPU 平台。

如要在預留期間結束後刪除自動建立的預留項目，請選取下列任一方法：

如要在預留期間結束後的特定時間後刪除自動建立的預留項目，請將 autoDeleteAutoCreatedReservations 設為 true，並加入 autoCreatedReservationsDeleteTime 欄位。

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoCreatedReservationsDeleteTime": "DELETE_TIME",
  "autoDeleteAutoCreatedReservations": true,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

將 DELETE_TIME 替換為 Compute Engine 刪除自動建立的預留項目的日期和時間。日期和時間必須採用 RFC 3339 時間戳記格式。

如要在預留期間開始時間的特定時間後刪除自動建立的預留項目，請將 autoDeleteAutoCreatedReservations 設為 true，並納入 autoCreatedReservationsDuration 欄位。

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoCreatedReservationsDuration": {
    "seconds": "DURATION_BEFORE_DELETE"
  },
  "autoDeleteAutoCreatedReservations": true,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

將 DURATION_BEFORE_DELETE 替換為秒數。例如，指定 604800 為 604,800 秒 (7 天)。

建立未來預留要求草稿後，您可以決定 Compute Engine 為要求配置的 VM 數量。

提交草稿要求

未來預留項目要求提交後， Google Cloud會核准這項要求，並在鎖定時間過後，您只能在未來預留項目的預留期間結束後，才能刪除未來預留項目及其自動建立的預留項目。如果您需要使用相同的房源建立另一個未來預留項目，刪除現有的未來預留項目會很有幫助。因此，在建立未來預留要求之前，請先確認下列事項：

專案中的任何現有預留項目或未來預留項目，都會限制您建立的未來預留項目要求的分享設定。如要確保您能成功建立未來預留項目要求，且您的要求不會在您共用未來預留項目要求或預留項目的其他專案中造成問題，請參閱限制。
無論自動建立的預留項目是否已用盡，您都必須承諾支付 Compute Engine 在整個預訂期間提供的預留資源費用。詳情請參閱「帳單」。

如果您想在提交未來預留項目要求草稿供審查時修改一或多個屬性，請參閱「修改未來預留項目要求」。

如要將未來預留項目草稿提交給 Google Cloud 進行審查，請選取下列任一選項：

主控台

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

前往「預留項目」
點按「Future reservations」(未來預留項目) 分頁標籤。
在「名稱」欄中，按一下未來預訂要求的名稱，該要求的採購狀態為「草擬」。

系統會開啟「未來預留項目」頁面，其中包含未來預留要求的詳細資料。
按一下「編輯草稿」。

更新未來預留項目要求草稿的頁面會隨即開啟。
如要提交未來預留項目要求草稿以供審查，請按一下「提交」。

「Reservation」頁面隨即開啟。在您剛提交的未來預訂要求「狀態」欄中，採購狀態會設為「待核准」。

gcloud

如要提交未來預留項目草稿要求以供審查，請使用 gcloud beta compute future-reservations update 指令，並將 --planning-status 旗標設為 SUBMITTED。

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --planning-status=SUBMITTED \
    --zone=ZONE

更改下列內容：

FUTURE_RESERVATION_NAME：現有草擬未來預訂要求的名稱。
ZONE：未來預訂要求所在區域。

REST

如要提交未來預留項目要求草稿以供審查，請對 beta.futureReservations.update 方法發出 PATCH 要求。在要求主體中加入 planningStatus 欄位，並將該欄位設為 SUBMITTED。

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

{
  "name": "FUTURE_RESERVATION_NAME",
  "planningStatus": "SUBMITTED"
}

更改下列內容：

PROJECT_ID：未來預訂要求所在專案的 ID。
ZONE：未來預訂要求所在區域。
FUTURE_RESERVATION_NAME：現有草擬未來預訂要求的名稱。

提交未來預留項目要求草稿以供審查後，您可以採取下列行動：

如要監控要求的採購狀態，並查看Google Cloud 是否已核准或拒絕您的要求，請查看未來預留項目要求的詳細資料。
如要停止 Google Cloud 審查要求，並防止 Compute Engine 佈建所要求的容量，請取消或刪除未來的保留要求。

疑難排解

如果在建立未來預留要求時發生錯誤，請參閱如何排解未來預留要求問題。

如果在排解問題後仍遇到問題，請與客戶技術顧問或銷售團隊聯絡。

後續步驟

瞭解如何查看未來預留項目要求。
瞭解如何修改未來預留要求。
瞭解如何取消或刪除未來的預訂要求。
在保留期間開始後，請參閱這篇文章，瞭解如何使用自動建立的保留項目。

建立共用的未來預留項目要求 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

事前準備

Console

gcloud

REST

必要的角色

所需權限

限制

建立草稿要求

指定執行個體範本

主控台

gcloud

REST

指定現有的 VM

直接指定屬性

主控台

gcloud

REST

提交草稿要求

主控台

gcloud

REST

疑難排解

後續步驟

建立共用的未來預留項目要求
透過集合功能整理內容你可以依據偏好儲存及分類內容。