Delete a future reservation request in calendar mode

This document explains how to cancel or permanently delete a future reservation request in calendar mode.

If you no longer need a future reservation request in calendar mode, then you can do one or both of the following:

• Cancel the reservation request: you can cancel a request to prevent Compute Engine from provisioning your requested resources and incurring charges for them. After you cancel a request, you can either retain your request for future reference or delete it.

• Delete the reservation request: after you cancel a request or after the request reaches its end time, you can permanently delete the request to remove the record from your project.

Only the owner project, the project in which a request exists, can cancel or delete a shared request. To learn more about the requirements and limitations that you apply when you cancel or delete a request in calendar mode, see About future reservation requests in calendar mode.

Before you begin

• If you haven't already, set up authentication. Authentication verifies your identity for access to Cloud de Confiance by S3NS 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 Cloud de Confiance console to access Cloud de Confiance by S3NS services and APIs, you don't need to set up authentication.

  gcloud

  1. Install the Google Cloud CLI, and then sign in to the gcloud CLI with your federated identity. After signing in, initialize the Google Cloud CLI by running the following command:

     gcloud init

  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, and then sign in to the gcloud CLI with your federated identity.

  For more information, see Authenticate for using REST in the Cloud de Confiance authentication documentation.

Required roles

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

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

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

Cancel a future reservation request in calendar mode

You can cancel a future reservation request in calendar mode if it meets one of the following conditions:

• The start time is more than 30 days away.

• You cancel the request within 24 hours after approval, and the start time is at least four days away.

After you cancel your request, Compute Engine deletes the empty reservation created for the request. You can view the details of your request or delete it.

To cancel multiple future reservation requests in calendar mode, use the Cloud de Confiance console. Otherwise, to cancel a single request, select one of the following options:

gcloud compute future-reservations cancel FUTURE_RESERVATION_NAME \
    --zone=ZONE

POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME/cancel

Delete a future reservation request in calendar mode

You can only delete a future reservation request in calendar mode after one of the following happens:

• The request is in the CANCELLED state.

• The request has reached its end time.

To delete multiple future reservation requests in calendar mode simultaneously, use the Cloud de Confiance console. Otherwise, to delete a single request, select one of the following options:

gcloud compute future-reservations delete FUTURE_RESERVATION_NAME \
    --zone=ZONE

DELETE https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME

What's next

• View reservations or future reservation requests

• Create a future reservation request in calendar mode