IBM Cloud Docs
Deleting an inactive or expired reservation

Deleting an inactive or expired reservation

After you purchase a reservation, you can't delete it before the end of the term. However, you can delete an inactive or expired reservation.

You can't delete an active reservation. You can delete only an inactive or expired reservation. This action can't be reversed.

Deleting an inactive or expired reservation with the UI

Use the following steps to delete an inactive or expired reservation.

  1. In the IBM Cloud console, click Navigation Menu icon menu icon > Infrastructure VPC icon > Reservations.
  2. In the reservation list, select the vertical action button to delete the reservation. You can also select the reservation first, then delete the reservation by using the Actions menu.

Virtual servers that are attached to a reservation are charged the on-demand rates when the reservation is deleted.

Reservations can be deleted for cases such as degraded capacity. All deletion requests are reviewed on a case-by-case basis. To delete an active reservation, contact support.

Deleting an inactive or expired reservation with the CLI

Use the following command to delete a reservation.

ibmcloud is reservation-delete (RESERVATION1 RESERVATION2 ...) [--output JSON] [-f, --force] [-q, --quiet]

For this example, you see a response similar to the following output.

ibmcloud is reservation-delete r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2
ibmcloud is reservation-delete r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2 r106-81222eee-b3e0-4dc3-b429-aee9e5c0abf3

Where the following argument and option values are used

  • RESERVATION1: ID or name of the reservation.
  • RESERVATION2: ID or name of the reservation.
  • --force, -f: Force the operation without confirmation
  • --output: Specify output format, only JSON is supported. One of: JSON.
  • -q, --quiet: Suppress verbose output.

Deleting an inactive or expired reservation with the API

You can delete an IBM Cloud VPC reservation in your region by using the application programming interface (API). To delete a reservation by using the API, use Delete a reservation.

Specify a DELETE /reservation request delete a reservation. See the following example.

curl -X DELETE "$vpc_api_endpoint/v1/reservations/$id?version=2024-01-27&generation=2" - H "Authorization: Bearer $iam_token"