Veja a capacidade reservada

Este documento explica como ver os seus pedidos de capacidade reservada e a sua capacidade reservada para clusters de HPC com VMs H4D e capacidades de gestão melhoradas. Ao ver a disponibilidade, as propriedades e a topologia da capacidade reservada e dos pedidos, pode planear a capacidade reservada para as suas cargas de trabalho.

O âmbito deste documento está limitado às 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 capacidades de gestão melhoradas, consulte o artigo Escolha uma opção de consumo e obtenha capacidade.

Depois de Google Cloud aprovar um pedido de reserva futura, o Compute Engine cria automaticamente (criação automática) uma reserva vazia para os recursos pedidos. Em seguida, pode ver a reserva para planear a sua carga de trabalho. Posteriormente, na hora de início pedida, o Compute Engine adiciona as instâncias de máquinas virtuais (VM) reservadas à reserva. Em seguida, pode começar a usar a reserva criando VMs que correspondam à reserva.

Antes de começar

  • Reservar capacidade: se ainda não o fez, reserve capacidade para instâncias H4D através de uma das seguintes opções:

  • Se ainda não o tiver feito, configure a autenticação. A autenticação valida a sua identidade para aceder a Google Cloud serviços e APIs. Para executar código ou exemplos a partir de um ambiente de desenvolvimento local, pode autenticar-se no Compute Engine selecionando uma das seguintes opções:

    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 Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando: 

      gcloud init

      Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

    2. Set a default region and zone.

    REST

    Para usar os exemplos da API REST nesta página num ambiente de desenvolvimento local, usa as credenciais que fornece à CLI gcloud.

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

      gcloud init

      Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

    Para mais informações, consulte o artigo Autenticar para usar REST na Google Cloud documentação de autenticação.

Funções necessárias

Para receber as autorizações de que precisa para ver as reservas, peça ao seu administrador para lhe conceder a função de IAM Utilizador de reserva futura de computação (roles/compute.futureReservationUser) no projeto. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Esta função predefinida contém as autorizações necessárias para ver reservas. Para ver as autorizações exatas que são necessárias, expanda a secção Autorizações necessárias:

Autorizações necessárias

As seguintes autorizações são necessárias para ver reservas:

  • Para ver os detalhes de um pedido de reserva futuro: compute.futureReservations.get no projeto
  • Para ver os detalhes de uma reserva: compute.reservations.get no projeto

Também pode conseguir estas autorizações com funções personalizadas ou outras funções predefinidas.

Limitações

Só pode ver uma reserva partilhada ou um pedido de reserva futura partilhado no projeto onde a Google o criou.

Veja os seus pedidos de capacidade reservada

Para ver os seus pedidos de reserva futuros, use um ou mais dos seguintes métodos:

Veja uma lista dos seus pedidos de reserva futuros

Pode ver uma lista dos seus pedidos de reserva futuros para ver o período de reserva, o estado e a zona dos seus pedidos.

Para ver uma lista dos seus pedidos de reserva futuros, selecione uma das seguintes opções:

Consola

  1. Na Google Cloud consola, aceda à página Reservas.

    Aceder a Reservas

  2. Clique no separador Reservas futuras. A tabela apresenta cada pedido de reserva futura e cada coluna da tabela descreve uma propriedade.
  3. Opcional: para refinar a lista de pedidos, no campo Filtro, selecione as propriedades pelas quais quer filtrar os pedidos.

gcloud

Para ver uma lista dos seus pedidos de reserva futuros, use o comando gcloud compute future-reservations list: 

gcloud compute future-reservations list

O resultado é semelhante ao seguinte exemplo:

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 a sua lista de pedidos de reserva futuros, use o mesmo comando com a flag --filter.

REST

Para ver uma lista dos seus pedidos de reserva futuros, faça um GET pedido através de um dos seguintes métodos:

Por exemplo, para ver uma lista de pedidos em todas as zonas, faça um pedido GET da seguinte forma:

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

Substitua PROJECT_ID pelo ID do projeto onde existem os pedidos.

O resultado de uma lista de pedidos de reservas futuras numa única zona é semelhante ao seguinte:

{
  "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 a sua lista de pedidos de reserva futuros, faça o mesmo pedido e, no URL do pedido, inclua o parâmetro de consulta filter.

Veja os detalhes de um pedido de reserva futuro

Pode ver os detalhes de um pedido de reserva futuro para rever as propriedades e o período de reserva dos seus recursos reservados.

Para ver os detalhes de um pedido de reserva futuro, selecione uma das seguintes opções:

Consola

  1. Na Google Cloud consola, aceda à página Reservas.

    Aceder a Reservas

  2. Clique no separador Reservas futuras. A tabela apresenta cada pedido de reserva futura e cada coluna da tabela descreve uma propriedade.
  3. Para ver os detalhes de um pedido, na coluna Nome, clique no nome do pedido. É aberta uma página com os detalhes do pedido de reserva futuro.

gcloud

Para ver os detalhes de um pedido de reserva futuro, use o comando gcloud compute future-reservations describe:

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

Substitua o seguinte:

  • FUTURE_RESERVATION_NAME: o nome do pedido de reserva futuro.
  • ZONE: a zona onde existe o pedido de reserva futuro.

O resultado é semelhante ao seguinte exemplo:

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 ver os detalhes de um pedido de reserva futuro, faça um GET pedido ao método futureReservations.get:

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

Substitua o seguinte:

  • PROJECT_ID: o ID do projeto onde existe o pedido de reserva futuro.
  • ZONE: a zona onde existe o pedido de reserva futuro.
  • FUTURE_RESERVATION_NAME: o nome do pedido de reserva futuro.

O resultado é semelhante ao 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"
}

Veja a sua capacidade reservada

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

  • Identifique uma reserva, um bloco e um sub-bloco que quer usar para implementar uma carga de trabalho.
  • Compreenda as propriedades, a utilização e a topologia da sua capacidade reservada.

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

  • Para ver uma vista geral de toda a capacidade reservada no seu projeto e verificar se existe capacidade reservada não utilizada, veja uma lista das suas reservas.
  • Para rever as propriedades e a disponibilidade de todas as VMs reservadas para uma reserva, veja os detalhes de uma reserva.
  • Para compreender como os blocos e os sub-blocos de capacidade de uma reserva estão organizados, como para integração com a sua ferramenta de agendamento ou planeamento, veja a topologia de uma reserva.

Veja uma lista das suas reservas

Pode ver uma lista das suas reservas no projeto para ver toda a capacidade reservada no projeto e pesquisar uma reserva para usar na implementação da sua carga de trabalho.

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

Consola

  1. Na Google Cloud consola, aceda à página Reservas.

    Aceder a Reservas

    No separador Reservas a pedido (predefinição), a tabela apresenta cada reserva e cada coluna da tabela descreve uma propriedade.

  2. Opcional: para refinar a lista de reservas, no campo Filtrar, selecione as propriedades pelas quais quer filtrar as reservas.

gcloud

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

gcloud compute reservations list

O resultado é semelhante ao 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 quiser refinar a sua lista de reservas, use o mesmo comando com a flag --filter.

REST

Para ver uma lista das suas reservas, faça um pedido GET através de um dos seguintes métodos:

Por exemplo, para ver uma lista das suas reservas em todas as zonas, faça um pedido GET da seguinte forma:

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

Substitua PROJECT_ID pelo ID do projeto onde existem as reservas.

O resultado de uma lista de reservas numa única zona é semelhante ao seguinte:

{
  "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 a sua lista de reservas, faça o mesmo pedido e, no URL do pedido, inclua o parâmetro de consulta filter.

Veja os detalhes de uma reserva

Pode ver os detalhes de uma reserva no seu projeto para compreender detalhes como os seguintes:

  • Que tipos de VMs estão na reserva.
  • Quantas VMs estão reservadas e disponíveis na reserva.

Se quiser compreender os blocos e os sub-blocos de uma reserva, consulte o artigo Veja a topologia de uma reserva em alternativa.

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

Consola

  1. Na Google Cloud consola, aceda à página Reservas.

    Aceder a Reservas

  2. Na tabela Reservas a pedido, na coluna Nome, clique no nome da reserva cujos detalhes quer ver. É apresentada uma página com os detalhes da reserva.

gcloud

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

gcloud compute reservations describe RESERVATION_NAME \
    --zone=ZONE

Substitua o seguinte:

  • RESERVATION_NAME: o nome da reserva.
  • ZONE: a zona onde a reserva existe.

O resultado é semelhante ao seguinte exemplo:

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 implementadas usando a reserva. Se este valor for inferior a count, veja como resolver problemas relacionados com um menor número de VMs disponíveis para consumo.
  • inUseCount: o número de VMs que já estão implementadas na reserva.
  • instanceProperties: as propriedades das VMs que podem ser implementadas na reserva.

REST

Para ver os detalhes de uma reserva, faça um pedido GET ao método :reservations.get

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

Substitua o seguinte:

  • PROJECT_ID: o ID do projeto onde a reserva existe.
  • ZONE: a zona onde existe a reserva.
  • RESERVATION_NAME: o nome da reserva.

O resultado é semelhante ao 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 implementadas na reserva.
  • inUseCount: o número de VMs que já estão implementadas na reserva.
  • assuredCount: o número total de VMs que podem ser implementadas usando a reserva. Se este valor for inferior a count, veja como resolver problemas relacionados com menos VMs disponíveis para consumo.
  • name: o nome da reserva.

Veja a topologia de uma reserva

Pode ver as informações detalhadas da topologia de uma reserva para ajudar a decidir onde criar VMs nos blocos e sub-blocos reservados. Para ver informações sobre o posicionamento de VMs reservadas que já foram implementadas, consulte o artigo Veja a topologia do cluster H4D.

Se quiser ver outros detalhes sobre uma reserva, consulte o artigo Veja os detalhes de uma reserva.

Veja blocos reservados

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

  • Que blocos de capacidade estão na reserva.
  • Qual a capacidade disponível em cada bloco.
  • O nome, o bloco e o sub-bloco de todas as VMs implementadas no bloco. (Disponível apenas quando visualiza um bloco específico através da CLI gcloud ou do REST.)

Consola

  1. Na Google Cloud consola, aceda à página Reservas.

    Aceder a Reservas

  2. Na tabela Reservas a pedido, na coluna Nome, clique no nome da reserva cujos detalhes quer ver. É apresentada a página de detalhes da reserva.
  3. Na secção Topologia de recursos, pode ver informações sobre os seus blocos reservados. Estas informações incluem o seguinte para cada bloco:
    • ID do bloco: o nome do bloco.
    • Count: o número total de VMs que podem ser implementadas no bloco.
    • Em utilização: o número de VMs que já estão implementadas no bloco.

gcloud

Pode ver os bloqueios numa reserva através dos seguintes comandos:

  • Para ver todos os blocos disponíveis numa reserva, use o comando gcloud compute reservations blocks list: 
    gcloud compute reservations blocks list RESERVATION_NAME \
    --zone=ZONE
  • Para ver um bloco específico numa reserva, use o comando gcloud compute reservations blocks describe. Para ver também o nome e a topologia de todas as VMs implementadas 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 o seguinte:

  • RESERVATION_NAME: o nome da reserva.
  • ZONE: a zona onde existe a reserva.
  • BLOCK_NAME: o nome do bloco.

A saída de cada bloco é semelhante ao seguinte exemplo:

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 implementadas no bloco.
  • inUseCount: o número de VMs que já estão implementadas no bloco.
  • name: o nome do bloco.
  • physicalTopology: a localização física do bloco, que também aparece na topologia de VMs, da seguinte forma:
    • block: o ID específico da organização do bloqueio.
    • cluster: o nome global do cluster.
    • instances: uma lista dos nomes e localizações físicas de todas as VMs no bloco, da seguinte forma. (Este campo só aparece quando 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 onde esta instância está localizada.
      • block: o ID específico da organização do bloco onde 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á implementada.

REST

Pode ver os bloqueios numa reserva através dos seguintes métodos:

  • Para ver todos os blocos disponíveis numa reserva, faça um pedido GET ao método reservationBlocks.list: 
    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks
  • Para ver um bloqueio específico numa reserva, faça um pedido GET ao método reservationBlocks.get. Para ver também o nome e a topologia de todas as VMs implementadas 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 o seguinte:

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

O resultado de cada bloco é semelhante ao seguinte:

{
  "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 implementadas no bloco.
  • inUseCount: o número de VMs que já estão implementadas no bloco.
  • physicalTopology: a localização física do bloco, que também aparece em Ver topologia do cluster H4D, da seguinte forma:
    • cluster: o nome global do cluster.
    • block: o ID específico da organização do bloqueio.
    • instances: uma lista dos nomes e localizações físicas de todas as VMs no bloco, da seguinte forma. (Este campo só aparece quando 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 onde esta instância está localizada.
      • block: o ID específico da organização do bloco onde 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á implementada.

Veja sub-blocos reservados

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

  • Que sub-blocos de capacidade estão no bloco reservado.
  • Qual a capacidade disponível em cada sub-bloco.

gcloud

Pode ver os sub-blocos numa reserva através dos seguintes comandos:

  • Para ver todos os sub-blocos disponíveis num 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 ver um sub-bloco específico num 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 o seguinte:

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

O resultado de cada sub-bloco é semelhante ao seguinte:

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 implementadas no sub-bloco.
  • inUseCount: o número de VMs que já estão implementadas no sub-bloco.
  • name: o nome do sub-bloco.
  • physicalTopology: a localização física do sub-bloco, que também aparece na topologia de VMs, da seguinte forma:
    • block: o ID específico da organização do bloqueio.
    • cluster: o nome global do cluster.
    • subblock: o ID específico da organização do sub-bloco.

REST

Pode ver os sub-blocos numa reserva através dos seguintes métodos:

  • Para ver todos os sub-blocos disponíveis num bloco de uma reserva, faça um pedido GET ao método reservationSubBlocks.list: 
    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks/BLOCK_NAME/reservationSubBlocks
  • Para ver um sub-bloco específico num bloco de uma reserva, faça um pedido GET ao 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 o seguinte:

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

O resultado de cada sub-bloco é semelhante ao seguinte:

{
  "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 implementadas no sub-bloco.
  • inUseCount: o número de VMs que já estão implementadas no sub-bloco.
  • physicalTopology: a localização física do sub-bloco, que também aparece na topologia de VMs, da seguinte forma:
    • cluster: o nome global do cluster.
    • block: o ID específico da organização do bloqueio.
    • subblock: o ID específico da organização do sub-bloco.

O que se segue?