Creates a launch configuration.
autoscaling_create_launch_configuration(LaunchConfigurationName,
ImageId, KeyName, SecurityGroups, ClassicLinkVPCId,
ClassicLinkVPCSecurityGroups, UserData, InstanceId, InstanceType,
KernelId, RamdiskId, BlockDeviceMappings, InstanceMonitoring, SpotPrice,
IamInstanceProfile, EbsOptimized, AssociatePublicIpAddress,
PlacementTenancy)[required] The name of the launch configuration. This name must be unique per Region per account.
The ID of the Amazon Machine Image (AMI) to use to launch your EC2 instances.
If you do not specify InstanceId, you must specify ImageId.
For more information, see Finding an AMI in the Amazon EC2 User Guide for Linux Instances.
The name of the key pair. For more information, see Amazon EC2 Key Pairs in the Amazon EC2 User Guide for Linux Instances.
One or more security groups with which to associate the instances.
If your instances are launched in EC2-Classic, you can either specify security group names or the security group IDs. For more information, see Amazon EC2 Security Groups in the Amazon EC2 User Guide for Linux Instances.
If your instances are launched into a VPC, specify security group IDs. For more information, see Security Groups for Your VPC in the Amazon Virtual Private Cloud User Guide.
The ID of a ClassicLink-enabled VPC to link your EC2-Classic instances to. This parameter is supported only if you are launching EC2-Classic instances. For more information, see ClassicLink in the Amazon EC2 User Guide for Linux Instances and Linking EC2-Classic Instances to a VPC in the Amazon EC2 Auto Scaling User Guide.
The IDs of one or more security groups for the specified ClassicLink-enabled VPC. For more information, see ClassicLink in the Amazon EC2 User Guide for Linux Instances and Linking EC2-Classic Instances to a VPC in the Amazon EC2 Auto Scaling User Guide.
Conditional: This parameter is required if you specify a ClassicLink-enabled VPC, and is not supported otherwise.
The user data to make available to the launched EC2 instances. For more information, see Instance Metadata and User Data in the Amazon EC2 User Guide for Linux Instances.
The ID of the instance to use to create the launch configuration. The new launch configuration derives attributes from the instance, except for the block device mapping.
To create a launch configuration with a block device mapping or override any other instance attributes, specify them as part of the same request.
For more information, see Create a Launch Configuration Using an EC2 Instance in the Amazon EC2 Auto Scaling User Guide.
If you do not specify InstanceId, you must specify both ImageId and
InstanceType.
The instance type of the EC2 instance.
For information about available instance types, see Available Instance Types in the Amazon EC2 User Guide for Linux Instances.
If you do not specify InstanceId, you must specify InstanceType.
The ID of the kernel associated with the AMI.
The ID of the RAM disk associated with the AMI.
One or more mappings that specify how block devices are exposed to the instance. For more information, see Block Device Mapping in the Amazon EC2 User Guide for Linux Instances.
Enables detailed monitoring (true) or basic monitoring (false) for
the Auto Scaling instances. The default value is true.
The maximum hourly price to be paid for any Spot Instance launched to fulfill the request. Spot Instances are launched when the price you specify exceeds the current Spot market price. For more information, see Launching Spot Instances in Your Auto Scaling Group in the Amazon EC2 Auto Scaling User Guide.
The name or the Amazon Resource Name (ARN) of the instance profile associated with the IAM role for the instance.
EC2 instances launched with an IAM role automatically have AWS security credentials available. You can use IAM roles with Amazon EC2 Auto Scaling to automatically enable applications running on your EC2 instances to securely access other AWS resources. For more information, see IAM Role for Applications That Run on Amazon EC2 Instances in the Amazon EC2 Auto Scaling User Guide.
Indicates whether the instance is optimized for Amazon EBS I/O. By default, the instance is not optimized for EBS I/O. The optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal I/O performance. This optimization is not available with all instance types. Additional usage charges apply. For more information, see Amazon EBS-Optimized Instances in the Amazon EC2 User Guide for Linux Instances.
Used for groups that launch instances into a virtual private cloud (VPC). Specifies whether to assign a public IP address to each instance. For more information, see Launching Auto Scaling Instances in a VPC in the Amazon EC2 Auto Scaling User Guide.
If you specify this parameter, be sure to specify at least one subnet when you create your group.
Default: If the instance is launched into a default subnet, the default is to assign a public IP address. If the instance is launched into a nondefault subnet, the default is not to assign a public IP address.
The tenancy of the instance. An instance with a tenancy of dedicated
runs on single-tenant hardware and can only be launched into a VPC.
To launch Dedicated Instances into a shared tenancy VPC (a VPC with the
instance placement tenancy attribute set to default), you must set the
value of this parameter to dedicated.
If you specify PlacementTenancy, be sure to specify at least one
subnet when you create your group.
For more information, see Instance Placement Tenancy in the Amazon EC2 Auto Scaling User Guide.
Valid values: default \| dedicated
svc$create_launch_configuration(
LaunchConfigurationName = "string",
ImageId = "string",
KeyName = "string",
SecurityGroups = list(
"string"
),
ClassicLinkVPCId = "string",
ClassicLinkVPCSecurityGroups = list(
"string"
),
UserData = "string",
InstanceId = "string",
InstanceType = "string",
KernelId = "string",
RamdiskId = "string",
BlockDeviceMappings = list(
list(
VirtualName = "string",
DeviceName = "string",
Ebs = list(
SnapshotId = "string",
VolumeSize = 123,
VolumeType = "string",
DeleteOnTermination = TRUE|FALSE,
Iops = 123,
Encrypted = TRUE|FALSE
),
NoDevice = TRUE|FALSE
)
),
InstanceMonitoring = list(
Enabled = TRUE|FALSE
),
SpotPrice = "string",
IamInstanceProfile = "string",
EbsOptimized = TRUE|FALSE,
AssociatePublicIpAddress = TRUE|FALSE,
PlacementTenancy = "string"
)
If you exceed your maximum limit of launch configurations, the call fails. For information about viewing this limit, see DescribeAccountLimits. For information about updating this limit, see Amazon EC2 Auto Scaling Limits in the Amazon EC2 Auto Scaling User Guide.
For more information, see Launch Configurations in the Amazon EC2 Auto Scaling User Guide.
# NOT RUN {
# This example creates a launch configuration.
# }
# NOT RUN {
svc$create_launch_configuration(
IamInstanceProfile = "my-iam-role",
ImageId = "ami-12345678",
InstanceType = "m3.medium",
LaunchConfigurationName = "my-launch-config",
SecurityGroups = list(
"sg-eb2af88e"
)
)
# }
# NOT RUN {
# }
Run the code above in your browser using DataLab