Cómo ver la capacidad reservada

En este documento, se explica cómo ver tus solicitudes de capacidad reservada y tu capacidad reservada para clústeres de HPC con VMs H4D y capacidades de administración mejoradas. Si ves la disponibilidad, las propiedades y la topología de tu capacidad reservada y tus solicitudes, puedes planificar la capacidad reservada para tus cargas de trabajo.

El alcance de este documento se limita a las cargas de trabajo que usan una opción de capacidad que menciona las reservas futuras. Para obtener más información sobre las opciones de capacidad para clústeres de HPC con VMs H4D y capacidades de administración mejoradas, consulta Elige una opción de consumo y obtén capacidad.

Después de que Google Cloud aprueba una solicitud de reserva futura, Compute Engine crea automáticamente (crea automáticamente) una reserva vacía para los recursos solicitados. Luego, puedes ver la reserva para planificar tu carga de trabajo. Más adelante, en la hora de inicio solicitada, Compute Engine agrega las instancias de máquina virtual (VM) reservadas a la reserva. Luego, puedes comenzar a usar la reserva creando VMs que coincidan con ella.

Antes de comenzar

  • Reserva capacidad: Si tu proyecto aún no lo hizo, reserva capacidad para las instancias H4D con una de las siguientes opciones:

  • Si aún no lo hiciste, configura la autenticación. La autenticación verifica tu identidad para acceder a los servicios y las APIs de Google Cloud . Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:

    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. Instala Google Cloud CLI. Después de instalarla, inicializa Google Cloud CLI ejecutando el siguiente comando: 

      gcloud init

      Si usas un proveedor de identidad (IdP) externo, primero debes Acceder a gcloud CLI con tu identidad federada.

    2. Set a default region and zone.

    REST

    Para usar las muestras de la API de REST en esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a gcloud CLI.

      Instala Google Cloud CLI. Después de instalarla, inicializa Google Cloud CLI ejecutando el siguiente comando: 

      gcloud init

      Si usas un proveedor de identidad (IdP) externo, primero debes Acceder a gcloud CLI con tu identidad federada.

    Para obtener más información, consulta Autentícate para usar REST en la documentación de autenticación de Google Cloud .

Roles obligatorios

Para obtener los permisos que necesitas para ver las reservas, pídele a tu administrador que te otorgue el rol de IAM Usuario de reserva futura de Compute (roles/compute.futureReservationUser) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para ver reservas. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para ver las reservas:

  • Para ver los detalles de una solicitud de reserva futura: compute.futureReservations.get en el proyecto
  • Para ver los detalles de una reserva: compute.reservations.get en el proyecto

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Limitaciones

Solo puedes ver una reserva compartida o una solicitud de reserva futura compartida en el proyecto en el que Google la creó.

Consulta tus solicitudes de capacidad reservada

Para ver tus solicitudes de reserva futuras, usa uno o más de los siguientes métodos:

Consulta una lista de tus solicitudes de reserva futuras

Puedes ver una lista de tus solicitudes de reserva futuras para consultar el período de reserva, el estado y la zona de tus solicitudes.

Para ver una lista de tus solicitudes de reserva futuras, selecciona una de las siguientes opciones:

Console

  1. En la consola de Google Cloud , ve a la página Reservas.

    Ir a Reservas

  2. Haz clic en la pestaña Reservas futuras. En la tabla, se enumeran todas las solicitudes de reserva futuras, y cada columna describe una propiedad.
  3. Opcional: Para definir mejor tu lista de solicitudes, en el campo Filtro , selecciona las propiedades por las que deseas filtrar las solicitudes.

gcloud

Para ver una lista de tus solicitudes de reserva futuras, usa el comando gcloud compute future-reservations list: 

gcloud compute future-reservations list

El resultado es similar al siguiente ejemplo.

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

Si deseas definir mejor tu lista de solicitudes de reserva futura, usa el mismo comando con la marca --filter.

REST

Para ver una lista de tus solicitudes de reserva futuras, haz una solicitud GET a uno de los siguientes métodos:

Por ejemplo, para ver una lista de solicitudes en todas las zonas, realiza una solicitud GET de la siguiente manera:

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

Reemplaza PROJECT_ID por el ID del proyecto en el que existen las solicitudes.

El resultado de una lista de solicitudes de reserva futuras en una sola zona es similar al siguiente:

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

Si deseas definir mejor tu lista de solicitudes de reserva futuras, haz la misma solicitud y, en la URL de la solicitud, incluye el parámetro de consulta filter.

Consulta los detalles de una solicitud de reserva futura

Puedes ver los detalles de una solicitud de reserva futura para revisar las propiedades y el período de reserva de los recursos reservados.

Para ver los detalles de una solicitud de reserva futura, selecciona una de las siguientes opciones:

Console

  1. En la consola de Google Cloud , ve a la página Reservas.

    Ir a Reservas

  2. Haz clic en la pestaña Reservas futuras. En la tabla, se enumeran todas las solicitudes de reserva futuras, y cada columna describe una propiedad.
  3. Para ver los detalles de una solicitud, en la columna Nombre, haz clic en el nombre de la solicitud. Se abrirá una página con los detalles de la solicitud de reserva futura.

gcloud

Para ver los detalles de una solicitud de reserva futura, usa el comando gcloud compute future-reservations describe:

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

Reemplaza lo siguiente:

  • FUTURE_RESERVATION_NAME: Es el nombre de la solicitud de reserva futura.
  • ZONE: Es la zona en la que existe la solicitud de reserva futura.

El resultado es similar al siguiente ejemplo.

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 los detalles de una solicitud de reserva futura, haz una solicitud GET al método futureReservations.get:

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

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto en el que existe la solicitud de reserva futura.
  • ZONE: Es la zona en la que existe la solicitud de reserva futura.
  • FUTURE_RESERVATION_NAME: Es el nombre de la solicitud de reserva futura.

El resultado es similar a lo siguiente:

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

Cómo ver tu capacidad reservada

Consulta tu capacidad reservada cuando quieras realizar una o más de las siguientes acciones:

  • Identifica una reserva, un bloque y un subbloque que quieras usar para implementar una carga de trabajo.
  • Comprende las propiedades, el uso y la topología de tu capacidad reservada.

Para ver tu capacidad reservada, usa uno o más de los siguientes métodos:

Visualiza una lista de tus reservas

Puedes ver una lista de tus reservas en tu proyecto para ver toda la capacidad reservada y buscar una reserva para implementar tu carga de trabajo.

Para ver una lista de tus reservas, selecciona una de las siguientes opciones:

Console

  1. En la consola de Google Cloud , ve a la página Reservas.

    Ir a Reservas

    En la pestaña Reservas según demanda (predeterminada), la tabla enumera cada reserva y cada columna de la tabla describe una propiedad.

  2. Opcional: Para definir mejor tu lista de reservas, en el campo Filtro , selecciona las propiedades por las que deseas filtrar las reservas.

gcloud

Para ver una lista de tus reservas, usa el comando gcloud compute reservations list: 

gcloud compute reservations list

El resultado es similar a lo siguiente:

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

Si deseas definir mejor tu lista de reservas, usa el mismo comando con la marca --filter.

REST

Para ver una lista de tus reservas, haz una solicitud GET a uno de los siguientes métodos:

Por ejemplo, para ver una lista de tus reservas en todas las zonas, realiza una solicitud GET de la siguiente manera:

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

Reemplaza PROJECT_ID por el ID del proyecto en el que existen las reservas.

El resultado de una lista de reservas en una sola zona es similar al siguiente:

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

Si deseas definir mejor tu lista de reservas, realiza la misma solicitud y, en la URL de la solicitud, incluye el parámetro de consulta filter.

Cómo ver los detalles de una reserva

Puedes ver los detalles de las reservas de tu proyecto para comprender detalles como los siguientes:

  • Qué tipos de VMs se incluyen en la reserva.
  • Cantidad de VMs reservadas y disponibles en la reserva.

Si deseas comprender los bloques y subbloques de una reserva, consulta Cómo ver la topología de una reserva.

Para ver los detalles de una reserva, selecciona una de las siguientes opciones:

Console

  1. En la consola de Google Cloud , ve a la página Reservas.

    Ir a Reservas

  2. En la tabla Reservas según demanda, en la columna Nombre, haz clic en el nombre de la reserva de la que deseas ver los detalles. Aparecerá una página con los detalles de la reserva.

gcloud

Para ver los detalles de una reserva, usa el comando gcloud compute reservations describe:

gcloud compute reservations describe RESERVATION_NAME \
    --zone=ZONE

Reemplaza lo siguiente:

  • RESERVATION_NAME por el nombre de la reserva.
  • ZONE: Es la zona en la que existe la reserva.

El resultado es similar al siguiente ejemplo.

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

El resultado incluye los siguientes campos para la reserva:

  • name por el nombre de la reserva.
  • reservationBlockCount: Es la cantidad total de bloques en la reserva.
  • assuredCount: Es la cantidad total de VMs que se pueden implementar con la reserva. Si este valor es inferior a count, consulta cómo solucionar el problema de menos VMs disponibles para el consumo.
  • inUseCount: Es la cantidad de VMs que ya se implementaron en la reserva.
  • instanceProperties: Son las propiedades de las VMs que se pueden implementar en la reserva.

REST

Para ver los detalles de una reserva, haz una solicitud GET al método reservations.get:

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

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto en el que existe la reserva.
  • ZONE: Es la zona en la que existe la reserva.
  • RESERVATION_NAME por el nombre de la reserva.

El resultado es similar a lo siguiente:

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

El resultado incluye los siguientes campos para la reserva:

  • instanceProperties: Son las propiedades de las VMs que se pueden implementar en la reserva.
  • inUseCount: Es la cantidad de VMs que ya se implementaron en la reserva.
  • assuredCount: Es la cantidad total de VMs que se pueden implementar con la reserva. Si este valor es inferior a count, consulta cómo solucionar el problema de menos VMs disponibles para el consumo.
  • name por el nombre de la reserva.

Cómo ver la topología de una reserva

Puedes ver la información detallada de la topología de una reserva para ayudarte a decidir dónde crear VMs dentro de los bloques y subbloques reservados. Para obtener información sobre la posición de las VMs reservadas que ya se implementaron, consulta Cómo ver la topología del clúster H4D.

Si deseas ver otros detalles sobre una reserva, consulta Visualiza los detalles de una reserva.

Cómo ver los bloques reservados

Para enumerar y describir los bloques disponibles en una reserva, usa cualquiera de los siguientes métodos. Esta tarea te ayuda a determinar lo siguiente:

  • Qué bloques de capacidad se incluyen en la reserva.
  • Indica cuánta capacidad está disponible en cada bloque.
  • El nombre, el bloque y el subbloque de todas las VMs que se implementan en el bloque. (Solo está disponible cuando se visualiza un bloque específico con gcloud CLI o REST).

Console

  1. En la consola de Google Cloud , ve a la página Reservas.

    Ir a Reservas

  2. En la tabla Reservas según demanda, en la columna Nombre, haz clic en el nombre de la reserva de la que deseas ver los detalles. Se abrirá la página de detalles de la reserva.
  3. En la sección Topología de recursos, puedes ver información sobre los bloques reservados. Esta información incluye lo siguiente para cada bloque:
    • ID de bloque: Es el nombre del bloque.
    • Recuento: Es la cantidad total de VMs que se pueden implementar en el bloque.
    • En uso: Es la cantidad de VMs que ya se implementaron en el bloque.

gcloud

Puedes ver los bloques en una reserva con los siguientes comandos:

  • Para ver todos los bloques disponibles en una reserva, usa el comando gcloud compute reservations blocks list: 
    gcloud compute reservations blocks list RESERVATION_NAME \
    --zone=ZONE
  • Para ver un bloqueo específico en una reserva, usa el comando gcloud compute reservations blocks describe. Para ver también el nombre y la topología de todas las VMs implementadas en el bloque, agrega la marca --full-view=BLOCK_VIEW_FULL. 
    gcloud compute reservations blocks describe RESERVATION_NAME \
    --zone=ZONE \
    --block-name=BLOCK_NAME \
    --full-view=BLOCK_VIEW_FULL

Reemplaza lo siguiente:

  • RESERVATION_NAME por el nombre de la reserva.
  • ZONE: Es la zona en la que existe la reserva.
  • BLOCK_NAME: Es el nombre del bloque.

El resultado de cada bloque es similar al siguiente ejemplo:

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

El resultado incluye los siguientes campos para cada bloque:

  • count: Es la cantidad total de VMs que se pueden implementar en el bloque.
  • inUseCount: Es la cantidad de VMs que ya se implementaron en el bloque.
  • name: Es el nombre del bloque.
  • physicalTopology: Es la ubicación física del bloque, que también aparece en la topología de la VM, de la siguiente manera:
    • block: Es el ID específico de la organización del bloque.
    • cluster: Es el nombre global del clúster.
    • instances: Es una lista de los nombres y las ubicaciones físicas de todas las VMs del bloque, como se indica a continuación. (Este campo solo aparece cuando incluyes la marca --full-view=BLOCK_VIEW_FULL).
      • instanceId: Es el ID de una instancia.
      • subBlock: Es el ID específico de la organización del subbloque en el que se encuentra esta instancia.
      • block: Es el ID específico de la organización del bloque en el que se encuentra esta instancia.
  • reservationSubBlockCount: Es la cantidad de subbloques en el bloque.
  • reservationSubBlockInUseCount: Es la cantidad de subbloques en el bloque con al menos una VM ya implementada.

REST

Puedes ver los bloques de una reserva con los siguientes métodos:

  • Para ver todos los bloques disponibles en una reserva, realiza una solicitud GET al método reservationBlocks.list: 
    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks
  • Para ver un bloqueo específico en una reserva, realiza una solicitud GET al método reservationBlocks.get. Para ver también el nombre y la topología de todas las VMs implementadas en el bloque, agrega el 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

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto en el que existe la reserva.
  • ZONE: Es la zona en la que existe la reserva.
  • RESERVATION_NAME por el nombre de la reserva.
  • BLOCK_NAME: Es el nombre del bloque.

El resultado de cada bloque es similar al siguiente:

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

El resultado incluye los siguientes campos para cada bloque:

  • name: Es el nombre del bloque.
  • count: Es la cantidad total de VMs que se pueden implementar en el bloque.
  • inUseCount: Es la cantidad de VMs que ya se implementaron en el bloque.
  • physicalTopology: Es la ubicación física del bloque, que también aparece en Cómo ver la topología del clúster H4D, de la siguiente manera:
    • cluster: Es el nombre global del clúster.
    • block: Es el ID específico de la organización del bloque.
    • instances: Es una lista de los nombres y las ubicaciones físicas de todas las VMs del bloque, como se indica a continuación. (Este campo solo aparece cuando incluyes el parámetro de consulta ?view=FULL).
      • instanceId: Es el ID de una instancia.
      • subBlock: Es el ID específico de la organización del subbloque en el que se encuentra esta instancia.
      • block: Es el ID específico de la organización del bloque en el que se encuentra esta instancia.
  • reservationSubBlockCount: Es la cantidad de subbloques en el bloque.
  • reservationSubBlockInUseCount: Es la cantidad de subbloques en el bloque con al menos una VM ya implementada.

Cómo ver los subbloques reservados

Para enumerar y describir los subbloques disponibles en un bloque de una reserva, usa Google Cloud CLI o la API de REST. Esta tarea te ayuda a determinar lo siguiente:

  • Son los subbloques de capacidad que se encuentran en el bloque reservado.
  • Cantidad de capacidad disponible en cada subbloque.

gcloud

Puedes ver los subbloques de una reserva con los siguientes comandos:

Reemplaza lo siguiente:

  • RESERVATION_NAME por el nombre de la reserva.
  • ZONE: Es la zona en la que existe la reserva.
  • BLOCK_NAME: Es el nombre del bloque.
  • SUB-BLOCK_NAME: Es el nombre del subbloque.

El resultado de cada subbloque es similar al siguiente:

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

El resultado incluye los siguientes campos para cada subbloque:

  • count: Es la cantidad total de VMs que se pueden implementar en el sub-bloque.
  • inUseCount: Es la cantidad de VMs que ya se implementaron en el sub-bloque.
  • name: Es el nombre del subbloque.
  • physicalTopology: Es la ubicación física del subbloque, que también aparece en la topología de la VM, de la siguiente manera:
    • block: Es el ID específico de la organización del bloque.
    • cluster: Es el nombre global del clúster.
    • subblock: Es el ID específico de la organización del subbloque.

REST

Puedes ver los bloques secundarios de una reserva con los siguientes métodos:

  • Para ver todos los subbloques disponibles en un bloque de una reserva, realiza una solicitud GET al 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 un subbloque específico en un bloque de una reserva, realiza una solicitud GET al 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

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto en el que existe la reserva.
  • ZONE: Es la zona en la que existe la reserva.
  • RESERVATION_NAME por el nombre de la reserva.
  • BLOCK_NAME: Es el nombre del bloque.
  • SUB-BLOCK_NAME: Es el nombre del subbloque.

El resultado de cada subbloque es similar al siguiente:

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

El resultado incluye los siguientes campos para cada subbloque:

  • name: Es el nombre del subbloque.
  • count: Es la cantidad total de VMs que se pueden implementar en el sub-bloque.
  • inUseCount: Es la cantidad de VMs que ya se implementaron en el sub-bloque.
  • physicalTopology: Es la ubicación física del subbloque, que también aparece en la topología de la VM, de la siguiente manera:
    • cluster: Es el nombre global del clúster.
    • block: Es el ID específico de la organización del bloque.
    • subblock: Es el ID específico de la organización del subbloque.

¿Qué sigue?