Ver reservas

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

La visualización de reservas es útil para obtener una descripción general de todas las reservas en tu proyecto o revisar los detalles de configuración de una reserva. Si deseas ver una reserva compartida, solo puedes verla con el proyecto propietario.

Antes de comenzar

  • 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

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 a proyectos, carpetas y organizaciones.

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:

  • 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

Según los detalles que desees ver en una reserva, selecciona uno de los siguientes métodos:

Visualiza una lista de tus reservas

Para ver una lista de tus reservas, selecciona una de las siguientes opciones:

Console

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

Ir a Reservas

En la pestaña Reservas según demanda (predeterminada), 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 VMs donde 25 de estas VMs se han consumido.

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

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, incluye la marca --filter.

gcloud compute reservations list \
    --filter="FILTER_EXPRESSION"

Reemplaza FILTER_EXPRESSION por 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, ejecuta el siguiente comando:

gcloud compute reservations list \
    --filter="name~prefix AND zone=us-central1-a"

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-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, incluye el parámetro de consulta filter de la siguiente manera:

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

Si quieres ver cuántas VMs consume cada producto de Google Cloud compatible en una reserva, consulta los detalles de la reserva con la consola de Google Cloud.

Para ver los detalles de una reserva, selecciona una de las siguientes opciones:

Console

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

    Ir a Reservas

  2. En la pestaña Reservas según demanda (predeterminada), en la columna Nombre, haz clic en el nombre de la reserva de la que deseas ver los detalles.

    Se abrirá la página de detalles de la reserva. En la sección Utilización, puedes ver cuántas VMs de cada producto de Google Cloud compatible consumen la reserva.

gcloud

Para ver los detalles de una reserva, usa el comando gcloud compute reservations describe.

gcloud compute reservations describe RESERVATION_NAME \
    --zone=ZONE

Reemplaza lo siguiente:

  • RESERVATION_NAME: Es el nombre de una reserva existente.

  • ZONE: Es la zona en la que se encuentra la reserva.

El resultado es similar a este:

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 y inUseCount. 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é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.

  • ZONE: Es la zona en la que se encuentra la reserva.

  • RESERVATION_NAME: Es el nombre de una reserva existente.

El resultado es similar a este:

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

¿Qué sigue?