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
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
-
Para ver uma lista de reservas:
compute.reservations.list
no projeto -
Para ver os detalhes de uma reserva:
compute.reservations.get
no projeto 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.
PROJECT_ID
: o ID do projeto em que suas reservas estão localizadas.ZONE
: a zona em que seus recursos estão localizadosPROJECT_ID
: o ID do projeto em que suas reservas estão localizadas.ZONE
: a zona em que seus recursos estão localizadosFILTER_EXPRESSION
: uma expressão de filtro.No console do Google Cloud, acesse a página 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.
RESERVATION_NAME
: o nome de uma reserva.ZONE
: a zona em que está localizada a VM.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.Saiba como anexar reservas a compromissos.
Saiba como consumir reservas.
Saiba como modificar reservas.
Saiba como excluir reservas.
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 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:
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:
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.
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 zonaus-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étodoreservations.list
.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations
Substitua:
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:
Por exemplo, para visualizar somente reservas com um nome que comece com
prefix
e estejam localizadas na zonaus-central1-a
, faça a seguinte solicitaçãoGET
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
gcloud
Para ver os detalhes de uma reserva, use o comando
gcloud compute reservations describe
.gcloud compute reservations describe RESERVATION_NAME \ --zone=ZONE
Substitua:
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
einUseCount
. 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étodoreservations.get
.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME
Substitua:
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
einUseCount
. Neste exemplo, 50 VMs foram reservadas e 25 foram consumidas.A seguir
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2024-11-21 UTC.
-