Ver reservas

En este documento, se explica cómo ver las reservas.

Antes de comenzar

Revisa los requisitos y las y las restricciones para las reservas.
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 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
```
  Nota: Si ya instalaste la CLI de gcloud, asegúrate de que tienes la versión más reciente mediante la ejecución de gcloud components update.
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.

Funciones obligatorias

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

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

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.

Consola

En la consola de Google Cloud, ve a la página SQL.

Ir a Reservas

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:

FILTER_EXPRESSION: es una expresión de filtro.
PROJECT_ID: el ID del proyecto en el que se encuentran tus reservas.

Por ejemplo, para ver solo las reservas con un nombre que comienza con prefix y se encuentran en la zona us-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étodo reservations.list.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations

Reemplaza lo siguiente:

PROJECT_ID: el ID del proyecto en el que se encuentran tus reservas.
ZONE: Es la zona donde se encuentran tus recursos.

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-k80",
          "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:

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.

Por ejemplo, para ver solo las reservas con un nombre que comienza con prefix y se encuentran en la zona us-central1-a, realiza la siguiente solicitud GET 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.

Consola

Para ver los detalles de una reserva, haz lo siguiente:

En la consola de Google Cloud, ve a la página Reservas.

Ir a 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.

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:

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.

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-k80
    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 y inUseCount. En este ejemplo, se reservan 50 VM y se consumieron 25 VM.

REST

Para ver los detalles de una reserva, realiza una solicitud GET al método reservations.get.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME

Reemplaza lo siguiente:

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.

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-k80",
          "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 y inUseCount. En este ejemplo, se reservan 50 VM y se consumieron 25 VM.

¿Qué sigue?

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.