En este documento, se explica cómo ver reservas.
Antes de comenzar
- Revisa los requisitos y las y las restricciones para las reservas.
-
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.reservations.list
en el proyecto -
Para ver los detalles de una reserva:
compute.reservations.get
en el proyecto FILTER_EXPRESSION
: es una expresión de filtro.PROJECT_ID
: el ID del proyecto en el que se encuentran tus reservas.PROJECT_ID
: el ID del proyecto en el que se encuentran tus reservas.ZONE
: Es la zona donde se encuentran tus recursos.PROJECT_ID
: el ID del proyecto en el que se encuentran tus reservas.ZONE
: Es la zona donde se encuentran tus recursos.FILTER_EXPRESSION
: es una expresión de filtro.En la consola de Google Cloud, ve a la página Reservas.
Aparecerá la página Reservas.
En la columna Nombre, haz clic en el nombre de la reserva que deseas describir.
Aparecerá la página de detalles de la reserva. Para determinar el uso de una reserva, consulta los campos Total de máquinas reservadas y Máquinas usadas.
RESERVATION_NAME
: Es el nombre de una reserva existente.PROJECT_ID
: El ID del proyecto en el que se encuentra la reserva futura.ZONE
: Es la zona en la que se encuentra la reserva.PROJECT_ID
: El ID del proyecto en el que se encuentra la reserva futura.ZONE
: Es la zona en la que se encuentra la reserva.RESERVATION_NAME
: Es el nombre de una reserva existente.- Obtén más información para adjuntar reservas a los compromisos.
- Obtén información sobre cómo consumir reservas.
- Obtén información sobre cómo modificar reservas.
- Obtén más información sobre cómo borrar reservas.
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
Si quieres obtener los permisos que necesitas para ver reservas, pídele a tu administrador que te otorgue el rol de IAM Administrador de Compute (
roles/compute.admin
) 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 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:
También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.
Ver tus reservas
Solo puedes ver las reservas que creó tu proyecto actual.
Solo el proyecto propietario puede ver una reserva compartida. Si deseas ver los proyectos con los que se comparte una reserva compartida, consulta los detalles de la reserva.
Visualiza una lista de tus reservas
Para ver una lista de tus reservas, usa la consola de Google Cloud, gcloud CLI o REST.
Console
En la consola de Google Cloud, ve a la página SQL.
Aparecerá la página Reservas.
En la tabla, cada fila describe una reserva y cada columna describe una propiedad. Por ejemplo, en la columna Máquinas usadas, se describe el uso y la capacidad total de cada reserva: un valor de
25 (50)
representa una reserva para 50 VM donde 25 de estas VM se realizaron. consumidos.Opcional: Para modificar qué reservas y propiedades se muestran, usa
Filtro y Opciones de visualización de columnas respectivamente.gcloud
Para ver una lista de tus reservas, usa el comando
gcloud compute reservations list
.gcloud compute reservations list \ --project=PROJECT_ID
Reemplaza
PROJECT_ID
por el ID del proyecto en el que se encuentran tus reservas.El resultado debería ser similar al siguiente ejemplo:
NAME: r-01 IN_USE_COUNT: 0 COUNT: 5 ZONE: us-central1-a SHARE_TYPE: LOCAL NAME: r-02 IN_USE_COUNT: 3 COUNT: 10 ZONE: us-central1-f SHARE_TYPE: LOCAL
De forma opcional, para limitar una lista de reservas con una expresión de filtro, especifica la marca
--filter
.gcloud compute reservations list \ --filter="FILTER_EXPRESSION" \ --project=PROJECT_ID
Reemplaza lo siguiente:
Por ejemplo, para ver solo las reservas con un nombre que comienza con
prefix
y se encuentran en la zonaus-central1-a
, ejecuta el siguiente comando:gcloud compute reservations list \ --filter="name~prefix AND zone=us-central1-a" \ --project=example-project
REST
Para ver una lista de tus reservas, realiza una solicitud
GET
al métodoreservations.list
.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations
Reemplaza lo siguiente:
El resultado es similar al siguiente ejemplo.
{ "id": "4100668622331754141", "creationTimestamp": "2019-09-27T08:21:14.707-07:00", "selfLink": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/reservation-05", "zone": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a", "name": "reservation-05", "specificReservation": { "instanceProperties": { "machineType": "n1-standard-2", "minCpuPlatform": "Any CPU Platform", }, "count": "100", "inUseCount": "0" }, "specificReservationRequired": false, "status": "READY", "kind": "compute#reservation" }, { "id": "2533514314332214789", "creationTimestamp": "2019-09-27T08:21:14.707-07:00", "selfLink": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/reservation-04", "zone": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a", "name": "reservation-04", "specificReservation": { "instanceProperties": { "machineType": "n1-standard-2", "guestAccelerators": [ { "acceleratorType": "nvidia-tesla-t4", "acceleratorCount": 1 } ], "minCpuPlatform": "Any CPU Platform", "localSsds": [ { "diskSizeGb": "375", "interface": "SCSI" } ] }, "count": "50", "inUseCount": "25" }, "specificReservationRequired": false, "status": "READY", "kind": "compute#reservation" }
De forma opcional, para limitar una lista de reservas con una expresión de filtro, realiza la siguiente solicitud
GET
:GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations?filter=FILTER_EXPRESSION
Reemplaza lo siguiente:
Por ejemplo, para ver solo las reservas con un nombre que comienza con
prefix
y se encuentran en la zonaus-central1-a
, realiza la siguiente solicitudGET
con valores codificados en URL:GET https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations?filter=name%7Eprefix%20AND%20zone=us-central1-a
Visualiza los detalles de una reserva
Para ver los detalles de una reserva, usa la consola de Google Cloud, gcloud CLI o REST.
Console
Para ver los detalles de una reserva, haz lo siguiente:
gcloud
Para ver los detalles de una reserva, usa el comando
gcloud compute reservations describe
.gcloud compute reservations describe RESERVATION_NAME \ --project=PROJECT_ID \ --zone=ZONE
Reemplaza lo siguiente:
El resultado debería ser similar al siguiente ejemplo:
kind: compute#reservation name: reservation-04 selfLink: https://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/reservation-04 specificReservation: count: '50' inUseCount: '25' instanceProperties: guestAccelerators: - acceleratorCount: 1 acceleratorType: nvidia-tesla-t4 localSsds: - diskSizeGb: '375' interface: SCSI machineType: n1-standard-2 minCpuPlatform: Any CPU Platform specificReservationRequired: false status: READY zone: https://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a
Para determinar el uso de una reserva, consulta los campos
count
yinUseCount
. En este ejemplo, se reservan 50 VM y se consumieron 25 VM.REST
Para ver los detalles de una reserva, haz una solicitud
GET
al métodoreservations.get
.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME
Reemplaza lo siguiente:
El resultado debería ser similar al siguiente ejemplo:
{ "id": "2533514314332214789", "creationTimestamp": "2019-09-27T08:21:14.707-07:00", "selfLink": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/reservation-04", "zone": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-centra1-a", "name": "reservation-04", "specificReservationRequired": false, "status": "READY", "kind": "compute#reservation", "specificReservation": { "instanceProperties": { "machineType": "n1-standard-2", "guestAccelerators": [ { "acceleratorType": "nvidia-tesla-t4", "acceleratorCount": 1 } ], "minCpuPlatform": "Any CPU Platform", "localSsds": [ { "diskSizeGb": "375", "interface": "SCSI" } ] }, "count": "50", "inUseCount": "25" } }
Para determinar el uso de una reserva, consulta los campos
count
yinUseCount
. En este ejemplo, se reservan 50 VM y se consumieron 25 VM.¿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-08-20 (UTC)
[{ "type": "thumb-down", "id": "hardToUnderstand", "label":"Hard to understand" },{ "type": "thumb-down", "id": "incorrectInformationOrSampleCode", "label":"Incorrect information or sample code" },{ "type": "thumb-down", "id": "missingTheInformationSamplesINeed", "label":"Missing the information/samples I need" },{ "type": "thumb-down", "id": "translationIssue", "label":"Problema de traducción" },{ "type": "thumb-down", "id": "otherDown", "label":"Otro" }] [{ "type": "thumb-up", "id": "easyToUnderstand", "label":"Fácil de comprender" },{ "type": "thumb-up", "id": "solvedMyProblem", "label":"Resolvió mi problema" },{ "type": "thumb-up", "id": "otherUp", "label":"Otro" }] -