View a Capacity Reservation Fleet

You can view configuration and capacity information for a Capacity Reservation Fleet at any time. Viewing a Fleet also provides details about the individual Capacity Reservations that are inside the Fleet.

To view a Capacity Reservation Fleet

Use the describe-capacity-reservation-fleets AWS CLI command.

aws ec2 describe-capacity-reservation-fleets \
--capacity-reservation-fleet-ids cr_fleet_ids

The following is example output.

{
    "CapacityReservationFleets": [
        {
            "Status": "status", 
            "EndDate": "yyyy-mm-ddThh:mm:ss.000Z", 
            "InstanceMatchCriteria": "open", 
            "Tags": [], 
            "CapacityReservationFleetId": "cr_fleet_id", 
            "Tenancy": "dedicated|default", 
            "InstanceTypeSpecifications": [
                {
                    "CapacityReservationId": "cr1_id", 
                    "AvailabilityZone": "cr1_availability_zone", 
                    "FulfilledCapacity": cr1_used_capacity, 
                    "Weight": cr1_instance_type_weight, 
                    "CreateDate": "yyyy-mm-ddThh:mm:ss.000Z", 
                    "InstancePlatform": "cr1_platform", 
                    "TotalInstanceCount": cr1_number of instances, 
                    "Priority": cr1_instance_type_priority, 
                    "EbsOptimized": true|false, 
                    "InstanceType": "cr1_instance_type"
                },
				{
                    "CapacityReservationId": "cr2_id", 
                    "AvailabilityZone": "cr2_availability_zone", 
                    "FulfilledCapacity": cr2_used_capacity, 
                    "Weight": cr2_instance_type_weight, 
                    "CreateDate": "yyyy-mm-ddThh:mm:ss.000Z", 
                    "InstancePlatform": "cr2_platform", 
                    "TotalInstanceCount": cr2_number of instances, 
                    "Priority": cr2_instance_type_priority, 
                    "EbsOptimized": true|false, 
                    "InstanceType": "cr2_instance_type"
                },
            ], 
            "TotalTargetCapacity": total_target_capacity, 
            "TotalFulfilledCapacity": total_target_capacity, 
            "CreateTime": "yyyy-mm-ddThh:mm:ss.000Z", 
            "AllocationStrategy": "prioritized"
        }
    ]
}

Example

aws ec2 describe-capacity-reservation-fleets \
--capacity-reservation-fleet-ids crf-abcdef01234567890

The following is example output.

{
    "CapacityReservationFleets": [
        {
            "Status": "active", 
            "EndDate": "2021-12-31T23:59:59.000Z", 
            "InstanceMatchCriteria": "open", 
            "Tags": [], 
            "CapacityReservationFleetId": "crf-abcdef01234567890", 
            "Tenancy": "default", 
            "InstanceTypeSpecifications": [
                {
                    "CapacityReservationId": "cr-1234567890abcdef0", 
                    "AvailabilityZone": "us-east-1a", 
                    "FulfilledCapacity": 5.0, 
                    "Weight": 1.0, 
                    "CreateDate": "2021-07-02T08:34:33.398Z", 
                    "InstancePlatform": "Linux/UNIX", 
                    "TotalInstanceCount": 5, 
                    "Priority": 1, 
                    "EbsOptimized": true, 
                    "InstanceType": "m5.xlarge"
                }
            ], 
            "TotalTargetCapacity": 5, 
            "TotalFulfilledCapacity": 5.0, 
            "CreateTime": "2021-07-02T08:34:33.397Z", 
            "AllocationStrategy": "prioritized"
        }
    ]
}

Capacity Reservation Fleet states

A Capacity Reservation Fleet can be in one of the following states:

• submitted — The Capacity Reservation Fleet request has been submitted and Amazon EC2 is preparing to create the Capacity Reservations.

• modifying — The Capacity Reservation Fleet is being modified. The Fleet remains in this state until the modification is complete.

• active — The Capacity Reservation Fleet has fulfilled its total target capacity and it is attempting to maintain this capacity. The Fleet remains in this state until it is modified or deleted.

• partially_fulfilled — The Capacity Reservation Fleet has partially fulfilled its total target capacity. There is insufficient Amazon EC2 capacity to fulfill the total target capacity. The Fleet is attempting to asynchronously fulfill its total target capacity.

• expiring — The Capacity Reservation Fleet has reached its end date and it is in the process of expiring. One or more of its Capacity Reservations might still be active.

• expired — The Capacity Reservation Fleet has reached its end date. The Fleet and its Capacity Reservations are expired. The Fleet can't create new Capacity Reservations.

• cancelling — The Capacity Reservation Fleet is in the process of being cancelled. One or more of its Capacity Reservations might still be active.

• cancelled — The Capacity Reservation Fleet has been manually cancelled. The Fleet and its Capacity Reservations are cancelled and the Fleet can't create new Capacity Reservations.

• failed — The Capacity Reservation Fleet failed to reserve capacity for the specified instance types.