Conferir solicitações de reserva adiantada

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 selecionando uma das seguintes opções:

    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
    2. Set a default region and zone.

      3. 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:

  • 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

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

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

    Acessar "Reservas"

  2. 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.

  3. Opcional: para filtrar as solicitações de reserva adiantadas exibidas na tabela, realize uma das ações a seguir ou ambas:

    • No campo Filtro , insira uma expressão de filtro.

      Por 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.

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áquina n2-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étodo beta.futureResevations.list.

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

Substitua:

  • 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.

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:

  • 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áquina n2-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

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

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

    Acessar "Reservas"

  2. Clique na guia Reservas adiantadas.

  3. 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.

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:

  • 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.

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étodo beta.futureReservations.get.

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME

Substitua:

  • 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.

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

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

    Acessar "Reservas"

  2. Clique na guia Reservas adiantadas.

  3. 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.

  4. Opcional: para mudar o número de VMs reservadas em uma solicitação de reserva adiantada, modifique a solicitação.

gcloud

  1. Confira os detalhes da solicitação de reserva adiantada.

  2. Na saída, subtraia o valor do campo existingMatchingUsageInfo do campo totalCount. Se o valor de existingMatchingUsageInfo.count for igual a totalCount, 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 campo existingMatchingUsageInfo.timestamp.

  3. Opcional: para mudar o número de VMs reservadas na solicitação de reserva adiantada, modifique a solicitação.

REST

  1. Confira os detalhes da solicitação de reserva adiantada.

  2. Na saída, subtraia o valor do campo existingMatchingUsageInfo do campo totalCount. Se o valor de existingMatchingUsageInfo.count for igual a totalCount, 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 campo existingMatchingUsageInfo.timestamp.

  3. Opcional: para mudar o número de VMs reservadas na solicitação de reserva adiantada, modifique a solicitação.

A seguir