FleetData¶
Structure Class¶
FleetData
dataclass
¶
Bases: _SerdeShape
Describes an EC2 Fleet.
Attributes¶
activity_status
class-attribute
instance-attribute
¶
activity_status: str | None = ...
The progress of the EC2 Fleet.
For fleets of type instant, the status is fulfilled after all
requests are placed, regardless of whether target capacity is met (this
is the only possible status for instant fleets).
For fleets of type request or maintain, the status is
pending_fulfillment after all requests are placed, fulfilled when
the fleet size meets or exceeds target capacity, pending_termination
while instances are terminating when fleet size is decreased, and
error if there's an error.
client_token
class-attribute
instance-attribute
¶
client_token: str | None = ...
Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see Ensuring idempotency.
Constraints: Maximum 64 ASCII characters
create_time
class-attribute
instance-attribute
¶
create_time: datetime | None = ...
The creation date and time of the EC2 Fleet.
errors
class-attribute
instance-attribute
¶
errors: list[DescribeFleetError] | None = ...
Information about the instances that could not be launched by the fleet.
Valid only when Type is set to instant.
excess_capacity_termination_policy
class-attribute
instance-attribute
¶
excess_capacity_termination_policy: str | None = ...
Indicates whether running instances should be terminated if the target capacity of the EC2 Fleet is decreased below the current size of the EC2 Fleet.
Supported only for fleets of type maintain.
fleet_state
class-attribute
instance-attribute
¶
fleet_state: str | None = ...
The state of the EC2 Fleet.
fulfilled_capacity
class-attribute
instance-attribute
¶
fulfilled_capacity: float | None = ...
The number of units fulfilled by this request compared to the set target capacity.
fulfilled_on_demand_capacity
class-attribute
instance-attribute
¶
fulfilled_on_demand_capacity: float | None = ...
The number of units fulfilled by this request compared to the set target On-Demand capacity.
instances
class-attribute
instance-attribute
¶
instances: list[DescribeFleetsInstances] | None = ...
Information about the instances that were launched by the fleet. Valid
only when Type is set to instant.
launch_template_configs
class-attribute
instance-attribute
¶
launch_template_configs: list[FleetLaunchTemplateConfig] | None = ...
The launch template and overrides.
on_demand_options
class-attribute
instance-attribute
¶
on_demand_options: OnDemandOptions | None = ...
The allocation strategy of On-Demand Instances in an EC2 Fleet.
replace_unhealthy_instances
class-attribute
instance-attribute
¶
replace_unhealthy_instances: bool | None = ...
Indicates whether EC2 Fleet should replace unhealthy Spot Instances.
Supported only for fleets of type maintain. For more information, see
EC2 Fleet health
checks
in the Amazon EC2 User Guide.
reserved_capacity_options
class-attribute
instance-attribute
¶
reserved_capacity_options: ReservedCapacityOptions | None = ...
Defines EC2 Fleet preferences for utilizing reserved capacity when
DefaultTargetCapacityType is set to reserved-capacity.
spot_options
class-attribute
instance-attribute
¶
spot_options: SpotOptions | None = ...
The configuration of Spot Instances in an EC2 Fleet.
tags
class-attribute
instance-attribute
¶
The tags for an EC2 Fleet resource.
target_capacity_specification
class-attribute
instance-attribute
¶
target_capacity_specification: TargetCapacitySpecification | None = ...
The number of units to request. You can choose to set the target
capacity in terms of instances or 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.
terminate_instances_with_expiration
class-attribute
instance-attribute
¶
terminate_instances_with_expiration: bool | None = ...
Indicates whether running instances should be terminated when the EC2 Fleet expires.
type
class-attribute
instance-attribute
¶
type: str | None = ...
The type of request. Indicates whether the EC2 Fleet only requests the
target capacity, or also attempts to maintain it. If you request a
certain target capacity, EC2 Fleet only places the required requests; it
does not attempt to replenish instances if capacity is diminished, and
it does not submit requests in alternative capacity pools if capacity is
unavailable. To maintain a certain target capacity, EC2 Fleet places the
required requests to meet this target capacity. It also automatically
replenishes any interrupted Spot Instances. Default: maintain.
valid_from
class-attribute
instance-attribute
¶
valid_from: datetime | None = ...
The start date and time of the request, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). The default is to start fulfilling the request immediately.
valid_until
class-attribute
instance-attribute
¶
valid_until: datetime | None = ...
The end date and time of the request, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). At this point, no new instance requests are placed or able to fulfill the request. The default end date is 7 days from the current date.