Conferir futuras solicitações de reserva

---

Visualização

Este produto ou recurso está sujeito aos "Termos das ofertas pré-GA" na seção "Termos de Serviço gerais" dos Termos específicos do serviço. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Neste documento, explicamos como visualizar solicitações de reserva futuras.

Para ver outras reservas, incluindo aquelas criadas automaticamente para uma reserva futura para provisionar os recursos reservados, 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

  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.

  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 futuras solicitações de reserva, peça ao administrador para conceder a você o papel de Leitor da reserva adiantada do Compute (roles/compute.futureReservationViewer) do IAM 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 futuras solicitações de reserva. 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 futuras:

• Para ver uma lista de reservas futuras: compute.futureReservations.list no projeto
• Para ver os detalhes de uma reserva futura: compute.futureReservations.get no projeto

Essas permissões também podem ser concedidas com papéis personalizados ou outros papéis predefinidos.

Ver suas solicitações de reserva futuras

Para visualizar as futuras solicitações de reserva em um projeto especificado, selecione um dos seguintes métodos:

• Veja uma lista de solicitações de reserva futuras.

  Nesta seção, explicamos como visualizar uma lista de todas as solicitações de reserva futuras criadas ou enviadas em um projeto especificado. Também é possível usar filtros para restringir os resultados com base em um ou mais atributos.

• Mais detalhes de uma solicitação de reserva futura.

  Nesta seção, explicamos como visualizar os detalhes de uma solicitação de reserva futura, como os projetos com que uma reserva futura compartilhada é compartilhada ou o horário de início do período de reserva.

Ver uma lista de solicitações de reserva futuras

É possível ver uma lista de solicitações futuras de reserva em um projeto especificado usando o console do Google Cloud, a CLI gcloud e o REST.

Console

Observação: se você quiser usar expressões de filtro mais avançadas para filtrar uma lista de solicitações de reserva futuras, use o método CLI gcloud ou REST.

Para visualizar uma lista de solicitações de reserva futuras, siga estas etapas:

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 futura e cada coluna descreve uma propriedade. Por exemplo, a coluna Contagem total descreve a capacidade reservada de cada solicitação de reserva futura.

3. Opcional: para filtrar as futuras solicitações de reserva 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 futuras solicitações de reserva 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 futuras, use o comando gcloud beta compute future-reservations list.

gcloud beta compute future-reservations list \
    --project=PROJECT_ID

Substitua PROJECT_ID pelo ID do projeto em que uma ou mais solicitações de reserva futuras estão localizadas. Se você omitir a flag --project, o ID do projeto atual será usado.

O resultado será assim:

NAME          TOTAL_COUNT    START_TIME             END_TIME               PROCUREMENT_STATUS   ZONE
fr-04         100            2025-07-20T07:00:00Z   2025-08-05T07:00:00Z   FULFILLED            us-east1-a
fr-05         10             2025-11-15T00:00:00Z   2025-12-01T00:00:00Z   PENDING_APPROVAL     us-west1-c

Também é possível especificar a flag --filter para consultar uma lista filtrada de reservas futuras com base em uma expressão de filtro.

gcloud beta compute future-reservations list \
    --filter="FILTER_EXPRESSION" \
    --project=PROJECT_ID

Substitua:

• FILTER_EXPRESSION por uma expressão de filtro.

  Por exemplo, para visualizar apenas reservas futuras que foram criadas na zona us-central1-a, especifique um tipo de máquina n2-standard-4 e tenha uma contagem total maior que 10, especifique a seguinte expressão de filtro:

  specificSkuProperties.instanceProperties.machineType=n2-standard-4 AND specificSkuProperties.totalCount>10 AND zone=us-central1-a
  

• PROJECT_ID: opcional. O ID do projeto em que uma ou mais solicitações de reserva futuras estão localizadas. Se você omitir a sinalização --project, o ID do projeto atual será usado.

REST

Para ver uma lista de solicitações de reserva futuras, 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 futuras de reserva estão localizadas.

• ZONE: a zona em que uma ou mais solicitações de reserva futuras estão localizadas.

O resultado será assim:

{
  "id": "projects/my-project/zones/us-east1-a/futureReservations",
  "items": [
    {
      "id": "743865190848184978",
      "creationTimestamp": "2025-04-11T18: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": {
        "startTime": "2025-07-20T07:00:00Z",
        "endTime": "2025-08-05T07:00:00Z"
      },
      "status": {
        "procurementStatus": "FULFILLED",
        "lockTime": "2025-05-04T07:00:00Z",
        "fulfilledCount": "100"
      },
      "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 especificar o parâmetro de consulta filter para consultar uma lista filtrada de reservas futuras com base em uma expressão de filtro.

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 futuras de reserva estão localizadas.

• FILTER_EXPRESSION: uma expressão de filtro que usa codificação de URL.

  Por exemplo, para visualizar apenas reservas futuras 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:

  specificSkuProperties.instanceProperties.machineType=n2-standard-4%20AND%20specificSkuProperties.totalCount%3E10%20AND%20zone=us-central1-a
  

  A expressão de filtro codificada para URL representa a seguinte expressão de filtro decodificado:

  specificSkuProperties.instanceProperties.machineType=n2-standard-4 AND specificSkuProperties.totalCount>10 AND zone=us-central1-a
  

Ver os detalhes de uma solicitação de reserva futura

É possível ver os detalhes de uma solicitação de reserva futura usando o console do Google Cloud, a CLI gcloud e o REST.

Console

Para ver os detalhes de uma solicitação de reserva futura, siga estas etapas:

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 futura 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 futura, use o comando gcloud beta compute future-reservations describe.

gcloud beta compute future-reservations describe FUTURE_RESERVATION_NAME \
    --project=PROJECT_ID \
    --zone=ZONE

Substitua:

• FUTURE_RESERVATION_NAME: o nome de uma solicitação de reserva adiantada atual.

• PROJECT_ID: opcional. O ID do projeto em que a solicitação de reserva adiantada está localizada. Se você omitir a flag --project, o ID do projeto atual será usado.

• ZONE: a zona em que a solicitação de reserva adiantada está localizada.

O resultado será assim:

creationTimestamp: '2025-07-19T12:44:11.855-07:00'
id: '5212276518668495076'
kind: compute#futureReservation
name: fr-01
namePrefix: test-fr
selfLink: https://www.googleapis.com/compute/beta/projects/project-01/zones/us-central1-a/futureReservations/future-reservation-test-1
selfLinkWithId: https://www.googleapis.com/compute/beta/projects/project-01/zones/us-central1-a/futureReservations/5212276518668495076
shareSettings:
  projects:
  - 'project-02'
  shareType: SPECIFIC_PROJECTS
specificSkuProperties:
  instanceProperties:
    localSsds:
    - diskSizeGb: '375'
      interface: SCSI
    machineType: n1-standard-64
    minCpuPlatform: Intel Skylake
  totalCount: '800'
planningStatus: SUBMITTED
status:
  lockTime: '2025-08-25T00:00:00Z'
  procurementStatus: APPROVED
timeWindow:
  endTime: '2025-12-10T00:00:00Z'
  startTime: '2025-11-10T00:00:00Z'
zone: https://www.googleapis.com/compute/beta/projects/project-01/zones/us-central1-a

REST

Para visualizar os detalhes de uma solicitação de reserva futura, 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/reservations/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 futura atual.

O resultado será assim:

{
  "creationTimestamp": "2025-04-11T18:16:45.274-07:00",
  "id": "743865190848184978",
  "name": "fr-01",
  "namePrefix": "test-fr",
  "kind": "compute#futureReservation",
  "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",
  "specificSkuProperties": {
    "instanceProperties": {
      "machineType": "n1-standard-1"
    },
    "totalCount": "100"
  },
  "planningStatus": "SUBMITTED",
  "timeWindow": {
    "endTime": "2025-08-05T07:00:00Z",
    "startTime": "2025-07-20T07:00:00Z"
  },
  "status": {
    "fulfilledCount": "100"
    "lockTime": "2025-05-04T07:00:00Z",
    "procurementStatus": "FULFILLED",
  },
  "zone": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a"
}

A seguir

• Saiba como modificar, cancelar ou excluir solicitações de reserva adiantada.

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

  • Modifique as reservas criadas automaticamente.

  • Exclua as reservas criadas automaticamente.