This document describes how to cancel or delete future reservation requests.

Before a future reservation request reaches itslock time,you can prevent Compute Engine from provisioning the requested resources bydoing one of the following:

• Cancel the future reservation request. This is useful to keep thecanceled request for reference when creating new requests. However, acanceled future reservation request prevents you from creating new requestswith properties that match the canceled request in your project, or in theprojects that the request is shared with, until you delete it. For moreinformation, seeRestrictions on creation.

• Delete the future reservation request. This is useful when you no longerneed the request. Deleting a future reservation request permanentlydeletes it and removes any restrictions on creating new requests.

After a fulfilled future reservation reaches the end of its reservation period,you can delete it to remove any restrictions on creating new requests. However,deleting a fulfilled future reservation doesn't delete its auto-createdreservations. To delete an auto-created reservation after its reservation periodends, seeDelete reservations.

Before you begin

• If you haven't already, set upauthentication. Authentication verifies your identity for access to Google Cloud services and APIs. To run code or samples from a local development environment, you can authenticate to Compute Engine by selecting one of the following options:

  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. After installation,initialize the Google Cloud CLI by running the following command:

     gcloudinit

     If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

     Note: If you installed the gcloud CLI previously, make sure you have the latest version by runninggcloud 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.

  Install the Google Cloud CLI. After installation,initialize the Google Cloud CLI by running the following command:

  gcloudinit

  If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  Note: If you installed the gcloud CLI previously, make sure you have the latest version by runninggcloud components update.

  For more information, seeAuthenticate for using REST in the Google Cloud authentication documentation.

Required roles

To get the permissions that you need to cancel or delete future reservation requests, ask your administrator to grant you theCompute Future Reservation Admin (roles/compute.futureReservationAdmin) IAM role on the project. For more information about granting roles, seeManage access to projects, folders, and organizations.

This predefined role contains the permissions required to cancel or delete future reservation requests. To see the exact permissions that are required, expand theRequired permissions section:

You might also be able to get these permissions withcustom roles or otherpredefined roles.

Cancel future reservation requests

You can only cancel a future reservation request in the following cases:

• The request is pending approval or has been declined.

• The request was approved, but its state hasn't changed toPROCURING yet.

After you cancel a future reservation request, you can onlyview its detailsordelete it.

To cancel a future reservation request, select one of the following options:

gcloud compute future-reservations cancelFUTURE_RESERVATION_NAME \    --zone=ZONE

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME/cancel

Delete future reservation requests

You can only delete a future reservation request in the following cases:

• The request hasn't reached its lock time yet (PROCURING) and isn't pendingapproval.

• The request was fulfilled and its reservation period has ended.

To delete a future reservation request that is pending approval, you mustcancel the request before deleting it.

Deleting a fulfilled future reservation doesn't delete its auto-createdreservations. To delete an auto-created reservation after its reservation periodends, seeDelete reservations.

To delete multiple future reservation requests simultaneously, use theGoogle Cloud console. Otherwise, to delete a single future reservation request,select any of the following options:

gcloud compute future-reservations deleteFUTURE_RESERVATION_NAME \    --zone=ZONE

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME

What's next

• Learn how toview future reservation requests.