software.amazon.awscdk.services.autoscaling

Interface CfnAutoScalingGroup.MixedInstancesPolicyProperty

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

CfnAutoScalingGroup.MixedInstancesPolicyProperty.Jsii$Proxy

Enclosing class:

CfnAutoScalingGroup

@Stability(value=Stable)
public static interface CfnAutoScalingGroup.MixedInstancesPolicyProperty
extends software.amazon.jsii.JsiiSerializable

`MixedInstancesPolicy` is a property of the [AWS::AutoScaling::AutoScalingGroup](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-as-group.html) resource. It allows you to configure a group that diversifies across On-Demand Instances and Spot Instances of multiple instance types. For more information, see [Auto Scaling groups with multiple instance types and purchase options](https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-mixed-instances-groups.html) in the *Amazon EC2 Auto Scaling User Guide* .

You can create a mixed instances policy for a new Auto Scaling group, or you can create it for an existing group by updating the group to specify MixedInstancesPolicy as the top-level property instead of a launch template or launch configuration. If you specify a MixedInstancesPolicy , you must specify a launch template as a property of the policy. You cannot specify a launch configuration for the policy.

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.autoscaling.*;
 MixedInstancesPolicyProperty mixedInstancesPolicyProperty = MixedInstancesPolicyProperty.builder()
         .launchTemplate(LaunchTemplateProperty.builder()
                 .launchTemplateSpecification(LaunchTemplateSpecificationProperty.builder()
                         .version("version")
                         // the properties below are optional
                         .launchTemplateId("launchTemplateId")
                         .launchTemplateName("launchTemplateName")
                         .build())
                 // the properties below are optional
                 .overrides(List.of(LaunchTemplateOverridesProperty.builder()
                         .instanceRequirements(InstanceRequirementsProperty.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"))
                                 .bareMetal("bareMetal")
                                 .baselineEbsBandwidthMbps(BaselineEbsBandwidthMbpsRequestProperty.builder()
                                         .max(123)
                                         .min(123)
                                         .build())
                                 .burstablePerformance("burstablePerformance")
                                 .cpuManufacturers(List.of("cpuManufacturers"))
                                 .excludedInstanceTypes(List.of("excludedInstanceTypes"))
                                 .instanceGenerations(List.of("instanceGenerations"))
                                 .localStorage("localStorage")
                                 .localStorageTypes(List.of("localStorageTypes"))
                                 .memoryGiBPerVCpu(MemoryGiBPerVCpuRequestProperty.builder()
                                         .max(123)
                                         .min(123)
                                         .build())
                                 .memoryMiB(MemoryMiBRequestProperty.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(VCpuCountRequestProperty.builder()
                                         .max(123)
                                         .min(123)
                                         .build())
                                 .build())
                         .instanceType("instanceType")
                         .launchTemplateSpecification(LaunchTemplateSpecificationProperty.builder()
                                 .version("version")
                                 // the properties below are optional
                                 .launchTemplateId("launchTemplateId")
                                 .launchTemplateName("launchTemplateName")
                                 .build())
                         .weightedCapacity("weightedCapacity")
                         .build()))
                 .build())
         // the properties below are optional
         .instancesDistribution(InstancesDistributionProperty.builder()
                 .onDemandAllocationStrategy("onDemandAllocationStrategy")
                 .onDemandBaseCapacity(123)
                 .onDemandPercentageAboveBaseCapacity(123)
                 .spotAllocationStrategy("spotAllocationStrategy")
                 .spotInstancePools(123)
                 .spotMaxPrice("spotMaxPrice")
                 .build())
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	CfnAutoScalingGroup.MixedInstancesPolicyProperty.Builder A builder for CfnAutoScalingGroup.MixedInstancesPolicyProperty
static class	CfnAutoScalingGroup.MixedInstancesPolicyProperty.Jsii$Proxy An implementation for CfnAutoScalingGroup.MixedInstancesPolicyProperty

Method Summary

Modifier and Type	Method and Description
static CfnAutoScalingGroup.MixedInstancesPolicyProperty.Builder	builder()
default Object	getInstancesDistribution() The instances distribution.
Object	getLaunchTemplate() One or more launch templates and the instance types (overrides) that are used to launch EC2 instances to fulfill On-Demand and Spot capacities.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Detail

getLaunchTemplate

@Stability(value=Stable)
 @NotNull
Object getLaunchTemplate()

One or more launch templates and the instance types (overrides) that are used to launch EC2 instances to fulfill On-Demand and Spot capacities.

getInstancesDistribution

@Stability(value=Stable)
 @Nullable
default Object getInstancesDistribution()

The instances distribution.

builder

@Stability(value=Stable)
static CfnAutoScalingGroup.MixedInstancesPolicyProperty.Builder builder()

Returns:

a CfnAutoScalingGroup.MixedInstancesPolicyProperty.Builder of CfnAutoScalingGroup.MixedInstancesPolicyProperty