Ver capacidade reservada

Neste documento, explicamos como visualizar seus pedidos de capacidade reservada e sua capacidade reservada para clusters de HPC com VMs H4D e recursos de gerenciamento aprimorados. 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 para clusters de HPC com VMs H4D e recursos de gerenciamento aprimorados, consulte Escolher uma opção de consumo e obter 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, 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.

Antes de começar

  • Reservar capacidade:se o projeto ainda não tiver feito isso, reserve capacidade para instâncias H4D usando uma das seguintes opções:

  • Configure a autenticação, caso ainda não tenha feito isso. Com isso, você confirma sua identidade para acesso a serviços e APIs do Google Cloud . Para executar código ou exemplos em um ambiente de desenvolvimento local, faça a autenticação no Compute Engine com um destes métodos:

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. 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.

    2. Set a default region and zone.

    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 futura 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.

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.

Ver suas solicitações de capacidade reservada

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

Conferir 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

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

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": "h4d-standard-192-lssd",
          "localSsds": [
            {
              "diskSizeGb": "375",
              "interface": "NVME"
            },
            ...
          ]
        },
        "totalCount": "8"
      },
      "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/us-central1-a/futureReservations/example-draft-request",
      "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/futureReservations/7979651787097007552",
      "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a",
      "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

  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": "h4d-standard-192"
    },
    "totalCount": "8"
  },
  "kind": "compute#futureReservation",
  "id": "7201773389437194422",
  "creationTimestamp": "2025-11-27T11:14:58.305-08:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/futureReservations/example-draft-request",
  "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/futureReservations/7201773389437194422",
  "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a",
  "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": "GROUPED",
  "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:

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

  1. 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.

  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 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 para uma lista de reservas em uma única zona é semelhante a esta:

{
  "id": "projects/example-project/zones/europe-west4-b/futureReservations",
  "items": [
    {
      "specificSkuProperties": {
        "instanceProperties": {
          "machineType": "h4d-highmem-192-lssd",
          "localSsds": [
            {
              "diskSizeGb": "375",
              "interface": "NVME"
            }
          ]
        },
        "totalCount": "8"
      },
      "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-west4-b/futureReservations/example-draft-request",
      "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west4-b/futureReservations/7979651787097007552",
      "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west4-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": "GROUPED",
      "autoCreatedReservationsDeleteTime": "2026-02-10T19:20:00Z"
    }
    ...
  ],
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west4-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 inclua o parâmetro de consulta filter no URL da solicitação.

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.

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 será aberta.

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: HIGHLY_AVAILABLE_CAPACITY
creationTimestamp: '2025-11-20T15:49:02.541-07:00'
deleteAtTime: '2026-01-31T07:00:00Z'
deploymentType: DENSE
id: '5555834036379788721'
kind: compute#reservation
name: example-res1
reservationSharingPolicy:
  serviceShareType: DISALLOW_ALL
resourceStatus:
  reservationBlockCount: 1
  reservationMaintenance:
    schedulingType: GROUPED
schedulingType: GROUPED
selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1
shareSettings:
  shareType: LOCAL
specificReservation:
  assuredCount: '8'
  count: '8'
  inUseCount: '0'
  instanceProperties:
    machineType: h4d-highmem-192
    minCpuPlatform: Any CPU Platform
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.
  • 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": "h4d-highmem-192-lssd",
      "minCpuPlatform": "Any CPU Platform",
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        }
      ]
    },
    "count": "8",
    "inUseCount": "0",
    "assuredCount": "8"
  },
  "kind": "compute#reservation",
  "id": "5555834036379788721",
  "creationTimestamp": "2025-11-20T15:49:02.541-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": "LOCAL"
  },
  "resourceStatus": {
    "reservationMaintenance": {
      "schedulingType": "INDEPENDENT"
    },
    "reservationBlockCount": 1
  },
  "reservationSharingPolicy": {
    "serviceShareType": "DISALLOW_ALL"
  },
  "deploymentType": "DENSE",
  "advancedDeploymentControl": {
    "reservationOperationalMode": "HIGHLY_AVAILABLE_CAPACITY"
  },
  "schedulingType": "INDEPENDENT",
  "deleteAtTime": "2026-01-31T07: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.

Ver a topologia de uma reserva

Você pode conferir as informações detalhadas de topologia de uma reserva para ajudar a 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 topologia do cluster H4D.

Se você quiser ver outros detalhes sobre uma reserva, consulte Visualizar 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.
  • 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

  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 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'
  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.
  • 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 essa 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
  }
}

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 em Conferir a topologia do cluster H4D, 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 essa 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.

Ver sub-blocos reservados

Para listar e descrever os sub-blocos disponíveis em um bloco de uma reserva, use a CLI gcloud 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.

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'
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.
  • inUseCount: o número de VMs já implantadas no subbloco.
  • 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"
    }
  }
}

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 subbloco.
  • 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.

A seguir