為單一專案建立未來預留項目

本文說明如何為單一專案建立未來預留項目要求。如要與其他專案共用預留資源，請參閱「建立共用未來預留項目要求」。

建立未來預留項目要求時，您會要求預留 vCPU、記憶體、GPU 和本機 SSD 磁碟，以便在未來時段建立虛擬機器 (VM) 執行個體。 Google Cloud 如果 Google Cloud 核准您的要求，Compute Engine 就會在您指定的日期和時間，使用您要求的資源建立預留項目。未來預留項目要求獲准後，可享下列好處：

• 專屬資源存取權。在整個預留期間，您的專案擁有預留資源的獨占存取權。預留項目到期後，除非您停止或刪除 VM，否則使用預留資源建立的 VM 會繼續執行。

• VM 建立作業的高保障。您可以使用預留資源建立 VM，其屬性與預留項目完全相符。這項操作可高度確保 VM 容量，並盡可能降低發生資源可用性錯誤的風險。

如要進一步瞭解建立未來預留項目要求時的適用規定和限制，請參閱「未來預留項目要求簡介」。

事前準備

• 提交 GPU、H4D 或 Z4M 執行個體的未來預留項目要求前，請先與帳戶團隊或銷售團隊聯絡，討論您的要求。否則 Google Cloud 可能會拒絕你的要求。
• 請務必確認您有足夠的配額，可供要預留的資源使用。如果配額不足， Google Cloud 可能會拒絕您日後的未來預留項目要求。或者，如果要求獲得核准，但您在要求開始時間配額不足，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.futureReservationUser) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備建立單一專案未來預留項目要求所需的權限。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：

所需權限

如要建立單一專案的未來預留項目要求，必須具備下列權限：

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

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

建立草稿要求

建立未來預留項目要求時，您可以將要求儲存為草稿，稍後再提交至 Google Cloud 進行審查，也可以直接提交要求以供審查。Google 建議您先建立草稿要求，這樣您就能判斷 Compute Engine 會為您的要求佈建多少 VM，而不必手動估算這個數量，並可選擇在提交審查前修改要求中預留的 VM 數量。

如要使用自動建立的未來預留項目，VM 的屬性必須與該預留項目完全相符。如要指定要透過建立未來預留項目要求來預留的 VM 屬性，請使用下列其中一種方法：

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

  您可以使用現有的執行個體範本，定義未來預留項目要求的屬性。您可以使用執行個體範本，在同一個位置定義未來預留項目的屬性，以及可使用自動建立預留項目的 VM。

• 指定現有 VM

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

• 直接指定屬性

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

系統自動建立的未來預留項目，可像手動建立的隨需預留項目一樣耗用。如要瞭解如何防止 VM 使用自動建立的預留項目，請參閱防止使用預留項目。

指定執行個體範本

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

• 建立未來預留項目要求時，必須與執行個體範本中的資源位於相同區域和可用區。在執行個體範本中指定的任何區域或可用區資源 (例如機器類型或 Persistent Disk)，都會限制範本只能在這些資源所在的地區使用。舉例來說，如果執行個體範本指定 us-central1-a 可用區中的現有永久磁碟，則您必須在同一個可用區中建立未來的預留項目要求。否則，建立未來預留項目要求會失敗。

  如要檢查現有範本是否指定任何資源，將範本繫結至特定區域或可用區，請查看範本詳細資料，並尋找範本內是否有區域或可用區資源的參照。

• 如要將為未來預留項目佈建的自動建立預留項目附加至承諾使用合約，則必須停用自動刪除選項。詳情請參閱「建立後的限制」。

建立未來預留項目要求後，您無法修改要求來覆寫範本的 VM 屬性，或指定其他範本。而是必須建立新的未來預留項目要求。

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

控制台

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

   前往「Reservations」(預留項目) 頁面

2. 點選「Future reservations」(未來預留項目) 分頁標籤。

3. 按一下 「Create future reservation」(建立未來預留項目)。「Create a future reservation」(建立未來預留項目) 頁面隨即顯示。

4. 在「設定」部分，執行下列操作：

   1. 選取「Use instance template」(使用執行個體範本)。

   2. 在「Instance template」(執行個體範本) 清單中，選取執行個體範本。如果選取區域執行個體範本，就只能在與範本區域相同的區域中預留資源。

5. 在「Location」(位置) 區段的「Region」(區域) 和「Zone」(可用區) 清單中，選取要預留資源的區域和可用區。

6. 在「Capacity details」(容量詳細資料) 區段的「Total capacity needed」(所需總容量) 部分，輸入要預留的 VM 總數。

   重要事項： 請確認您在提交要求時和要求開始時間，都有足夠的配額可預留資源。否則， Google Cloud 可能會拒絕未來預留項目要求，或只提供部分要求的資源。

7. 在「預訂期間」部分，執行下列操作：

   1. 在「Start time」(開始時間) 欄位中，指定預留期間的開始時間。將未來預留項目要求送審後，開始時間不得晚於之後一年。為了確保有足夠時間在未來預留項目進入鎖定時間前，選擇性修改、取消或刪除該項目，請指定開始時間的建議值。

   2. 在「End time」(結束時間) 欄位中，指定預留期間的結束時間。在「Duration summary」(時間長度摘要) 部分，會顯示預留期間的時間長度。將未來預留項目要求送審後，為了提高Google Cloud 核准的可能性，建議您指定至少 365 天的預留期間。

8. 點選「下一步」。

9. 在「Auto-delete」(自動刪除) 部分，執行下列任一操作：

   • 如要啟用 Compute Engine，自動刪除因未來預留項目要求而自動建立的預留項目，請執行下列操作：

     注意： 如果啟用自動刪除選項，無論預留項目是否用盡，Compute Engine 都會在指定的刪除時間刪除所有自動建立的預留項目。

     1. 勾選「Enable auto-delete」(啟用自動刪除功能) 核取方塊。

     2. 選用：在「Auto-delete time」(自動刪除時間) 欄位中，輸入要刪除自動建立預留項目的日期和時間。日期和時間必須晚於預留期間的結束時間。若將這個欄位留空，Compute Engine 就會在預留期間結束後的兩小時內，刪除自動建立的預留項目。

   • 如要停用自動刪除功能，請取消勾選「Enable auto-delete」(啟用自動刪除功能) 核取方塊。

10. 在「Use with VM instance」(用於 VM 執行個體) 部分，選取下列任一選項：

    • 如要允許相符的 VM 自動使用自動建立的預留項目，請選取「Use reservation automatically」(自動使用預留項目)。

    • 如要只在建立明確指定預留項目的相符 VM 時，才使用自動建立的預留項目，請選用「Select specific reservation」(選取特定預留項目)。

11. 點選「下一步」。

12. 在「Future reservation name」(未來預留項目名稱) 欄位中，輸入未來預留項目要求的名稱。

13. 在「Prefix」(前置字串) 部分，輸入名稱前置字串。凡是根據這項未來預留項目要求自動建立的預留項目，都會使用這個前置字串。

14. 草擬未來預留項目要求後，如要完成建立作業，請按一下「Save a draft」(儲存草稿)。「Reservations」(預留項目) 頁面隨即顯示。未來預留項目要求建立作業會在一分鐘內完成。如要確認 Compute Engine 何時完成建立作業，請查看未來預留項目要求。

gcloud

如要指定執行個體範本，建立單一專案未來預留項目要求，請使用 gcloud compute future-reservations create 指令。

如要建立未來預留項目要求草稿，請指定執行個體範本，不加入任何選用旗標，並在預留期間結束時自動刪除自動建立的預留項目，請執行下列指令：

gcloud compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --source-instance-template=INSTANCE_TEMPLATE_URL \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

更改下列內容：

• FUTURE_RESERVATION_NAME：未來預留項目要求的名稱。

• INSTANCE_TEMPLATE_URL：現有執行個體範本的網址。請指定下列其中一個值：

  • 區域性執行個體範本： projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_NAME

  • 全域執行個體範本： INSTANCE_TEMPLATE_NAME

• START_TIME：預留時段的開始時間，採用 RFC 3339 時間戳記，格式必須如下：

  YYYY-MM-DDTHH:MM:SSOFFSET
  

  更改下列內容：

  • YYYY-MM-DD：資料格式為 4 位數年份、2 位數月份和 2 位數日期，並以連字號分隔 (-)。

  • HH:MM:SS：時間格式為 24 小時制的 2 位數小時、2 位數分鐘和 2 位數秒，以半形冒號 (:) 分隔。

  • OFFSET：時區，格式為世界標準時間 (UTC) 的偏移量。舉例來說，如要使用太平洋標準時間 (PST)，請指定 -08:00。如要使用零偏移值，請指定 Z。

  將未來預留項目要求送審後，從這個日期和時間起算，開始時間不得晚於之後一年。為了確保有足夠時間在未來預留要求獲得核准後，選擇性取消、刪除或修改該要求，請指定開始時間的建議值。

• END_TIME：預訂期間的結束時間，格式為 RFC 3339 時間戳記。將要求送審後，為了提高Google Cloud 核准的可能性，建議您指定至少 365 天的預留期間。如要指定時間長度而非結束時間，請將 --end-time 旗標換成 --duration=END_DURATION 旗標。將 END_DURATION 替換為時間長度 (以秒為單位)。例如，指定 31536000 代表 31,536,000 秒 (365 天)。

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

• TOTAL_COUNT：要預留的 VM 總數。

• ZONE：要預留資源的可用區。

舉例來說，假設您要在可用區 us-central1-a 建立名為 fr-01 的未來預留項目要求草稿，並設定下列屬性：

• 預留期間從 2024 年 11 月 10 日午夜 (世界標準時間) 開始，到 2024 年 12 月 10 日午夜 (世界標準時間) 結束。

• VM 總數為 80 個。

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

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

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

gcloud compute future-reservations create fr-01 \
    --auto-delete-auto-created-reservations \
    --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

您也可以採取下列一或多項做法：

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

  gcloud compute future-reservations create FUTURE_RESERVATION_NAME \
      --auto-delete-auto-created-reservations \
      --name-prefix=NAME_PREFIX \
      --source-instance-template=INSTANCE_TEMPLATE_URL \
      --start-time=START_TIME \
      --end-time=END_TIME \
      --total-count=TOTAL_COUNT \
      --zone=ZONE
  

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

• 如要只允許明確指定自動建立預留項目名稱的 VM 使用預留項目，請加入 --require-specific-reservation 旗標。

  gcloud compute future-reservations create FUTURE_RESERVATION_NAME \
      --auto-delete-auto-created-reservations \
      --source-instance-template=INSTANCE_TEMPLATE_URL \
      --require-specific-reservation \
      --start-time=START_TIME \
      --end-time=END_TIME \
      --total-count=TOTAL_COUNT \
      --zone=ZONE
  

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

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

    gcloud compute future-reservations create FUTURE_RESERVATION_NAME \
        --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \
        --auto-delete-auto-created-reservations \
        --source-instance-template=INSTANCE_TEMPLATE_URL \
        --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 compute future-reservations create FUTURE_RESERVATION_NAME \
        --auto-created-reservations-duration=DURATION_BEFORE_DELETE \
        --auto-delete-auto-created-reservations \
        --source-instance-template=INSTANCE_TEMPLATE_URL \
        --start-time=START_TIME \
        --end-time=END_TIME \
        --total-count=TOTAL_COUNT \
        --zone=ZONE
    

    將 DURATION_BEFORE_DELETE 替換為時間長度 (以天、小時、分鐘或秒為單位)。舉例來說，如要指定 30 分鐘，請輸入 30m；如要指定 1 天 2 小時 3 分 4 秒，請輸入 1d2h3m4s。

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

  gcloud compute future-reservations create FUTURE_RESERVATION_NAME \
      --no-auto-delete-auto-created-reservations \
      --source-instance-template=INSTANCE_TEMPLATE_URL \
      --start-time=START_TIME \
      --end-time=END_TIME \
      --total-count=TOTAL_COUNT \
      --zone=ZONE
  

REST

如要指定執行個體範本，建立單一專案的未來預留項目要求，請向 futureReservations.insert 方法發出 POST 要求。

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

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

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "INSTANCE_TEMPLATE_URL",
    "totalCount": TOTAL_COUNT
  },
  "specificReservationRequired": RESERVATION_AFFINITY,
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

更改下列內容：

• PROJECT_ID：要預留資源的專案 ID，也是執行個體範本所在的專案。

• ZONE：要預留資源的可用區。

• AUTO_DELETE_AUTO_CREATED_RESERVATIONS：如果將這個欄位設為 true，Compute Engine 會在預留期間結束後的兩小時內，自動刪除為這項未來預留項目自動建立的預留項目。如要將自動建立的預留項目附加至承諾使用合約，請將這個欄位設為 false。

• INSTANCE_TEMPLATE_URL：現有執行個體範本的網址。請指定下列其中一個值：

  • 區域性執行個體範本： projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_NAME

  • 全域執行個體範本： INSTANCE_TEMPLATE_NAME

• TOTAL_COUNT：要預留的 VM 總數。

• RESERVATION_AFFINITY：VM 是否必須以自動建立的預留項目為目標，才能使用預留項目 (true)，或是任何相符的 VM 都能自動使用預留項目 (false)。

• START_TIME：預留時段的開始時間，採用 RFC 3339 時間戳記，格式必須如下：

  YYYY-MM-DDTHH:MM:SSOFFSET
  

  更改下列內容：

  • YYYY-MM-DD：資料格式為 4 位數年份、2 位數月份和 2 位數日期，並以連字號分隔 (-)。

  • HH:MM:SS：時間格式為 24 小時制的 2 位數小時、2 位數分鐘和 2 位數秒，以半形冒號 (:) 分隔。

  • OFFSET：時區格式為世界標準時間 (UTC) 的偏移量。舉例來說，如要使用太平洋標準時間 (PST)，請指定 -08:00。如不使用偏移值，請指定 Z。

  將未來預留項目要求送審後，從這個日期和時間起算，開始時間不得晚於之後一年。為了確保有足夠時間在未來預留項目要求核准後，且進入鎖定時間前，選擇性取消、刪除或修改該項目，請指定開始時間的建議值。

• END_TIME：預訂期間的結束時間，格式為 RFC 3339 時間戳記。提交要求後，為提高Google Cloud 核准的可能性，請指定至少 365 天的預留期間。如要指定時間長度而非結束時間，請將 endTime 欄位替換為 duration 欄位：

  "duration": {
    "seconds": END_DURATION
  }
  

  將 END_DURATION 替換為時間長度 (以秒為單位)。例如，指定 31536000 代表 31,536,000 秒 (365 天)。

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

舉例來說，假設您想在區域 us-central1-a 中建立名為 fr-01 的草擬未來預留項目要求，並具備下列屬性：

• 預留期間從 2024 年 11 月 10 日午夜 (世界標準時間) 開始，到 2024 年 12 月 10 日午夜 (世界標準時間) 結束。

• VM 總數為 80 個。

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

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

如要建立 fr-01，請按照下列方式提出 POST 要求：

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

{
  "autoDeleteAutoCreatedReservations": true,
  "name": "fr-01",
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/example-project/regions/us-central1/instanceTemplates/example-template",
    "totalCount": 80
  },
  "specificReservationRequired": RESERVATION_AFFINITY,
  "timeWindow": {
    "startTime": "2024-11-10T00:00:00Z",
    "endTime": "2024-12-10T00:00:00Z"
  }
}

您也可以視需要執行下列一或多項操作：

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

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations
  
  {
    "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
    "name": "FUTURE_RESERVATION_NAME",
    "namePrefix": "NAME_PREFIX",
    "specificSkuProperties": { 
      "sourceInstanceTemplate": "INSTANCE_TEMPLATE_URL",
      "totalCount": TOTAL_COUNT
    },
    "specificReservationRequired": RESERVATION_AFFINITY,
    "timeWindow": {
      "startTime": "START_TIME",
      "endTime": "END_TIME"
    }
  }
  

  將 NAME_PREFIX 替換為每個自動建立預留項目的名稱前置字串。為方便您識別因這項未來預留項目要求而自動建立的預留項目， Google Cloud 建議您指定專屬名稱前置字串。

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

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

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations
    
    {
      "autoCreatedReservationsDeleteTime": "DELETE_TIME",
      "autoDeleteAutoCreatedReservations": true,
      "name": "FUTURE_RESERVATION_NAME",
      "specificSkuProperties": { 
        "sourceInstanceTemplate": "INSTANCE_TEMPLATE_URL",
        "totalCount": TOTAL_COUNT
      },
      "specificReservationRequired": RESERVATION_AFFINITY,
      "timeWindow": {
        "startTime": "START_TIME",
        "endTime": "END_TIME"
      }
    }
    

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

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

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations
    
    {
      "autoCreatedReservationsDuration": {
        "seconds": "DURATION_BEFORE_DELETE"
      },
      "autoDeleteAutoCreatedReservations": true,
      "name": "FUTURE_RESERVATION_NAME",
      "specificSkuProperties": { 
        "sourceInstanceTemplate": "INSTANCE_TEMPLATE_URL",
        "totalCount": TOTAL_COUNT
      },
      "specificReservationRequired": RESERVATION_AFFINITY,
      "timeWindow": {
        "startTime": "START_TIME",
        "endTime": "END_TIME"
      }
    }
    

    將 DURATION_BEFORE_DELETE 替換為以秒為單位的時間長度。舉例來說，如要指定 604,800 秒 (7 天)，請輸入 604800。

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

指定現有 VM

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

未來預留項目要求獲得核准並進入預留期間後，您就能建立屬性與參考 VM 相符的 VM，使用系統自動建立的預留項目。 Google Cloud ：

• 請按照下列步驟建立及使用執行個體範本：

  1. 根據參照 VM 建立執行個體範本，而不覆寫參照 VM 的屬性。

  2. 使用新建立的範本建立 VM，方法是執行下列其中一項或兩項操作：

     • 建立單一 VM

     • 建立可用區代管執行個體群組 (MIG)

• 根據參照 VM 建立 VM，同時確保新 VM 和參照 VM 的屬性完全相符。

如要建立單一專案的未來預留項目要求，並使用現有 VM 的屬性，請執行下列步驟：

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

   前往「Reservations」(預留項目) 頁面

2. 點選「Future reservations」(未來預留項目) 分頁標籤。

3. 按一下 「Create future reservation」(建立未來預留項目)。「Create a future reservation」(建立未來預留項目) 頁面隨即顯示。

4. 在「Configurations」(設定) 部分，執行下列操作：

   1. 選取「使用現有 VM」。

   2. 在「Existing VM」(現有 VM) 清單中，選取要用來建立預留項目的 VM。

5. 在「Location」(位置) 區段的「Region」(區域) 和「Zone」(可用區) 清單中，選取要預留資源的區域和可用區。

6. 在「Capacity details」(容量詳細資料) 區段的「Total capacity needed」(所需總容量) 部分，輸入要預留的 VM 總數。

   重要事項： 請確認您在提交要求時和要求開始時間，都有足夠的配額可預留資源。否則， Google Cloud 可能會拒絕您日後的預留項目要求，或只提供部分要求的資源。

7. 在「Reservation period」(預留期限) 部分，執行下列操作：

   1. 在「Start time」(開始時間) 欄位中，指定預留期間的開始時間。將未來預留項目要求送審後，開始時間不得晚於之後一年。為了確保有足夠時間在未來預留項目進入鎖定時間前，選擇性修改、取消或刪除該項目，請指定開始時間的建議值。

   2. 在「End time」(結束時間) 欄位中，指定預留期間的結束時間。「時間長度摘要」部分會顯示預留期間的時間長度。將未來預留項目要求送審後，為了提高Google Cloud 核准的可能性，建議您指定至少 365 天的預留期間。

8. 點選「下一步」。

9. 在「Auto-delete」(自動刪除) 部分，執行下列任一操作：

   • 如要啟用 Compute Engine，自動刪除因未來預留項目要求而自動建立的預留項目，請執行下列操作：

     注意： 如果啟用自動刪除選項，無論預留項目是否用盡，Compute Engine 都會在指定的刪除時間刪除所有自動建立的預留項目。

     1. 勾選「Enable auto-delete」(啟用自動刪除功能) 核取方塊。

     2. 選用：在「Auto-delete time」(自動刪除時間) 欄位中，輸入要刪除自動建立預留項目的日期和時間。日期和時間必須晚於預留期間的結束時間。若將這個欄位留空，Compute Engine 就會在預留期間結束後的兩小時內，刪除自動建立的預留項目。

   • 如要停用自動刪除功能，請取消勾選「Enable auto-delete」(啟用自動刪除功能) 核取方塊。

10. 在「Use with VM instance」(用於 VM 執行個體) 部分，選取下列任一選項：

    • 如要允許相符的 VM 自動使用自動建立的預留項目，請選取「Use reservation automatically」(自動使用預留項目)。

    • 如要只在建立明確指定預留項目的相符 VM 時，才使用自動建立的預留項目，請選用「Select specific reservation」(選取特定預留項目)。

11. 點選「下一步」。

12. 在「Future reservation name」(未來預留項目名稱) 欄位中，輸入未來預留項目要求的名稱。

13. 在「Prefix」(前置字串) 部分，輸入名稱前置字串。凡是根據這項未來預留項目要求自動建立的預留項目，都會使用這個前置字串。

14. 草擬未來預留項目要求後，如要完成建立作業，請按一下「Save a draft」(儲存草稿)。「Reservations」(預留項目) 頁面隨即顯示。未來預留項目要求建立作業會在一分鐘內完成。如要確認 Compute Engine 何時完成建立作業，請查看未來預留項目要求。

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

直接指定屬性

如要將為未來預留項目佈建的自動建立預留項目附加至承諾使用合約，則必須停用自動刪除選項。詳情請參閱「建立後的限制」。

如要直接指定屬性來建立單一專案的未來預留項目，請選取下列其中一個選項：

控制台

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

   前往「Reservations」(預留項目) 頁面

2. 點選「Future reservations」(未來預留項目) 分頁標籤。

3. 按一下 「Create future reservation」(建立未來預留項目)。「Create a future reservation」(建立未來預留項目) 頁面隨即顯示。

4. 在「Configurations」(設定) 部分，執行下列操作：

   1. 選取「指定機型」。

   2. 指定預留 VM 要使用的機器家族、系列和類型。

5. 在「Location」(位置) 區段的「Region」(區域) 和「Zone」(可用區) 清單中，選取要預留資源的區域和可用區。

6. 在「Capacity details」(容量詳細資料) 區段的「Total capacity needed」(所需總容量) 部分，輸入要預留的 VM 總數。

   重要事項： 請確認您在提交要求時和要求開始時間，都有足夠的配額可預留資源。否則， Google Cloud 可能會拒絕您日後的預留項目要求，或只提供部分要求的資源。

7. 在「預訂期間」部分，執行下列操作：

   1. 在「Start time」(開始時間) 欄位中，指定預留期間的開始時間。將未來預留項目要求送審後，從這個日期和時間起算，開始時間不得晚於之後一年。為了確保有足夠時間在未來預留項目進入鎖定時間前，選擇性修改、取消或刪除該項目，請指定開始時間的建議值。

   2. 在「End time」(結束時間) 欄位中，指定預留期間的結束時間。在「Duration summary」(時間長度摘要) 部分，會顯示預留期間的時間長度。提交未來預留項目要求後，為了提高Google Cloud 核准的可能性，建議您指定至少 365 天的預留期間。

8. 點選「下一步」。

9. 在「Auto-delete」(自動刪除) 部分，執行下列任一操作：

   • 如要啟用 Compute Engine，自動刪除因未來預留項目要求而自動建立的預留項目，請執行下列操作：

     注意： 如果啟用自動刪除選項，無論預留項目是否用盡，Compute Engine 都會在指定的刪除時間刪除所有自動建立的預留項目。

     1. 勾選「Enable auto-delete」(啟用自動刪除功能) 核取方塊。

     2. 選用：在「Auto-delete time」(自動刪除時間) 欄位中，輸入要刪除自動建立預留項目的日期和時間。日期和時間必須晚於預留期間的結束時間。若將這個欄位留空，Compute Engine 就會在預留期間結束後的兩小時內，刪除自動建立的預留項目。

   • 如要停用自動刪除功能，請取消勾選「Enable auto-delete」(啟用自動刪除功能) 核取方塊。

10. 在「Use with VM instance」(用於 VM 執行個體) 部分，選取下列任一選項：

    • 如要允許相符的 VM 自動使用自動建立的預留項目，請選取「Use reservation automatically」(自動使用預留項目)。

    • 如要只在建立明確指定預留項目的相符 VM 時，才使用自動建立的預留項目，請選用「Select specific reservation」(選取特定預留項目)。

11. 點選「下一步」。

12. 在「Future reservation name」(未來預留項目名稱) 欄位中，輸入未來預留項目要求的名稱。

13. 在「Prefix」(前置字串) 部分，輸入名稱前置字串。凡是根據這項未來預留項目要求自動建立的預留項目，都會使用這個前置字串。

14. 草擬未來預留項目要求後，如要完成建立作業，請按一下「Save a draft」(儲存草稿)。「Reservations」(預留項目) 頁面隨即顯示。未來預留項目要求建立作業會在一分鐘內完成。如要確認 Compute Engine 何時完成建立作業，請查看未來預留項目要求。

gcloud

如要直接指定屬性，建立單一專案的未來預留項目要求，請使用 gcloud compute future-reservations create 指令。

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

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

更改下列內容：

• FUTURE_RESERVATION_NAME：未來預留項目要求的名稱。

• MACHINE_TYPE：各個預留 VM 要使用的機器類型。

• START_TIME：預留時段的開始時間，採用 RFC 3339 時間戳記，格式必須如下：

  YYYY-MM-DDTHH:MM:SSOFFSET
  

  更改下列內容：

  • YYYY-MM-DD：資料格式為 4 位數年份、2 位數月份和 2 位數日期，並以連字號分隔 (-)。

  • HH:MM:SS：時間格式為 2 位數的小時 (24 小時制)、2 位數的分鐘和 2 位數的秒數，並以半形冒號分隔 (:)。

  • OFFSET：時區，格式為世界標準時間 (UTC) 的偏移量。舉例來說，如要使用太平洋標準時間 (PST)，請指定 -08:00。如不使用偏移值，請指定 Z。

  將未來預留項目要求送審後，從這個日期和時間起算，開始時間不得晚於之後一年。為了確保有足夠時間在未來預留要求獲得核准後，選擇性取消、刪除或修改該要求，請指定開始時間的建議值。

• END_TIME：預訂期間的結束時間，格式為 RFC 3339 時間戳記。將要求送審後，為了提高Google Cloud 核准的可能性，建議您指定至少 365 天的預留期間。如要指定時間長度而非結束時間，請將 --end-time 旗標換成 --duration=END_DURATION 旗標。將 END_DURATION 替換為時間長度 (以秒為單位)。例如，指定 31536000 代表 31,536,000 秒 (365 天)。

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

• TOTAL_COUNT：要預留的 VM 總數。

• ZONE：要預留資源的可用區。

舉例來說，假設您要在可用區 us-central1-a 建立名為 fr-01 的未來預留項目要求草稿，並設定下列屬性：

• 預留期間從 2024 年 11 月 10 日午夜 (世界標準時間) 開始，到 2024 年 12 月 10 日午夜 (世界標準時間) 結束。

• VM 總數為 80 個。

• 具備 4 個 vCPU 的 N2 預先定義機型。

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

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

gcloud compute future-reservations create fr-01 \
    --auto-delete-auto-created-reservations \
    --machine-type=n2-standard-4 \
    --start-time=2024-11-10T00:00:00Z \
    --end-time=2024-12-10T00:00:00Z \
    --total-count=80 \
    --zone=us-central1-a

您也可以採取下列一或多項做法：

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

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

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

• 如要只讓明確指定自動建立預留項目名稱的 VM 使用這些預留項目，請加入 --require-specific-reservation 旗標。

  gcloud compute future-reservations create FUTURE_RESERVATION_NAME \
      --auto-delete-auto-created-reservations \
      --machine-type=MACHINE_TYPE \
      --require-specific-reservation \
      --start-time=START_TIME \
      --end-time=END_TIME \
      --total-count=TOTAL_COUNT \
      --zone=ZONE
  

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

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

    gcloud 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 \
        --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 compute future-reservations create FUTURE_RESERVATION_NAME \
        --auto-created-reservations-duration=DURATION_BEFORE_DELETE \
        --auto-delete-auto-created-reservations \
        --machine-type=MACHINE_TYPE \
        --start-time=START_TIME \
        --end-time=END_TIME \
        --total-count=TOTAL_COUNT \
        --zone=ZONE
    

    將 DURATION_BEFORE_DELETE 替換為時間長度 (以天、小時、分鐘或秒為單位)。舉例來說，如要指定 30 分鐘，請輸入 30m；如要指定 1 天 2 小時 3 分 4 秒，請輸入 1d2h3m4s。

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

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

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

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

  將 MIN_CPU_PLATFORM 替換為最低 CPU 平台。如要確認您預留資源的可用區是否支援特定 CPU 平台，請查看各可用區適用的 CPU 平台。

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

  gcloud compute future-reservations create FUTURE_RESERVATION_NAME \
      --accelerator=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \
      --auto-delete-auto-created-reservations \
      --machine-type=MACHINE_TYPE \
      --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 型號，在您建立未來預留項目要求的可用區中可用。

• 如要將本機 SSD 磁碟連接至預設不含本機 SSD 磁碟的機型，請加入 --local-ssd 旗標。您只能附加 375 GB 的本機 SSD 磁碟。

  gcloud 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 \
      --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

REST

如要直接指定屬性，建立單一專案的未來預留項目要求，請向 futureReservations.insert 方法發出 POST 要求。

如要建立未來預留項目要求草稿，請直接指定屬性，不加入任何選項欄位，並按照下列方式提出 POST 要求：

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

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "specificReservationRequired": RESERVATION_AFFINITY,
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

更改下列內容：

• PROJECT_ID：要預留資源的專案 ID。

• ZONE：要預留資源的可用區。

• AUTO_DELETE_AUTO_CREATED_RESERVATIONS：如果將這個欄位設為 true，Compute Engine 就會在預留期間結束後的兩小時內，自動刪除這項未來預留項目自動建立的預留項目。如要將自動建立的預訂項目附加至承諾，請將這個欄位設為 false。

• TOTAL_COUNT：要預留的 VM 總數。

• RESERVATION_AFFINITY：VM 是否必須以自動建立的預留項目為目標，才能使用預留項目 (true)，或是任何相符的 VM 都能自動使用預留項目 (false)。

• START_TIME：預留時段的開始時間，採用 RFC 3339 時間戳記，格式必須如下：

  YYYY-MM-DDTHH:MM:SSOFFSET
  

  更改下列內容：

  • YYYY-MM-DD：資料格式為 4 位數年份、2 位數月份和 2 位數日期，並以連字號分隔 (-)。

  • HH:MM:SS：時間格式為 2 位數的小時 (24 小時制)、2 位數的分鐘和 2 位數的秒數，並以半形冒號分隔 (:)。

  • OFFSET：時區，格式為世界標準時間 (UTC) 的偏移量。舉例來說，如要使用太平洋標準時間 (PST)，請指定 -08:00。如不使用偏移值，請指定 Z。

  將未來預留項目要求送審後，從這個日期和時間起算，開始時間不得晚於之後一年。為了確保有足夠時間在未來預留項目要求核准後，且進入鎖定時間前，選擇性取消、刪除或修改該項目，請指定開始時間的建議值。

• END_TIME：預訂期間的結束時間，格式為 RFC 3339 時間戳記。提交要求後，為提高Google Cloud 核准的可能性，請指定至少 365 天的預留期間。如要指定時間長度而非結束時間，請將 endTime 欄位替換為 duration 欄位：

  "duration": {
    "seconds": END_DURATION
  }
  

  將 END_DURATION 替換為時間長度 (以秒為單位)。例如，指定 31536000 代表 31,536,000 秒 (365 天)。

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

舉例來說，假設您要在可用區 us-central1-a 建立名為 fr-01 的未來預留項目要求草稿，並設定下列屬性：

• 預留期間從 2024 年 11 月 10 日午夜 (世界標準時間) 開始，到 2024 年 12 月 10 日午夜 (世界標準時間) 結束。

• VM 總數為 80 個。

• 具備 4 個 vCPU 的 N2 預先定義機型。

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

如要建立 fr-01，請按照下列方式提出 POST 要求：

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

{
  "autoDeleteAutoCreatedReservations": true,
  "name": "fr-01",
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "n2-standard-4"
    },
    "totalCount": 80
  },
  "specificReservationRequired": RESERVATION_AFFINITY,
  "timeWindow": {
    "startTime": "2024-11-10T00:00:00Z",
    "endTime": "2024-12-10T00:00:00Z"
  }
}

您也可以視需要執行下列一或多項操作：

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

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations
  
  {
    "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
    "name": "FUTURE_RESERVATION_NAME",
    "namePrefix": "NAME_PREFIX",
    "specificSkuProperties": { 
      "instanceProperties": {
        "machineType": "MACHINE_TYPE"
      },
      "totalCount": TOTAL_COUNT
    },
    "specificReservationRequired": RESERVATION_AFFINITY,
    "timeWindow": {
      "startTime": "START_TIME",
      "endTime": "END_TIME"
    }
  }
  

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

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

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations
  
  {
    "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
    "name": "FUTURE_RESERVATION_NAME",
    "specificSkuProperties": {
      "instanceProperties": {
        "guestAccelerators": [
          {
            "acceleratorCount": NUMBER_OF_ACCELERATORS,
            "acceleratorType": "ACCELERATOR_TYPE"
          }
        ],
        "machineType": "MACHINE_TYPE"
      },
      "totalCount": TOTAL_COUNT
    },
    "specificReservationRequired": RESERVATION_AFFINITY,
    "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/v1/projects/PROJECT_ID/zones/ZONE/futureReservations
  
  {
    "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
    "name": "FUTURE_RESERVATION_NAME",
    "specificSkuProperties": {
      "instanceProperties": {
        "localSsds": [
          {
            "diskSizeGb": "375",
            "interface": "INTERFACE_TYPE"
          },
          {
            "diskSizeGb": "375",
            "interface": "INTERFACE_TYPE"
          }
        ],
        "machineType": "MACHINE_TYPE"
      },
      "totalCount": TOTAL_COUNT
    },
    "specificReservationRequired": RESERVATION_AFFINITY,
    "timeWindow": {
      "startTime": "START_TIME",
      "endTime": "END_TIME"
    }
  }
  

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

  • NVME 磁碟介面：NVME

  • SCSI 磁碟介面：SCSI

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

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations
  
  {
    "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
    "name": "FUTURE_RESERVATION_NAME",
    "specificSkuProperties": {
      "instanceProperties": {
        "machineType": "MACHINE_TYPE",
        "minCpuPlatform": "MINIMUM_CPU_PLATFORM"
      },
      "totalCount": TOTAL_COUNT
    },
    "specificReservationRequired": RESERVATION_AFFINITY,
    "timeWindow": {
      "startTime": "START_TIME",
      "endTime": "END_TIME"
    }
  }
  

  將 MIN_CPU_PLATFORM 替換為最低 CPU 平台。如要確認 CPU 平台是否適用於您預留資源的可用區，請查看各可用區適用的 CPU 平台。

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

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

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations
    
    {
      "autoCreatedReservationsDeleteTime": "DELETE_TIME",
      "autoDeleteAutoCreatedReservations": true,
      "name": "FUTURE_RESERVATION_NAME",
      "specificSkuProperties": { 
        "instanceProperties": {
          "machineType": "MACHINE_TYPE"
        },
        "totalCount": TOTAL_COUNT
      },
      "specificReservationRequired": RESERVATION_AFFINITY,
      "timeWindow": {
        "startTime": "START_TIME",
        "endTime": "END_TIME"
      }
    }
    

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

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

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations
    
    {
      "autoCreatedReservationsDuration": {
        "seconds": "DURATION_BEFORE_DELETE"
      },
      "autoDeleteAutoCreatedReservations": true,
      "name": "FUTURE_RESERVATION_NAME",
      "specificSkuProperties": { 
        "instanceProperties": {
          "machineType": "MACHINE_TYPE"
        },
        "totalCount": TOTAL_COUNT
      },
      "specificReservationRequired": RESERVATION_AFFINITY,
      "timeWindow": {
        "startTime": "START_TIME",
        "endTime": "END_TIME"
      }
    }
    

    將 DURATION_BEFORE_DELETE 替換為以秒為單位的時間長度。舉例來說，如要指定 604,800 秒 (7 天)，請輸入 604800。

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

提交草稿要求

提交未來預留項目要求並獲得 Google Cloud核准，且已過鎖定時間後，您只能在未來預留項目的預留期間結束後，刪除該預留項目和自動建立的預留項目。如果您需要建立另一個具有相同屬性的未來預留項目，可以刪除現有的未來預留項目。因此，建立未來預留項目要求前，請確認下列事項：

• 專案中現有的預留項目或未來預留項目，會限制您可建立的未來預留項目要求共用設定。為確保您能成功建立未來預留項目要求，且該要求不會對您共用未來預留項目要求或預留項目的其他專案造成問題，請參閱「限制」。

• 無論是否耗用自動建立的預留項目，您都必須承諾支付 Compute Engine 在整個預留期間佈建的預留資源費用。詳情請參閱「計費方式」。

如要在將草擬的未來預留項目要求送審時，修改一或多個屬性，請參閱「修改未來預留項目要求」一文。

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

控制台

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

   前往「Reservations」(預留項目) 頁面

2. 點選「Future reservations」(未來預留項目) 分頁標籤。

3. 在「Name」(名稱) 欄中，按一下採購狀態為「Drafting」(草擬中) 的未來預留項目要求名稱。「Future reservations」(未來預留項目) 頁面隨即顯示，當中包含未來預留項目要求的詳細資料。

4. 按一下「 編輯草稿」。系統會顯示更新未來預留項目要求草稿的頁面。

5. 如要提交草擬的未來預留項目要求以供審查，請按一下「Create」(建立)。「Reservation」(預留項目) 頁面隨即顯示。

gcloud

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

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

更改下列內容：

• FUTURE_RESERVATION_NAME：現有草稿未來預留項目要求的名稱。

• ZONE：未來預留項目要求所在的可用區。

REST

如要提交未來預留項目要求草稿以供審查，請向 futureReservations.update 方法發出 PATCH 要求。在要求網址中，加入設為 planningStatus 的 updateMask 查詢參數。

PATCH https://compute.googleapis.com/compute/v1/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 佈建要求的容量，請取消或刪除未來預留項目要求。

疑難排解

如果在建立未來預留項目要求時發生錯誤，請參閱這篇文章，瞭解如何排解未來預留項目要求的問題。

如果疑難排解後仍有問題，請與帳戶團隊或銷售團隊聯絡。

後續步驟

• 瞭解如何查看未來預留項目要求。

• 瞭解如何修改未來預留項目要求。

• 瞭解如何取消或刪除未來的預留項目要求。

• 預留期間開始後，請參閱這篇文章，瞭解如何耗用自動建立的預留項目。