Skip to content

EC2  >  Structures  >  SpotFleetLaunchSpecification

SpotFleetLaunchSpecification

Structure Class

SpotFleetLaunchSpecification dataclass

Bases: _SerdeShape

Describes the launch specification for one or more Spot Instances. If you include On-Demand capacity in your fleet request or want to specify an EFA network device, you can't use SpotFleetLaunchSpecification; you must use LaunchTemplateConfig.

Attributes

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

Deprecated.

block_device_mappings class-attribute instance-attribute
block_device_mappings: list[BlockDeviceMapping] | None = ...

One or more block devices that are mapped to the Spot Instances. You can't specify both a snapshot ID and an encryption value. This is because only blank volumes can be encrypted on creation. If a snapshot is the basis for a volume, it is not blank and its encryption status is used for the volume encryption status.

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

Indicates whether the instances are optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

Default: false

iam_instance_profile class-attribute instance-attribute
iam_instance_profile: IamInstanceProfileSpecification | None = ...

The IAM instance profile.

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

The ID of the AMI.

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

The attributes for the instance types. When you specify instance attributes, Amazon EC2 will identify instance types with those attributes.

Note

If you specify InstanceRequirements, you can't specify InstanceType.

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

The instance type.

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

The ID of the kernel.

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

The name of the key pair.

monitoring class-attribute instance-attribute
monitoring: SpotFleetMonitoring | None = ...

Enable or disable monitoring for the instances.

network_interfaces class-attribute instance-attribute
network_interfaces: list[InstanceNetworkInterfaceSpecification] | None = ...

The network interfaces.

Note

SpotFleetLaunchSpecification does not support Elastic Fabric Adapter (EFA). You must use LaunchTemplateConfig instead.

placement class-attribute instance-attribute
placement: SpotPlacement | None = ...

The placement information.

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

The ID of the RAM disk. Some kernels require additional drivers at launch. Check the kernel requirements for information about whether you need to specify a RAM disk. To find kernel requirements, refer to the Amazon Web Services Resource Center and search for the kernel ID.

security_groups class-attribute instance-attribute
security_groups: list[GroupIdentifier] | None = ...

The security groups.

If you specify a network interface, you must specify any security groups as part of the network interface instead of using this parameter.

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

The maximum price per unit hour that you are willing to pay for a Spot Instance. We do not recommend using this parameter because it can lead to increased interruptions. If you do not specify this parameter, you will pay the current Spot price.

Warning

If you specify a maximum price, your instances will be interrupted more frequently than if you do not specify this parameter.

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

The IDs of the subnets in which to launch the instances. To specify multiple subnets, separate them using commas; for example, "subnet-1234abcdeexample1, subnet-0987cdef6example2".

If you specify a network interface, you must specify any subnets as part of the network interface instead of using this parameter.

tag_specifications class-attribute instance-attribute
tag_specifications: list[SpotFleetTagSpecification] | None = ...

The tags to apply during creation.

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

The base64-encoded user data that instances use when starting up. User data is limited to 16 KB.

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

The number of units provided by the specified instance type. These are the same units that you chose to set the target capacity in terms of instances, or a performance characteristic such as vCPUs, memory, or I/O.

If the target capacity divided by this value is not a whole number, Amazon EC2 rounds the number of instances to the next whole number. If this value is not specified, the default is 1.

Note

When specifying weights, the price used in the lowestPrice and priceCapacityOptimized allocation strategies is per unit hour (where the instance price is divided by the specified weight). However, if all the specified weights are above the requested TargetCapacity, resulting in only 1 instance being launched, the price used is per instance hour.