Consultar las solicitudes de reserva futuras

En este documento, se explica cómo ver las solicitudes de reserva futura.

La visualización de solicitudes de reserva futuras es útil para obtener una descripción general de todas las solicitudes de reserva futuras de tu proyecto y revisar los detalles de configuración de una solicitud de reserva futura. Si deseas ver una solicitud de reserva futura compartida, solo puedes verla con el proyecto propietario.

Para ver las reservas creadas de forma automática aprovisionadas para una reserva futura, consulta Cómo ver reservas.

Antes de comenzar

  • Si aún no lo hiciste, configura la autenticación. La autenticación es el proceso mediante el cual se verifica tu identidad para acceder a los servicios y las API 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. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. 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 proporcionas a la CLI de gcloud.

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

      Si deseas obtener más información, consulta Autentica para usar REST en la documentación de autenticación de Google Cloud.

Roles obligatorios

Para obtener los permisos que necesitas para ver las solicitudes de reserva futura, pídele a tu administrador que te otorgue el rol Visualizador de reservas futuras de Compute (roles/compute.futureReservationViewer) de IAM 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 las solicitudes de reserva futuras. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para ver las solicitudes de reserva futura:

  • Para ver una lista de reservas: compute.futureReservations.list en el proyecto
  • Para ver los detalles de una reserva futura: compute.futureReservations.get en el proyecto

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

Consulta tus solicitudes de reserva futura

Según los detalles que desees ver en una solicitud de reserva futura, usa uno de los siguientes métodos:

Visualiza una lista de solicitudes de reserva futuras

Cuando veas una lista de tus solicitudes de reserva futuras, puedes usar expresiones de filtro para limitar los resultados. Para expresiones de filtro más avanzadas, usa gcloud CLI o REST.

Para ver una lista de solicitudes de reserva futuras en tu proyecto, 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, cada fila describe una solicitud de reserva futura y cada columna describe una propiedad. Por ejemplo, la columna Recuento total describe la capacidad reservada de cada solicitud de reserva futura.

  3. Opcional: para filtrar las solicitudes de reserva futuras que se muestran en la tabla, haz una de las siguientes acciones o ambas:

    • En el campo Filtro, ingresa una expresión de filtro.

      Por ejemplo, para ver solo las solicitudes de reserva futura que se crearon en la zona us-central1-a o que reservaron más de 10 recursos, especifica la siguiente expresión:

      Zone:us-central1-a OR Total Count>10

    • Haz clic en Opciones de visualización de columnas y, luego, elige los valores que deseas filtrar para la tabla.

gcloud

Para ver una lista de las solicitudes de reserva futura, usa el comando gcloud beta compute future-reservations list.

gcloud beta compute future-reservations list

El resultado es similar a este:

NAME: fr-04
TOTAL_COUNT: 100
START_TIME: 2025-07-20T07:00:00Z
END_TIME: 2025-08-05T07:00:00Z
PROCUREMENT_STATUS: FULFILLED
ZONE: us-east1-a

NAME: fr-05
TOTAL_COUNT: 10
START_TIME: 2025-07-20T07:00:00Z
END_TIME: 2025-12-01T00:00:00Z
PROCUREMENT_STATUS: PENDING_APPROVAL
ZONE: us-west1-c

De forma opcional, para filtrar tus solicitudes de reserva futuras según una expresión de filtro, incluye la marca --filter.

gcloud beta compute future-reservations list \
    --filter="FILTER_EXPRESSION"

Reemplaza FILTER_EXPRESSION por una expresión de filtro.

Por ejemplo, para ver solo las reservas futuras que se crearon en la zona us-central1-a, especifica un tipo de máquina n2-standard-4 y ten un recuento total superior a 10, especifica la siguiente expresión de filtro:

zone=us-central1-a AND specificSkuProperties.instanceProperties.machineType=n2-standard-4 AND specificSkuProperties.totalCount>10

REST

Para ver una lista de las solicitudes de reserva futuras, haz una solicitud GET al método beta.futureResevations.list.

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

Reemplaza lo siguiente:

  • PROJECT_ID: el ID del proyecto en el que se encuentran una o más solicitudes de reserva futuras.

  • ZONE: es la zona en la que se encuentran una o más solicitudes de reserva futuras.

El resultado es similar a este:

{
  "id": "projects/my-project/zones/us-east1-a/futureReservations",
  "items": [
    {
      "id": "743865190848184978",
      "creationTimestamp": "2025-03-23T18:16:45.274-07:00",
      "selfLink": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a/futureReservations/fr-base",
      "selfLinkWithId": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a/futureReservations/743865190848184978",
      "zone": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a",
      "name": "fr-base",
      "specificSkuProperties": {
        "instanceProperties": {
          "machineType": "n1-standard-1"
        },
        "totalCount": "100"
      },
      "planningStatus": "SUBMITTED",
      "timeWindow": {
        "endTime": "2025-05-02T01:00:00Z",
        "startTime": "2025-04-30T17:30:00Z"
      },
      "status": {
        "procurementStatus": "FULFILLED",
        "lockTime": "2025-03-30T07:00:00Z",
        "existingMatchingUsageInfo": {
          "count": "3",
          "timestamp": "2025-03-30T01:00:00Z"
        }
      },
      "kind": "compute#futureReservation"
    },
    ...
  ],
  "selfLink": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a/futureReservations",
  "etag": "AnzKY34l-cvvV-JnniESJ0dtQvQ=/hvc4jaHpxFAZmOt1FVtKNgzZu-M=",
  "kind": "compute#futureReservationsListResponse"
}

De forma opcional, para filtrar tus solicitudes de reserva futuras según una expresión de filtro, incluye el parámetro de consulta filter.

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/aggregated/futureReservations?filter=FILTER_EXPRESSION

Reemplaza lo siguiente:

  • PROJECT_ID: el ID del proyecto en el que se encuentran una o más solicitudes de reserva futuras.

  • FILTER_EXPRESSION: es una expresión de filtro que usa la codificación de URL.

    Por ejemplo, para ver solo las reservas futuras que se crearon en la zona us-central1-a, reserva un tipo de máquina n2-standard-4 y ten un recuento total superior a diez, especifica la siguiente expresión de filtro:

    zone=us-central1-a%20AND%20specificSkuProperties.instanceProperties.machineType=n2-standard-4%20AND%20specificSkuProperties.totalCount%3E10

    Ten en cuenta que la expresión de filtro codificada en URL representa la siguiente expresión de filtro decodificada:

    zone=us-central1-a AND specificSkuProperties.instanceProperties.machineType=n2-standard-4 AND specificSkuProperties.totalCount>10

Consulta los detalles de una solicitud de reserva futura

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.

  3. En la columna Nombre, haz clic en el nombre de la solicitud de reserva futura de la que deseas ver los detalles.

    Se abrirá la página Reservas futuras con los detalles de la solicitud de reserva futura.

gcloud

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

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

Reemplaza lo siguiente:

  • FUTURE_RESERVATION_NAME: El nombre de una solicitud de reserva futura existente.

  • ZONE: Es la zona en la que se encuentra la solicitud de reserva futura.

El resultado es similar a este:

autoCreatedReservationsDeleteTime: '2025-05-02T01:00:00Z'
creationTimestamp: '2025-03-23T10:08:31.613-07:00'
id: '5212276518668495076'
kind: compute#futureReservation
name: fr-01
planningStatus: SUBMITTED
selfLink: https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-01
selfLinkWithId: https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/5212276518668495076
shareSettings:
  shareType: LOCAL
specificSkuProperties:
  instanceProperties:
    machineType: n1-standard-64
  totalCount: '800'
status:
  existingMatchingUsageInfo:
    count: '3'
    timestamp: '2025-03-30T01:00:00Z'
  lockTime: '2025-03-30T17:09:59.297799Z'
  procurementStatus: APPROVED
timeWindow:
  endTime: '2025-05-02T01:00:00Z'
  startTime: '2025-04-30T17:30:00Z'
zone: https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a

REST

Para ver los detalles de una solicitud de reserva futura, haz una solicitud GET al método beta.futureReservations.get.

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

Reemplaza lo siguiente:

  • PROJECT_ID es el ID del proyecto en el que se encuentra la solicitud de reserva futura.

  • ZONE: Es la zona en la que se encuentra la solicitud de reserva futura.

  • FUTURE_RESERVATION_NAME: El nombre de una solicitud de reserva futura existente.

El resultado es similar a este:

{
  "autoCreatedReservationsDeleteTime": "2025-05-02T01:00:00Z",
  "creationTimestamp": "2025-03-23T10:08:31.613-07:00",
  "id": "5212276518668495076",
  "kind": "compute#futureReservation",
  "name": "fr-01",
  "planningStatus": "SUBMITTED",
  "selfLink": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-01",
  "selfLinkWithId": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/5212276518668495076",
  "shareSettings": {
    "shareType": "LOCAL"
  },
  "specificSkuProperties": {
    "instanceProperties": {
      "machineType": "n1-standard-64"
    },
    "totalCount": "800"
  },
  "status": {
    "lockTime": "2025-03-30T17:09:59.297799Z",
    "procurementStatus": "APPROVED",
    "existingMatchingUsageInfo": {
      "count": "3",
      "timestamp": "2025-03-30T01:00:00Z"
    }
  },
  "timeWindow": {
    "endTime": "2025-05-02T01:00:00Z",
    "startTime": "2025-04-30T17:30:00Z"
  },
  "zone": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a"
}

Determina la cantidad de VMs aprovisionadas

Después de crear una solicitud de reserva futura, puedes ver cuántas VMs en ejecución y reservas sin usar en tu proyecto, o en un proyecto con el que se comparte la solicitud de reserva futura, coinciden con las propiedades de la VM especificadas en tu solicitud. Si restas esta cantidad del recuento total especificado en tu solicitud, puedes determinar cuántas VMs Compute Engine aprovisionará después de que se apruebe tu solicitud y alcance su hora de inicio.

Para determinar la cantidad de VMs aprovisionadas para varias solicitudes de reserva futuras de forma simultánea, usa la consola de Google Cloud. De lo contrario, para determinar la cantidad de VMs aprovisionadas para una sola solicitud, selecciona cualquiera 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.

  3. Para cada solicitud de reserva futura, puedes determinar lo siguiente:

    • En la columna Cantidad total, el recuento total de la solicitud.

    • En la columna Cantidad de coincidencias, se muestra la cantidad de VMs en ejecución y las reservas cuyas propiedades de VM coinciden con la solicitud.

    Si restas el valor de la columna Cantidad coincidente del valor de la columna Cantidad total, puedes determinar la cantidad de VMs que Compute Engine aprovisionará para una solicitud de reserva futura en su hora de inicio. Si ves una advertencia en la columna Cantidad de coincidencias, se debe a uno de los siguientes motivos:

    • El valor de Cantidad de coincidencias es cero. En este caso, no hay VMs ni reservas en ejecución que coincidan en tu proyecto.

    • El valor de Cantidad que coincide es igual a Cantidad total. En este caso, Compute Engine no aprovisionará ninguna VM reservada para la solicitud de reserva futura .

    Si modificas la solicitud de reserva futura o creas VMs o reservaciones nuevas con propiedades de VM que coincidan con la solicitud, Compute Engine actualizará el valor en la columna Cantidad coincidente en un plazo de 30 minutos. Para verificar cuándo se actualizó por última vez la columna Cantidad de coincidencias, consulta los detalles de la solicitud y, luego, verifica el valor en la fila Último tiempo de evaluación de uso coincidente.

  4. Opcional: Para cambiar la cantidad de VMs reservadas en una solicitud de reserva futura, modifica la solicitud de reserva futura.

gcloud

  1. Consulta los detalles de la solicitud de reserva futura.

  2. En el resultado, resta el valor del campo existingMatchingUsageInfo del campo totalCount. Si el valor de existingMatchingUsageInfo.count es igual a totalCount, entonces Compute Engine no aprovisionará ninguna VM reservada para la solicitud de reserva futura.

    Si modificas la solicitud de reserva futura o creas VMs o reservaciones nuevas con propiedades de VM que coincidan con la solicitud, Compute Engine actualizará el campo existingMatchingUsageInfo en un plazo de 30 minutos. Para verificar cuándo se actualizó el campo por última vez, verifica el valor del campo existingMatchingUsageInfo.timestamp.

  3. Opcional: Para cambiar la cantidad de VMs reservadas en tu solicitud de reserva futura, modifica la solicitud de reserva futura.

REST

  1. Consulta los detalles de la solicitud de reserva futura.

  2. En el resultado, resta el valor del campo existingMatchingUsageInfo del campo totalCount. Si el valor de existingMatchingUsageInfo.count es igual a totalCount, entonces Compute Engine no aprovisionará ninguna VM reservada para la solicitud de reserva futura.

    Si modificas la solicitud de reserva futura o creas VMs o reservaciones nuevas con propiedades de VM que coincidan con la solicitud, Compute Engine actualizará el campo existingMatchingUsageInfo en un plazo de 30 minutos. Para verificar cuándo se actualizó el campo por última vez, verifica el valor del campo existingMatchingUsageInfo.timestamp.

  3. Opcional: Para cambiar la cantidad de VMs reservadas en tu solicitud de reserva futura, modifica la solicitud de reserva futura.

¿Qué sigue?