Ver reservas

Neste documento, explicamos como visualizar as reservas.

Antes de começar

  • Revise os requisitos e restrições para reservas.
  • Configure a autenticação, caso ainda não tenha feito isso. A autenticação é o processo de verificação da sua identidade para acesso a serviços e APIs do Google Cloud. Para executar códigos ou amostras de um ambiente de desenvolvimento local, autentique-se no Compute Engine da seguinte maneira.

    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 as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para gcloud CLI.

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

      Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.

Funções exigidas

Para receber as permissões necessárias para visualizar reservas, peça ao administrador para conceder a você o papel do IAM de Administrador do Compute (roles/compute.admin) no projeto. Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.

Esse papel predefinido contém as permissões necessárias para visualizar reservas. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As seguintes permissões são necessárias para visualizar reservas:

  • Para ver uma lista de reservas: compute.reservations.list no projeto
  • Para ver os detalhes de uma reserva: compute.reservations.get no projeto

Essas permissões também podem ser concedidas com papéis personalizados ou outros papéis predefinidos.

Ver suas reservas

Só é possível ver as reservas que foram criadas pelo seu projeto atual.

Somente o projeto do proprietário pode ver uma reserva compartilhada. Se você quiser ver os projetos com que uma reserva é compartilhada, veja os detalhes da reserva.

Ver uma lista das suas reservas

Para ver uma lista das suas reservas, use o console do Google Cloud, a CLI gcloud ou o REST.

Console

No console do Google Cloud, acesse a página Reservas.

Acessar "Reservas"

A página Reservas é exibida.

Na tabela, cada linha descreve uma reserva, e cada coluna descreve uma propriedade. Por exemplo, a coluna Máquinas usadas descreve a utilização e a capacidade total de cada reserva: o valor 25 (50) representa uma reserva para 50 VMs em que 25 delas foram consumidos.

Opcional: para modificar quais reservas e propriedades são exibidas, use o filtro e as opções de exibição de coluna , respectivamente.

gcloud

Para ver uma lista das suas reservas, use o comando gcloud compute reservations list.

gcloud compute reservations list \
    --project=PROJECT_ID

Substitua PROJECT_ID pelo ID do projeto em que suas reservas estão localizadas.

A saída será semelhante a este exemplo:

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

Para restringir uma lista de reservas usando uma expressão de filtro, especifique a sinalização --filter.

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

Substitua:

  • FILTER_EXPRESSION: uma expressão de filtro.

  • PROJECT_ID: o ID do projeto em que suas reservas estão localizadas.

Por exemplo, para visualizar somente reservas com um nome que comece com prefix e esteja localizada na zona us-central1-a, execute o seguinte comando:

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

REST

Para ver uma lista das suas reservas, faça uma solicitação GET ao método reservations.list.

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

Substitua:

  • PROJECT_ID: o ID do projeto em que suas reservas estão localizadas.

  • ZONE: a zona em que seus recursos estão localizados

A resposta será semelhante a:

{
  "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"
}

Para restringir uma lista de reservas usando uma expressão de filtro, faça a seguinte solicitação GET:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations?filter=FILTER_EXPRESSION

Substitua:

  • PROJECT_ID: o ID do projeto em que suas reservas estão localizadas.

  • ZONE: a zona em que seus recursos estão localizados

  • FILTER_EXPRESSION: uma expressão de filtro.

Por exemplo, para visualizar somente reservas com um nome que comece com prefix e estejam localizadas na zona us-central1-a, faça a seguinte solicitação GET usando valores codificados em URL:

GET https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations?filter=name%7Eprefix%20AND%20zone=us-central1-a

Mais detalhes de uma reserva

Para visualizar os detalhes de uma reserva, use o console do Google Cloud, a CLI gcloud ou o REST.

Console

Para ver os detalhes de uma VM, realize as seguintes ações:

  1. No console do Google Cloud, acesse a página Reservas.

    Acessar "Reservas"

    A página Reservas é exibida.

  2. Na coluna Nome, clique no nome da reserva que você quer descrever.

    A página de detalhes da reserva vai aparecer. Para determinar a utilização de uma reserva, consulte os campos Total de máquinas reservadas e Máquinas usadas.

gcloud

Para ver os detalhes de uma reserva, use o comando gcloud compute reservations describe.

gcloud compute reservations describe RESERVATION_NAME \
    --project=PROJECT_ID \
    --zone=ZONE

Substitua:

  • RESERVATION_NAME: o nome de uma reserva.

  • PROJECT_ID: o ID do projeto em que a reserva está.

  • ZONE: a zona em que está localizada a VM.

A saída será semelhante a este exemplo:

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 a utilização de uma reserva, consulte os campos count e inUseCount. Neste exemplo, 50 VMs foram reservadas e 25 foram consumidas.

REST

Para visualizar os detalhes de uma reserva, faça uma solicitação GET para o método reservations.get.

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

Substitua:

  • PROJECT_ID: o ID do projeto em que a reserva está.

  • ZONE: a zona em que está localizada a VM.

  • RESERVATION_NAME: o nome de uma reserva.

A saída será semelhante a este exemplo:

{
  "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 a utilização de uma reserva, consulte os campos count e inUseCount. Neste exemplo, 50 VMs foram reservadas e 25 foram consumidas.

A seguir