Package software.amazon.awscdk.mixins.preview.services.ec2.mixins

Class CfnSpotFleetPropsMixin

java.lang.Object

software.amazon.jsii.JsiiObject

software.amazon.awscdk.mixins.preview.core.Mixin

software.amazon.awscdk.mixins.preview.services.ec2.mixins.CfnSpotFleetPropsMixin

All Implemented Interfaces:

IMixin, software.amazon.jsii.JsiiSerializable

@Generated(value="jsii-pacmak/1.121.0 (build d7af9b9)",
           date="2025-12-18T18:20:25.360Z")
@Stability(Stable)
public class CfnSpotFleetPropsMixin
extends Mixin
implements IMixin

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.mixins.preview.mixins.*;
 import software.amazon.awscdk.mixins.preview.services.ec2.mixins.*;
 CfnSpotFleetPropsMixin cfnSpotFleetPropsMixin = CfnSpotFleetPropsMixin.Builder.create(CfnSpotFleetMixinProps.builder()
         .spotFleetRequestConfigData(SpotFleetRequestConfigDataProperty.builder()
                 .allocationStrategy("allocationStrategy")
                 .context("context")
                 .excessCapacityTerminationPolicy("excessCapacityTerminationPolicy")
                 .iamFleetRole("iamFleetRole")
                 .instanceInterruptionBehavior("instanceInterruptionBehavior")
                 .instancePoolsToUseCount(123)
                 .launchSpecifications(List.of(SpotFleetLaunchSpecificationProperty.builder()
                         .blockDeviceMappings(List.of(BlockDeviceMappingProperty.builder()
                                 .deviceName("deviceName")
                                 .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())
                         .imageId("imageId")
                         .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)
                                 .requireEncryptionInTransit(false)
                                 .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()
                                         .primary(false)
                                         .privateIpAddress("privateIpAddress")
                                         .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()
                                 .launchTemplateId("launchTemplateId")
                                 .launchTemplateName("launchTemplateName")
                                 .version("version")
                                 .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)
                                         .requireEncryptionInTransit(false)
                                         .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()))
                 .targetCapacity(123)
                 .targetCapacityUnitType("targetCapacityUnitType")
                 .terminateInstancesWithExpiration(false)
                 .type("type")
                 .validFrom("validFrom")
                 .validUntil("validUntil")
                 .build())
         .tags(List.of(CfnTag.builder()
                 .key("key")
                 .value("value")
                 .build()))
         .build())
 .strategy(PropertyMergeStrategy.OVERRIDE)
 .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	CfnSpotFleetPropsMixin.AcceleratorCountRequestProperty	The minimum and maximum number of accelerators (GPUs, FPGAs, or AWS Inferentia chips) on an instance.
static interface	CfnSpotFleetPropsMixin.AcceleratorTotalMemoryMiBRequestProperty	The minimum and maximum amount of total accelerator memory, in MiB.
static interface	CfnSpotFleetPropsMixin.BaselineEbsBandwidthMbpsRequestProperty	The minimum and maximum baseline bandwidth to Amazon EBS, in Mbps.
static interface	CfnSpotFleetPropsMixin.BaselinePerformanceFactorsRequestProperty	The baseline performance to consider, using an instance family as a baseline reference.
static interface	CfnSpotFleetPropsMixin.BlockDeviceMappingProperty	Specifies a block device mapping.
static final class	CfnSpotFleetPropsMixin.Builder	A fluent builder for CfnSpotFleetPropsMixin.
static interface	CfnSpotFleetPropsMixin.ClassicLoadBalancerProperty	Specifies a Classic Load Balancer.
static interface	CfnSpotFleetPropsMixin.ClassicLoadBalancersConfigProperty	Specifies the Classic Load Balancers to attach to a Spot Fleet.
static interface	CfnSpotFleetPropsMixin.CpuPerformanceFactorRequestProperty	The CPU performance to consider, using an instance family as the baseline reference.
static interface	CfnSpotFleetPropsMixin.EbsBlockDeviceProperty	Describes a block device for an EBS volume.
static interface	CfnSpotFleetPropsMixin.FleetLaunchTemplateSpecificationProperty	Specifies the launch template to be used by the Spot Fleet request for configuring Amazon EC2 instances.
static interface	CfnSpotFleetPropsMixin.GroupIdentifierProperty	Describes a security group.
static interface	CfnSpotFleetPropsMixin.IamInstanceProfileSpecificationProperty	Describes an IAM instance profile.
static interface	CfnSpotFleetPropsMixin.InstanceIpv6AddressProperty	Describes an IPv6 address.
static interface	CfnSpotFleetPropsMixin.InstanceNetworkInterfaceSpecificationProperty	Describes a network interface.
static interface	CfnSpotFleetPropsMixin.InstanceRequirementsRequestProperty	The attributes for the instance types.
static interface	CfnSpotFleetPropsMixin.LaunchTemplateConfigProperty	Specifies a launch template and overrides.
static interface	CfnSpotFleetPropsMixin.LaunchTemplateOverridesProperty	Specifies overrides for a launch template.
static interface	CfnSpotFleetPropsMixin.LoadBalancersConfigProperty	Specifies the Classic Load Balancers and target groups to attach to a Spot Fleet request.
static interface	CfnSpotFleetPropsMixin.MemoryGiBPerVCpuRequestProperty	The minimum and maximum amount of memory per vCPU, in GiB.
static interface	CfnSpotFleetPropsMixin.MemoryMiBRequestProperty	The minimum and maximum amount of memory, in MiB.
static interface	CfnSpotFleetPropsMixin.NetworkBandwidthGbpsRequestProperty	The minimum and maximum amount of baseline network bandwidth, in gigabits per second (Gbps).
static interface	CfnSpotFleetPropsMixin.NetworkInterfaceCountRequestProperty	The minimum and maximum number of network interfaces.
static interface	CfnSpotFleetPropsMixin.PerformanceFactorReferenceRequestProperty	Specify an instance family to use as the baseline reference for CPU performance.
static interface	CfnSpotFleetPropsMixin.PrivateIpAddressSpecificationProperty	Describes a secondary private IPv4 address for a network interface.
static interface	CfnSpotFleetPropsMixin.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	CfnSpotFleetPropsMixin.SpotFleetLaunchSpecificationProperty	Specifies the launch specification for one or more Spot Instances.
static interface	CfnSpotFleetPropsMixin.SpotFleetMonitoringProperty	Describes whether monitoring is enabled.
static interface	CfnSpotFleetPropsMixin.SpotFleetRequestConfigDataProperty	Specifies the configuration of a Spot Fleet request.
static interface	CfnSpotFleetPropsMixin.SpotFleetTagSpecificationProperty	The tags for a Spot Fleet resource.
static interface	CfnSpotFleetPropsMixin.SpotMaintenanceStrategiesProperty	The strategies for managing your Spot Instances that are at an elevated risk of being interrupted.
static interface	CfnSpotFleetPropsMixin.SpotPlacementProperty	Describes Spot Instance placement.
static interface	CfnSpotFleetPropsMixin.TargetGroupProperty	Describes a load balancer target group.
static interface	CfnSpotFleetPropsMixin.TargetGroupsConfigProperty	Describes the target groups to attach to a Spot Fleet.
static interface	CfnSpotFleetPropsMixin.TotalLocalStorageGBRequestProperty	The minimum and maximum amount of total local storage, in GB.
static interface	CfnSpotFleetPropsMixin.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.amazon.awscdk.mixins.preview.core.IMixin

IMixin.Jsii$Default, IMixin.Jsii$Proxy

Field Summary

Fields

Modifier and Type	Field	Description
protected static final List<String>	CFN_PROPERTY_KEYS

Constructor Summary

Constructors

Modifier	Constructor	Description
	CfnSpotFleetPropsMixin(CfnSpotFleetMixinProps props)	Create a mixin to apply properties to AWS::EC2::SpotFleet.
	CfnSpotFleetPropsMixin(CfnSpotFleetMixinProps props, CfnPropertyMixinOptions options)	Create a mixin to apply properties to AWS::EC2::SpotFleet.
protected	CfnSpotFleetPropsMixin(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	CfnSpotFleetPropsMixin(software.amazon.jsii.JsiiObjectRef objRef)

Method Summary

Modifier and Type	Method	Description
software.constructs.IConstruct	applyTo(software.constructs.IConstruct construct)	Apply the mixin properties to the construct.
protected CfnSpotFleetMixinProps	getProps()
protected PropertyMergeStrategy	getStrategy()
Boolean	supports(software.constructs.IConstruct construct)	Check if this mixin supports the given construct.

Methods inherited from class software.amazon.awscdk.mixins.preview.core.Mixin

isMixin

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, toString, wait, wait, wait

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Field Details

CFN_PROPERTY_KEYS

@Stability(Stable)
protected static final List<String> CFN_PROPERTY_KEYS

Constructor Details

CfnSpotFleetPropsMixin

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

CfnSpotFleetPropsMixin

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

CfnSpotFleetPropsMixin

@Stability(Stable)
public CfnSpotFleetPropsMixin(@NotNull
 CfnSpotFleetMixinProps props,
 @Nullable
 CfnPropertyMixinOptions options)

Create a mixin to apply properties to AWS::EC2::SpotFleet.

Parameters:

props - L1 properties to apply. This parameter is required.

options - Mixin options.

CfnSpotFleetPropsMixin

@Stability(Stable)
public CfnSpotFleetPropsMixin(@NotNull
 CfnSpotFleetMixinProps props)

Create a mixin to apply properties to AWS::EC2::SpotFleet.

Parameters:

props - L1 properties to apply. This parameter is required.

Method Details

applyTo

@Stability(Stable)
@NotNull
public software.constructs.IConstruct applyTo(@NotNull
 software.constructs.IConstruct construct)

Apply the mixin properties to the construct.

Specified by:

applyTo in interface IMixin

Specified by:

applyTo in class Mixin

Parameters:

construct - This parameter is required.

supports

@Stability(Stable)
@NotNull
public Boolean supports(@NotNull
 software.constructs.IConstruct construct)

Check if this mixin supports the given construct.

Specified by:

supports in interface IMixin

Overrides:

supports in class Mixin

Parameters:

construct - This parameter is required.

getProps

@Stability(Stable)
@NotNull
protected CfnSpotFleetMixinProps getProps()

getStrategy

@Stability(Stable)
@NotNull
protected PropertyMergeStrategy getStrategy()