Consultar las solicitudes de reserva futuras

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

Si deseas ver otras reservas, incluidas las que se crearon de forma automática para una reserva futura para aprovisionar los recursos reservados, consulta Visualiza reservas en su lugar.

Antes de empezar

  • Configura la autenticación si aún no lo hiciste. 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 un código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine de la siguiente manera.

    Selecciona la pestaña para saber cómo planeas usar las muestras en esta página:

    Consola

    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

    1. Instala Google Cloud CLI y, luego, inicializa la ejecución del siguiente comando: 

      gcloud init
    2. Configura una región y una zona predeterminadas.

    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.

      Instala Google Cloud CLI y, luego, inicializa la ejecución del siguiente comando: 

      gcloud init

Roles obligatorios

Para obtener los permisos que necesitas para ver las solicitudes de reserva futuras, pídele a tu administrador que te otorgue el rol de IAMVisualizador de reservas futuras de Compute (roles/compute.futureReservationViewer ) en el proyecto. Para obtener más información sobre cómo otorgar funciones, consulta Administra el acceso.

Esta función predefinida 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 futuras:

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

También puedes obtener estos permisos con funciones personalizadas o con otras funciones predefinidas.

Consulta tus solicitudes de reserva futuras

Para ver las solicitudes de reserva futuras de un proyecto específico, elige uno de los siguientes métodos:

  • Visualiza una lista de solicitudes de reserva futuras.

    En esta sección, se explica cómo ver una lista de todas las solicitudes de reserva futuras en borrador o enviadas en un proyecto específico. También puedes usar filtros para reducir los resultados según uno o más atributos.

  • Consulta los detalles de una solicitud de reserva futura.

    En esta sección, se explica cómo ver los detalles de una solicitud de reserva futura, como por ejemplo los proyectos con los que se comparte una reserva futura o la hora de inicio de su período de reserva.

Visualiza una lista de solicitudes de reserva futuras

Puedes ver una lista de las solicitudes de reserva futuras en un proyecto específico con la consola de Google Cloud, gcloud CLI y REST.

Console

Para ver una lista de solicitudes de reserva futuras, sigue estos pasos:

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

      Por ejemplo, para ver solo las solicitudes de reserva futuras 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 solicitudes de reserva futuras, usa el comando gcloud beta compute future-reservations list.

gcloud beta compute future-reservations list \
    --project=PROJECT_ID

Reemplaza PROJECT_ID por el ID del proyecto en el que se encuentran una o más solicitudes de reserva futuras. Si omites la marca --project, se usa el ID del proyecto actual.

El resultado es similar a este:

NAME          TOTAL_COUNT    START_TIME             END_TIME               PROCUREMENT_STATUS   ZONE
fr-04         100            2025-07-20T07:00:00Z   2025-08-05T07:00:00Z   FULFILLED            us-east1-a
fr-05         10             2025-11-15T00:00:00Z   2025-12-01T00:00:00Z   PENDING_APPROVAL     us-west1-c

De manera opcional, puedes especificar la marca --filter para ver una lista filtrada de reservas futuras en función de una expresión de filtro.

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

Reemplaza lo siguiente:

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

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

  • PROJECT_ID: opcional El ID del proyecto en el que se encuentran una o más solicitudes de reserva futuras. Si omites la marca --project, se usa el ID del proyecto actual.

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-04-11T18: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": {
        "startTime": "2025-07-20T07:00:00Z",
        "endTime": "2025-08-05T07:00:00Z"
      },
      "status": {
        "procurementStatus": "FULFILLED",
        "lockTime": "2025-05-04T07:00:00Z",
        "fulfilledCount": "100"
      },
      "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 manera opcional, puedes especificar el parámetro de consulta filter para ver una lista filtrada de reservas futuras en función de una expresión de filtro.

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, reservar un tipo de máquina n2-standard-4 y tener un recuento total superior a diez, especifica la siguiente expresión de filtro:

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

    Ten en cuenta que la expresión de filtro codificado en URL representa la siguiente expresión de filtro decodificado:

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

Consulta los detalles de una solicitud de reserva futura

Puedes ver los detalles de una solicitud de reserva futura mediante la consola de Google Cloud, gcloud CLI y REST.

Console

Para ver los detalles de una solicitud de reserva futura, sigue estos pasos:

  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 \
    --project=PROJECT_ID \
    --zone=ZONE

Reemplaza lo siguiente:

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

  • PROJECT_ID: Opcional El ID del proyecto en el que se encuentra la solicitud de reserva futura. Si omites la marca --project, se usa el ID del proyecto actual.

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

El resultado es similar a este:

creationTimestamp: '2025-07-19T12:44:11.855-07:00'
id: '5212276518668495076'
kind: compute#futureReservation
name: fr-01
namePrefix: test-fr
selfLink: https://www.googleapis.com/compute/beta/projects/project-01/zones/us-central1-a/futureReservations/future-reservation-test-1
selfLinkWithId: https://www.googleapis.com/compute/beta/projects/project-01/zones/us-central1-a/futureReservations/5212276518668495076
shareSettings:
  projects:
  - 'project-02'
  shareType: SPECIFIC_PROJECTS
specificSkuProperties:
  instanceProperties:
    localSsds:
    - diskSizeGb: '375'
      interface: SCSI
    machineType: n1-standard-64
    minCpuPlatform: Intel Skylake
  totalCount: '800'
planningStatus: SUBMITTED
status:
  lockTime: '2025-08-25T00:00:00Z'
  procurementStatus: APPROVED
timeWindow:
  endTime: '2025-12-10T00:00:00Z'
  startTime: '2025-11-10T00:00:00Z'
zone: https://www.googleapis.com/compute/beta/projects/project-01/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/reservations/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:

{
  "creationTimestamp": "2025-04-11T18:16:45.274-07:00",
  "id": "743865190848184978",
  "name": "fr-01",
  "namePrefix": "test-fr",
  "kind": "compute#futureReservation",
  "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",
  "specificSkuProperties": {
    "instanceProperties": {
      "machineType": "n1-standard-1"
    },
    "totalCount": "100"
  },
  "planningStatus": "SUBMITTED",
  "timeWindow": {
    "endTime": "2025-08-05T07:00:00Z",
    "startTime": "2025-07-20T07:00:00Z"
  },
  "status": {
    "fulfilledCount": "100"
    "lockTime": "2025-05-04T07:00:00Z",
    "procurementStatus": "FULFILLED",
  },
  "zone": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a"
}

¿Qué sigue?