View future reservation requests

This document explains how to view future reservation requests.

To view other reservations, including those auto-created for a future reservation to provision the reserved resources, see View reservations instead.

Before you begin

If you haven't already, set up authentication. Authentication is the process by which your identity is verified for access to Google Cloud services and APIs. To run code or samples from a local development environment, you can authenticate to Compute Engine as follows.

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

To use the REST API samples on this page in a local development environment, you use the credentials you provide to the gcloud CLI.

Required roles

To get the permissions that you need to view future reservation requests, ask your administrator to grant you the Compute Future Reservation Viewer (roles/compute.futureReservationViewer) IAM role on the project. For more information about granting roles, see Manage access.

This predefined role contains the permissions required to view future reservation requests. To see the exact permissions that are required, expand the Required permissions section:

Required permissions

The following permissions are required to view future reservation requests:

To view a list of future reservations: compute.futureReservations.list on the project
To view the details of a future reservation: compute.futureReservations.get on the project

You might also be able to get these permissions with custom roles or other predefined roles.

View your future reservation requests

To view the future reservation requests in a specified project, select one of the following methods:

View a list of future reservation requests.

This section explains how to view a list of all drafted or submitted future reservation requests in a specified project. You can also use filters to narrow down results based on one or more attributes.
View details of a future reservation request.

This section explains how to view the details of a future reservation request, such as the projects a shared future reservation is shared with or the start time of its reservation period.

View a list of future reservation requests

You can view a list of future reservation requests in a specified project using the Google Cloud console, gcloud CLI, and REST.

Console

To view a list of future reservation requests, follow these steps:

In the Google Cloud console, go to the Reservations page.

Go to Reservations
Click the Future reservations tab.

In the table, each row describes a future reservation request and each column describes a property. For example, the Total count column describes the reserved capacity of each future reservation request.
Optional: To filter the future reservation requests displayed in the table, do one or both of the following:
- In the Filter field, enter a filter expression.
  
  For example, to only view the future reservation requests that were created in zone us-central1-a or which reserved more than 10 resources, specify the following expression:
```
Zone:us-central1-a OR Total Count>10
```
- Click Column display options, and then select the values that you want to filter the table by.

gcloud

To view a list of future reservation requests, use the gcloud beta compute future-reservations list command.

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

Replace PROJECT_ID with the ID of the project where one or more future reservation requests are located. If you omit the --project flag, the ID of the current project is used.

The output is similar to the following:

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

Optionally, you can specify the --filter flag to view a filtered list of future reservations based on a filter expression.

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

Replace the following:

FILTER_EXPRESSION with a filter expression.

For example, to only view future reservations that were created in zone us-central1-a, specify an n2-standard-4 machine type, and have a total count greater than 10, specify the following filter expression:
```
specificSkuProperties.instanceProperties.machineType=n2-standard-4 AND specificSkuProperties.totalCount>10 AND zone=us-central1-a
```
PROJECT_ID: Optional. The ID of the project where one or more future reservation requests are located. If you omit the --project flag, the ID of the current project is used.

REST

To view a list of future reservation requests, make a GET request to the beta.futureResevations.list method.

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

Replace the following:

PROJECT_ID: the ID of the project where one or more future reservation requests are located.
ZONE: the zone where one or more future reservation requests are located.

The output is similar to the following:

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

Optionally, you can specify the filter query parameter to view a filtered list of future reservations based on a filter expression.

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/aggregated/futureReservations?filter=FILTER_EXPRESSION

Replace the following:

PROJECT_ID: the ID of the project where one or more future reservation requests are located.
FILTER_EXPRESSION: a filter expression that uses URL-encoding.

For example, to only view future reservations that were created in zone us-central1-a, reserved an n2-standard-4 machine type, and have a total count greater than ten, specify the following filter expression:
```
specificSkuProperties.instanceProperties.machineType=n2-standard-4%20AND%20specificSkuProperties.totalCount%3E10%20AND%20zone=us-central1-a
```
Note that the URL-encoded filter expression represents the following decoded filter expression:
```
specificSkuProperties.instanceProperties.machineType=n2-standard-4 AND specificSkuProperties.totalCount>10 AND zone=us-central1-a
```

View the details of a future reservation request

You can view the details of a future reservation request using the Google Cloud console, gcloud CLI, and REST.

Console

To view the details of a future reservation request, follow these steps:

In the Google Cloud console, go to the Reservations page.

Go to Reservations
Click the Future reservations tab.
In the Name column, click the name of the future reservation request that you want to view the details of.

The Future reservations page with the details of the future reservation request opens.

gcloud

To view the details of a future reservation request, use the gcloud beta compute future-reservations describe command.

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

Replace the following:

FUTURE_RESERVATION_NAME: the name of an existing future reservation request.
PROJECT_ID: Optional. The ID of the project where the future reservation request is located. If you omit the --project flag, the ID of the current project is used.
ZONE: the zone where the future reservation request is located.

The output is similar to the following:

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

To view the details of a future reservation request, make a GET request to the beta.futureReservations.get method.

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

Replace the following:

PROJECT_ID: the ID of the project where the future reservation request is located.
ZONE: the zone where the future reservation request is located.
FUTURE_RESERVATION_NAME: the name of an existing future reservation request.

The output is similar to the following:

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

What's next

Learn how to modify, cancel, or delete future reservation requests.
After you reach the start time of your reservation period, learn how to consume the auto-created reservations.
After the end time of your reservation period, learn how to do the following:
- Modify the auto-created reservations.
- Delete the auto-created reservations.