Ver reservas

Neste documento, explicamos como visualizar as reservas.

A visualização de reservas é útil para ter uma visão geral de todas as reservas no seu projeto ou revisar os detalhes de configuração de uma reserva. Se você quiser acessar uma reserva compartilhada, só poderá fazer isso usando o projeto do proprietário.

Antes de começar

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
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

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 a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

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 funções personalizadas ou outros papéis predefinidos.

Ver suas reservas

Com base nos detalhes que você quer visualizar em uma reserva, selecione um dos seguintes métodos:

Para ter uma visão geral de todas as reservas no seu projeto, confira uma lista de suas reservas.
Para conferir os detalhes de configuração de uma reserva, como os projetos de consumidor com que uma reserva é compartilhada, confira os detalhes da reserva.

Ver uma lista das suas reservas

Para conferir uma lista das suas reservas, selecione uma das seguintes opções:

Console

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

Acessar "Reservas"

Na guia Reservas imediatas (padrão), 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 consumidas.

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

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

Ou então, para restringir uma lista de reservas usando uma expressão de filtro, inclua a flag --filter.

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

Substitua FILTER_EXPRESSION por uma expressão de filtro.

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"

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, inclua o parâmetro de consulta filter da seguinte maneira:

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

Se você quiser saber quantas VMs cada produto do Google Cloud com suporte está consumindo em uma reserva, confira os detalhes da reserva usando o console do Google Cloud.

Para conferir os detalhes de uma reserva, selecione uma das seguintes opções:

Console

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

Acessar "Reservas"
Na guia Reservas imediatas (padrão), na coluna Nome, clique no nome da reserva que você quer consultar.

A página de detalhes da reserva será exibida. Na seção Utilização, é possível conferir quantas VMs de cada produto compatível do Google Cloud estão consumindo a reserva.

gcloud

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

gcloud compute reservations describe RESERVATION_NAME \
    --zone=ZONE

Substitua:

RESERVATION_NAME: o nome de uma reserva.
ZONE: a zona em que está localizada a VM.

O resultado será assim:

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 um reserva atual.

O resultado será assim:

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

Saiba como anexar reservas a compromissos.
Saiba como consumir reservas.
Saiba como modificar reservas.
Saiba como excluir reservas.