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
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
-
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 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.
En la consola de Google Cloud, ve a la página Reservas.
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.
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 expresión de filtro.
Filtro, ingresa unaPor 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.
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áquinan2-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.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.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áquinan2-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
En la consola de Google Cloud, ve a la página Reservas.
Haz clic en la pestaña Reservas futuras.
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.
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.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.Obtén información para cambiar, cancelar o borrar solicitudes de reserva futuras.
Después de llegar a la hora de inicio del período de reserva, obtén información para consumir las reservas creadas de forma automática.
Después de la hora de finalización del período de reserva, obtén información para hacer lo siguiente:
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:
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 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:
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:
REST
Para ver una lista de las solicitudes de reserva futuras, haz una solicitud
GET
al métodobeta.futureResevations.list
.GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations
Reemplaza lo siguiente:
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:
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:
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:
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étodobeta.futureReservations.get
.GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations/FUTURE_RESERVATION_NAME
Reemplaza lo siguiente:
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?
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2024-09-03 (UTC)
-