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

主控台

在日曆模式下建立未來預留要求時，您可以查看某個地區的 GPU VM 或 TPU 未來可用性。詳情請參閱本文的「為 GPU VM 或 TPU 建立預訂要求」一節。

gcloud

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

• 如要查看 GPU 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：要預留的 GPU VM 數量。

• MACHINE_TYPE：要預留的 GPU 機型。

• NUMBER_OF_CHIPS：要預留的 TPU 晶片數量。

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

  • TPU v6e：V6E

  • 如果是 TPU v5p：V5P

  • 如果是 TPU v5e：V5E

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

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

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

• REGION：預留 GPU VM 或 TPU 的區域。如要查看支援的區域和可用區，請參閱本文的「限制」一節。

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

  YYYY-MM-DDTHH:MM:SSOFFSET
  

  更改下列內容：

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

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

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

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

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

- recommendationsPerSpec:
    spec:
      endTime: '2025-09-07T00:00:00Z'
      location: zones/us-east5-a
      otherLocations:
        zones/us-east5-b:
          details: this machine family is not supported in this zone
          status: NOT_SUPPORTED
        zones/us-east5-c:
          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'

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

REST

如要查看某個地區的 GPU VM 或 TPU 未來可用情形，請向 Beta 版 advice.calendarMode 方法發出 GET 要求。根據您想查看的資源，在要求主體中加入下列欄位：

• 如要查看 GPU VM 可用性，請加入 instanceCount 和 machineType 欄位：

  POST https://compute.s3nsapis.fr/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 可用性，請加入 acceleratorCount 和 vmFamily 欄位：

  POST https://compute.s3nsapis.fr/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 或 TPU 的區域。如要查看支援的區域和可用區，請參閱本文的「限制」一節。

• NUMBER_OF_VMS：要預留的 GPU VM 數量。

• MACHINE_TYPE：要預留的 GPU 機型。

• NUMBER_OF_CHIPS：要預留的 TPU 晶片數量。

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

  • 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 上執行的工作負載類型：

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

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

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

  YYYY-MM-DDTHH:MM:SSOFFSET
  

  更改下列內容：

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

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

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

• FROM_END_TIME 和 TO_END_TIME：容量預留結束的最早和最晚日期。請將這些日期設為 RFC 3339 時間戳記格式。如要指定預訂期間的時長範圍，而非結束時間，請將 endTimeNotEarlierThan 和 endTimeNotLaterThan 欄位替換為 minDuration 和 maxDuration 欄位。

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

{
  "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-east5-b": {
              "status": "NOT_SUPPORTED",
              "details": "this machine family is not supported in this zone"
            },
            "zones/us-east5-c": {
              "status": "NOT_SUPPORTED",
              "details": "this machine family is not supported in this zone"
            }
          },
          "location": "zones/us-east5-a"
        }
      }
    }
  ]
}

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

主控台

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

   前往「預留項目」頁面

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

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

4. 在「Configuration」(設定) 區段中，執行下列任一操作，指定要預留的 GPU VM 或 TPU 屬性：

   • 如要直接指定 GPU VM 或 TPU 屬性，請完成下列步驟：

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

     2. 按一下「GPU」或「TPU」分頁標籤，然後選取要預留的 GPU 機器類型或 TPU 版本。

   • 如要使用現有的執行個體範本指定 GPU VM 屬性，請選取「執行個體範本」，然後選取範本。

   • 如要使用現有 VM 做為參考，指定 GPU VM 屬性，請選取「Use existing 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 VM 時) 或「Number of chips」(晶片數量) 清單 (預留 TPU 時)，指定要預留的 GPU VM 或 TPU 晶片數量。

   3. 在「開始時間」清單中，選取要求的開始時間。

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

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

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

7. 點選「下一步」。

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

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

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

9. 點選「下一步」。

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

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

12. 點選「建立」。

gcloud

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

• 如要預留 GPU VM，請加入 --total-count 和 --machine-type 標記：

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

更改下列內容：

• FUTURE_RESERVATION_NAME：要求的名稱。

• NUMBER_OF_VMS：要預留的 GPU VM 數量。

• MACHINE_TYPE：要預留的 GPU 機型。

• NUMBER_OF_CHIPS：要預留的 TPU 晶片數量。

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

  • TPU v6e：V6E

  • 如果是 TPU v5p：V5P

  • 如果是 TPU v5e：V5E

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

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

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

• 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

如要在日曆模式中建立未來預留要求，並提交審查，請將下列 POST 要求傳送至 beta futureReservations.insert 方法。根據您要保留的資源，在要求主體中加入下列欄位：

• 如要預留 GPU VM，請加入 totalCount 和 machineType 欄位：

  POST https://compute.s3nsapis.fr/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，請加入 acceleratorCount 和 vmFamily 欄位：

  POST https://compute.s3nsapis.fr/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,
    "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_1 和 CONSUMER_PROJECT_ID_2 替換為您要允許使用所要求容量的兩個專案 ID。

• NUMBER_OF_VMS：要預留的 GPU VM 數量。

• MACHINE_TYPE：要預留的 GPU 機型。

• NUMBER_OF_CHIPS：要預留的 TPU 晶片數量。

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

  • 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 上執行的工作負載類型：

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

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

• START_TIME：請求的開始時間，格式為 RFC 3339 時間戳記。

• END_TIME：預訂期間的結束時間，格式為 RFC 3339 時間戳記。如要指定預訂期限 (以秒為單位)，而非結束時間，請將 endTime 欄位替換為 duration 欄位。