Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Extend Capacity Blocks

With Capacity Blocks, you reserve compute capacity for your workloads, ensuring availability and consistency. To accommodate your changing needs, you can extend the duration of your existing Capacity Blocks as required.

To extend a Capacity Block, it must have a status of active or scheduled, and have no extensions that are payment-pending. Request an extension up to 1 hour before your Capacity Block’s scheduled end time. You can extend your Capacity Block by 1-day increments up to 14 days, and 7-day increments up to 182 days (26 weeks) total. When you extend your Capacity Block, its end date will be updated so that your instances can continue to run without disruption.

Billing

The price of a Capacity Block offering is charged up front. The extension will remain in payment-pending until the bill is paid. If your payment can't be processed within 12 hours, or up to 35 minutes before the Capacity Block is scheduled to end (whichever comes first), your extension is not successful and the status changes to payment-failed. Your Capacity Block reservation will remain active and will be terminated on the original end date.

After your payment is processed successfully, the Capacity Block extension status changes to payment-succeeded and the end date of the Capacity Block reservation will be updated to the new end date. The details of your extension can be viewed in the Capacity Block Extension details section of the console, or by using the describe-capacity-block-extension-history command.

Extend your Capacity Block

Use one of the following methods to extend your Capacity Block reservation.

Console

To extend Capacity Blocks using the console

1. Open the Amazon EC2 console at https://console.amazonaws.cn/ec2/.

2. In the navigation pane, choose Capacity Reservations.

3. On the Capacity Reservations overview page, you see a resource table with details about all of your Capacity Reservations resources. Select the reservation ID for the Capacity Block that you want to extend.

4. From the Actions drop down menu, choose Extend Capacity Block.

5. Under Duration, enter the number of days or weeks you need to extend the reservation for.

6. Choose Find Capacity Block.

7. If a Capacity Block is available that meets your specifications, an offering appears under Recommended Capacity Blocks. To view other Capacity Block offerings, adjust your search inputs and choose Find Capacity Blocks again.

8. When you find a Capacity Block offering that you want to purchase, choose Extend.

9. In the pop-up window Extend Capacity Block, enter confirm, then choose Extend.

Amazon CLI

To find a Capacity Block extension using the Amazon CLI

Use the describe-capacity-block-extension-offerings command.

The following example searches for a 48 hour Capacity Block extension for Reservation cr-1234567890abcdefg.

aws ec2 describe-capacity-block-extension-offerings \
--capacity-reservation-id cr-0123456789abcdefg \
--capacity-block-extension-duration-hours 48

To extend a Capacity Block using the Amazon CLI

Use the purchase-capacity-block-extension command. In the command, specify the reservation ID and the extension offering ID from the output of the previous command.

aws ec2 purchase-capacity-block-extension \
--capacity-block-extension-offering-id cbe-0123456789abcdefg \
--capacity-reservation-id cr-1234567890abcdefg

To view Capacity Block extensions using the Amazon CLI

Use the describe-capacity-block-extension-history command.

The following example describes all of your extensions.

aws ec2 describe-capacity-block-extension-history

The following example describes all extensions for a single reservation.

aws ec2 describe-capacity-block-extension-history \
--capacity-reservation-ids cr-1234567890abcdefg