Package software.amazon.awscdk.services.ec2

Class CfnSpotFleet

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

software.amazon.awscdk.CfnElement

software.amazon.awscdk.CfnRefElement

software.amazon.awscdk.CfnResource

software.amazon.awscdk.services.ec2.CfnSpotFleet

All Implemented Interfaces:

IInspectable, ISpotFleetRef, IEnvironmentAware, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct, software.constructs.IDependable

@Generated(value="jsii-pacmak/1.120.0 (build 192dc88)",
           date="2025-12-05T22:26:35.022Z")
@Stability(Stable)
public class CfnSpotFleet
extends CfnResource
implements IInspectable, ISpotFleetRef

Specifies a Spot Fleet request.

The Spot Fleet request specifies the total target capacity and the On-Demand target capacity. Amazon EC2 calculates the difference between the total capacity and On-Demand capacity, and launches the difference as Spot capacity.

You can submit a single request that includes multiple launch specifications that vary by instance type, AMI, Availability Zone, or subnet.

By default, the Spot Fleet requests Spot Instances in the Spot Instance pool where the price per unit is the lowest. Each launch specification can include its own instance weighting that reflects the value of the instance type to your application workload.

Alternatively, you can specify that the Spot Fleet distribute the target capacity across the Spot pools included in its launch specifications. By ensuring that the Spot Instances in your Spot Fleet are in different Spot pools, you can improve the availability of your fleet.

You can specify tags for the Spot Fleet request and instances launched by the fleet. You cannot tag other resource types in a Spot Fleet request because only the spot-fleet-request and instance resource types are supported.

For more information, see Spot Fleet in the Amazon EC2 User Guide .

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.ec2.*;
 CfnSpotFleet cfnSpotFleet = CfnSpotFleet.Builder.create(this, "MyCfnSpotFleet")
         .spotFleetRequestConfigData(SpotFleetRequestConfigDataProperty.builder()
                 .iamFleetRole("iamFleetRole")
                 .targetCapacity(123)
                 // the properties below are optional
                 .allocationStrategy("allocationStrategy")
                 .context("context")
                 .excessCapacityTerminationPolicy("excessCapacityTerminationPolicy")
                 .instanceInterruptionBehavior("instanceInterruptionBehavior")
                 .instancePoolsToUseCount(123)
                 .launchSpecifications(List.of(SpotFleetLaunchSpecificationProperty.builder()
                         .imageId("imageId")
                         // the properties below are optional
                         .blockDeviceMappings(List.of(BlockDeviceMappingProperty.builder()
                                 .deviceName("deviceName")
                                 // the properties below are optional
                                 .ebs(EbsBlockDeviceProperty.builder()
                                         .deleteOnTermination(false)
                                         .encrypted(false)
                                         .iops(123)
                                         .snapshotId("snapshotId")
                                         .volumeSize(123)
                                         .volumeType("volumeType")
                                         .build())
                                 .noDevice("noDevice")
                                 .virtualName("virtualName")
                                 .build()))
                         .ebsOptimized(false)
                         .iamInstanceProfile(IamInstanceProfileSpecificationProperty.builder()
                                 .arn("arn")
                                 .build())
                         .instanceRequirements(InstanceRequirementsRequestProperty.builder()
                                 .acceleratorCount(AcceleratorCountRequestProperty.builder()
                                         .max(123)
                                         .min(123)
                                         .build())
                                 .acceleratorManufacturers(List.of("acceleratorManufacturers"))
                                 .acceleratorNames(List.of("acceleratorNames"))
                                 .acceleratorTotalMemoryMiB(AcceleratorTotalMemoryMiBRequestProperty.builder()
                                         .max(123)
                                         .min(123)
                                         .build())
                                 .acceleratorTypes(List.of("acceleratorTypes"))
                                 .allowedInstanceTypes(List.of("allowedInstanceTypes"))
                                 .bareMetal("bareMetal")
                                 .baselineEbsBandwidthMbps(BaselineEbsBandwidthMbpsRequestProperty.builder()
                                         .max(123)
                                         .min(123)
                                         .build())
                                 .baselinePerformanceFactors(BaselinePerformanceFactorsRequestProperty.builder()
                                         .cpu(CpuPerformanceFactorRequestProperty.builder()
                                                 .references(List.of(PerformanceFactorReferenceRequestProperty.builder()
                                                         .instanceFamily("instanceFamily")
                                                         .build()))
                                                 .build())
                                         .build())
                                 .burstablePerformance("burstablePerformance")
                                 .cpuManufacturers(List.of("cpuManufacturers"))
                                 .excludedInstanceTypes(List.of("excludedInstanceTypes"))
                                 .instanceGenerations(List.of("instanceGenerations"))
                                 .localStorage("localStorage")
                                 .localStorageTypes(List.of("localStorageTypes"))
                                 .maxSpotPriceAsPercentageOfOptimalOnDemandPrice(123)
                                 .memoryGiBPerVCpu(MemoryGiBPerVCpuRequestProperty.builder()
                                         .max(123)
                                         .min(123)
                                         .build())
                                 .memoryMiB(MemoryMiBRequestProperty.builder()
                                         .max(123)
                                         .min(123)
                                         .build())
                                 .networkBandwidthGbps(NetworkBandwidthGbpsRequestProperty.builder()
                                         .max(123)
                                         .min(123)
                                         .build())
                                 .networkInterfaceCount(NetworkInterfaceCountRequestProperty.builder()
                                         .max(123)
                                         .min(123)
                                         .build())
                                 .onDemandMaxPricePercentageOverLowestPrice(123)
                                 .requireHibernateSupport(false)
                                 .spotMaxPricePercentageOverLowestPrice(123)
                                 .totalLocalStorageGb(TotalLocalStorageGBRequestProperty.builder()
                                         .max(123)
                                         .min(123)
                                         .build())
                                 .vCpuCount(VCpuCountRangeRequestProperty.builder()
                                         .max(123)
                                         .min(123)
                                         .build())
                                 .build())
                         .instanceType("instanceType")
                         .kernelId("kernelId")
                         .keyName("keyName")
                         .monitoring(SpotFleetMonitoringProperty.builder()
                                 .enabled(false)
                                 .build())
                         .networkInterfaces(List.of(InstanceNetworkInterfaceSpecificationProperty.builder()
                                 .associatePublicIpAddress(false)
                                 .deleteOnTermination(false)
                                 .description("description")
                                 .deviceIndex(123)
                                 .groups(List.of("groups"))
                                 .ipv6AddressCount(123)
                                 .ipv6Addresses(List.of(InstanceIpv6AddressProperty.builder()
                                         .ipv6Address("ipv6Address")
                                         .build()))
                                 .networkInterfaceId("networkInterfaceId")
                                 .privateIpAddresses(List.of(PrivateIpAddressSpecificationProperty.builder()
                                         .privateIpAddress("privateIpAddress")
                                         // the properties below are optional
                                         .primary(false)
                                         .build()))
                                 .secondaryPrivateIpAddressCount(123)
                                 .subnetId("subnetId")
                                 .build()))
                         .placement(SpotPlacementProperty.builder()
                                 .availabilityZone("availabilityZone")
                                 .groupName("groupName")
                                 .tenancy("tenancy")
                                 .build())
                         .ramdiskId("ramdiskId")
                         .securityGroups(List.of(GroupIdentifierProperty.builder()
                                 .groupId("groupId")
                                 .build()))
                         .spotPrice("spotPrice")
                         .subnetId("subnetId")
                         .tagSpecifications(List.of(SpotFleetTagSpecificationProperty.builder()
                                 .resourceType("resourceType")
                                 .tags(List.of(CfnTag.builder()
                                         .key("key")
                                         .value("value")
                                         .build()))
                                 .build()))
                         .userData("userData")
                         .weightedCapacity(123)
                         .build()))
                 .launchTemplateConfigs(List.of(LaunchTemplateConfigProperty.builder()
                         .launchTemplateSpecification(FleetLaunchTemplateSpecificationProperty.builder()
                                 .version("version")
                                 // the properties below are optional
                                 .launchTemplateId("launchTemplateId")
                                 .launchTemplateName("launchTemplateName")
                                 .build())
                         .overrides(List.of(LaunchTemplateOverridesProperty.builder()
                                 .availabilityZone("availabilityZone")
                                 .instanceRequirements(InstanceRequirementsRequestProperty.builder()
                                         .acceleratorCount(AcceleratorCountRequestProperty.builder()
                                                 .max(123)
                                                 .min(123)
                                                 .build())
                                         .acceleratorManufacturers(List.of("acceleratorManufacturers"))
                                         .acceleratorNames(List.of("acceleratorNames"))
                                         .acceleratorTotalMemoryMiB(AcceleratorTotalMemoryMiBRequestProperty.builder()
                                                 .max(123)
                                                 .min(123)
                                                 .build())
                                         .acceleratorTypes(List.of("acceleratorTypes"))
                                         .allowedInstanceTypes(List.of("allowedInstanceTypes"))
                                         .bareMetal("bareMetal")
                                         .baselineEbsBandwidthMbps(BaselineEbsBandwidthMbpsRequestProperty.builder()
                                                 .max(123)
                                                 .min(123)
                                                 .build())
                                         .baselinePerformanceFactors(BaselinePerformanceFactorsRequestProperty.builder()
                                                 .cpu(CpuPerformanceFactorRequestProperty.builder()
                                                         .references(List.of(PerformanceFactorReferenceRequestProperty.builder()
                                                                 .instanceFamily("instanceFamily")
                                                                 .build()))
                                                         .build())
                                                 .build())
                                         .burstablePerformance("burstablePerformance")
                                         .cpuManufacturers(List.of("cpuManufacturers"))
                                         .excludedInstanceTypes(List.of("excludedInstanceTypes"))
                                         .instanceGenerations(List.of("instanceGenerations"))
                                         .localStorage("localStorage")
                                         .localStorageTypes(List.of("localStorageTypes"))
                                         .maxSpotPriceAsPercentageOfOptimalOnDemandPrice(123)
                                         .memoryGiBPerVCpu(MemoryGiBPerVCpuRequestProperty.builder()
                                                 .max(123)
                                                 .min(123)
                                                 .build())
                                         .memoryMiB(MemoryMiBRequestProperty.builder()
                                                 .max(123)
                                                 .min(123)
                                                 .build())
                                         .networkBandwidthGbps(NetworkBandwidthGbpsRequestProperty.builder()
                                                 .max(123)
                                                 .min(123)
                                                 .build())
                                         .networkInterfaceCount(NetworkInterfaceCountRequestProperty.builder()
                                                 .max(123)
                                                 .min(123)
                                                 .build())
                                         .onDemandMaxPricePercentageOverLowestPrice(123)
                                         .requireHibernateSupport(false)
                                         .spotMaxPricePercentageOverLowestPrice(123)
                                         .totalLocalStorageGb(TotalLocalStorageGBRequestProperty.builder()
                                                 .max(123)
                                                 .min(123)
                                                 .build())
                                         .vCpuCount(VCpuCountRangeRequestProperty.builder()
                                                 .max(123)
                                                 .min(123)
                                                 .build())
                                         .build())
                                 .instanceType("instanceType")
                                 .priority(123)
                                 .spotPrice("spotPrice")
                                 .subnetId("subnetId")
                                 .weightedCapacity(123)
                                 .build()))
                         .build()))
                 .loadBalancersConfig(LoadBalancersConfigProperty.builder()
                         .classicLoadBalancersConfig(ClassicLoadBalancersConfigProperty.builder()
                                 .classicLoadBalancers(List.of(ClassicLoadBalancerProperty.builder()
                                         .name("name")
                                         .build()))
                                 .build())
                         .targetGroupsConfig(TargetGroupsConfigProperty.builder()
                                 .targetGroups(List.of(TargetGroupProperty.builder()
                                         .arn("arn")
                                         .build()))
                                 .build())
                         .build())
                 .onDemandAllocationStrategy("onDemandAllocationStrategy")
                 .onDemandMaxTotalPrice("onDemandMaxTotalPrice")
                 .onDemandTargetCapacity(123)
                 .replaceUnhealthyInstances(false)
                 .spotMaintenanceStrategies(SpotMaintenanceStrategiesProperty.builder()
                         .capacityRebalance(SpotCapacityRebalanceProperty.builder()
                                 .replacementStrategy("replacementStrategy")
                                 .terminationDelay(123)
                                 .build())
                         .build())
                 .spotMaxTotalPrice("spotMaxTotalPrice")
                 .spotPrice("spotPrice")
                 .tagSpecifications(List.of(SpotFleetTagSpecificationProperty.builder()
                         .resourceType("resourceType")
                         .tags(List.of(CfnTag.builder()
                                 .key("key")
                                 .value("value")
                                 .build()))
                         .build()))
                 .targetCapacityUnitType("targetCapacityUnitType")
                 .terminateInstancesWithExpiration(false)
                 .type("type")
                 .validFrom("validFrom")
                 .validUntil("validUntil")
                 .build())
         .build();
 

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-spotfleet.html

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	CfnSpotFleet.AcceleratorCountRequestProperty	The minimum and maximum number of accelerators (GPUs, FPGAs, or AWS Inferentia chips) on an instance.
static interface	CfnSpotFleet.AcceleratorTotalMemoryMiBRequestProperty	The minimum and maximum amount of total accelerator memory, in MiB.
static interface	CfnSpotFleet.BaselineEbsBandwidthMbpsRequestProperty	The minimum and maximum baseline bandwidth to Amazon EBS, in Mbps.
static interface	CfnSpotFleet.BaselinePerformanceFactorsRequestProperty	The baseline performance to consider, using an instance family as a baseline reference.
static interface	CfnSpotFleet.BlockDeviceMappingProperty	Specifies a block device mapping.
static final class	CfnSpotFleet.Builder	A fluent builder for CfnSpotFleet.
static interface	CfnSpotFleet.ClassicLoadBalancerProperty	Specifies a Classic Load Balancer.
static interface	CfnSpotFleet.ClassicLoadBalancersConfigProperty	Specifies the Classic Load Balancers to attach to a Spot Fleet.
static interface	CfnSpotFleet.CpuPerformanceFactorRequestProperty	The CPU performance to consider, using an instance family as the baseline reference.
static interface	CfnSpotFleet.EbsBlockDeviceProperty	Describes a block device for an EBS volume.
static interface	CfnSpotFleet.FleetLaunchTemplateSpecificationProperty	Specifies the launch template to be used by the Spot Fleet request for configuring Amazon EC2 instances.
static interface	CfnSpotFleet.GroupIdentifierProperty	Describes a security group.
static interface	CfnSpotFleet.IamInstanceProfileSpecificationProperty	Describes an IAM instance profile.
static interface	CfnSpotFleet.InstanceIpv6AddressProperty	Describes an IPv6 address.
static interface	CfnSpotFleet.InstanceNetworkInterfaceSpecificationProperty	Describes a network interface.
static interface	CfnSpotFleet.InstanceRequirementsRequestProperty	The attributes for the instance types.
static interface	CfnSpotFleet.LaunchTemplateConfigProperty	Specifies a launch template and overrides.
static interface	CfnSpotFleet.LaunchTemplateOverridesProperty	Specifies overrides for a launch template.
static interface	CfnSpotFleet.LoadBalancersConfigProperty	Specifies the Classic Load Balancers and target groups to attach to a Spot Fleet request.
static interface	CfnSpotFleet.MemoryGiBPerVCpuRequestProperty	The minimum and maximum amount of memory per vCPU, in GiB.
static interface	CfnSpotFleet.MemoryMiBRequestProperty	The minimum and maximum amount of memory, in MiB.
static interface	CfnSpotFleet.NetworkBandwidthGbpsRequestProperty	The minimum and maximum amount of baseline network bandwidth, in gigabits per second (Gbps).
static interface	CfnSpotFleet.NetworkInterfaceCountRequestProperty	The minimum and maximum number of network interfaces.
static interface	CfnSpotFleet.PerformanceFactorReferenceRequestProperty	Specify an instance family to use as the baseline reference for CPU performance.
static interface	CfnSpotFleet.PrivateIpAddressSpecificationProperty	Describes a secondary private IPv4 address for a network interface.
static interface	CfnSpotFleet.SpotCapacityRebalanceProperty	The Spot Instance replacement strategy to use when Amazon EC2 emits a signal that your Spot Instance is at an elevated risk of being interrupted.
static interface	CfnSpotFleet.SpotFleetLaunchSpecificationProperty	Specifies the launch specification for one or more Spot Instances.
static interface	CfnSpotFleet.SpotFleetMonitoringProperty	Describes whether monitoring is enabled.
static interface	CfnSpotFleet.SpotFleetRequestConfigDataProperty	Specifies the configuration of a Spot Fleet request.
static interface	CfnSpotFleet.SpotFleetTagSpecificationProperty	The tags for a Spot Fleet resource.
static interface	CfnSpotFleet.SpotMaintenanceStrategiesProperty	The strategies for managing your Spot Instances that are at an elevated risk of being interrupted.
static interface	CfnSpotFleet.SpotPlacementProperty	Describes Spot Instance placement.
static interface	CfnSpotFleet.TargetGroupProperty	Describes a load balancer target group.
static interface	CfnSpotFleet.TargetGroupsConfigProperty	Describes the target groups to attach to a Spot Fleet.
static interface	CfnSpotFleet.TotalLocalStorageGBRequestProperty	The minimum and maximum amount of total local storage, in GB.
static interface	CfnSpotFleet.VCpuCountRangeRequestProperty	The minimum and maximum number of vCPUs.

Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject

software.amazon.jsii.JsiiObject.InitializationMode

Nested classes/interfaces inherited from interface software.constructs.IConstruct

software.constructs.IConstruct.Jsii$Default

Nested classes/interfaces inherited from interface software.amazon.awscdk.IInspectable

IInspectable.Jsii$Default, IInspectable.Jsii$Proxy

Nested classes/interfaces inherited from interface software.amazon.awscdk.interfaces.ec2.ISpotFleetRef

ISpotFleetRef.Jsii$Default, ISpotFleetRef.Jsii$Proxy

Field Summary

Fields

Modifier and Type	Field	Description
static final String	CFN_RESOURCE_TYPE_NAME	The CloudFormation resource type name for this resource class.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	CfnSpotFleet(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	CfnSpotFleet(software.amazon.jsii.JsiiObjectRef objRef)
	CfnSpotFleet(software.constructs.Construct scope, String id, CfnSpotFleetProps props)	Create a new AWS::EC2::SpotFleet.

Method Summary

Modifier and Type	Method	Description
String	getAttrId()	The ID of the Spot Fleet.
protected Map<String,Object>	getCfnProperties()
SpotFleetReference	getSpotFleetRef()	A reference to a SpotFleet resource.
Object	getSpotFleetRequestConfigData()	Describes the configuration of a Spot Fleet request.
void	inspect(TreeInspector inspector)	Examines the CloudFormation resource and discloses attributes.
static Boolean	isCfnSpotFleet(Object x)	Checks whether the given object is a CfnSpotFleet.
protected Map<String,Object>	renderProperties(Map<String,Object> props)
void	setSpotFleetRequestConfigData(IResolvable value)	Describes the configuration of a Spot Fleet request.
void	setSpotFleetRequestConfigData(CfnSpotFleet.SpotFleetRequestConfigDataProperty value)	Describes the configuration of a Spot Fleet request.

Methods inherited from class software.amazon.awscdk.CfnResource

addDeletionOverride, addDependency, addDependsOn, addMetadata, addOverride, addPropertyDeletionOverride, addPropertyOverride, applyRemovalPolicy, applyRemovalPolicy, applyRemovalPolicy, getAtt, getAtt, getCfnOptions, getCfnResourceType, getEnv, getMetadata, getUpdatedProperites, getUpdatedProperties, isCfnResource, obtainDependencies, obtainResourceDependencies, removeDependency, replaceDependency, shouldSynthesize, toString, validateProperties

Methods inherited from class software.amazon.awscdk.CfnRefElement

getRef

Methods inherited from class software.amazon.awscdk.CfnElement

getCreationStack, getLogicalId, getStack, isCfnElement, overrideLogicalId

Methods inherited from class software.constructs.Construct

getNode, isConstruct

Methods inherited from class software.amazon.jsii.JsiiObject

jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSet

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface software.constructs.IConstruct

getNode

Methods inherited from interface software.amazon.awscdk.interfaces.IEnvironmentAware

getEnv

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Field Details

CFN_RESOURCE_TYPE_NAME

@Stability(Stable)
public static final String CFN_RESOURCE_TYPE_NAME

The CloudFormation resource type name for this resource class.

Constructor Details

CfnSpotFleet

protected CfnSpotFleet(software.amazon.jsii.JsiiObjectRef objRef)

CfnSpotFleet

protected CfnSpotFleet(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

CfnSpotFleet

@Stability(Stable)
public CfnSpotFleet(@NotNull
 software.constructs.Construct scope,
 @NotNull
 String id,
 @NotNull
 CfnSpotFleetProps props)

Create a new AWS::EC2::SpotFleet.

Parameters:

scope - Scope in which this resource is defined. This parameter is required.

id - Construct identifier for this resource (unique in its scope). This parameter is required.

props - Resource properties. This parameter is required.

Method Details

isCfnSpotFleet

@Stability(Stable)
@NotNull
public static Boolean isCfnSpotFleet(@NotNull
 Object x)

Checks whether the given object is a CfnSpotFleet.

Parameters:

x - This parameter is required.

inspect

@Stability(Stable)
public void inspect(@NotNull
 TreeInspector inspector)

Examines the CloudFormation resource and discloses attributes.

Specified by:

inspect in interface IInspectable

Parameters:

inspector - tree inspector to collect and process attributes. This parameter is required.

renderProperties

@Stability(Stable)
@NotNull
protected Map<String,Object> renderProperties(@NotNull
 Map<String,Object> props)

Overrides:

renderProperties in class CfnResource

Parameters:

props - This parameter is required.

getAttrId

@Stability(Stable)
@NotNull
public String getAttrId()

The ID of the Spot Fleet.

getCfnProperties

@Stability(Stable)
@NotNull
protected Map<String,Object> getCfnProperties()

Overrides:

getCfnProperties in class CfnResource

getSpotFleetRef

@Stability(Stable)
@NotNull
public SpotFleetReference getSpotFleetRef()

A reference to a SpotFleet resource.

Specified by:

getSpotFleetRef in interface ISpotFleetRef

getSpotFleetRequestConfigData

@Stability(Stable)
@NotNull
public Object getSpotFleetRequestConfigData()

Describes the configuration of a Spot Fleet request.

Returns union: either IResolvable or CfnSpotFleet.SpotFleetRequestConfigDataProperty

setSpotFleetRequestConfigData

@Stability(Stable)
public void setSpotFleetRequestConfigData(@NotNull
 IResolvable value)

Describes the configuration of a Spot Fleet request.

setSpotFleetRequestConfigData

@Stability(Stable)
public void setSpotFleetRequestConfigData(@NotNull
 CfnSpotFleet.SpotFleetRequestConfigDataProperty value)

Describes the configuration of a Spot Fleet request.