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
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- 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.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
-
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.
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 localizadosFILTER_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:
No console do Google Cloud, acesse a página Reservas.
A página Reservas é exibida.
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
- Saiba como anexar reservas a compromissos.
- Saiba como consumir reservas.
- Saiba como modificar reservas.
- Saiba como excluir reservas.