Package software.amazon.awscdk.services.autoscaling

Interface AutoScalingGroupProps

All Superinterfaces:

CommonAutoScalingGroupProps, software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

AutoScalingGroupProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.84.0 (build 5404dcf)",
           date="2023-06-19T16:30:45.183Z")
@Stability(Stable)
public interface AutoScalingGroupProps
extends software.amazon.jsii.JsiiSerializable, CommonAutoScalingGroupProps

Properties of a Fleet.

Example:

 Vpc vpc;
 SecurityGroup mySecurityGroup = SecurityGroup.Builder.create(this, "SecurityGroup").vpc(vpc).build();
 AutoScalingGroup.Builder.create(this, "ASG")
         .vpc(vpc)
         .instanceType(InstanceType.of(InstanceClass.BURSTABLE2, InstanceSize.MICRO))
         .machineImage(new AmazonLinuxImage())
         .securityGroup(mySecurityGroup)
         .build();
 

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method	Description
static AutoScalingGroupProps.Builder	builder()
default CloudFormationInit	getInit()	Apply the given CloudFormation Init configuration to the instances in the AutoScalingGroup at startup.
default ApplyCloudFormationInitOptions	getInitOptions()	Use the given options for applying CloudFormation Init.
default InstanceType	getInstanceType()	Type of instance to launch.
default ILaunchTemplate	getLaunchTemplate()	Launch template to use.
default IMachineImage	getMachineImage()	AMI to launch.
default MixedInstancesPolicy	getMixedInstancesPolicy()	Mixed Instances Policy to use.
default Boolean	getRequireImdsv2()	Whether IMDSv2 should be required on launched instances.
default IRole	getRole()	An IAM role to associate with the instance profile assigned to this Auto Scaling Group.
default ISecurityGroup	getSecurityGroup()	Security group to launch the instances in.
default UserData	getUserData()	Specific UserData to use.
IVpc	getVpc()	VPC to launch these instances in.

Methods inherited from interface software.amazon.awscdk.services.autoscaling.CommonAutoScalingGroupProps

getAllowAllOutbound, getAssociatePublicIpAddress, getAutoScalingGroupName, getBlockDevices, getCooldown, getDesiredCapacity, getGroupMetrics, getHealthCheck, getIgnoreUnmodifiedSizeProperties, getInstanceMonitoring, getKeyName, getMaxCapacity, getMaxInstanceLifetime, getMinCapacity, getNewInstancesProtectedFromScaleIn, getNotifications, getNotificationsTopic, getReplacingUpdateMinSuccessfulInstancesPercent, getResourceSignalCount, getResourceSignalTimeout, getRollingUpdateConfiguration, getSignals, getSpotPrice, getTerminationPolicies, getUpdatePolicy, getUpdateType, getVpcSubnets

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getVpc

@Stability(Stable)
@NotNull
IVpc getVpc()

VPC to launch these instances in.

getInit

@Stability(Stable)
@Nullable
default CloudFormationInit getInit()

Apply the given CloudFormation Init configuration to the instances in the AutoScalingGroup at startup.

If you specify init, you must also specify signals to configure the number of instances to wait for and the timeout for waiting for the init process.

Default: - no CloudFormation init

getInitOptions

@Stability(Stable)
@Nullable
default ApplyCloudFormationInitOptions getInitOptions()

Use the given options for applying CloudFormation Init.

Describes the configsets to use and the timeout to wait

Default: - default options

getInstanceType

@Stability(Stable)
@Nullable
default InstanceType getInstanceType()

Type of instance to launch.

launchTemplate must not be specified when this property is specified.

Default: - Do not provide any instance type

getLaunchTemplate

@Stability(Stable)
@Nullable
default ILaunchTemplate getLaunchTemplate()

Launch template to use.

Launch configuration related settings and MixedInstancesPolicy must not be specified when a launch template is specified.

Default: - Do not provide any launch template

getMachineImage

@Stability(Stable)
@Nullable
default IMachineImage getMachineImage()

AMI to launch.

launchTemplate must not be specified when this property is specified.

Default: - Do not provide any machine image

getMixedInstancesPolicy

@Stability(Stable)
@Nullable
default MixedInstancesPolicy getMixedInstancesPolicy()

Mixed Instances Policy to use.

Launch configuration related settings and Launch Template must not be specified when a MixedInstancesPolicy is specified.

Default: - Do not provide any MixedInstancesPolicy

getRequireImdsv2

@Stability(Stable)
@Nullable
default Boolean getRequireImdsv2()

Whether IMDSv2 should be required on launched instances.

Default: false

getRole

@Stability(Stable)
@Nullable
default IRole getRole()

An IAM role to associate with the instance profile assigned to this Auto Scaling Group.

The role must be assumable by the service principal ec2.amazonaws.com:

launchTemplate must not be specified when this property is specified.

Default: A role will automatically be created, it can be accessed via the `role` property

Example:

 Role role = Role.Builder.create(this, "MyRole")
         .assumedBy(new ServicePrincipal("ec2.amazonaws.com"))
         .build();
 

getSecurityGroup

@Stability(Stable)
@Nullable
default ISecurityGroup getSecurityGroup()

Security group to launch the instances in.

launchTemplate must not be specified when this property is specified.

Default: - A SecurityGroup will be created if none is specified.

getUserData

@Stability(Stable)
@Nullable
default UserData getUserData()

Specific UserData to use.

The UserData may still be mutated after creation.

launchTemplate must not be specified when this property is specified.

Default: - A UserData object appropriate for the MachineImage's Operating System is created.

builder

@Stability(Stable)
static AutoScalingGroupProps.Builder builder()

Returns:

a AutoScalingGroupProps.Builder of AutoScalingGroupProps