AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Creates an Application Load Balancer or a Network Load Balancer.

When you create a load balancer, you can specify security groups, subnets, IP address type, and tags. Otherwise, you could do so later using SetSecurityGroups, SetSubnets, SetIpAddressType, and AddTags.

To create listeners for your load balancer, use CreateListener. To describe your current load balancers, see DescribeLoadBalancers. When you are finished with a load balancer, you can delete it using DeleteLoadBalancer.

You can create up to 20 load balancers per region per account. You can request an increase for the number of load balancers for your account. For more information, see Limits for Your Application Load Balancer in the Application Load Balancers Guide and Limits for Your Network Load Balancer in the Network Load Balancers Guide.

For more information, see Application Load Balancers in the Application Load Balancers Guide and Network Load Balancers in the Network Load Balancers Guide.

Note:

For PCL 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

C#
public abstract CreateLoadBalancerResponse CreateLoadBalancer(
         CreateLoadBalancerRequest request
)
Parameters
request
Type: Amazon.ElasticLoadBalancingV2.Model.CreateLoadBalancerRequest

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

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

Exceptions

ExceptionCondition
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.
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 AWS account.
TooManyTagsException You've reached the limit on the number of tags per load balancer.

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 response = client.CreateLoadBalancer(new CreateLoadBalancerRequest 
{
    Name = "my-load-balancer",
    Subnets = new List {
        "subnet-b7d581c0",
        "subnet-8360a9e7"
    }
});

List 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 response = client.CreateLoadBalancer(new CreateLoadBalancerRequest 
{
    Name = "my-internal-load-balancer",
    Scheme = "internal",
    SecurityGroups = new List {
                    
    },
    Subnets = new List {
        "subnet-b7d581c0",
        "subnet-8360a9e7"
    }
});

List loadBalancers = response.LoadBalancers;

            

Version Information

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

Portable Class Library:
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms

See Also