There are more AWS SDK examples available in the AWS Doc SDK Examples
Use CreateLaunchConfiguration with a CLI
The following code examples show how to use CreateLaunchConfiguration.
- CLI
-
- AWS CLI
-
Example 1: To create a launch configuration
The following
create-launch-configurationexample creates a simple launch configuration.aws autoscaling create-launch-configuration \ --launch-configuration-namemy-lc\ --image-idami-04d5cc9b88example\ --instance-typem5.largeThis command produces no output.
For more information, see Creating a launch configuration in the Amazon EC2 Auto Scaling User Guide.
Example 2: To create a launch configuration with a security group, key pair, and bootstrapping script
The following
create-launch-configurationexample creates a launch configuration with a security group, a key pair, and a bootstrapping script contained in the user data.aws autoscaling create-launch-configuration \ --launch-configuration-namemy-lc\ --image-idami-04d5cc9b88example\ --instance-typem5.large\ --security-groupssg-eb2af88example\ --key-namemy-key-pair\ --user-datafile://myuserdata.txtContents of
myuserdata.txt:#!/bin/bash yum update -y yum install -y httpd systemctl start httpd systemctl enable httpdThis command produces no output.
For more information, see Creating a launch configuration in the Amazon EC2 Auto Scaling User Guide.
Example 3: To create a launch configuration with an IAM role
The following
create-launch-configurationexample creates a launch configuration with the instance profile name of an IAM role.aws autoscaling create-launch-configuration \ --launch-configuration-namemy-lc\ --image-idami-04d5cc9b88example\ --instance-typem5.large\ --iam-instance-profilemy-autoscaling-roleThis command produces no output.
For more information, see IAM role for applications that run on Amazon EC2 instances in the Amazon EC2 Auto Scaling User Guide.
Example 4: To create a launch configuration with detailed monitoring enabled
The following
create-launch-configurationexample creates a launch configuration with EC2 detailed monitoring enabled, which sends EC2 metrics to CloudWatch in 1-minute periods.aws autoscaling create-launch-configuration \ --launch-configuration-namemy-lc\ --image-idami-04d5cc9b88example\ --instance-typem5.large\ --instance-monitoringEnabled=trueThis command produces no output.
For more information, see Configuring monitoring for Auto Scaling instances in the Amazon EC2 Auto Scaling User Guide.
Example 5: To create a launch configuration that launches Spot Instances
The following
create-launch-configurationexample creates a launch configuration that uses Spot Instances as the only purchase option.aws autoscaling create-launch-configuration \ --launch-configuration-namemy-lc\ --image-idami-04d5cc9b88example\ --instance-typem5.large\ --spot-price"0.50"This command produces no output.
For more information, see Requesting Spot Instances in the Amazon EC2 Auto Scaling User Guide.
Example 6: To create a launch configuration using an EC2 instance
The following
create-launch-configurationexample creates a launch configuration based on the attributes of an existing instance. It overrides the placement tenancy and whether a public IP address is set by including the--placement-tenancyand--no-associate-public-ip-addressoptions.aws autoscaling create-launch-configuration \ --launch-configuration-namemy-lc-from-instance\ --instance-idi-1234567890abcdef0\ --instance-typem5.large\ --no-associate-public-ip-address \ --placement-tenancydedicatedThis command produces no output.
For more information, see Creating a launch configuration using an EC2 instance in the Amazon EC2 Auto Scaling User Guide.
Example 7: To create a launch configuration with a block device mapping for an Amazon EBS volume
The following
create-launch-configurationexample creates a launch configuration with a block device mapping for an Amazon EBSgp3volume with the device name/dev/sdhand a volume size of 20.aws autoscaling create-launch-configuration \ --launch-configuration-namemy-lc\ --image-idami-04d5cc9b88example\ --instance-typem5.large\ --block-device-mappings '[{"DeviceName":"/dev/sdh","Ebs":{"VolumeSize":20,"VolumeType":"gp3"}}]'This command produces no output.
For more information, see Block device mappings for volumes on Amazon EC2 instances in the Amazon EC2 User Guide.
For information about the syntax for quoting JSON-formatted parameter values, see Using quotation marks with strings in the AWS CLI in the AWS Command Line Interface User Guide.
Example 8: To create a launch configuration with a block device mapping for an instance store volume
The following
create-launch-configurationexample creates a launch configuration withephemeral1as an instance store volume with the device name/dev/sdc.aws autoscaling create-launch-configuration \ --launch-configuration-namemy-lc\ --image-idami-04d5cc9b88example\ --instance-typem5.large\ --block-device-mappings '[{"DeviceName":"/dev/sdc","VirtualName":"ephemeral1"}]'This command produces no output.
For more information, see Instance store temporary block storage for EC2 instances in the Amazon EC2 User Guide.
For information about the syntax for quoting JSON-formatted parameter values, see Using quotation marks with strings in the AWS CLI in the AWS Command Line Interface User Guide.
Example 9: To create a launch configuration and suppress a block device from attaching at launch time
The following
create-launch-configurationexample creates a launch configuration that suppresses a block device specified by the block device mapping of the AMI (for example,/dev/sdf).aws autoscaling create-launch-configuration \ --launch-configuration-namemy-lc\ --image-idami-04d5cc9b88example\ --instance-typem5.large\ --block-device-mappings '[{"DeviceName":"/dev/sdf","NoDevice":true}]'This command produces no output.
For more information, see Block device mappings for volumes on Amazon EC2 instances in the Amazon EC2 User Guide.
For information about the syntax for quoting JSON-formatted parameter values, see Using quotation marks with strings in the AWS CLI in the AWS Command Line Interface User Guide.
-
For API details, see CreateLaunchConfiguration
in AWS CLI Command Reference.
-
- PowerShell
-
- Tools for PowerShell V4
-
Example 1: This example creates a launch configuration named 'my-lc'. The EC2 instances launched by Auto Scaling groups that use this launch configuration use specified instance type, AMI, security group, and IAM role.
New-ASLaunchConfiguration -LaunchConfigurationName my-lc -InstanceType "m3.medium" -ImageId "ami-12345678" -SecurityGroup "sg-12345678" -IamInstanceProfile "myIamRole"-
For API details, see CreateLaunchConfiguration in AWS Tools for PowerShell Cmdlet Reference (V4).
-
- Tools for PowerShell V5
-
Example 1: This example creates a launch configuration named 'my-lc'. The EC2 instances launched by Auto Scaling groups that use this launch configuration use specified instance type, AMI, security group, and IAM role.
New-ASLaunchConfiguration -LaunchConfigurationName my-lc -InstanceType "m3.medium" -ImageId "ami-12345678" -SecurityGroup "sg-12345678" -IamInstanceProfile "myIamRole"-
For API details, see CreateLaunchConfiguration in AWS Tools for PowerShell Cmdlet Reference (V5).
-