Neste documento, explicamos como visualizar solicitações de reserva adiantadas.
A visualização das solicitações de reserva adiantadas é útil para ter uma visão geral de todas essas solicitações no projeto e para analisar os detalhes de configuração de uma determinada solicitação de reserva adiantada. Só é possível acessar uma solicitação de reserva adiantada compartilhada usando o projeto do proprietário.
Para conferir as reservas criadas automaticamente e provisionadas para uma reserva adiantada, consulte Visualizar reservas.
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 adiantadas:
compute.futureReservations.list
no projeto -
Para ver os detalhes de uma reserva adiantada:
compute.futureReservations.get
no projeto Para conferir o nome, o período de reserva, o estado, a contagem total e a zona de todas as solicitações de reserva adiantadas no projeto, confira uma lista de solicitações de reserva adiantadas.
Para conferir todos os detalhes de configuração e todas as propriedades de uma única solicitação de reserva adiantada, confira os detalhes dessa solicitação de reserva adiantada.
No console do Google Cloud, acesse a página Reservas.
Clique na guia Reservas adiantadas.
Na tabela, cada linha descreve uma solicitação de reserva adiantada e cada coluna descreve uma propriedade. Por exemplo, a coluna Contagem total descreve a capacidade reservada de cada solicitação de reserva adiantada.
Opcional: para filtrar as solicitações de reserva adiantadas exibidas na tabela, realize uma das ações a seguir ou ambas:
No campo Filtro expressão de filtro.
, insira umaPor exemplo, para visualizar somente as solicitações de reserva adiantadas que foram criadas na zona
us-central1-a
ou que reservaram mais de 10 recursos, especifique a seguinte expressão:Zone:us-central1-a OR Total Count>10
Clique em
Opções de exibição de colunas e selecione os valores que você quer filtrar na tabela.
PROJECT_ID
: o ID do projeto em que uma ou mais solicitações de reserva adiantadas estão localizadas.ZONE
: a zona em que uma ou mais solicitações de reserva adiantadas estão localizadas.PROJECT_ID
: o ID do projeto em que uma ou mais solicitações de reserva adiantadas estão localizadas.FILTER_EXPRESSION
: uma expressão de filtro que usa codificação de URL.Por exemplo, para visualizar apenas reservas adiantadas que foram criadas na zona
us-central1-a
, reservaram um tipo de máquinan2-standard-4
e têm uma contagem total maior que 10, especifique a seguinte expressão de filtro:zone=us-central1-a%20AND%20specificSkuProperties.instanceProperties.machineType=n2-standard-4%20AND%20specificSkuProperties.totalCount%3E10
A expressão de filtro codificada para URL representa a seguinte expressão de filtro decodificado:
zone=us-central1-a AND specificSkuProperties.instanceProperties.machineType=n2-standard-4 AND specificSkuProperties.totalCount>10
No console do Google Cloud, acesse a página Reservas.
Clique na guia Reservas adiantadas.
Na coluna Nome, clique no nome da solicitação de reserva adiantada com os detalhes que você quer ver.
A página Reservas adiantadas com os detalhes da solicitação de reserva adiantada abre.
FUTURE_RESERVATION_NAME
: o nome de uma solicitação de reserva adiantada atual.ZONE
: a zona em que a solicitação de reserva adiantada está localizada.PROJECT_ID
: o ID do projeto em que a solicitação de reserva adiantada está localizada.ZONE
: a zona em que a solicitação de reserva adiantada está localizada.FUTURE_RESERVATION_NAME
: o nome de uma solicitação de reserva adiantada atual.No console do Google Cloud, acesse a página Reservas.
Clique na guia Reservas adiantadas.
Para cada solicitação de reserva adiantada, é possível determinar o seguinte:
Na coluna Contagem total, a contagem total da solicitação.
Na coluna Contagem de correspondências, o número de VMs em execução e reservas com propriedades de VM que correspondem à solicitação.
Subtraindo o valor da coluna Contagem de correspondências do valor da coluna Contagem total, é possível determinar o número de VMs que o Compute Engine vai provisionar para uma solicitação de reserva adiantada no horário de início. Quando você recebe um aviso na coluna Contagem de correspondências, isso se deve a um destes motivos:
O valor de Contagem de correspondências é zero. Nesse caso, não há VMs em execução ou reservas correspondentes no projeto.
O valor de Contagem de correspondências é igual a Contagem total. Nesse caso, o Compute Engine não vai provisionar VMs reservadas para a solicitação de reserva adiantada.
Se você modificar a solicitação de reserva adiantada ou criar VMs ou reservas com propriedades de VM correspondentes à solicitação, o Compute Engine vai atualizar o valor da coluna Contagem de correspondência em até 30 minutos. Para verificar quando a coluna Contagem de correspondências foi atualizada pela última vez, confira os detalhes da solicitação e verifique o valor da linha Horário da avaliação de último uso correspondente.
Opcional: para mudar o número de VMs reservadas em uma solicitação de reserva adiantada, modifique a solicitação.
Na saída, subtraia o valor do campo
existingMatchingUsageInfo
do campototalCount
. Se o valor deexistingMatchingUsageInfo.count
for igual atotalCount
, o Compute Engine não vai provisionar VMs reservadas para a solicitação de reserva adiantada.Se você modificar a solicitação de reserva adiantada ou criar VMs ou reservas com propriedades de VM correspondentes à solicitação, o Compute Engine vai atualizar o campo
existingMatchingUsageInfo
em 30 minutos. Para verificar quando o campo foi atualizado pela última vez, verifique o valor do campoexistingMatchingUsageInfo.timestamp
.Opcional: para mudar o número de VMs reservadas na solicitação de reserva adiantada, modifique a solicitação.
Na saída, subtraia o valor do campo
existingMatchingUsageInfo
do campototalCount
. Se o valor deexistingMatchingUsageInfo.count
for igual atotalCount
, o Compute Engine não vai provisionar VMs reservadas para a solicitação de reserva adiantada.Se você modificar a solicitação de reserva adiantada ou criar VMs ou reservas com propriedades de VM correspondentes à solicitação, o Compute Engine vai atualizar o campo
existingMatchingUsageInfo
em 30 minutos. Para verificar quando o campo foi atualizado pela última vez, verifique o valor do campoexistingMatchingUsageInfo.timestamp
.Opcional: para mudar o número de VMs reservadas na solicitação de reserva adiantada, modifique a solicitação.
Saiba como modificar solicitações de reserva adiantadas.
Saiba como cancelar ou excluir solicitações de reserva adiantadas.
Depois de atingir o horário de início do período de reserva, saiba como consumir as reservas criadas automaticamente.
Após o horário de término do período de reserva, saiba como fazer o seguinte:
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 e visualizar solicitações de reserva adiantadas, peça ao administrador para conceder a você o papel do IAM de Leitor de reservas adiantadas do Compute (
roles/compute.futureReservationViewer
) 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 solicitações de reserva adiantadas. 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 solicitações de reserva adiantadas:
Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.
Ver suas solicitações de reserva adiantadas
Com base nos detalhes que você quer visualizar em uma solicitação de reserva adiantada, use um dos seguintes métodos:
Ver uma lista de solicitações de reserva adiantadas
Ao visualizar uma lista de solicitações de reserva adiantadas, é possível usar expressões de filtro para restringir os resultados. Para expressões de filtro mais avançadas, use a gcloud CLI ou REST.
Para conferir uma lista de solicitações de reserva adiantadas no projeto, selecione uma das seguintes opções:
Console
gcloud
Para visualizar uma lista de solicitações de reserva adiantadas, use o comando
gcloud beta compute future-reservations list
.gcloud beta compute future-reservations list
O resultado será assim:
NAME: fr-04 TOTAL_COUNT: 100 START_TIME: 2025-07-20T07:00:00Z END_TIME: 2025-08-05T07:00:00Z PROCUREMENT_STATUS: FULFILLED ZONE: us-east1-a NAME: fr-05 TOTAL_COUNT: 10 START_TIME: 2025-07-20T07:00:00Z END_TIME: 2025-12-01T00:00:00Z PROCUREMENT_STATUS: PENDING_APPROVAL ZONE: us-west1-c
Também é possível filtrar as solicitações de reserva adiantadas com base em uma expressão de filtro incluindo a flag
--filter
.gcloud beta compute future-reservations list \ --filter="FILTER_EXPRESSION"
Substitua
FILTER_EXPRESSION
por uma expressão de filtro.Por exemplo, para visualizar apenas reservas adiantadas que foram criadas na zona
us-central1-a
, que especificam um tipo de máquinan2-standard-4
e que têm uma contagem total maior que 10, especifique a seguinte expressão de filtro:zone=us-central1-a AND specificSkuProperties.instanceProperties.machineType=n2-standard-4 AND specificSkuProperties.totalCount>10
REST
Para ver uma lista de solicitações de reserva adiantadas, faça uma solicitação
GET
para o métodobeta.futureResevations.list
.GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations
Substitua:
O resultado será assim:
{ "id": "projects/my-project/zones/us-east1-a/futureReservations", "items": [ { "id": "743865190848184978", "creationTimestamp": "2025-03-23T18:16:45.274-07:00", "selfLink": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a/futureReservations/fr-base", "selfLinkWithId": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a/futureReservations/743865190848184978", "zone": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a", "name": "fr-base", "specificSkuProperties": { "instanceProperties": { "machineType": "n1-standard-1" }, "totalCount": "100" }, "planningStatus": "SUBMITTED", "timeWindow": { "endTime": "2025-05-02T01:00:00Z", "startTime": "2025-04-30T17:30:00Z" }, "status": { "procurementStatus": "FULFILLED", "lockTime": "2025-03-30T07:00:00Z", "existingMatchingUsageInfo": { "count": "3", "timestamp": "2025-03-30T01:00:00Z" } }, "kind": "compute#futureReservation" }, ... ], "selfLink": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a/futureReservations", "etag": "AnzKY34l-cvvV-JnniESJ0dtQvQ=/hvc4jaHpxFAZmOt1FVtKNgzZu-M=", "kind": "compute#futureReservationsListResponse" }
Também é possível filtrar as solicitações de reserva adiantadas com base em uma expressão de filtro incluindo o parâmetro de consulta
filter
.GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/aggregated/futureReservations?filter=FILTER_EXPRESSION
Substitua:
Ver os detalhes de uma solicitação de reserva adiantada
Para conferir os detalhes de uma solicitação de reserva adiantada, selecione uma das seguintes opções:
Console
gcloud
Para visualizar os detalhes de uma solicitação de reserva adiantada, use o comando
gcloud beta compute future-reservations describe
.gcloud beta compute future-reservations describe FUTURE_RESERVATION_NAME \ --zone=ZONE
Substitua:
O resultado será assim:
autoCreatedReservationsDeleteTime: '2025-05-02T01:00:00Z' creationTimestamp: '2025-03-23T10:08:31.613-07:00' id: '5212276518668495076' kind: compute#futureReservation name: fr-01 planningStatus: SUBMITTED selfLink: https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-01 selfLinkWithId: https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/5212276518668495076 shareSettings: shareType: LOCAL specificSkuProperties: instanceProperties: machineType: n1-standard-64 totalCount: '800' status: existingMatchingUsageInfo: count: '3' timestamp: '2025-03-30T01:00:00Z' lockTime: '2025-03-30T17:09:59.297799Z' procurementStatus: APPROVED timeWindow: endTime: '2025-05-02T01:00:00Z' startTime: '2025-04-30T17:30:00Z' zone: https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a
REST
Para visualizar os detalhes de uma solicitação de reserva adiantada, faça uma solicitação
GET
para o métodobeta.futureReservations.get
.GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME
Substitua:
O resultado será assim:
{ "autoCreatedReservationsDeleteTime": "2025-05-02T01:00:00Z", "creationTimestamp": "2025-03-23T10:08:31.613-07:00", "id": "5212276518668495076", "kind": "compute#futureReservation", "name": "fr-01", "planningStatus": "SUBMITTED", "selfLink": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-01", "selfLinkWithId": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/5212276518668495076", "shareSettings": { "shareType": "LOCAL" }, "specificSkuProperties": { "instanceProperties": { "machineType": "n1-standard-64" }, "totalCount": "800" }, "status": { "lockTime": "2025-03-30T17:09:59.297799Z", "procurementStatus": "APPROVED", "existingMatchingUsageInfo": { "count": "3", "timestamp": "2025-03-30T01:00:00Z" } }, "timeWindow": { "endTime": "2025-05-02T01:00:00Z", "startTime": "2025-04-30T17:30:00Z" }, "zone": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a" }
Determinar o número de VMs provisionadas
Depois de criar uma solicitação de reserva adiantada, é possível conferir quantas VMs em execução e reservas não utilizadas no seu projeto ou em outro com o qual a solicitação de reserva adiantada é compartilhada correspondem às propriedades da VM especificadas na solicitação. Subtraindo esse número da contagem total especificada na solicitação, é possível determinar quantas VMs o Compute Engine vai provisionar depois que a solicitação for aprovada e atingir o horário de início.
Para determinar o número de VMs provisionadas para várias solicitações de reserva adiantadas simultaneamente, use o console do Google Cloud. Caso contrário, para determinar o número de VMs provisionadas para uma única solicitação, selecione uma das seguintes opções:
Console
gcloud
REST
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.
-