Skip to content

EC2  >  Structures  >  OnDemandOptions

OnDemandOptions

Structure Class

OnDemandOptions dataclass

Bases: _SerdeShape

Describes the configuration of On-Demand Instances in an EC2 Fleet.

Attributes

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

The strategy that determines the order of the launch template overrides to use in fulfilling On-Demand capacity.

lowest-price - EC2 Fleet uses price to determine the order, launching the lowest price first.

prioritized - EC2 Fleet uses the priority that you assigned to each launch template override, launching the highest priority first.

Default: lowest-price

capacity_reservation_options class-attribute instance-attribute
capacity_reservation_options: CapacityReservationOptions | None = ...

The strategy for using unused Capacity Reservations for fulfilling On-Demand capacity.

Supported only for fleets of type instant.

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

The maximum amount per hour for On-Demand Instances that you're willing to pay.

Note

If your fleet includes T instances that are configured as unlimited, and if their average CPU usage exceeds the baseline utilization, you will incur a charge for surplus credits. The maxTotalPrice does not account for surplus credits, and, if you use surplus credits, your final cost might be higher than what you specified for maxTotalPrice. For more information, see Surplus credits can incur charges in the Amazon EC2 User Guide.

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

The minimum target capacity for On-Demand Instances in the fleet. If this minimum capacity isn't reached, no instances are launched.

Constraints: Maximum value of 1000. Supported only for fleets of type instant.

At least one of the following must be specified: SingleAvailabilityZone | SingleInstanceType

single_availability_zone class-attribute instance-attribute
single_availability_zone: bool | None = ...

Indicates that the fleet launches all On-Demand Instances into a single Availability Zone.

Supported only for fleets of type instant.

single_instance_type class-attribute instance-attribute
single_instance_type: bool | None = ...

Indicates that the fleet uses a single instance type to launch all On-Demand Instances in the fleet.

Supported only for fleets of type instant.