Consultar las solicitudes de reserva futuras


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

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.

    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.

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

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 futura

    En esta sección, se explica cómo ver una lista de todas las solicitudes de reserva futura enviadas o en borrador en un proyecto específico. También puedes usar filtros para limitar 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, en la columna Recuento total, se 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 \
    --project=PROJECT_ID

Reemplaza PROJECT_ID por el ID del proyecto en el que se encuentran una o más solicitudes de reserva futura. 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 basadas en 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 futura. 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 forma opcional, puedes especificar el parámetro de consulta filter para ver una lista filtrada de reservas futuras según 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, reserva un tipo de máquina n2-standard-4 y ten 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 codificada en URL representa la siguiente expresión de filtro decodificada:

    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?