Cancel a Capacity Reservation
You can cancel a Capacity Reservation that is in one of the following states:
-
assessing -
scheduled -
active -
delayed
Note
You can't modify or cancel a Capacity Block. For more information, see Capacity Blocks for ML.
If the Capacity Reservation is active with no commitment duration or an elapsed
commitment duration, cancellation is free.
If the Capacity Reservation is assessing or delayed, cancellation is
free.
If the Capacity Reservation is scheduled or active with remaining
commitment duration, a cancellation charge might apply. For more information, see
Cancellation charges.
If you cancel a Capacity Reservation that has running instances, the instances continue to run normally outside of the Capacity Reservation at standard On-Demand Instance rates or at a discounted rate if you have a matching Regional Reserved Instance.
After you cancel a Capacity Reservation, instances that target it can no longer launch. Modify these instances so that they either target a different Capacity Reservation, launch into any open Capacity Reservation with matching attributes and sufficient capacity, or avoid launching into a Capacity Reservation. For more information, see Modify the Capacity Reservation settings of your instance.
Cancellation charges
If you cancel a future-dated Capacity Reservation within 8 weeks of the start date, or during the commitment duration after delivery, you're charged for a percentage of your commitment duration. Capacity is released as soon as you cancel, but the reservation continues to be billed at the On-Demand rate through the end of the reduced commitment period. If you have a matching Regional Reserved Instance, the discounted rate applies automatically.
To calculate the charge, Amazon EC2 multiplies your commitment duration by a cancellation rate. The earlier you cancel relative to the start date, the lower the rate. The following table shows the cancellation rates.
| When you cancel | Minimum cancellation rate |
|---|---|
| 8 or more weeks before the original start date | No charge |
| 2 to 8 weeks before the original start date | 25% of total commitment |
| Within 2 weeks of the original start date | 50% of total commitment |
| After delivery, during the commitment duration | 50% of remaining commitment |
This table provides general guidance on cancellation charges. The cancellation quote determines the exact cancellation charge duration.
For example, if you have a 70-instance c8g.xlarge Capacity Reservation with a 14-day
commitment duration and you cancel within 2 weeks of the original start date (50%
cancellation rate), you're charged for 7 days of commitment. During those 7 days,
you pay for 70 instances at the On-Demand rate.
When you are charged for cancellation:
-
The Capacity Reservation enters the
cancellingstate. -
The Capacity Reservation can't be modified, moved, shared, or split.
-
The Capacity Reservation remains visible in the console and in
DescribeCapacityReservationsresponses. -
The Capacity Reservation transitions to
cancelledwhen the commitment ends.
To find when cancellation charges end, use the describe-capacity-reservations command and check the
CommitmentInfo.CommitmentEndDate field in the response. Charges stop
when the commitment ends and the Capacity Reservation transitions to cancelled. For
information about how cancellation charges appear in the AWS Cost and Usage
Report 2.0, see Cancellation charges in Cost and Usage Report 2.0.
If the Capacity Reservation has remaining commitment duration, you can't cancel it while instances are still running. You must first stop or terminate the running instances, which prevents you from incurring both cancellation charges and On-Demand Instance charges at the same time.
To cancel a Capacity Reservation with a cancellation charge, you must first generate a cancellation quote and accept the terms. For more information, see Cancellation quote.
Cancellation quote
When a cancellation requires a charge, you must review and accept a cancellation quote before proceeding. The quote provides the exact cancellation terms, including the following details:
-
The current configuration of the Capacity Reservation
-
The state that the Capacity Reservation transitions to after cancellation (
cancelling) -
The committed instance count that the charge applies to
-
The charge duration
-
The charge end date (when the commitment ends and the Capacity Reservation transitions to
cancelled)
After you review the terms, you confirm the cancellation by accepting the quote.
In the Amazon EC2 console, the quote is generated automatically when you
initiate a cancellation. You can review the terms and confirm your acceptance
directly. With the AWS CLI or API, use
CreateCapacityReservationCancellationQuote to generate the quote, then
pass the quote ID to CancelCapacityReservation.
The cancellation quote is valid for 24 hours. After 24 hours, you must generate
a new quote. To view your existing cancellation quotes, use
DescribeCapacityReservationCancellationQuotes.
Important
Cancellation is irreversible. After you accept a cancellation quote and cancel a Capacity Reservation, you can't undo the cancellation.
Cancel a Capacity Reservation
Use the following procedures to cancel a Capacity Reservation.