在日曆模式中建立未來預約要求

本文說明如何在日曆模式中建立預留項目要求。使用這些要求預留高需求資源,建立最多可執行 90 天的虛擬機器 (VM) 執行個體。舉例來說,您可以在日曆模式中使用未來的預留項目,為 VM 預留 GPU 或 TPU 資源。

您可以在日曆模式中使用未來預留項目要求,預留高需求資源來執行下列工作負載:

  • 模型預先訓練工作

  • 模型微調工作

  • 高效能運算 (HPC) 模擬工作負載

  • 推論工作負載短期內增加

Google Cloud 在日曆模式中核准要求後,您就能在指定交貨日期和時間建立 GPU、H4D 或 TPU 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. 安裝 Google Cloud CLI。 完成後,執行下列指令來初始化 Google Cloud CLI:

      gcloud init

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

    2. Set a default region and zone.

    REST

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

      安裝 Google Cloud CLI。 完成後,執行下列指令來初始化 Google Cloud CLI:

      gcloud init

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

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

必要的角色

如要取得在日曆模式中建立未來預留項目要求所需的權限,請要求管理員授予您專案的Compute Future Reservation User (roles/compute.futureReservationUser) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備在日曆模式中建立未來預留項目要求所需的權限。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:

所需權限

如要在日曆模式中建立未來預留項目要求,必須具備下列權限:

  • 如要建立未來預留項目要求: compute.futureReservations.create 在專案上
  • 如要讓 Compute Engine 自動建立預留項目,請在專案中執行下列操作: compute.reservations.create
  • 如要查看資源的未來供應情形: compute.advice.calendarMode 在專案中

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

總覽

如要在日曆模式中建立未來預留項目要求,請完成下列步驟:

  1. 查看資源未來供應情形。查看您想預留的 GPU VM、H4D VM 或 TPU 未來可用情形。接著,建立要求時,請指定您確認可用的資源數量、類型和預訂時間長度。提供這項資訊後, Google Cloud 核准要求的機率會更高。

  2. 為 GPU VM、H4D VM 或 TPU 建立預留要求。在日曆模式中,為 GPU VM、H4D VM 或 TPU 建立並提交未來預留要求。如果可以成功建立要求,則 Google Cloud 會在 1 分鐘內核准要求。

查看資源未來可用情形

如要查看 GPU VM、H4D VM 或 TPU 在某個區域的未來供應情形,請按照下列步驟操作:

  • GPU VM 最多可提前 60 天預訂
  • H4D VM:最多提前 120 天
  • TPU:最多可提前 120 天預訂

如要查看某個區域的 GPU VM、H4D VM 或 TPU 未來可用性,請選取下列其中一個選項:

控制台

在日曆模式中建立預約要求時,您可以查看區域中 GPU VM、H4D VM 或 TPU 的未來可用性。詳情請參閱本文的為 GPU VM、H4D VM 或 TPU 建立預訂要求一節。

gcloud

如要查看某個地區的 GPU VM、H4D VM 或 TPU 未來供應情形,請使用下列其中一個 gcloud beta compute advice calendar-mode 指令。根據您要查看的資源,加入下列標記:

  • 如要查看 GPU VM 或 H4D VM 的可用性,請加入 --vm-count--machine-type 旗標:

    gcloud beta compute advice calendar-mode \
        --vm-count=NUMBER_OF_VMS \
        --machine-type=MACHINE_TYPE \
        --region=REGION \
        --start-time-range=from=FROM_START_TIME,to=TO_START_TIME \
        --end-time-range=from=FROM_END_TIME,to=TO_END_TIME
    
  • 如要查看 TPU 可用性,請加入 --chip-count--tpu-version 旗標:

    gcloud beta compute advice calendar-mode \
        --chip-count=NUMBER_OF_CHIPS \
        --tpu-version=TPU_VERSION \
        --region=REGION \
        --start-time-range=from=FROM_START_TIME,to=TO_START_TIME \
        --end-time-range=from=FROM_END_TIME,to=TO_END_TIME
    

更改下列內容:

  • NUMBER_OF_VMS:要預留的 VM 數量。對於 GPU VM,這個值不得小於 1 且不得大於 80;對於 H4D HPC VM,這個值不得大於 256

  • MACHINE_TYPE:要預留的 GPU 或 H4D 機型。請指定下列其中一個值:

    • A4 機型:a4-highgpu-8g

    • A3 Ultra 機型:a3-ultragpu-8g

    • A3 Mega 機型:a3-megagpu-8g

    • 如果是搭載 8 個 GPU 的 A3 High 機型:a3-highgpu-8g

    • 如為 H4D HPC 機型:請參閱 H4D 機型

  • NUMBER_OF_CHIPS:要預留的 TPU 晶片數量。 值必須是 1481632641282565121024

  • TPU_VERSION:要預留的 TPU 版本。指定下列其中一個值:

    • TPU7x:TPU7X

    • TPU v6e:V6E

    • 如果是 TPU v5p:V5P

    • 如果是 TPU v5e:V5E

    如果您指定 TPU v5e,則必須加上 --workload-type 旗標。將這個旗標設為要在 TPU 上執行的工作負載類型:

    • 對於在單一或多項作業中處理大量資料的工作負載,例如機器學習 (ML) 訓練工作負載,請指定 BATCH

    • 對於處理並行要求且需要最低網路延遲的工作負載 (例如機器學習推論工作負載),請指定 SERVING

  • REGION:要預留 GPU VM、H4D VM 或 TPU 的區域。如要查看支援的地區和區域,請參閱限制

  • FROM_START_TIMETO_START_TIME: 您要預留容量的最早和最晚日期。 請將這些日期設為 RFC 3339 時間戳記:

    YYYY-MM-DDTHH:MM:SSOFFSET
    

    更改下列內容:

    • YYYY-MM-DD:日期格式為四位數年份、兩位數月份和兩位數日期,並以連字號分隔 (-)。

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

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

  • FROM_END_TIMETO_END_TIME:容量預留結束的最早和最晚日期。請將這些日期設為 RFC 3339 時間戳記格式。如要指定預訂期間的時長範圍,而非結束時間,請將 --end-time-range 旗標替換為 --duration-range 旗標

輸出結果會與下列內容相似:

- recommendationsPerSpec:
    spec:
      endTime: '2025-09-07T00:00:00Z'
      location: zones/us-central1-a
      otherLocations:
        zones/us-central1-b:
          details: Recommendation in this zone is possible.
          status: RECOMMENDED
        zones/us-central1-c:
          details: Temporarily no free capacity in this zone in the
          requested time window.
          status: NO_CAPACITY
        zones/us-central1-f:
          details: This machine family is not supported in this zone.
          status: NOT_SUPPORTED
      recommendationId: 0d3f005d-f952-4fce-96f2-6af25e1591eb
      recommendationType: FUTURE_RESERVATION
      startTime: '2025-06-09T00:00:00Z'

如果要求的資源可用,輸出內容會包含 startTimeendTimelocation 欄位。這些欄位會指定資源可用的最早開始時間、最晚結束時間和時區。

REST

如要在特定區域查看 GPU VM、H4D VM 或 TPU 未來的供應情形,請向 beta advice.calendarMode 方法發出 GET 要求。根據您想查看的資源,在要求主體中加入下列欄位:

  • 如要查看 GPU VM 或 H4D VM 的可用性,請加入 instanceCountmachineType 欄位:

    POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/advice/calendarMode
    
    {
      "futureResourcesSpecs": {
        "spec": {
          "targetResources": {
            "specificSkuResources": {
              "instanceCount": "NUMBER_OF_VMS",
              "machineType": "MACHINE_TYPE"
            }
          },
          "timeRangeSpec": {
            "startTimeNotEarlierThan": "FROM_START_TIME",
            "startTimeNotLaterThan": "TO_START_TIME",
            "endTimeNotEarlierThan": "FROM_END_TIME",
            "endTimeNotLaterThan": "TO_END_TIME"
          }
        }
      }
    }
    
  • 如要查看 TPU 可用性,請加入 acceleratorCountvmFamily 欄位:

    POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/advice/calendarMode
    
    {
      "futureResourcesSpecs": {
        "spec": {
          "targetResources": {
            "aggregateResources": {
              "acceleratorCount": "NUMBER_OF_CHIPS",
              "vmFamily": "TPU_VERSION"
            }
          },
          "timeRangeSpec": {
            "startTimeNotEarlierThan": "FROM_START_TIME",
            "startTimeNotLaterThan": "TO_START_TIME",
            "endTimeNotEarlierThan": "FROM_END_TIME",
            "endTimeNotLaterThan": "TO_END_TIME"
          }
        }
      }
    }
    

更改下列內容:

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

  • REGION:您要預留 GPU VM、H4D VM 或 TPU 的區域。如要查看支援的地區和區域,請參閱限制

  • NUMBER_OF_VMS:要預留的 GPU 或 H4D VM 數量。如果是 GPU VM,值必須介於 180 之間。 如果是 H4D VM,值必須介於 1256 之間。

  • MACHINE_TYPE:要預留的 GPU 或 H4D 機型。請指定下列其中一個值:

    • A4 機型:a4-highgpu-8g

    • A3 Ultra 機型:a3-ultragpu-8g

    • A3 Mega 機型:a3-megagpu-8g

    • 如果是搭載 8 個 GPU 的 A3 High 機型:a3-highgpu-8g

    • 如為 H4D HPC 機型:請參閱 H4D 機型

  • NUMBER_OF_CHIPS:要預留的 TPU 晶片數量。 值必須是 1481632641282565121024

  • TPU_VERSION:要預留的 TPU 版本。指定下列其中一個值:

    • TPU7x:VM_FAMILY_CLOUD_TPU_POD_SLICE_TPU7X

    • TPU v6e:VM_FAMILY_CLOUD_TPU_LITE_POD_SLICE_CT6E

    • 如果是 TPU v5p:VM_FAMILY_CLOUD_TPU_POD_SLICE_CT5P

    • 如果是 TPU v5e:VM_FAMILY_CLOUD_TPU_LITE_POD_SLICE_CT5LP

    如果您指定 TPU v5e,則必須在 aggregateResources 欄位中加入 workloadType 欄位。將這個欄位設為要在 TPU 上執行的工作負載類型:

    • 對於在單一或多項作業中處理大量資料的工作負載,例如機器學習 (ML) 訓練工作負載,請指定 BATCH

    • 對於處理並行要求且需要最低網路延遲的工作負載 (例如機器學習推論工作負載),請指定 SERVING

  • FROM_START_TIMETO_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

  • FROM_END_TIMETO_END_TIME:容量預留結束的最早和最晚日期。請將這些日期設為 RFC 3339 時間戳記格式。如要指定預訂期間的時長範圍,而非結束時間,請將 endTimeNotEarlierThanendTimeNotLaterThan 欄位替換為 minDurationmaxDuration 欄位

輸出結果會與下列內容相似:

{
  "recommendations": [
    {
      "recommendationsPerSpec": {
        "spec": {
          "recommendationId": "a21a2fa0-72c7-4105-8179-88de5409890b",
          "recommendationType": "FUTURE_RESERVATION",
          "startTime": "2025-06-09T00:00:00Z",
          "endTime": "2025-09-07T00:00:00Z",
          "otherLocations": {
            "zones/us-central1-b": {
              "status": "RECOMMENDED",
              "details": "Recommendation in this zone is possible."
            },
            "zones/us-central1-c": {
              "status": "NO_CAPACITY",
              "details": "Temporarily no free capacity in this zone in the
                          requested time window."
            },
            "zones/us-central1-f": {
              "status": "NOT_SUPPORTED",
              "details": "This machine family is not supported in this zone."
            }
          },
          "location": "zones/us-central1-a"
        }
      }
    }
  ]
}

如果要求的資源可用,輸出內容會包含 startTimeendTimelocation 欄位。這些欄位會指定資源可用的最早開始時間、最晚結束時間和時區。

為 GPU VM、H4D VM 或 TPU 建立預留要求

在日曆模式中建立未來預留項目要求時,您只能指定下列預留期間:

  • 開始時間:根據您要預留的資源,您必須指定開始時間,且該時間至少應為您建立及提交要求時的下列其中一個值:

    • GPU 和 H4D VM:87 小時 (3 天 15 小時)

    • TPU:6 小時

  • 結束時間:資源最多可預留 90 天。

如要使用現有 GPU 或 H4D VM 做為參考來建立要求,請使用Google Cloud 控制台。否則,請選取下列其中一個選項:

控制台

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

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

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

  3. 按一下 「Create future reservation」(建立未來預留項目)。「Create a future reservation」(建立未來預留項目) 頁面隨即顯示,並選取「Hardware configuration」(硬體設定) 窗格。

  4. 在「Configurations」(設定) 部分,指定要預留的 GPU VM、H4D VM 或 TPU 屬性,方法如下:

    • 如要直接指定 GPU VM、H4D VM 或 TPU 屬性,請完成下列步驟:

      1. 選取「指定機器類型」

      2. 按一下「GPU」、「TPU」或「運算最佳化」分頁標籤,然後選取支援的 GPU 機器類型、H4D 機器類型或 TPU 版本。

    • 如要使用現有 VM 做為參考,指定 GPU 或 H4D VM 屬性,請選取「使用現有 VM」,然後選取 VM。

  5. 如果您在上一個步驟中指定了 TPU v5e (CT5LP),請在「TPU v5 workload type」(TPU v5 工作負載類型) 清單中選取下列其中一個選項:

    • 如要在 TPU 上執行處理大量資料的工作負載 (單一或多項作業),例如機器學習訓練工作負載,請選取「批次」

    • 如要在 TPU 上執行處理並行要求的工作負載,並盡量減少網路延遲,例如機器學習推論工作負載,請選取「服務」

  6. 在「Search for capacity」(搜尋容量) 區段中,完成下列步驟:

    1. 在「Region」(區域) 和「Zone」(可用區) 清單中,指定要預留資源的區域和可用區。

    2. 在「Total capacity needed」(所需總容量) 欄位 (預留 GPU 或 H4D VM 時) 或「Number of chips」(晶片數量) 清單 (預留 TPU 時),指定要預留的 GPU VM、H4D VM 或 TPU 晶片數量。您可以指定下列值:

      • 如果是 GPU VM,則值介於 180 之間
      • 如果是 H4D VM,值必須介於 1256 之間
      • 如果是 TPU 晶片,值為 1481632641282565121024
    3. 在「開始時間」清單中,選取要求的開始時間。

    4. 選用:在「選擇彈性開始日期」清單中,選取開始日期必須有多準確。

    5. 在「預留時間長度」欄位中,指定要預留資源的時間長度。

    6. 按一下「搜尋運算資源」。接著,在「可用容量」表格中,選取其中一個可用選項,其中包含要預留的 GPU VM、H4D VM 或 TPU 的類型、數量和預留期間。

  7. 點選「下一步」

  8. 在「Share type」(共用類型) 部分,選取要共用所要求容量的專案:

    • 如要僅在專案中使用預留容量,請選取「本機」

    • 如要與其他專案共用預留容量,請選取「共用」,按一下 「新增專案」,然後按照提示選取專案。

  9. 點選「下一步」

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

  11. 在「Reservation name」(保留項目名稱) 欄位中,輸入 Compute Engine 自動建立的保留項目名稱,以佈建您要求的容量。

  12. 點選「建立」

gcloud

如要在日曆模式中建立未來預訂要求,並提交審查,請使用下列其中一個 gcloud beta compute future-reservations create 指令。 根據您要保留的資源,加入下列旗標:

  • 如要預留 GPU 或 H4D VM,請加入 --total-count--machine-type--deployment-type=DENSE 標記:

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
        --auto-delete-auto-created-reservations \
        --total-count=NUMBER_OF_VMS \
        --machine-type=MACHINE_TYPE \
        --deployment-type=DENSE \
        --planning-status=SUBMITTED \
        --require-specific-reservation \
        --reservation-mode=CALENDAR \
        --reservation-name=RESERVATION_NAME \
        --share-setting=SHARE_TYPE \
        --start-time=START_TIME \
        --end-time=END_TIME \
        --zone=ZONE
    
  • 如要預留 TPU,請加入 --chip-count--tpu-version 旗標:

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
        --auto-delete-auto-created-reservations \
        --chip-count=NUMBER_OF_CHIPS \
        --tpu-version=TPU_VERSION \
        --planning-status=SUBMITTED \
        --require-specific-reservation \
        --reservation-mode=CALENDAR \
        --reservation-name=RESERVATION_NAME \
        --share-setting=SHARE_TYPE \
        --start-time=START_TIME \
        --end-time=END_TIME \
        --zone=ZONE
    

更改下列內容:

  • FUTURE_RESERVATION_NAME:要求的名稱。

  • NUMBER_OF_VMS:要預留的 GPU 或 H4D VM 數量。如果是 GPU VM,值必須介於 180 之間。如果是 H4D VM,值必須介於 1256 之間。指定 VM 數量,該數量必須等於或小於您確認可用的 VM 數量

  • MACHINE_TYPE:要預留的 GPU 或 H4D 機型。

  • NUMBER_OF_CHIPS:要預留的 TPU 晶片數量。 指定的值必須等於或小於你確認可用的晶片數量。值必須是下列其中一個:1481632641282565121024

  • TPU_VERSION:要預留的 TPU 版本。如果您指定 TPU v5e (V5E),則必須加入 --workload-type 旗標,指定要在 TPU 上執行的工作負載類型。

  • RESERVATION_NAME:Compute Engine 自動建立的預留項目名稱,用於佈建您要求的容量。

  • SHARE_TYPE:機構中的其他專案是否可使用預留容量。請指定下列其中一個值:

    • 如要僅在專案中使用容量,請按照下列步驟操作:local

    • 如要與其他專案共用容量,請按照下列步驟操作:projects

    如果您指定 projects,則必須加入 --share-with 旗標,並將其設為以半形逗號分隔的專案 ID 清單,例如 project-1,project-2。您最多可以在機構內指定 100 個專案。請勿在這份清單中加入專案 ID。根據預設,您可以耗用預留容量。

  • START_TIME:請求的開始時間,您必須將格式設為 RFC 3339 時間戳記。

  • END_TIME:預訂期間的結束時間,格式必須為 RFC 3339 時間戳記。如要指定預訂期間的秒數,而非結束時間,請將 --end-time 旗標換成 --duration 旗標

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

REST

如要在日曆模式中建立未來預留項目要求,並提交審查,請對 beta futureReservations.insert 方法發出下列 POST 要求。根據要預訂的資源,在要求主體中加入下列欄位:

  • 如要預留 GPU 或 H4D VM,請加入 totalCountmachineType 欄位,以及設為 DENSEdeploymentType 欄位:

    POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations
    
    {
      "name": "FUTURE_RESERVATION_NAME",
      "autoDeleteAutoCreatedReservations": true,
      "deploymentType": "DENSE",
      "planningStatus": "SUBMITTED",
      "reservationMode": "CALENDAR",
      "reservationName": "RESERVATION_NAME",
      "shareSettings": {
        "shareType": "SHARE_TYPE"
      },
      "specificReservationRequired": true,
      "specificSkuProperties": {
        "totalCount": NUMBER_OF_VMS,
        "instanceProperties": {
          "machineType": "MACHINE_TYPE"
        }
      },
      "timeWindow": {
        "startTime": "START_TIME",
        "endTime": "END_TIME"
      }
    }
    
  • 如要預留 TPU,請加入 acceleratorCountvmFamily 欄位:

    POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations
    
    {
      "name": "FUTURE_RESERVATION_NAME",
      "autoDeleteAutoCreatedReservations": true,
      "planningStatus": "SUBMITTED",
      "reservationMode": "CALENDAR",
      "reservationName": "RESERVATION_NAME",
      "shareSettings": {
        "shareType": "SHARE_TYPE"
      },
      "specificReservationRequired": true,
      "aggregateReservation": {
        "reservedResources": [
          {
            "accelerator": {
              "acceleratorCount": NUMBER_OF_CHIPS
            }
          }
        ],
        "vmFamily": "TPU_VERSION"
      },
      "timeWindow": {
        "startTime": "START_TIME",
        "endTime": "END_TIME"
      }
    }
    

更改下列內容:

  • PROJECT_ID:您要在當中建立要求的專案 ID。

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

  • FUTURE_RESERVATION_NAME:要求的名稱。

  • RESERVATION_NAME:Compute Engine 自動建立的預留項目名稱,用於佈建您要求的容量。

  • SHARE_TYPE:機構中的其他專案是否可使用預留容量。請指定下列其中一個值:

    • 如要僅在專案中使用容量,請按照下列步驟操作:LOCAL

    • 如要與其他專案共用容量,請按照下列步驟操作:SPECIFIC_PROJECTS

    如果您指定 SPECIFIC_PROJECTS,則必須在 shareSettings 欄位中加入 projectMap 欄位,指定要共用容量的專案。您最多可以在機構內指定 100 個專案。請勿指定專案 ID。 根據預設,您可以取用預留容量。

    舉例來說,如要與另外兩個專案共用要求的容量,請加入下列項目:

    "shareSettings": {
      "shareType": "SPECIFIC_PROJECTS",
      "projectMap": {
        "CONSUMER_PROJECT_ID_1": {
          "projectId": "CONSUMER_PROJECT_ID_1"
        },
        "CONSUMER_PROJECT_ID_2": {
          "projectId": "CONSUMER_PROJECT_ID_2"
        }
      }
    }
    

    CONSUMER_PROJECT_ID_1CONSUMER_PROJECT_ID_2 替換為您要允許使用所要求容量的兩個專案 ID。

  • NUMBER_OF_VMS:要預留的 GPU 或 H4D VM 數量。如果是 GPU VM,值必須介於 180 之間。 如果是 H4D VM,值必須介於 1256 之間。 指定的 VM 數量必須等於或低於確認可用的 VM 數量

  • MACHINE_TYPE:要預留的 GPU 或 H4D 機型。

  • NUMBER_OF_CHIPS:要預留的 TPU 晶片數量。 指定的值必須等於或小於你確認可用的晶片數量。值必須是下列其中一個:1481632641282565121024

  • TPU_VERSION:要預留的 TPU 版本。如果您指定 TPU v5e (VM_FAMILY_CLOUD_TPU_LITE_POD_SLICE_CT5LP),則必須在 aggregateResources 欄位中加入 workloadType 欄位,指定要在 TPU 上執行的工作負載類型。

  • START_TIME:請求的開始時間,您必須將格式設為 RFC 3339 時間戳記。

  • END_TIME:預訂期間的結束時間,格式必須為 RFC 3339 時間戳記。如要指定預訂期間的秒數,而非結束時間,請將 endTime 欄位替換為 duration 欄位。

後續步驟