Cómo ver la capacidad reservada

En este documento, se explica cómo ver tus solicitudes de capacidad reservada y tu capacidad reservada para AI Hypercomputer. 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 de AI Hypercomputer, consulta la Descripción general de la 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 tarde, a la hora de inicio solicitada, ocurre lo siguiente:

  • Compute Engine agrega las instancias de Compute Engine reservadas a la reserva. Luego, puedes comenzar a usar la reserva creando instancias de procesamiento que coincidan con la reserva.
  • Puedes modificar la reserva para permitir que los trabajos de entrenamiento o predicción de Vertex AI la usen. Para obtener instrucciones, consulta Modifica la política de uso compartido de una reserva.

Limitaciones

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

Antes de comenzar

  1. Reserva capacidad: Si tu proyecto aún no lo hizo, reserva capacidad para AI Hypercomputer con una de las siguientes opciones:

  2. Selecciona la pestaña que corresponda a la forma en que planeas usar las muestras de esta página:

    Console

    Cuando usas la consola de Google Cloud para acceder a los servicios y las APIs de Google Cloud , no necesitas configurar la autenticación.

    gcloud

    En la consola de Google Cloud , activa Cloud Shell.

    Activa Cloud Shell

    En la parte inferior de la consola de Google Cloud , se inicia una sesión de Cloud Shell que muestra una ventana emergente con una línea de comandos. Cloud Shell es un entorno de shell con Google Cloud CLI ya instalada y con valores ya establecidos para el proyecto actual. La sesión puede tardar unos segundos en inicializarse.

    REST

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

      Instala Google Cloud CLI.

      Si usas un proveedor de identidad externo (IdP), primero debes acceder a la 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.

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 reservas futuras en una sola zona es similar al siguiente:

{
  "id": "projects/example-project/aggregated/futureReservations",
  "items": [
    {
      "specificSkuProperties": {
        "instanceProperties": {
          "machineType": "a3-ultragpu-8g",
          "guestAccelerators": [
            {
              "acceleratorType": "nvidia-h200-141gb",
              "acceleratorCount": 8
            }
          ],
          "localSsds": [
            {
              "diskSizeGb": "375",
              "interface": "NVME"
            },
            ...
          ]
        },
        "totalCount": "2"
      },
      "kind": "compute#futureReservation",
      "id": "7979651787097007552",
      "creationTimestamp": "2025-11-27T11:14:58.305-08:00",
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/example-draft-request",
      "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/7979651787097007552",
      "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b",
      "name": "example-draft-request",
      "timeWindow": {
        "startTime": "2026-01-27T19:20:00Z",
        "endTime": "2026-02-10T19:20:00Z"
      },
      "status": {
        "procurementStatus": "DRAFTING",
        "lockTime": "2026-01-27T19:15:00Z"
      },
      "planningStatus": "DRAFT",
      "specificReservationRequired": true,
      "reservationName": "example-reservation",
      "deploymentType": "DENSE",
      "schedulingType": "INDEPENDENT",
      "autoCreatedReservationsDeleteTime": "2026-02-10T19:20:00Z"
    },
    ...
  ],
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/aggregated/futureReservations",
  "etag": "AnzKY34l-cvvV-JnniESJ0dtQvQ=/hvc4jaHpxFAZmOt1FVtKNgzZu-M=",
  "kind": "compute#futureReservationsListResponse"
}

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 consultar 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, haz clic en su nombre en la columna Nombre. 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": "a3-ultragpu-8g",
      "guestAccelerators": [
        {
          "acceleratorType": "nvidia-h200-141gb",
          "acceleratorCount": 8
        }
      ],
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        ...
      ]
    },
    "totalCount": "2"
  },
  "kind": "compute#futureReservation",
  "id": "7979651787097007552",
  "creationTimestamp": "2025-11-27T11:14:58.305-08:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/example-draft-request",
  "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/7979651787097007552",
  "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b",
  "name": "example-draft-request",
  "timeWindow": {
    "startTime": "2026-01-27T19:20:00Z",
    "endTime": "2026-02-10T19:20:00Z"
  },
  "status": {
    "procurementStatus": "DRAFTING",
    "lockTime": "2026-01-27T19:15:00Z"
  },
  "planningStatus": "DRAFT",
  "specificReservationRequired": true,
  "reservationName": "example-reservation",
  "deploymentType": "DENSE",
  "schedulingType": "INDEPENDENT",
  "autoCreatedReservationsDeleteTime": "2026-02-10T19:20:00Z"
}

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, realiza 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-west1-b/futureReservations",
  "items": [
    {
      "specificSkuProperties": {
        "instanceProperties": {
          "machineType": "a3-ultragpu-8g",
          "guestAccelerators": [
            {
              "acceleratorType": "nvidia-h200-141gb",
              "acceleratorCount": 8
            }
          ],
          "localSsds": [
            {
              "diskSizeGb": "375",
              "interface": "NVME"
            },
            ...
          ]
        },
        "totalCount": "2"
      },
      "kind": "compute#futureReservation",
      "id": "7979651787097007552",
      "creationTimestamp": "2025-11-27T11:14:58.305-08:00",
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/example-draft-request",
      "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/7979651787097007552",
      "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b",
      "name": "example-draft-request",
      "timeWindow": {
        "startTime": "2026-01-27T19:20:00Z",
        "endTime": "2026-02-10T19:20:00Z"
      },
      "status": {
        "procurementStatus": "DRAFTING",
        "lockTime": "2026-01-27T19:15:00Z"
      },
      "planningStatus": "DRAFT",
      "specificReservationRequired": true,
      "reservationName": "example-reservation",
      "deploymentType": "DENSE",
      "schedulingType": "INDEPENDENT",
      "autoCreatedReservationsDeleteTime": "2026-02-10T19:20:00Z"
    }
    ...
  ],
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations",
  "etag": "AnzKY34l-cvvV-JnniESJ0dtQvQ=/hvc4jaHpxFAZmOt1FVtKNgzZu-M=",
  "kind": "compute#futureReservationsListResponse"
}

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:

  • Tipos de instancias de procesamiento en la reserva.
  • Cantidad de instancias de procesamiento reservadas y disponibles en la reserva.
  • Es el estado de la reserva, incluida la cantidad de bloques en buen estado. (Solo está disponible a través de gcloud CLI o REST).

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: ALL_CAPACITY
creationTimestamp: '2025-07-18T13:23:22.191-07:00'
deleteAtTime: '2026-06-19T00:00:00Z'
deploymentType: DENSE
enableEmergentMaintenance: false
id: '4298354039694234582'
kind: compute#reservation
name: example-res1
reservationSharingPolicy:
  serviceShareType: DISALLOW_ALL
resourceStatus:
  healthInfo:
    degradedBlockCount: 0
    healthStatus: HEALTHY
    healthyBlockCount: 1
  reservationBlockCount: 1
  reservationMaintenance:
    schedulingType: GROUPED
schedulingType: GROUPED
selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1
selfLinkWithId: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/4298354039694234582
shareSettings:
  shareType: LOCAL
specificReservation:
  assuredCount: '18'
  count: '18'
  inUseCount: '2'
  instanceProperties:
    guestAccelerators:
    -   acceleratorCount: 4
      acceleratorType: nvidia-gb200
    localSsds:
    -   diskSizeGb: '3000'
      interface: NVME
    -   diskSizeGb: '3000'
      interface: NVME
    -   diskSizeGb: '3000'
      interface: NVME
    -   diskSizeGb: '3000'
      interface: NVME
    machineType: a4x-highgpu-4g
specificReservationRequired: true
status: READY
zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a

El resultado incluye los siguientes campos para la reserva:

  • name por el nombre de la reserva.
  • healthInfo: Es la información de salud de la reserva, de la siguiente manera:
    • degradedBlockCount: Es la cantidad de bloques degradados en la reserva.
    • healthStatus: Es el estado general de la reserva.
    • healthyBlockCount: Es la cantidad de bloques en buen estado en 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": "a4x-highgpu-4g",
      "guestAccelerators": [
        {
          "acceleratorType": "nvidia-gb200",
          "acceleratorCount": 4
        }
      ],
      "localSsds": [
        {
          "diskSizeGb": "3000",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "3000",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "3000",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "3000",
          "interface": "NVME"
        }
      ]
    },
    "count": "36",
    "inUseCount": "35",
    "assuredCount": "33"
  },
  "kind": "compute#reservation",
  "id": "6823689647457870910",
  "creationTimestamp": "2025-08-04T13:40:50.496-07:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1",
  "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a",
  "name": "example-res1",
  "specificReservationRequired": true,
  "status": "READY",
  "shareSettings": {
    "shareType": "SPECIFIC_PROJECTS"
  },
  "resourceStatus": {
    "reservationMaintenance": {
      "upcomingGroupMaintenance": {
        "type": "SCHEDULED",
        "canReschedule": false,
        "maintenanceStatus": "ONGOING"
      },
      "maintenanceOngoingCount": 2,
      "maintenancePendingCount": 34,
      "schedulingType": "GROUPED",
      "subblockInfraMaintenanceOngoingCount": 0,
      "subblockInfraMaintenancePendingCount": 0,
      "instanceMaintenanceOngoingCount": 3,
      "instanceMaintenancePendingCount": 32
    },
    "reservationBlockCount": 1,
    "healthInfo": {
      "healthStatus": "DEGRADED",
      "healthyBlockCount": 0,
      "degradedBlockCount": 1
    }
  },
  "reservationSharingPolicy": {
    "serviceShareType": "DISALLOW_ALL"
  },
  "deploymentType": "DENSE",
  "advancedDeploymentControl": {
    "reservationOperationalMode": "ALL_CAPACITY"
  },
  "enableEmergentMaintenance": false,
  "schedulingType": "GROUPED",
  "deleteAtTime": "2025-10-01T00:00:00Z"
}

El resultado incluye los siguientes campos para la reserva:

  • instanceProperties: Son las propiedades de las instancias de procesamiento que se pueden implementar en la reserva.
  • inUseCount: Es la cantidad de instancias de procesamiento que ya se implementaron en la reserva.
  • assuredCount: Es la cantidad total de instancias de procesamiento que se pueden implementar con la reserva. Si este valor es inferior a count, consulta cómo solucionar el problema de la menor cantidad de VMs disponibles para el consumo.
  • name por el nombre de la reserva.
  • healthInfo: Es la información de salud de la reserva, de la siguiente manera:
    • healthStatus: Es el estado general de la reserva.
    • healthyBlockCount: Es la cantidad de bloques en buen estado en la reserva.
    • degradedBlockCount: Es la cantidad de bloques degradados en la reserva.

Visualiza 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 instancias de procesamiento dentro de los bloques y subbloques reservados. Para obtener información sobre la ubicación de las instancias de procesamiento reservadas que ya se implementaron, consulta Cómo ver la topología de una instancia de procesamiento.

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 estado de cada bloque, incluida la cantidad de subbloques en buen estado (Solo está disponible a través de gcloud CLI o REST).
  • El nombre, el bloque y el subbloque de todas las instancias de procesamiento implementadas 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 del bloque: Es el nombre del bloque.
    • Recuento: Es la cantidad total de instancias de procesamiento que se pueden implementar en el bloque.
    • En uso: Es la cantidad de instancias de procesamiento que ya se implementaron en el bloque.

gcloud

Puedes ver los bloques de 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 instancias de procesamiento 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'
  healthInfo:
    degradedSubBlockCount: 2
    healthStatus: DEGRADED
    healthySubBlockCount: 0
  id: '4360924059555106309'
  inUseCount: 35
  kind: compute#reservationBlock
  name: example-res1-block-0001
  physicalTopology:
    block: 1acd074d42cd3be9e4486b524db2e9ab
    cluster: us-central1-cluster-dnkc
    instances:
    -   instanceId: '5815586279631866288'
      physicalHostTopology:
        host: c229b308380a83e0ca345d4a0de05aa7
        subBlock: c02af6bdaeccacef571e0adbe79e8c28
      projectId: 'PROJECT_NUMBER'
    ...
    -   instanceId: '8389759878923049076'
      physicalHostTopology:
        host: '3ac534f00c20e6e0c87c3aaff2705be6'
        subBlock: 'c081876ba0aa2857d608eb30a5b2fa40'
      projectId: 'PROJECT_NUMBER'
  reservationMaintenance:
    instanceMaintenanceOngoingCount: 3
    instanceMaintenancePendingCount: 32
    maintenanceOngoingCount: 2
    maintenancePendingCount: 34
    schedulingType: GROUPED
    subblockInfraMaintenanceOngoingCount: 0
    subblockInfraMaintenancePendingCount: 0
    upcomingGroupMaintenance:
      canReschedule: false
      maintenanceReasons:
      -   PLANNED_UPDATE
      maintenanceStatus: ONGOING
      type: SCHEDULED
      windowEndTime: '2025-09-08T17:00:00.000-07:00'
      windowStartTime: '2025-09-08T13:00:00.000-07:00'
  reservationSubBlockCount: 2
  reservationSubBlockInUseCount: 2
  selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001
  selfLinkWithId: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/4360924059555106309
  status: READY
  zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a

El resultado incluye los siguientes campos para cada bloque:

  • count: Es la cantidad total de instancias de procesamiento que se pueden implementar en el bloque.
  • healthInfo: Es la información de salud del bloque, como se indica a continuación:
    • degradedSubBlockCount: Es la cantidad de subbloques degradados en el bloque.
    • healthStatus: Es el estado general del bloque.
    • healthySubBlockCount: Es la cantidad de subbloques en buen estado del bloque.
  • inUseCount: Es la cantidad de instancias de procesamiento 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 instancia de procesamiento, 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 instancias de procesamiento del bloque, como se indica a continuación. (Este campo solo aparece cuando incluyes la marca --full-view=BLOCK_VIEW_FULL).
      • instanceId: 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 instancia de procesamiento 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 instancias de procesamiento que se implementan 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,
    "healthInfo": {
      "healthStatus": "DEGRADED",
      "healthySubBlockCount": 0,
      "degradedSubBlockCount": 2
    }
  }
}

El resultado incluye los siguientes campos para cada bloque:

  • name: Es el nombre del bloque.
  • count: Es la cantidad total de instancias de procesamiento que se pueden implementar en el bloque.
  • inUseCount: Es la cantidad de instancias de procesamiento que ya se implementaron en el bloque.
  • physicalTopology: Es la ubicación física del bloque, que también aparece en la topología de la instancia de procesamiento, 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 instancias de procesamiento del bloque, como se indica a continuación. (Este campo solo aparece cuando incluyes el parámetro de consulta ?view=FULL).
      • instanceId: ID de una instancia
      • subBlock: Es el ID específico de la organización del subbloque en el que se encuentra esta instancia de procesamiento.
      • block: Es el ID específico de la organización del bloque en el que se encuentra esta instancia de procesamiento.
  • reservationSubBlockCount: Es la cantidad de subbloques en el bloque.
  • reservationSubBlockInUseCount: Es la cantidad de subbloques en el bloque con al menos una instancia de procesamiento ya implementada.
  • healthInfo: Es la información de salud del bloque, como se indica a continuación:
    • healthStatus: Es el estado general del bloque.
    • healthySubBlockCount: La cantidad de subbloques en buen estado del bloque.
    • degradedSubBlockCount: Es la cantidad de subbloques degradados en el bloque.

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:

  • Qué subbloques de capacidad se encuentran en el bloque reservado.
  • Cantidad de capacidad disponible en cada subbloque.
  • Es el estado de cada subbloque, incluida la cantidad de máquinas host en buen estado y la cantidad de interconexiones de aceleradores en buen estado.

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'
healthInfo:
  degradedHostCount: 0
  degradedInfraCount: 0
  healthStatus: HEALTHY
  healthyHostCount: 18
  healthyInfraCount: 1
id: '6848013619223297894'
inUseCount: 2
kind: compute#reservationSubBlock
name: example-res1-block-0001-subblock-0001
physicalTopology:
  block: 2b6aa63faa2b60b7ecd3b87ec337f270
  cluster: us-central1-cluster-xvhj
  subBlock: 556a310b49a0b247bc109cc7f997cea2
reservationSubBlockMaintenance:
  schedulingType: GROUPED
selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001/reservationSubBlocks/example-res1-block-0001-subblock-0001
selfLinkWithId: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001/reservationSubBlocks/6848013619223297894
status: READY
zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a

El resultado incluye los siguientes campos para cada subbloque:

  • count: Es la cantidad total de instancias de procesamiento que se pueden implementar en el subbloque.
  • healthInfo: Es la información de salud del subbloque, de la siguiente manera:
    • degradedHostCount: Es la cantidad de máquinas host degradadas en el subbloque.
    • degradedInfraCount: Es la cantidad de interconexiones de aceleradores degradadas en el subbloque.
    • healthStatus: Es el estado general del subbloque.
    • healthyHostCount: Es la cantidad de máquinas host en buen estado en el subbloque.
    • healthyInfraCount: Es la cantidad de interconexiones de aceleradores en buen estado en el subbloque.
  • inUseCount: Es la cantidad de instancias de procesamiento que ya se implementaron en el subbloque.
  • 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 instancia de procesamiento, 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 subbloques en 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"
    },
    "healthInfo": {
      "healthStatus": "DEGRADED",
      "healthyHostCount": 16,
      "degradedHostCount": 2,
      "healthyInfraCount": 1,
      "degradedInfraCount": 0
    }
  }
}

El resultado incluye los siguientes campos para cada subbloque:

  • name: Es el nombre del subbloque.
  • count: Es la cantidad total de instancias de procesamiento que se pueden implementar en el subbloque.
  • inUseCount: Es la cantidad de instancias de procesamiento que ya se implementaron en el subbloque.
  • physicalTopology: Es la ubicación física del subbloque, que también aparece en la topología de la instancia de procesamiento, 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.
  • healthInfo: Es la información de salud del subbloque, de la siguiente manera:
    • healthStatus: Es el estado general del subbloque.
    • healthyHostCount: Es la cantidad de máquinas host en buen estado en el subbloque.
    • degradedHostCount: Es la cantidad de máquinas host degradadas en el subbloque.
    • healthyInfraCount: Es la cantidad de interconexiones de aceleradores en buen estado en el subbloque.
    • degradedInfraCount: Es la cantidad de interconexiones de aceleradores degradadas en el subbloque.

¿Qué sigue?