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
-
If you haven't already, then 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 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
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
Go
To use the Go samples on this page in a local development environment, install and initialize the gcloud CLI, and then set up Application Default Credentials with your user credentials.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
For more information, see Set up authentication for a local development environment.
Java
To use the Java samples on this page in a local development environment, install and initialize the gcloud CLI, and then set up Application Default Credentials with your user credentials.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
For more information, see Set up authentication for a local development environment.
Node.js
To use the Node.js samples on this page in a local development environment, install and initialize the gcloud CLI, and then set up Application Default Credentials with your user credentials.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
For more information, see Set up authentication for a local development environment.
Python
To use the Python samples on this page in a local development environment, install and initialize the gcloud CLI, and then set up Application Default Credentials with your user credentials.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
For more information, see Set up authentication for a local development environment.
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, then initialize it by running the following command:
gcloud init
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:
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 multiple reservations simultaneously, use the Google Cloud console. Otherwise, to delete a single reservation, select any of the following options:
Console
In the Google Cloud console, go to the Reservations page.
On the On-demand reservations tab (default), select the reservations that you want to delete.
Click
Delete.To confirm, click Delete.
Deleting one or more reservations simultaneously might take up to a minute 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.
Go
Java
Node.js
Python
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.