| « PreviousNext » | |
  | Did this page help you? Yes | No | Tell us about it... |
CreateLaunchConfiguration
Description
Creates a new launch configuration. The launch configuration name must be unique within the scope of the client's AWS account. The maximum limit of launch configurations, which by default is 100, must not yet have been met; otherwise, the call will fail. When created, the new launch configuration is available for immediate use.
You can create a launch configuration with Amazon EC2 security groups or with Amazon VPC security groups. However, you can't use Amazon EC2 security groups together with Amazon VPC security groups, or vice versa.
Note
At this time, Auto Scaling launch configurations don't support compressed (e.g. zipped) user data files.
Request Parameters
For information about the common parameters that all actions use, see Common Parameters.
- BlockDeviceMappings.member.N
A list of mappings that specify how block devices are exposed to the instance. Each mapping is made up of a VirtualName, a DeviceName, and an ebs data structure that contains information about the associated Elastic Block Storage volume. For more information about Amazon EC2 BlockDeviceMappings, go to Block Device Mapping in the Amazon EC2 product documentation.
Type: BlockDeviceMapping list
Required: No
- EbsOptimized
Whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization is not available with all instance types. Additional usage charges apply when using an EBS Optimized instance. For information about EBS-optimized instances, go to EBS-Optimized Instances in the Amazon Elastic Compute Cloud User Guide.
Type: Boolean
Required: No
- IamInstanceProfile
The name or the Amazon Resource Name (ARN) of the instance profile associated with the IAM role for the instance. For information on launching EC2 instances with an IAM role, go to Launching Auto Scaling Instances With an IAM Role in the Auto Scaling Developer Guide.
Type: String
Length constraints: Minimum length of 1. Maximum length of 1600.
Required: No
- ImageId
Unique ID of the Amazon Machine Image (AMI) which was assigned during registration. For more information about Amazon EC2 images, please see Amazon EC2 product documentation.
Type: String
Length constraints: Minimum length of 1. Maximum length of 255.
Required: Yes
- InstanceMonitoring
Enables detailed monitoring, which is enabled by default.
When detailed monitoring is enabled, CloudWatch will generate metrics every minute and your account will be charged a fee. When you disable detailed monitoring, by specifying
False, Cloudwatch will generate metrics every 5 minutes. For information about monitoring, see the Amazon CloudWatch product page.Type: InstanceMonitoring
Required: No
- InstanceType
The instance type of the Amazon EC2 instance. For more information about Amazon EC2 instance types, please see Amazon EC2 product documentation
Type: String
Length constraints: Minimum length of 1. Maximum length of 255.
Required: Yes
- KernelId
The ID of the kernel associated with the Amazon EC2 AMI.
Type: String
Length constraints: Minimum length of 1. Maximum length of 255.
Required: No
- KeyName
The name of the Amazon EC2 key pair.
Type: String
Length constraints: Minimum length of 1. Maximum length of 255.
Required: No
- LaunchConfigurationName
The name of the launch configuration to create.
Type: String
Length constraints: Minimum length of 1. Maximum length of 255.
Required: Yes
- RamdiskId
The ID of the RAM disk associated with the Amazon EC2 AMI.
Type: String
Length constraints: Minimum length of 1. Maximum length of 255.
Required: No
- SecurityGroups.member.N
The names of the security groups with which to associate Amazon EC2 or Amazon VPC instances. Specify Amazon EC2 security groups using security group names, such as
websrv. Specify Amazon VPC security groups using security group IDs, such assg-12345678. For more information about Amazon EC2 security groups, go to Using Security Groups in the Amazon EC2 product documentation. For more information about Amazon VPC security groups, go to Security Groups in the Amazon VPC product documentation.Type: String list
Required: No
- SpotPrice
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 on launching Spot Instances, go to Using Auto Scaling to Launch Spot Instances in the Auto Scaling Developer Guide.
Type: String
Length constraints: Minimum length of 1. Maximum length of 255.
Required: No
- UserData
The user data available to the launched Amazon EC2 instances. For more information about Amazon EC2 user data, please see Amazon EC2 product documentation.
Type: String
Length constraints: Minimum length of 0. Maximum length of 21847.
Required: No
Errors
For information about the errors that are common to all actions, see Common Errors.
- AlreadyExists
The named Auto Scaling group or launch configuration already exists.
HTTP Status Code: 400
- LimitExceeded
The quota for capacity groups or launch configurations for this customer has already been reached.
HTTP Status Code: 400
