Ver capacidade reservada

Neste documento, explicamos como visualizar seus pedidos e sua capacidade reservada para o Hipercomputador de IA. Ao conferir 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 do Hipercomputador de IA, consulte Visão geral da capacidade.

Depois que Google Cloud aprova uma solicitação de reserva adiantada, o Compute Engine cria automaticamente (criação automática) uma reserva vazia para os recursos solicitados. Em seguida, você pode 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 reservadas do Compute Engine à reserva. Em seguida, comece a usar a reserva criando instâncias de computação 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

  1. Reservar capacidade:se o projeto ainda não tiver feito isso, reserve capacidade para o Hipercomputador de IA usando uma das seguintes opções:

  2. Selecione a guia para como planeja usar as amostras nesta página:

    Console

    Quando você usa o console Google Cloud para acessar serviços Google Cloud e APIs, não é necessário configurar a autenticação.

    gcloud

    No console do Google Cloud , ative o Cloud Shell.

    Ativar o Cloud Shell

    Na parte de baixo do console Google Cloud , uma sessão do Cloud Shell é iniciada e exibe um prompt de linha de comando. O Cloud Shell é um ambiente shell com a CLI do Google Cloud já instalada e com valores já definidos para o projeto atual. A inicialização da sessão pode levar alguns segundos.

    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.

      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 adiantada, use um ou mais dos seguintes métodos:

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

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

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

Console

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

    Acesse "Reservas"

  2. Clique na guia Reservas adiantadas. A tabela lista cada solicitação de reserva adiantada, e cada coluna descreve uma propriedade.
  3. 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 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:

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 futura

É 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

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

    Acesse "Reservas"

  2. Clique na guia Reservas adiantadas. A tabela lista cada solicitação de reserva adiantada, e cada coluna descreve uma propriedade.
  3. 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 sua ferramenta de programação ou planejamento, veja a topologia de uma reserva.

Ver uma lista das suas reservas

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

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

Console

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

    Acesse "Reservas"

    Na guia Reservas imediatas (padrão), a tabela lista cada reserva, e cada coluna descreve uma propriedade.

  2. 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:

Por exemplo, para ver uma lista das suas reservas em todas as zonas, faça uma solicitação GET desta 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 instâncias de computação estão na reserva.
  • Quantas instâncias de computação 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

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

    Acesse "Reservas"

  2. 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, saiba 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 existe.
  • 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 instâncias de computação que podem ser implantadas na reserva.
  • inUseCount: o número de instâncias de computação já implantadas na reserva.
  • assuredCount: o número total de instâncias de computação que podem ser implantadas usando a reserva. Se esse valor for menor que count, saiba 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 instâncias de computação nos blocos e sub-blocos reservados. Para informações sobre o posicionamento de instâncias de computação reservadas que já foram implantadas, consulte Ver a topologia de uma instância de computação.

Se você quiser ver 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 instâncias de computação implantadas no bloco. (Disponível apenas ao visualizar um bloco específico usando a CLI gcloud ou REST.)

Console

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

    Acesse "Reservas"

  2. 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.
  3. 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 instâncias de computação que podem ser implantadas no bloco.
    • Em uso: o número de instâncias de computação 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 instâncias de computação 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 instâncias de computação 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 instâncias de computação já implantadas no bloco.
  • name: o nome do bloco.
  • physicalTopology: o local físico do bloco, que também aparece na topologia da instância de computação, 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 instâncias de computação 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 instância de computação 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 instâncias de computação 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 instâncias de computação que podem ser implantadas no bloco.
  • inUseCount: o número de instâncias de computação já implantadas no bloco.
  • physicalTopology: o local físico do bloco, que também aparece na topologia da instância de computação, 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 instâncias de computação 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 subbloco em que esta instância de computação está localizada.
      • block: o ID específico da organização do bloco em que esta instância de computação está localizada.
  • reservationSubBlockCount: o número de sub-blocos no bloco.
  • reservationSubBlockInUseCount: o número de sub-blocos no bloco com pelo menos uma instância de computação 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 interconexões de aceleradores íntegras.

gcloud

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

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 instâncias de computação 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 subbloco.
    • degradedInfraCount: o número de interconexões de acelerador degradadas no sub-bloco.
    • healthStatus: o status geral de integridade do subbloco.
    • 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 instâncias de computação já implantadas no subbloco.
  • name: o nome do sub-bloco.
  • physicalTopology: o local físico do subbloco, que também aparece na topologia da instância de computação, 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 instâncias de computação que podem ser implantadas no subbloco.
  • inUseCount: o número de instâncias de computação já implantadas no subbloco.
  • physicalTopology: o local físico do subbloco, que também aparece na topologia da instância de computação, 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 sub-bloco.
    • 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.

A seguir