Skip to content

EC2  >  Structures  >  TargetCapacitySpecificationRequest

TargetCapacitySpecificationRequest

Structure Class

TargetCapacitySpecificationRequest dataclass

Bases: _SerdeShape

The number of units to request. You can choose to set the target capacity as the number of instances. Or you can set the target capacity to a performance characteristic that is important to your application workload, such as vCPUs, memory, or I/O. If the request type is maintain, you can specify a target capacity of 0 and add capacity later.

You can use the On-Demand Instance MaxTotalPrice parameter, the Spot Instance MaxTotalPrice parameter, or both parameters to ensure that your fleet cost does not exceed your budget. If you set a maximum price per hour for the On-Demand Instances and Spot Instances in your request, EC2 Fleet will launch instances until it reaches the maximum amount that you're willing to pay. When the maximum amount you're willing to pay is reached, the fleet stops launching instances even if it hasn't met the target capacity. The MaxTotalPrice parameters are located in OnDemandOptionsRequest and SpotOptionsRequest.

Attributes

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

The default target capacity type.

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

The number of On-Demand units to request.

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

The number of Spot units to request.

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

The unit for the target capacity. You can specify this parameter only when using attributed-based instance type selection.

Default: units (the number of instances)

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

The number of units to request, filled using the default target capacity type.