Delete reservations

This document explains how to delete reservations.

If you no longer need a reservation, then delete it to stop incurring charges for its reserved resources. If you no longer need a shared reservation, then you can only delete it using the owner project.

Before you begin

Review the requirements and restrictions for reservations.
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.
For more information, see Authenticate for using REST in the Google Cloud authentication documentation.

Delete a reservation

Before deleting a reservation, ensure that the following conditions are met:

The reservation isn't tied to a commitment.
If you want to delete a specific reservation, then ensure that no virtual machine (VM) instances are targeting it for consumption by doing one or more of the following:
- Delete VMs.
- Update the reservationAffinity property of the VMs.

After deleting a reservation, you're no longer charged for the reservation and the reserved VMs are no longer reserved for you. The previously reserved VMs continue to run and you keep incurring charges for those VMs.

To delete a reservation, select one of the following options:

Console

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

Go to Reservations
Select each reservation that you want to delete.
Click Delete reservation.
To confirm, click Delete.

Deleting the reservation might take some time to complete.

gcloud

To delete a reservation, use the gcloud compute reservations delete command.

gcloud compute reservations delete RESERVATION_NAME \
    --zone=ZONE

Replace the following:

RESERVATION_NAME: the name of an existing reservation that you want to delete.
ZONE: the zone where the reservation is located.

REST

To delete a reservation, make a DELETE request to the reservation.delete method.

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME

Replace the following:

PROJECT_ID: the ID of the project that you used to create the reservation.
ZONE: the zone where the reservation is located.
RESERVATION_NAME: the name of the reservation that you want to delete.

What's next

Learn how to view your reservations.