Ver capacidade reservada

Neste documento, explicamos como conferir seus pedidos e sua capacidade reservada para o Hipercomputador de IA. Ao visualizar a disponibilidade, as propriedades e a topologia da capacidade reservada e das solicitações, é possível planejar a capacidade reservada para suas cargas de trabalho.

O escopo deste documento é limitado a cargas de trabalho que usam uma opção de capacidade que menciona reservas futuras. Para mais informações sobre as opções de capacidade da AI Hypercomputer, consulte Visão geral da capacidade.

Depois que Google Cloud aprova uma solicitação de reserva adiantada, o Compute Engine cria automaticamente (cria automaticamente) uma reserva vazia para os recursos solicitados. Em seguida, é possível conferir a reserva para planejar sua carga de trabalho. Mais tarde, no horário de início solicitado, acontece o seguinte:

O Compute Engine adiciona as instâncias de máquina virtual (VM) reservadas à reserva. Em seguida, é possível começar a usar a reserva criando VMs que correspondam a ela.
É possível modificar a reserva para permitir que jobs de treinamento ou previsão da Vertex AI a usem. Para instruções, consulte Modificar a política de compartilhamento de uma reserva.

Limitações

Só é possível acessar uma reserva compartilhada ou uma solicitação de reserva adiantada compartilhada no projeto em que o Google a criou.

Antes de começar

Reservar capacidade:se ainda não tiver feito isso, reserve capacidade para o AI Hypercomputer usando uma das seguintes opções:
- Reservar capacidade com sua equipe de conta
- Criar uma solicitação de reserva adiantada no modo de calendário

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

Para usar as amostras da API REST desta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para gcloud CLI.

Instale a CLI do Google Cloud. Após a instalação, inicialize a CLI do Google Cloud executando o seguinte comando:

gcloud init

Ao usar um provedor de identidade (IdP) externo, primeiro faça login na gcloud CLI com sua identidade federada.

Saiba mais em Autenticar para usar REST na documentação de autenticação do Google Cloud .

Funções exigidas

Para receber as permissões necessárias para ver reservas, peça ao administrador para conceder a você o papel do IAM de Usuário da reserva adiantada do Compute (roles/compute.futureReservationUser) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém as permissões necessárias para visualizar reservas. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As seguintes permissões são necessárias para visualizar reservas:

Para ver os detalhes de uma solicitação de reserva adiantada: compute.futureReservations.get no projeto
Para ver os detalhes de uma reserva: compute.reservations.get no projeto

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Ver suas solicitações de capacidade reservada

Para conferir suas solicitações de reserva futuras, use um ou mais dos seguintes métodos:

Para ter uma visão geral de todas as solicitações de reserva adiantada no seu projeto, confira uma lista de solicitações de reserva adiantada.
Para conferir todos os detalhes de uma única solicitação de reserva adiantada, confira os detalhes de uma solicitação de reserva adiantada.

Ver uma lista das suas solicitações de reserva adiantadas

É possível conferir uma lista das suas solicitações de reserva adiantada para ver o período, o status e a zona das solicitações.

Para conferir uma lista das suas solicitações de reserva adiantada, selecione uma das seguintes opções:

Console

No console do Google Cloud , acesse a página Reservas.
Acesse "Reservas"
Clique na guia Reservas adiantadas. A tabela lista cada solicitação de reserva adiantada, e cada coluna descreve uma propriedade.
Opcional: para refinar sua lista de solicitações, no campo Filtro, selecione as propriedades que você quer usar para filtrar as solicitações.

gcloud

Para ver uma lista das suas solicitações de reserva adiantadas, use o comando gcloud compute future-reservations list:

gcloud compute future-reservations list

A resposta será semelhante a:

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

Se você quiser refinar sua lista de solicitações de reserva adiantada, use o mesmo comando com a flag --filter.

REST

Para conferir uma lista das suas solicitações de reserva adiantada, faça uma solicitação GET para um dos seguintes métodos:

Para conferir uma lista de solicitações em todas as zonas: método futureReservations.aggregatedList
Para conferir uma lista de solicitações em uma zona específica: método futureReservations.list

Por exemplo, para conferir uma lista de solicitações em todas as zonas, faça uma solicitação GET da seguinte maneira:

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

Substitua PROJECT_ID pelo ID do projeto em que as solicitações estão.

A saída de uma lista de solicitações de reserva adiantada em uma única zona é semelhante a esta:

{
  "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"
}

Se quiser refinar sua lista de solicitações de reserva adiantada, faça a mesma solicitação e, no URL da solicitação, inclua o filter parâmetro de consulta.

Ver os detalhes de uma solicitação de reserva adiantada

É possível conferir os detalhes de uma solicitação de reserva adiantada para analisar as propriedades e o período de reserva dos recursos reservados.

Para conferir os detalhes de uma solicitação de reserva adiantada, selecione uma das seguintes opções:

Console

No console do Google Cloud , acesse a página Reservas.

Acesse "Reservas"
Clique na guia Reservas adiantadas. A tabela lista cada solicitação de reserva adiantada, e cada coluna descreve uma propriedade.
Para conferir os detalhes de uma solicitação, clique no nome dela na coluna Nome. Uma página com os detalhes da solicitação de reserva adiantada vai aparecer.

gcloud

Para conferir os detalhes de uma solicitação de reserva adiantada, use o comando gcloud compute future-reservations describe:

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

Substitua:

FUTURE_RESERVATION_NAME: o nome da solicitação de reserva adiantada.
ZONE: a zona em que a solicitação de reserva adiantada existe.

A resposta será semelhante a:

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

Para conferir os detalhes de uma solicitação de reserva adiantada, faça uma solicitação GET para o método futureReservations.get:

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

Substitua:

PROJECT_ID: o ID do projeto em que a solicitação de reserva adiantada existe.
ZONE: a zona em que a solicitação de reserva adiantada existe.
FUTURE_RESERVATION_NAME: o nome da solicitação de reserva adiantada.

O resultado será o seguinte:

{
  "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"
}

Ver sua capacidade reservada

Consulte sua capacidade reservada quando quiser fazer uma ou mais das seguintes ações:

Identifique uma reserva, um bloco e um subbloco que você quer usar para implantar uma carga de trabalho.
Entenda as propriedades, o uso e a topologia da sua capacidade reservada.

Para conferir sua capacidade reservada, use um ou mais dos seguintes métodos:

Para conferir uma visão geral de toda a capacidade reservada no seu projeto e verificar se há capacidade reservada não utilizada, confira uma lista de suas reservas.
Para revisar as propriedades e a disponibilidade de todas as VMs reservadas para uma reserva, confira os detalhes de uma reserva.
Para entender como os blocos e sub-blocos de capacidade de uma reserva são organizados, como para integração com seu programador ou ferramenta de planejamento, consulte a topologia de uma reserva.

Ver uma lista das suas reservas

É possível conferir uma lista das reservas no seu projeto para ver toda a capacidade reservada e pesquisar uma reserva para usar na implantação da carga de trabalho.

Para conferir uma lista das suas reservas, selecione uma das seguintes opções:

Console

No console do Google Cloud , acesse a página Reservas.
Acesse "Reservas"

Na guia Reservas sob demanda (padrão), a tabela lista cada reserva, e cada coluna descreve uma propriedade.
Opcional: para refinar sua lista de reservas, no campo Filtro, selecione as propriedades que você quer usar para filtrar as reservas.

gcloud

Para ver uma lista das suas reservas, use o comando gcloud compute reservations list:

gcloud compute reservations list

O resultado será o seguinte:

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

Se você quiser refinar sua lista de reservas, use o mesmo comando com a flag --filter.

REST

Para conferir uma lista das suas reservas, faça uma solicitação GET para um dos seguintes métodos:

Para conferir uma lista das suas reservas em todas as zonas: método reservations.aggregatedList
Para conferir uma lista das suas reservas em uma única zona: método reservations.list

Por exemplo, para ver uma lista das suas reservas em todas as zonas, faça uma solicitação GET da seguinte maneira:

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

Substitua PROJECT_ID pelo ID do projeto em que as reservas estão.

A saída de uma lista de reservas em uma única zona é semelhante a esta:

{
  "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"
}

Se quiser refinar sua lista de reservas, faça a mesma solicitação e, no URL da solicitação, inclua o parâmetro de consulta filter.

Ver os detalhes de uma reserva

É possível conferir os detalhes de uma reserva no seu projeto para entender detalhes como:

Quais tipos de VMs estão na reserva.
Quantas VMs estão reservadas e disponíveis na reserva.
A integridade da reserva, incluindo o número de blocos íntegros. (Disponível apenas usando a CLI gcloud ou REST.)

Para entender os blocos e sub-blocos de uma reserva, consulte Ver a topologia de uma reserva.

Para conferir os detalhes de uma reserva, selecione uma das seguintes opções:

Console

No console do Google Cloud , acesse a página Reservas.

Acesse "Reservas"
Na tabela Reservas sob demanda, na coluna Nome, clique no nome da reserva que você quer consultar. Uma página com os detalhes da reserva vai aparecer.

gcloud

Para conferir os detalhes de uma reserva, use o comando gcloud compute reservations describe:

gcloud compute reservations describe RESERVATION_NAME \
    --zone=ZONE

Substitua:

RESERVATION_NAME: o nome da reserva.
ZONE: a zona em que a reserva existe.

A resposta será semelhante a:

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

A saída inclui os seguintes campos para a reserva:

name: o nome da reserva.
healthInfo: as informações de saúde da reserva da seguinte forma:
- degradedBlockCount: o número de blocos degradados na reserva.
- healthStatus: o status geral de integridade da reserva.
- healthyBlockCount: o número de blocos íntegros na reserva.
reservationBlockCount: o número total de blocos na reserva.
assuredCount: o número total de VMs que podem ser implantadas usando a reserva. Se esse valor for menor que count, consulte como resolver problemas de menos VMs disponíveis para consumo.
inUseCount: o número de VMs já implantadas na reserva.
instanceProperties: as propriedades das VMs que podem ser implantadas na reserva.

REST

Para conferir os detalhes de uma reserva, faça uma solicitação GET para o método reservations.get:

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

Substitua:

PROJECT_ID: o ID do projeto em que a reserva está.
ZONE: a zona em que a reserva existe.
RESERVATION_NAME: o nome da reserva.

O resultado será o seguinte:

{
  "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"
}

A saída inclui os seguintes campos para a reserva:

instanceProperties: as propriedades das VMs que podem ser implantadas na reserva.
inUseCount: o número de VMs já implantadas na reserva.
assuredCount: o número total de VMs que podem ser implantadas usando a reserva. Se esse valor for menor que count, consulte como resolver problemas de menos VMs disponíveis para consumo.
name: o nome da reserva.
healthInfo: as informações de saúde da reserva da seguinte forma:
- healthStatus: o status geral de integridade da reserva.
- healthyBlockCount: o número de blocos íntegros na reserva.
- degradedBlockCount: o número de blocos degradados na reserva.

Ver a topologia de uma reserva

Você pode conferir as informações detalhadas de topologia de uma reserva para decidir onde criar VMs nos blocos e sub-blocos reservados. Para informações sobre o posicionamento de VMs reservadas que já foram implantadas, consulte Ver a topologia de uma instância de computação.

Se você quiser conferir outros detalhes sobre uma reserva, consulte Ver detalhes de uma reserva.

Ver blocos reservados

Para listar e descrever os blocos disponíveis em uma reserva, use um dos seguintes métodos. Esta tarefa ajuda você a determinar o seguinte:

Quais blocos de capacidade estão na reserva.
Quanta capacidade está disponível em cada bloco.
A integridade de cada bloco, incluindo o número de sub-blocos íntegros. (Disponível apenas usando a CLI gcloud ou REST.)
O nome, o bloco e o sub-bloco de todas as VMs implantadas no bloco. (Disponível apenas ao visualizar um bloco específico usando a CLI gcloud ou a REST.)

Console

No console do Google Cloud , acesse a página Reservas.

Acesse "Reservas"
Na tabela Reservas sob demanda, na coluna Nome, clique no nome da reserva que você quer consultar. A página de detalhes da reserva será exibida.
Na seção Topologia de recursos, é possível conferir informações sobre os blocos reservados. Essas informações incluem o seguinte para cada bloco:
- ID do bloco: o nome do bloco.
- Contagem: o número total de VMs que podem ser implantadas no bloco.
- Em uso: o número de VMs já implantadas no bloco.

gcloud

É possível conferir os blocos em uma reserva usando os seguintes comandos:

Para conferir todos os blocos disponíveis em uma reserva, use o comando gcloud compute reservations blocks list:
```
gcloud compute reservations blocks list RESERVATION_NAME \
    --zone=ZONE
```
Para ver um bloco específico em uma reserva, use o comando gcloud compute reservations blocks describe. Para conferir também o nome e a topologia de todas as VMs implantadas no bloco, adicione a flag --full-view=BLOCK_VIEW_FULL.
```
gcloud compute reservations blocks describe RESERVATION_NAME \
    --zone=ZONE \
    --block-name=BLOCK_NAME \
    --full-view=BLOCK_VIEW_FULL
```

Substitua:

RESERVATION_NAME: o nome da reserva.
ZONE: a zona em que a reserva existe.
BLOCK_NAME: o nome do bloco.

A saída para cada bloco é semelhante ao exemplo a seguir:

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

A saída inclui os seguintes campos para cada bloco:

count: o número total de VMs que podem ser implantadas no bloco.
healthInfo: as informações de saúde do bloco da seguinte forma:
- degradedSubBlockCount: o número de sub-blocos degradados no bloco.
- healthStatus: o status geral de integridade do bloco.
- healthySubBlockCount: o número de sub-blocos íntegros no bloco.
inUseCount: o número de VMs já implantadas no bloco.
name: o nome do bloco.
physicalTopology: o local físico do bloco, que também aparece na topologia da VM, da seguinte forma:
- block: o ID específico da organização do bloco.
- cluster: o nome global do cluster.
- instances: uma lista dos nomes e locais físicos de todas as VMs no bloco, da seguinte forma: Esse campo só aparece quando você inclui a flag --full-view=BLOCK_VIEW_FULL.
  - instanceId: o ID de uma instância.
  - subBlock: o ID específico da organização do sub-bloco em que essa instância está localizada.
  - block: o ID específico da organização do bloco em que esta instância está localizada.
reservationSubBlockCount: o número de sub-blocos no bloco.
reservationSubBlockInUseCount: o número de sub-blocos no bloco com pelo menos uma VM já implantada.

REST

É possível conferir os bloqueios em uma reserva usando os seguintes métodos:

Para conferir todos os blocos disponíveis em uma reserva, faça uma solicitação GET para o método reservationBlocks.list:

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

Para conferir um bloco específico em uma reserva, faça uma solicitação GET para o método reservationBlocks.get. Para conferir também o nome e a topologia de todas as VMs implantadas no bloco, adicione o parâmetro de consulta ?view=FULL.
```
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks/BLOCK_NAME?view=FULL
```

Substitua:

PROJECT_ID: o ID do projeto em que a reserva existe.
ZONE: a zona em que a reserva existe.
RESERVATION_NAME: o nome da reserva.
BLOCK_NAME: o nome do bloco.

A saída para cada bloco é semelhante a esta:

{
  "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
    }
  }
}

A saída inclui os seguintes campos para cada bloco:

name: o nome do bloco.
count: o número total de VMs que podem ser implantadas no bloco.
inUseCount: o número de VMs já implantadas no bloco.
physicalTopology: o local físico do bloco, que também aparece na topologia da VM, da seguinte forma:
- cluster: o nome global do cluster.
- block: o ID específico da organização do bloco.
- instances: uma lista dos nomes e locais físicos de todas as VMs no bloco, da seguinte forma: Esse campo só aparece quando você inclui o parâmetro de consulta ?view=FULL.
  - instanceId: o ID de uma instância.
  - subBlock: o ID específico da organização do sub-bloco em que essa instância está localizada.
  - block: o ID específico da organização do bloco em que esta instância está localizada.
reservationSubBlockCount: o número de sub-blocos no bloco.
reservationSubBlockInUseCount: o número de sub-blocos no bloco com pelo menos uma VM já implantada.
healthInfo: as informações de saúde do bloco da seguinte forma:
- healthStatus: o status geral de integridade do bloco.
- healthySubBlockCount: o número de sub-blocos íntegros no bloco.
- degradedSubBlockCount: o número de sub-blocos degradados no bloco.

Ver sub-blocos reservados

Para listar e descrever os sub-blocos disponíveis em um bloco de uma reserva, use a Google Cloud CLI ou a API REST. Esta tarefa ajuda você a determinar o seguinte:

Quais sub-blocos de capacidade estão no bloco reservado.
Quanta capacidade está disponível em cada sub-bloco.
O estado de cada sub-bloco, incluindo o número de máquinas host íntegras e de interconexões de aceleradores íntegras.

gcloud

É possível conferir os sub-blocos em uma reserva usando os seguintes comandos:

Para conferir todos os sub-blocos disponíveis em um bloco de uma reserva, use o comando gcloud compute reservations sub-blocks list:
```
gcloud compute reservations sub-blocks list RESERVATION_NAME \
    --zone=ZONE \
    --block-name=BLOCK_NAME
```

Para conferir um sub-bloco específico em um bloco de uma reserva, use o comando 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

Substitua:

RESERVATION_NAME: o nome da reserva.
ZONE: a zona em que a reserva existe.
BLOCK_NAME: o nome do bloco.
SUB-BLOCK_NAME: o nome do sub-bloco.

A saída para cada sub-bloco é semelhante a esta:

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

A saída inclui os seguintes campos para cada sub-bloco:

count: o número total de VMs que podem ser implantadas no subbloco.
healthInfo: as informações de saúde do subbloco da seguinte forma:
- degradedHostCount: o número de máquinas host degradadas no sub-bloco.
- degradedInfraCount: o número de interconexões de acelerador degradadas no subbloco.
- healthStatus: o status geral de integridade do sub-bloco.
- healthyHostCount: o número de máquinas host íntegras no subbloco.
- healthyInfraCount: o número de interconexões de acelerador íntegras no subbloco.
inUseCount: o número de VMs já implantadas no sub-bloco.
name: o nome do sub-bloco.
physicalTopology: a localização física do subbloco, que também aparece na topologia da VM, da seguinte forma:
- block: o ID específico da organização do bloco.
- cluster: o nome global do cluster.
- subblock: o ID específico da organização do sub-bloco.

REST

É possível conferir os sub-blocos em uma reserva usando os seguintes métodos:

Para conferir todos os sub-blocos disponíveis em um bloco de uma reserva, faça uma solicitação GET para o método reservationSubBlocks.list:

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

Para conferir um sub-bloco específico em um bloco de uma reserva, faça uma solicitação GET para o método reservationSubBlocks.get:

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

Substitua:

PROJECT_ID: o ID do projeto em que a reserva existe.
ZONE: a zona em que a reserva existe.
RESERVATION_NAME: o nome da reserva.
BLOCK_NAME: o nome do bloco.
SUB-BLOCK_NAME: o nome do sub-bloco.

A saída para cada sub-bloco é semelhante a esta:

{
  "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
    }
  }
}

A saída inclui os seguintes campos para cada sub-bloco:

name: o nome do sub-bloco.
count: o número total de VMs que podem ser implantadas no subbloco.
inUseCount: o número de VMs já implantadas no sub-bloco.
physicalTopology: a localização física do subbloco, que também aparece na topologia da VM, da seguinte forma:
- cluster: o nome global do cluster.
- block: o ID específico da organização do bloco.
- subblock: o ID específico da organização do sub-bloco.
healthInfo: as informações de saúde do subbloco da seguinte forma:
- healthStatus: o status geral de integridade do sub-bloco.
- healthyHostCount: o número de máquinas host íntegras no subbloco.
- degradedHostCount: o número de máquinas host degradadas no sub-bloco.
- healthyInfraCount: o número de interconexões de acelerador íntegras no subbloco.
- degradedInfraCount: o número de interconexões de acelerador degradadas no subbloco.

Ver capacidade reservada Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Limitações

Antes de começar

Console

gcloud

REST

Funções exigidas

Permissões necessárias

Ver suas solicitações de capacidade reservada

Ver uma lista das suas solicitações de reserva adiantadas

Console

gcloud

REST

Ver os detalhes de uma solicitação de reserva adiantada

Console

gcloud

REST

Ver sua capacidade reservada

Ver uma lista das suas reservas

Console

gcloud

REST

Ver os detalhes de uma reserva

Console

gcloud

REST

Ver a topologia de uma reserva

Ver blocos reservados

Console

gcloud

REST

Ver sub-blocos reservados

gcloud

REST

A seguir

Ver capacidade reservada