查看預留容量

本文說明如何查看 AI Hypercomputer 的預留容量要求和預留容量。查看預留容量和要求的可用性、屬性和拓撲，即可為工作負載規劃預留容量。

本文件僅適用於使用容量選項的工作負載，且該選項提及未來預留。如要進一步瞭解 AI Hypercomputer 的容量選項，請參閱容量總覽。

Google Cloud 核准未來預留項目要求後，Compute Engine 會自動為您要求的資源建立 (自動建立) 空預留項目。接著，您就可以查看預訂內容，規劃工作負載。稍後，在要求的開始時間，會發生下列情況：

Compute Engine 會將預留的虛擬機器 (VM) 執行個體新增至預留項目。接著，您可以建立符合預留資源的 VM，開始使用預留資源。
您可以修改預留項目，允許 Vertex AI 訓練或預測工作使用。如需操作說明，請參閱「修改預訂的共用政策」。

限制

您只能在 Google 建立共用預留項目或共用未來預留項目要求的專案中查看。

事前準備

預留容量：如果專案尚未預留容量，請使用下列其中一個選項，為 AI 超級電腦預留容量：
- 透過帳戶團隊預留容量
- 在日曆模式中建立未來預留項目要求

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

In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

REST

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

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

gcloud init

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

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

必要的角色

如要取得查看預留資源所需的權限，請要求管理員授予您專案的「Compute Future Reservation User」(Compute 未來預留資源使用者) (roles/compute.futureReservationUser) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備查看預訂所需的權限。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：

所需權限

如要查看預留項目，必須具備下列權限：

如要查看未來預留項目要求的詳細資料，請在專案上按一下 compute.futureReservations.get。
如要查看預訂詳細資料： compute.reservations.get 專案

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

查看預留容量要求

如要查看未來的預留項目要求，請使用下列一或多種方法：

如要查看專案中所有未來預留項目要求的總覽，請查看未來預留項目要求清單。
如要查看單一未來預留項目要求的完整詳細資料，請查看未來預留項目要求詳細資料。

查看未來預留項目要求清單

您可以查看未來預留項目要求清單，瞭解要求預留項目期間、狀態和區域。

如要查看未來預留項目要求清單，請選取下列其中一個選項：

控制台

前往 Google Cloud 控制台的「Reservations」(預留項目) 頁面。
前往「Reservations」(預留項目) 頁面
點選「Future reservations」(未來預留項目) 分頁標籤。表格會列出每項預訂要求，每個表格欄位則說明一項屬性。
選用：如要縮小要求清單範圍，請在「Filter」(篩選器) 欄位中，選取要用來篩選要求的屬性。

gcloud

如要查看未來預留項目要求清單，請使用 gcloud compute future-reservations list 指令：

gcloud compute future-reservations list

輸出結果會與下列範例相似：

NAME: fr-01
TOTAL_COUNT: 100
START_TIME: 2026-07-20T07:00:00Z
END_TIME: 2026-08-05T07:00:00Z
PROCUREMENT_STATUS: FULFILLED
ZONE: us-west4-b

NAME: fr-02
TOTAL_COUNT: 10
START_TIME: 2026-07-20T07:00:00Z
END_TIME: 2026-12-01T00:00:00Z
PROCUREMENT_STATUS: PENDING_APPROVAL
ZONE: us-west4-b

如要縮小未來預留項目要求清單的範圍，請使用相同的指令搭配 --filter 旗標。

REST

如要查看未來預留項目要求清單，請對下列其中一種方法發出 GET 要求：

如要查看所有區域的要求清單：futureReservations.aggregatedList 方法
如要查看特定區域中的要求清單：futureReservations.list 方法

舉例來說，如要查看所有區域的要求清單，請發出 GET 要求，如下所示：

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/futureReservations

將 PROJECT_ID 替換為要求所在的專案 ID。

單一可用區的未來預留項目要求清單輸出內容如下所示：

{
  "id": "projects/example-project/aggregated/futureReservations",
  "items": [
    {
      "specificSkuProperties": {
        "instanceProperties": {
          "machineType": "a3-ultragpu-8g",
          "guestAccelerators": [
            {
              "acceleratorType": "nvidia-h200-141gb",
              "acceleratorCount": 8
            }
          ],
          "localSsds": [
            {
              "diskSizeGb": "375",
              "interface": "NVME"
            },
            ...
          ]
        },
        "totalCount": "2"
      },
      "kind": "compute#futureReservation",
      "id": "7979651787097007552",
      "creationTimestamp": "2025-11-27T11:14:58.305-08:00",
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/example-draft-request",
      "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/7979651787097007552",
      "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b",
      "name": "example-draft-request",
      "timeWindow": {
        "startTime": "2026-01-27T19:20:00Z",
        "endTime": "2026-02-10T19:20:00Z"
      },
      "status": {
        "procurementStatus": "DRAFTING",
        "lockTime": "2026-01-27T19:15:00Z"
      },
      "planningStatus": "DRAFT",
      "specificReservationRequired": true,
      "reservationName": "example-reservation",
      "deploymentType": "DENSE",
      "schedulingType": "INDEPENDENT",
      "autoCreatedReservationsDeleteTime": "2026-02-10T19:20:00Z"
    },
    ...
  ],
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/aggregated/futureReservations",
  "etag": "AnzKY34l-cvvV-JnniESJ0dtQvQ=/hvc4jaHpxFAZmOt1FVtKNgzZu-M=",
  "kind": "compute#futureReservationsListResponse"
}

如要縮小未來預留項目要求清單的範圍，請發出相同要求，並在要求網址中加入 filter 查詢參數。

查看未來預留項目的詳細資料要求

您可以查看未來預留項目要求的詳細資料，瞭解預留資源的屬性和預留期間。

如要查看未來預留項目要求的詳細資料，請選取下列其中一個選項：

控制台

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

前往「Reservations」(預留項目) 頁面
點選「Future reservations」(未來預留項目) 分頁標籤。表格會列出每項預訂要求，每個表格欄位則說明一項屬性。
如要查看要求的詳細資料，請按一下「名稱」欄中的要求名稱。系統會開啟頁面，顯示未來預留要求詳細資料。

gcloud

如要查看未來預留項目要求的詳細資料，請使用 gcloud compute future-reservations describe 指令：

gcloud compute future-reservations describe FUTURE_RESERVATION_NAME \
    --zone=ZONE

更改下列內容：

FUTURE_RESERVATION_NAME：未來預留項目要求的名稱。
ZONE：未來預留項目要求所在的區域。

輸出結果會與下列範例相似：

autoCreatedReservationsDeleteTime: '2026-02-10T19:20:00Z'
creationTimestamp: '2025-11-27T11:14:58.305-08:00'
deploymentType: DENSE
id: '7979651787097007552'
kind: compute#futureReservation
name: example-draft-request
planningStatus: DRAFT
reservationName: example-reservation
schedulingType: INDEPENDENT
selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/example-draft-request
selfLinkWithId: https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/7979651787097007552
specificReservationRequired: true
specificSkuProperties:
  instanceProperties:
    guestAccelerators:
    -   acceleratorCount: 8
      acceleratorType: nvidia-h200-141gb
    localSsds:
    -   diskSizeGb: '375'
      interface: NVME
    ...
  machineType: a3-ultragpu-8g
totalCount: '2'
status:
  autoCreatedReservations:
  -   https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/reservations/example-reservation
  fulfilledCount: '2'
  lockTime: '2026-01-27T19:15:00Z'
  procurementStatus: DRAFTING
timeWindow:
  endTime: '2026-02-10T19:20:00Z'
  startTime: '2026-01-27T19:20:00Z'
zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b

REST

如要查看未來預留項目要求的詳細資料，請向 futureReservations.get 方法發出 GET 要求：

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

更改下列內容：

PROJECT_ID：未來預訂要求所在的專案 ID。
ZONE：未來預留項目要求所在的區域。
FUTURE_RESERVATION_NAME：未來預留項目要求的名稱。

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

{
  "specificSkuProperties": {
    "instanceProperties": {
      "machineType": "a3-ultragpu-8g",
      "guestAccelerators": [
        {
          "acceleratorType": "nvidia-h200-141gb",
          "acceleratorCount": 8
        }
      ],
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        ...
      ]
    },
    "totalCount": "2"
  },
  "kind": "compute#futureReservation",
  "id": "7979651787097007552",
  "creationTimestamp": "2025-11-27T11:14:58.305-08:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/example-draft-request",
  "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/7979651787097007552",
  "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b",
  "name": "example-draft-request",
  "timeWindow": {
    "startTime": "2026-01-27T19:20:00Z",
    "endTime": "2026-02-10T19:20:00Z"
  },
  "status": {
    "procurementStatus": "DRAFTING",
    "lockTime": "2026-01-27T19:15:00Z"
  },
  "planningStatus": "DRAFT",
  "specificReservationRequired": true,
  "reservationName": "example-reservation",
  "deploymentType": "DENSE",
  "schedulingType": "INDEPENDENT",
  "autoCreatedReservationsDeleteTime": "2026-02-10T19:20:00Z"
}

查看預留容量

如要執行下列一或多項操作，請查看預留容量：

找出要用於部署工作負載的預訂、區塊和子區塊。
瞭解預留容量的屬性、用量和拓撲。

如要查看預留容量，請使用下列一或多種方法：

如要查看專案中所有預留容量的總覽，並檢查是否有未使用的預留容量，請查看預留項目清單。
如要查看保留項目中所有預留 VM 的屬性和可用性，請查看保留項目的詳細資料。
如要瞭解保留項目的容量區塊和子區塊的組織方式，例如與排程器或規劃工具整合，請查看保留項目的拓撲。

查看預訂清單

您可以查看專案中的保留項目清單，瞭解專案中的所有保留容量，並搜尋要用於部署工作負載的保留項目。

如要查看預訂清單，請選取下列其中一個選項：

控制台

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

在「On-demand reservations」(隨需預留項目) 分頁 (預設)，表格會列出每個預留項目，而每個表格欄位則說明一項屬性。
(選用) 如要縮小預訂清單範圍，請在「Filter」(篩選器) 欄位中，選取要用來篩選預訂的屬性。

gcloud

如要查看預訂清單，請使用 gcloud compute reservations list 指令：

gcloud compute reservations list

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

NAME: r-01
IN_USE_COUNT: 0
COUNT: 5
ZONE: europe-west4-b
SHARE_TYPE: LOCAL

NAME: r-02
IN_USE_COUNT: 3
COUNT: 10
ZONE: europe-west4-b
SHARE_TYPE: LOCAL

如要縮小預訂清單範圍，請使用相同的指令搭配 --filter 旗標。

REST

如要查看預訂清單，請對下列其中一種方法發出 GET 要求：

如要查看所有區域的保留項目清單：reservations.aggregatedList 方法
如要查看單一可用區的預訂清單，請使用 reservations.list 方法：

舉例來說，如要查看所有區域的預訂清單，請發出下列 GET 要求：

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/reservations

將 PROJECT_ID 替換為預訂項目所在的專案 ID。

單一可用區的預留項目清單輸出內容如下所示：

{
  "id": "projects/example-project/zones/europe-west1-b/futureReservations",
  "items": [
    {
      "specificSkuProperties": {
        "instanceProperties": {
          "machineType": "a3-ultragpu-8g",
          "guestAccelerators": [
            {
              "acceleratorType": "nvidia-h200-141gb",
              "acceleratorCount": 8
            }
          ],
          "localSsds": [
            {
              "diskSizeGb": "375",
              "interface": "NVME"
            },
            ...
          ]
        },
        "totalCount": "2"
      },
      "kind": "compute#futureReservation",
      "id": "7979651787097007552",
      "creationTimestamp": "2025-11-27T11:14:58.305-08:00",
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/example-draft-request",
      "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/7979651787097007552",
      "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b",
      "name": "example-draft-request",
      "timeWindow": {
        "startTime": "2026-01-27T19:20:00Z",
        "endTime": "2026-02-10T19:20:00Z"
      },
      "status": {
        "procurementStatus": "DRAFTING",
        "lockTime": "2026-01-27T19:15:00Z"
      },
      "planningStatus": "DRAFT",
      "specificReservationRequired": true,
      "reservationName": "example-reservation",
      "deploymentType": "DENSE",
      "schedulingType": "INDEPENDENT",
      "autoCreatedReservationsDeleteTime": "2026-02-10T19:20:00Z"
    }
    ...
  ],
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations",
  "etag": "AnzKY34l-cvvV-JnniESJ0dtQvQ=/hvc4jaHpxFAZmOt1FVtKNgzZu-M=",
  "kind": "compute#futureReservationsListResponse"
}

如要縮小預訂項目清單範圍，請發出相同要求，並在要求網址中加入 filter 查詢參數。

查看預訂詳細資料

您可以查看專案中的預留項目詳細資料，瞭解下列詳細資料：

預留項目中的 VM 類型。
預留項目中預留和可用的 VM 數量。
預訂的健康狀態，包括健康狀態良好的區塊數量。 (僅能透過 gcloud CLI 或 REST 使用)。

如要瞭解預留項目的區塊和子區塊，請改為參閱「查看預留項目的拓撲」。

如要查看預訂詳細資料，請選取下列其中一個選項：

控制台

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

前往「Reservations」(預留項目) 頁面
在「隨選預訂」表格的「名稱」欄中，按一下要查看詳細資料的預訂名稱。系統會顯示預訂詳細資料頁面。

gcloud

如要查看預訂詳細資料，請使用 gcloud compute reservations describe 指令：

gcloud compute reservations describe RESERVATION_NAME \
    --zone=ZONE

更改下列內容：

RESERVATION_NAME：預訂名稱。
ZONE：預留項目所在的可用區。

輸出結果會與下列範例相似：

advancedDeploymentControl:
  reservationOperationalMode: ALL_CAPACITY
creationTimestamp: '2025-07-18T13:23:22.191-07:00'
deleteAtTime: '2026-06-19T00:00:00Z'
deploymentType: DENSE
enableEmergentMaintenance: false
id: '4298354039694234582'
kind: compute#reservation
name: example-res1
reservationSharingPolicy:
  serviceShareType: DISALLOW_ALL
resourceStatus:
  healthInfo:
    degradedBlockCount: 0
    healthStatus: HEALTHY
    healthyBlockCount: 1
  reservationBlockCount: 1
  reservationMaintenance:
    schedulingType: GROUPED
schedulingType: GROUPED
selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1
selfLinkWithId: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/4298354039694234582
shareSettings:
  shareType: LOCAL
specificReservation:
  assuredCount: '18'
  count: '18'
  inUseCount: '2'
  instanceProperties:
    guestAccelerators:
    -   acceleratorCount: 4
      acceleratorType: nvidia-gb200
    localSsds:
    -   diskSizeGb: '3000'
      interface: NVME
    -   diskSizeGb: '3000'
      interface: NVME
    -   diskSizeGb: '3000'
      interface: NVME
    -   diskSizeGb: '3000'
      interface: NVME
    machineType: a4x-highgpu-4g
specificReservationRequired: true
status: READY
zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a

輸出內容包含預訂的下列欄位：

name：預訂名稱。
healthInfo：預訂的健康資訊，如下所示：
- degradedBlockCount：預留空間中損毀的區塊數量。
- healthStatus：預訂的整體健康狀態。
- healthyBlockCount：預訂中正常運作的區塊數量。
reservationBlockCount：預訂中的區塊總數。
assuredCount：可使用預留項目部署的 VM 總數。如果這個值小於 count，請參閱如何排解可供使用的 VM 數量較少問題。
inUseCount：已在預留項目中部署的 VM 數量。
instanceProperties：可部署預留項目的 VM 屬性。

REST

如要查看預留項目的詳細資料，請向 reservations.get 方法發出 GET 要求：

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME

更改下列內容：

PROJECT_ID：預留項目所在的專案 ID。
ZONE：預留項目所在的可用區。
RESERVATION_NAME：預訂名稱。

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

{
  "specificReservation": {
    "instanceProperties": {
      "machineType": "a4x-highgpu-4g",
      "guestAccelerators": [
        {
          "acceleratorType": "nvidia-gb200",
          "acceleratorCount": 4
        }
      ],
      "localSsds": [
        {
          "diskSizeGb": "3000",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "3000",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "3000",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "3000",
          "interface": "NVME"
        }
      ]
    },
    "count": "36",
    "inUseCount": "35",
    "assuredCount": "33"
  },
  "kind": "compute#reservation",
  "id": "6823689647457870910",
  "creationTimestamp": "2025-08-04T13:40:50.496-07:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1",
  "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a",
  "name": "example-res1",
  "specificReservationRequired": true,
  "status": "READY",
  "shareSettings": {
    "shareType": "SPECIFIC_PROJECTS"
  },
  "resourceStatus": {
    "reservationMaintenance": {
      "upcomingGroupMaintenance": {
        "type": "SCHEDULED",
        "canReschedule": false,
        "maintenanceStatus": "ONGOING"
      },
      "maintenanceOngoingCount": 2,
      "maintenancePendingCount": 34,
      "schedulingType": "GROUPED",
      "subblockInfraMaintenanceOngoingCount": 0,
      "subblockInfraMaintenancePendingCount": 0,
      "instanceMaintenanceOngoingCount": 3,
      "instanceMaintenancePendingCount": 32
    },
    "reservationBlockCount": 1,
    "healthInfo": {
      "healthStatus": "DEGRADED",
      "healthyBlockCount": 0,
      "degradedBlockCount": 1
    }
  },
  "reservationSharingPolicy": {
    "serviceShareType": "DISALLOW_ALL"
  },
  "deploymentType": "DENSE",
  "advancedDeploymentControl": {
    "reservationOperationalMode": "ALL_CAPACITY"
  },
  "enableEmergentMaintenance": false,
  "schedulingType": "GROUPED",
  "deleteAtTime": "2025-10-01T00:00:00Z"
}

輸出內容包含預訂的下列欄位：

instanceProperties：可部署預留項目的 VM 屬性。
inUseCount：已在預留項目中部署的 VM 數量。
assuredCount：可使用預留項目部署的 VM 總數。如果這個值小於 count，請參閱如何排解可供使用的 VM 數量較少問題。
name：預訂名稱。
healthInfo：預訂的健康資訊，如下所示：
- healthStatus：預訂的整體健康狀態。
- healthyBlockCount：預訂中正常運作的區塊數量。
- degradedBlockCount：預留空間中損毀的區塊數量。

查看預留項目的拓撲

您可以查看預留項目的詳細拓撲資訊，決定要在預留區塊和子區塊中建立 VM。如要瞭解已部署預留 VM 的放置位置，請參閱「查看運算執行個體的拓撲」。

如要查看預訂的其他詳細資料，請參閱「查看預訂詳細資料」。

查看預留的區塊

如要列出及說明預留項目中的可用區塊，請使用下列任一方法。這項工作可協助您判斷下列事項：

預留項目中的容量區塊。
每個區塊的可用容量。
每個區塊的健康狀態，包括健康狀態良好的子區塊數量。 (僅能透過 gcloud CLI 或 REST 使用)。
部署在區塊中的所有 VM 名稱、區塊和子區塊。(僅在使用 gcloud CLI 或 REST 查看特定區塊時適用)。

控制台

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

前往「Reservations」(預留項目) 頁面
在「隨選預訂」表格的「名稱」欄中，按一下要查看詳細資料的預訂名稱。預訂詳細資料頁面隨即開啟。
您可以在「Resource topology」(資源拓撲) 區段中，查看預留區塊的相關資訊。這項資訊包括每個區塊的下列內容：
- 區塊 ID：區塊的名稱。
- 數量：可在區塊中部署的 VM 總數。
- 使用中：已在區塊中部署的 VM 數量。

gcloud

您可以使用下列指令，查看預訂中的區塊：

如要查看預訂中的所有可用區塊，請使用 gcloud compute reservations blocks list 指令：
```
gcloud compute reservations blocks list RESERVATION_NAME \
    --zone=ZONE
```
如要查看預留項目中的特定區塊，請使用 gcloud compute reservations blocks describe 指令。如要查看部署在區塊中的所有 VM 名稱和拓撲，請新增 --full-view=BLOCK_VIEW_FULL 旗標。
```
gcloud compute reservations blocks describe RESERVATION_NAME \
    --zone=ZONE \
    --block-name=BLOCK_NAME \
    --full-view=BLOCK_VIEW_FULL
```

更改下列內容：

RESERVATION_NAME：預訂的名稱。
ZONE：預留項目所在的可用區。
BLOCK_NAME：區塊名稱。

每個區塊的輸出內容與下列範例類似：

resource:
  count: 36
  creationTimestamp: '2025-08-04T15:15:07.074-07:00'
  healthInfo:
    degradedSubBlockCount: 2
    healthStatus: DEGRADED
    healthySubBlockCount: 0
  id: '4360924059555106309'
  inUseCount: 35
  kind: compute#reservationBlock
  name: example-res1-block-0001
  physicalTopology:
    block: 1acd074d42cd3be9e4486b524db2e9ab
    cluster: us-central1-cluster-dnkc
    instances:
    -   instanceId: '5815586279631866288'
      physicalHostTopology:
        host: c229b308380a83e0ca345d4a0de05aa7
        subBlock: c02af6bdaeccacef571e0adbe79e8c28
      projectId: 'PROJECT_NUMBER'
    ...
    -   instanceId: '8389759878923049076'
      physicalHostTopology:
        host: '3ac534f00c20e6e0c87c3aaff2705be6'
        subBlock: 'c081876ba0aa2857d608eb30a5b2fa40'
      projectId: 'PROJECT_NUMBER'
  reservationMaintenance:
    instanceMaintenanceOngoingCount: 3
    instanceMaintenancePendingCount: 32
    maintenanceOngoingCount: 2
    maintenancePendingCount: 34
    schedulingType: GROUPED
    subblockInfraMaintenanceOngoingCount: 0
    subblockInfraMaintenancePendingCount: 0
    upcomingGroupMaintenance:
      canReschedule: false
      maintenanceReasons:
      -   PLANNED_UPDATE
      maintenanceStatus: ONGOING
      type: SCHEDULED
      windowEndTime: '2025-09-08T17:00:00.000-07:00'
      windowStartTime: '2025-09-08T13:00:00.000-07:00'
  reservationSubBlockCount: 2
  reservationSubBlockInUseCount: 2
  selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001
  selfLinkWithId: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/4360924059555106309
  status: READY
  zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a

輸出內容會針對每個區塊包含下列欄位：

count：可在區塊中部署的 VM 總數。
healthInfo：區塊的健康狀態資訊，如下所示：
- degradedSubBlockCount：區塊中效能降低的子區塊數量。
- healthStatus：區塊的整體健康狀態。
- healthySubBlockCount：區塊中健康狀態良好的子區塊數量。
inUseCount：已在區塊中部署的 VM 數量。
name：區塊名稱。
physicalTopology：區塊的實體位置，也會顯示在 VM 拓撲中，如下所示：
- block：區塊的機構專屬 ID。
- cluster：叢集的全域名稱。
- instances：區塊中所有 VM 的名稱和實體位置清單，如下所示。(只有在您加入 --full-view=BLOCK_VIEW_FULL 旗標時，系統才會顯示這個欄位)。
  - instanceId：執行個體的 ID。
  - subBlock：這個執行個體所在的子區塊專屬 ID。
  - block：這個執行個體所在區塊的機構專屬 ID。
reservationSubBlockCount：區塊中的子區塊數量。
reservationSubBlockInUseCount：區塊中的子區塊數量，且至少已部署一個 VM。

REST

您可以使用下列方法查看預訂中的限制：

如要查看預訂中的所有可用區塊，請對 reservationBlocks.list 方法發出 GET 要求：

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks

如要查看預訂中的特定區塊，請對 reservationBlocks.get 方法發出 GET 要求。如要查看部署在區塊中的所有 VM 名稱和拓撲，請加入 ?view=FULL 查詢參數。
```
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks/BLOCK_NAME?view=FULL
```

更改下列內容：

PROJECT_ID：預留項目所在的專案 ID。
ZONE：預留項目所在的可用區。
RESERVATION_NAME：預訂名稱。
BLOCK_NAME：區塊名稱。

每個區塊的輸出內容如下：

{
  "resource": {
    "kind": "compute#reservationBlock",
    "id": "4360924059555106309",
    "creationTimestamp": "2025-08-04T15:15:07.074-07:00",
    "name": "example-res1-block-0001",
    "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a",
    "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001",
    "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/4360924059555106309",
    "count": 36,
    "inUseCount": 35,
    "reservationMaintenance": {
      "upcomingGroupMaintenance": {
        "type": "SCHEDULED",
        "canReschedule": false,
        "windowStartTime": "2025-09-08T13:00:00.000-07:00",
        "windowEndTime": "2025-09-08T17:00:00.000-07:00",
        "maintenanceStatus": "ONGOING",
        "maintenanceReasons": [
          "PLANNED_UPDATE"
        ]
      },
      "maintenanceOngoingCount": 2,
      "maintenancePendingCount": 34,
      "schedulingType": "GROUPED",
      "subblockInfraMaintenanceOngoingCount": 0,
      "subblockInfraMaintenancePendingCount": 0,
      "instanceMaintenanceOngoingCount": 3,
      "instanceMaintenancePendingCount": 32
    },
    "status": "READY",
    "physicalTopology": {
      "cluster": "us-central1-cluster-dnkc",
      "block": "1acd074d42cd3be9e4486b524db2e9ab",
      "instances": [
        {
          "instanceId": "5815586279631866288",
          "projectId": "PROJECT_NUMBER",
          "physicalHostTopology": {
            "subBlock": "c02af6bdaeccacef571e0adbe79e8c28",
            "host": "c229b308380a83e0ca345d4a0de05aa7"
          }
        },
        ...
        {
          "instanceId": "8389759878923049076",
          "projectId": "PROJECT_NUMBER",
          "physicalHostTopology": {
            "subBlock": "c081876ba0aa2857d608eb30a5b2fa40",
            "host": "3ac534f00c20e6e0c87c3aaff2705be6"
          }
        }
      ]
    },
    "reservationSubBlockCount": 2,
    "reservationSubBlockInUseCount": 2,
    "healthInfo": {
      "healthStatus": "DEGRADED",
      "healthySubBlockCount": 0,
      "degradedSubBlockCount": 2
    }
  }
}

輸出內容會針對每個區塊包含下列欄位：

name：區塊名稱。
count：可在區塊中部署的 VM 總數。
inUseCount：已在區塊中部署的 VM 數量。
physicalTopology：區塊的實體位置，也會顯示在 VM 拓撲中，如下所示：
- cluster：叢集的全域名稱。
- block：區塊的機構專屬 ID。
- instances：區塊中所有 VM 的名稱和實體位置清單，如下所示。(只有在加入 ?view=FULL 查詢參數時，系統才會顯示這個欄位)。
  - instanceId：執行個體的 ID。
  - subBlock：這個執行個體所在的子區塊專屬 ID。
  - block：這個執行個體所在區塊的機構專屬 ID。
reservationSubBlockCount：區塊中的子區塊數量。
reservationSubBlockInUseCount：區塊中的子區塊數量，且至少已部署一個 VM。
healthInfo：區塊的健康狀態資訊，如下所示：
- healthStatus：區塊的整體健康狀態。
- healthySubBlockCount：區塊中健康狀態良好的子區塊數量。
- degradedSubBlockCount：區塊中效能降低的子區塊數量。

查看預留的子區塊

如要列出及說明預訂區塊中的可用子區塊，請使用 Google Cloud CLI 或 REST API。這項工作可協助您判斷下列事項：

保留區塊中的容量子區塊。
每個子區塊的可用容量。
每個子區塊的健康狀態，包括健康主機數量和健康加速器互連數量。

gcloud

您可以使用下列指令，查看預訂中的子區塊：

如要查看預留區塊中的所有可用子區塊，請使用 gcloud compute reservations sub-blocks list 指令：
```
gcloud compute reservations sub-blocks list RESERVATION_NAME \
    --zone=ZONE \
    --block-name=BLOCK_NAME
```

如要查看預留項目區塊中的特定子區塊，請使用 gcloud compute reservations sub-blocks describe 指令：

gcloud compute reservations sub-blocks describe RESERVATION_NAME \
    --zone=ZONE \
    --block-name=BLOCK_NAME \
    --sub-block-name=SUB-BLOCK_NAME

更改下列內容：

RESERVATION_NAME：預訂的名稱。
ZONE：預留項目所在的可用區。
BLOCK_NAME：區塊名稱。
SUB-BLOCK_NAME：子區塊的名稱。

每個子區塊的輸出內容如下：

count: 18
creationTimestamp: '2025-07-18T14:50:01.652-07:00'
healthInfo:
  degradedHostCount: 0
  degradedInfraCount: 0
  healthStatus: HEALTHY
  healthyHostCount: 18
  healthyInfraCount: 1
id: '6848013619223297894'
inUseCount: 2
kind: compute#reservationSubBlock
name: example-res1-block-0001-subblock-0001
physicalTopology:
  block: 2b6aa63faa2b60b7ecd3b87ec337f270
  cluster: us-central1-cluster-xvhj
  subBlock: 556a310b49a0b247bc109cc7f997cea2
reservationSubBlockMaintenance:
  schedulingType: GROUPED
selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001/reservationSubBlocks/example-res1-block-0001-subblock-0001
selfLinkWithId: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001/reservationSubBlocks/6848013619223297894
status: READY
zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a

輸出內容會針對每個子區塊包含下列欄位：

count：可在子區塊中部署的 VM 總數。
healthInfo：子區塊的健康狀態資訊，如下所示：
- degradedHostCount：子區塊中效能降低的主機數量。
- degradedInfraCount：子區塊中效能降低的加速器互連數量。
- healthStatus：子區塊的整體健康狀態。
- healthyHostCount：子區塊中運作正常的主機數量。
- healthyInfraCount：子區塊中健康狀態良好的加速器互連數量。
inUseCount：已部署在子區塊中的 VM 數量。
name：子區塊的名稱。
physicalTopology：子區塊的實體位置，也會顯示在 VM 拓撲中，如下所示：
- block：區塊的機構專屬 ID。
- cluster：叢集的全域名稱。
- subblock：子區塊的機構專屬 ID。

REST

您可以使用下列方法查看預訂中的子區塊：

如要查看預訂區塊中所有可用的子區塊，請對 reservationSubBlocks.list 方法發出 GET 要求：

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks/BLOCK_NAME/reservationSubBlocks

如要查看預訂區塊中的特定子區塊，請對 reservationSubBlocks.get 方法發出 GET 要求：

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks/BLOCK_NAME/reservationSubBlocks/SUB-BLOCK_NAME

更改下列內容：

PROJECT_ID：預留項目所在的專案 ID。
ZONE：預留項目所在的可用區。
RESERVATION_NAME：預訂名稱。
BLOCK_NAME：區塊名稱。
SUB-BLOCK_NAME：子區塊的名稱。

每個子區塊的輸出內容如下：

{
  "resource": {
    "kind": "compute#reservationSubBlock",
    "id": "5679680646666817028",
    "creationTimestamp": "2025-08-04T15:15:07.625-07:00",
    "name": "example-res1-block-0001-subblock-0001",
    "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a",
    "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001/reservationSubBlocks/example-res1-block-0001-subblock-0001",
    "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001/reservationSubBlocks/5679680646666817028",
    "count": 18,
    "inUseCount": 18,
    "reservationSubBlockMaintenance": {
      "upcomingGroupMaintenance": {
        "type": "SCHEDULED",
        "canReschedule": false,
        "windowStartTime": "2025-09-08T13:00:00.000-07:00",
        "windowEndTime": "2025-09-08T17:00:00.000-07:00",
        "maintenanceStatus": "ONGOING",
        "maintenanceReasons": [
          "PLANNED_UPDATE"
        ]
      },
      "maintenanceOngoingCount": 2,
      "maintenancePendingCount": 16,
      "schedulingType": "GROUPED",
      "subblockInfraMaintenanceOngoingCount": 0,
      "subblockInfraMaintenancePendingCount": 0,
      "instanceMaintenanceOngoingCount": 3,
      "instanceMaintenancePendingCount": 15
    },
    "status": "READY",
    "physicalTopology": {
      "cluster": "us-central1-cluster-dnkc",
      "block": "1acd074d42cd3be9e4486b524db2e9ab",
      "subBlock": "c081876ba0aa2857d608eb30a5b2fa40"
    },
    "healthInfo": {
      "healthStatus": "DEGRADED",
      "healthyHostCount": 16,
      "degradedHostCount": 2,
      "healthyInfraCount": 1,
      "degradedInfraCount": 0
    }
  }
}

輸出內容會針對每個子區塊包含下列欄位：

name：子區塊的名稱。
count：可在子區塊中部署的 VM 總數。
inUseCount：已部署在子區塊中的 VM 數量。
physicalTopology：子區塊的實體位置，也會顯示在 VM 拓撲中，如下所示：
- cluster：叢集的全域名稱。
- block：區塊的機構專屬 ID。
- subblock：子區塊的機構專屬 ID。
healthInfo：子區塊的健康狀態資訊，如下所示：
- healthStatus：子區塊的整體健康狀態。
- healthyHostCount：子區塊中運作正常的主機數量。
- degradedHostCount：子區塊中效能降低的主機數量。
- healthyInfraCount：子區塊中健康狀態良好的加速器互連數量。
- degradedInfraCount：子區塊中效能降低的加速器互連數量。

查看預留容量 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

限制

事前準備

Console

gcloud

REST

必要的角色

所需權限

查看預留容量要求

查看未來預留項目要求清單

控制台

gcloud

REST

查看未來預留項目的詳細資料 要求

控制台

gcloud

REST

查看預留容量

查看預訂清單

控制台

gcloud

REST

查看預訂詳細資料

控制台

gcloud

REST

查看預留項目的拓撲

查看預留的區塊

控制台

gcloud

REST

查看預留的子區塊

gcloud

REST

後續步驟

查看預留容量

查看未來預留項目的詳細資料要求