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.

    Selecione a guia para como planeja usar as amostras nesta página:

    Console

    Quando você usa o console do Google Cloud para acessar os serviços e as APIs do Google Cloud, não é necessário configurar a autenticação.

    gcloud

    1. Instale a Google Cloud CLI e inicialize-a executando o seguinte comando: 

      gcloud init
    2. Defina uma região e uma zona padrão.

    REST

    Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para a CLI gcloud.

      Instale a Google Cloud CLI e inicialize-a executando o seguinte comando: 

      gcloud init

Funções exigidas

Para receber as permissões necessárias para criar reservas compartilhadas, 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-k80",
          "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-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 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-k80",
          "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