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).
View Capacity Blocks
After you reserve a Capacity Block, you can view the Capacity Block reservation in your Amazon
account. You can view the start-date and end-date to see
when your reservation will begin and end. Before a Capacity Block reservation begins, the
available capacity appears as zero. You can see how many instances will be available
in your Capacity Block by the tag value for the tag key
aws:ec2capacityreservation:incrementalRequestedQuantity.
When a Capacity Block reservation begins, the reservation state changes from
scheduled to active. We emit an event through Amazon EventBridge
to notify you that the Capacity Block is available to use. For more information, see Monitor Capacity Blocks using EventBridge.
Capacity Blocks have the following states:
-
payment-pending – The upfront payment hasn't been
processed yet.
-
payment-failed—The payment couldn't be processed in
the 12 hour time frame. Your Capacity Block was released.
-
scheduled – The payment was processed and the Capacity Block
reservation hasn't started yet.
-
active – The reserved capacity is available for your
use.
-
expired – The Capacity Block reservation expired
automatically at the date and time specified in your reservation request.
The reserved capacity is no longer available for your use.
You can use one of the following methods to view your Capacity Block reservation.
- Console
-
To view Capacity Blocks using the console
Open the Amazon EC2 console at
https://console.amazonaws.cn/ec2/.
-
In the navigation pane, choose
Capacity Reservations.
-
On the Capacity Reservations overview page, you see a
resource table with details about all of your Capacity Reservation resources. To
find your Capacity Blocks reservations, select
Capacity Blocks from the dropdown list above
Capacity Reservation ID. In the table, you can see
information about your Capacity Blocks such as start and end dates,
duration, and status.
-
For more details about a Capacity Block, select the reservation ID
for the Capacity Block that you want to view. The Capacity Reservation
details page displays all the properties of the
reservation and the number of instances in use and available in
the Capacity Block.
Before a Capacity Block reservation begins, the available
capacity appears as zero. You can see how many instances
will be available when the Capacity Block reservation starts by
using the following tag value for the tag key:
aws:ec2capacityreservation:incrementalRequestedQuantity.
- Amazon CLI
-
To view Capacity Blocks using the Amazon CLI
By default, when you use the describe-capacity-reservations command both On-Demand Capacity Reservations
and Capacity Block reservations are listed. To view only your Capacity Block
reservations, filter using capacity-block for the
capacity-reservation-type parameter.
For example, the following command describes one or more of your
Capacity Block reservations in your current Amazon Web Services Region.
aws ec2 describe-capacity-reservations -reservation-type capacity-block
Example output.
{
"CapacityReservations": [
{
"CapacityReservationId": "cr-12345678",
"EndDateType": "limited",
"ReservationType": "capacity-block"
"AvailabilityZone": "eu-east-2a",
"InstanceMatchCriteria": "targeted",
"EphemeralStorage": false,
"CreateDate": "2023-11-29T14:22:45Z",
"StartDate": "2023-12-15T12:00:00Z",
"EndDate": "2023-08-19T12:00:00Z",
"AvailableInstanceCount": 0,
"InstancePlatform": "Linux/UNIX",
"TotalInstanceCount": 16,
"State": "payment-pending",
"Tenancy": "default",
"EbsOptimized": true,
"InstanceType": "p5.48xlarge"
},
...