AmazonElasticLoadBalancingV2Client.CreateLoadBalancer Method (CreateLoadBalancerRequest)

Creates an Application Load Balancer, Network Load Balancer, or Gateway Load Balancer.

For more information, see the following:

This operation is idempotent, which means that it completes at most one time. If you attempt to create multiple load balancers with the same settings, each call succeeds.

Note:

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

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

Syntax

public virtual CreateLoadBalancerResponse CreateLoadBalancer(
         CreateLoadBalancerRequest request
)

Parameters

request: Type: Amazon.ElasticLoadBalancingV2.Model.CreateLoadBalancerRequest

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

Return Value

Type: CreateLoadBalancerResponse

The response from the CreateLoadBalancer service method, as returned by ElasticLoadBalancingV2.

Exceptions

Exception	Condition
AllocationIdNotFoundException	The specified allocation ID does not exist.
AvailabilityZoneNotSupportedException	The specified Availability Zone is not supported.
DuplicateLoadBalancerNameException	A load balancer with the specified name already exists.
DuplicateTagKeysException	A tag key was specified more than once.
InvalidConfigurationRequestException	The requested configuration is not valid.
InvalidSchemeException	The requested scheme is not valid.
InvalidSecurityGroupException	The specified security group does not exist.
InvalidSubnetException	The specified subnet is out of available addresses.
OperationNotPermittedException	This operation is not allowed.
ResourceInUseException	A specified resource is in use.
SubnetNotFoundException	The specified subnet does not exist.
TooManyLoadBalancersException	You've reached the limit on the number of load balancers for your Amazon Web Services account.
TooManyTagsException	You've reached the limit on the number of tags for this resource.

Examples

This example creates an Internet-facing load balancer and enables the Availability Zones for the specified subnets.

To create an Internet-facing load balancer


var client = new AmazonElasticLoadBalancingV2Client();
var response = client.CreateLoadBalancer(new CreateLoadBalancerRequest 
{
    Name = "my-load-balancer",
    Subnets = new List<string> {
        "subnet-b7d581c0",
        "subnet-8360a9e7"
    }
});

List<LoadBalancer> loadBalancers = response.LoadBalancers;

This example creates an internal load balancer and enables the Availability Zones for the specified subnets.

To create an internal load balancer


var client = new AmazonElasticLoadBalancingV2Client();
var response = client.CreateLoadBalancer(new CreateLoadBalancerRequest 
{
    Name = "my-internal-load-balancer",
    Scheme = "internal",
    SecurityGroups = new List<string> {
                    
    },
    Subnets = new List<string> {
        "subnet-b7d581c0",
        "subnet-8360a9e7"
    }
});

List<LoadBalancer> loadBalancers = response.LoadBalancers;

Version Information

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

AmazonElasticLoadBalancingV2Client.CreateLoadBalancer (CreateLoadBalancerRequest)

Method