Skip to content

EC2  >  Structures  >  CapacityReservationSpecification

CapacityReservationSpecification

Structure Class

CapacityReservationSpecification dataclass

Bases: _SerdeShape

Describes an instance's Capacity Reservation targeting option.

Use the CapacityReservationPreference parameter to configure the instance to run as an On-Demand Instance, to run in any open Capacity Reservation that has matching attributes, or to run only in a Capacity Reservation or Capacity Reservation group. Use the CapacityReservationTarget parameter to explicitly target a specific Capacity Reservation or a Capacity Reservation group.

You can only specify CapacityReservationPreference and CapacityReservationTarget if the CapacityReservationPreference is capacity-reservations-only.

Attributes

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

Indicates the instance's Capacity Reservation preferences. Possible preferences include:

  • capacity-reservations-only - The instance will only run in a Capacity Reservation or Capacity Reservation group. If capacity isn't available, the instance will fail to launch.

  • open - The instance can run in any open Capacity Reservation that has matching attributes (instance type, platform, Availability Zone, and tenancy). If capacity isn't available, the instance runs as an On-Demand Instance.

  • none - The instance doesn't run in a Capacity Reservation even if one is available. The instance runs as an On-Demand Instance.

capacity_reservation_target class-attribute instance-attribute
capacity_reservation_target: CapacityReservationTarget | None = ...

Information about the target Capacity Reservation or Capacity Reservation group.