Conferir futuras solicitações de reserva

Console

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 filter_list, 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 view_column 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
  

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"
}