AmazonAutoScalingClient.CreateLaunchConfiguration Method (CreateLaunchConfigurationRequest)

Creates a launch configuration.

If you exceed your maximum limit of launch configurations, the call fails. To query this limit, call the DescribeAccountLimits API. For information about updating this limit, see Quotas for Amazon EC2 Auto Scaling in the Amazon EC2 Auto Scaling User Guide.

For more information, see Launch configurations in the Amazon EC2 Auto Scaling User Guide.

Amazon EC2 Auto Scaling configures instances launched as part of an Auto Scaling group using either a launch template or a launch configuration. We strongly recommend that you do not use launch configurations. They do not provide full functionality for Amazon EC2 Auto Scaling or Amazon EC2. For information about using launch templates, see Launch templates in the Amazon EC2 Auto Scaling User Guide.

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to CreateLaunchConfigurationAsync.

Namespace: Amazon.AutoScaling
Assembly: AWSSDK.AutoScaling.dll
Version: 3.x.y.z

Syntax

public virtual CreateLaunchConfigurationResponse CreateLaunchConfiguration(
         CreateLaunchConfigurationRequest request
)

Parameters

request: Type: Amazon.AutoScaling.Model.CreateLaunchConfigurationRequest

Container for the necessary parameters to execute the CreateLaunchConfiguration service method.

Return Value

Type: CreateLaunchConfigurationResponse

The response from the CreateLaunchConfiguration service method, as returned by AutoScaling.

Exceptions

Exception	Condition
AlreadyExistsException	You already have an Auto Scaling group or launch configuration with this name.
LimitExceededException	You have already reached a limit for your Amazon EC2 Auto Scaling resources (for example, Auto Scaling groups, launch configurations, or lifecycle hooks). For more information, see DescribeAccountLimits in the Amazon EC2 Auto Scaling API Reference.
ResourceContentionException	You already have a pending update to an Amazon EC2 Auto Scaling resource (for example, an Auto Scaling group, instance, or load balancer).

Examples

This example creates a launch configuration.

To create a launch configuration


var client = new AmazonAutoScalingClient();
var response = client.CreateLaunchConfiguration(new CreateLaunchConfigurationRequest 
{
    IamInstanceProfile = "my-iam-role",
    ImageId = "ami-12345678",
    InstanceType = "m3.medium",
    LaunchConfigurationName = "my-launch-config",
    SecurityGroups = new List<string> {
        "sg-eb2af88e"
    }
});

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

AmazonAutoScalingClient.CreateLaunchConfiguration (CreateLaunchConfigurationRequest)

Method