Skip to content

EC2  >  Structures  >  CapacityReservationFleet

CapacityReservationFleet

Structure Class

CapacityReservationFleet dataclass

Bases: _SerdeShape

Information about a Capacity Reservation Fleet.

Attributes

allocation_strategy class-attribute instance-attribute
allocation_strategy: str | None = ...

The strategy used by the Capacity Reservation Fleet to determine which of the specified instance types to use. For more information, see For more information, see Allocation strategy in the Amazon EC2 User Guide.

availability_zone class-attribute instance-attribute
availability_zone: str | None = ...

Reserved for internal use.

availability_zone_id class-attribute instance-attribute
availability_zone_id: str | None = ...

Reserved for internal use.

capacity_reservation_fleet_arn class-attribute instance-attribute
capacity_reservation_fleet_arn: str | None = ...

The ARN of the Capacity Reservation Fleet.

capacity_reservation_fleet_id class-attribute instance-attribute
capacity_reservation_fleet_id: str | None = ...

The ID of the Capacity Reservation Fleet.

create_time class-attribute instance-attribute
create_time: datetime | None = ...

The date and time at which the Capacity Reservation Fleet was created.

end_date class-attribute instance-attribute
end_date: datetime | None = ...

The date and time at which the Capacity Reservation Fleet expires.

instance_match_criteria class-attribute instance-attribute
instance_match_criteria: str | None = ...

Indicates the type of instance launches that the Capacity Reservation Fleet accepts. All Capacity Reservations in the Fleet inherit this instance matching criteria.

Currently, Capacity Reservation Fleets support open instance matching criteria only. This means that instances that have matching attributes (instance type, platform, and Availability Zone) run in the Capacity Reservations automatically. Instances do not need to explicitly target a Capacity Reservation Fleet to use its reserved capacity.

instance_requirements class-attribute instance-attribute
instance_requirements: InstanceRequirementsRequest | None = ...

Reserved for internal use.

instance_type_specifications class-attribute instance-attribute
instance_type_specifications: list[FleetCapacityReservation] | None = ...

Information about the instance types for which to reserve the capacity.

state class-attribute instance-attribute
state: str | None = ...

The state of the Capacity Reservation Fleet. Possible states include:

  • submitted - The Capacity Reservation Fleet request has been submitted and Amazon Elastic Compute Cloud 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 to fulfill the total target capacity. The Fleet is attempting to asynchronously fulfill its total target capacity.

  • expiring - The Capacity Reservation Fleet has reach 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 reach 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.

tags class-attribute instance-attribute
tags: list[Tag] | None = ...

The tags assigned to the Capacity Reservation Fleet.

tenancy class-attribute instance-attribute
tenancy: str | None = ...

The tenancy of the Capacity Reservation Fleet. Tenancies include:

  • default - The Capacity Reservation Fleet is created on hardware that is shared with other Amazon Web Services accounts.

  • dedicated - The Capacity Reservation Fleet is created on single-tenant hardware that is dedicated to a single Amazon Web Services account.

total_fulfilled_capacity class-attribute instance-attribute
total_fulfilled_capacity: float | None = ...

The capacity units that have been fulfilled.

total_target_capacity class-attribute instance-attribute
total_target_capacity: int | None = ...

The total number of capacity units for which the Capacity Reservation Fleet reserves capacity. For more information, see Total target capacity in the Amazon EC2 User Guide.