CreateLoadBalancer

GET /?Action=CreateLoadBalancer
Description

Creates a load balancer.
The load balancer is created with a unique Domain Name Service (DNS) name. It receives the incoming traffic and routes it to its registered instances.
By default, this action creates an Internet-facing load balancer, resolving to public IP addresses. To create an internal load balancer in a Virtual Private Cloud (VPC), resolving to private IP addresses, use the Scheme parameter.

Body parameter

Required: false
Name: CreateLoadBalancerInput

Name Description Required Schema Default Example

AvailabilityZones.member.N

The name of the Availability Zone (currently, only one AZ is supported). This parameter is not required if you create a load balancer in a VPC. To create an internal load balancer, use the Scheme parameter.

true

string

Listeners.member.N

One or more listeners.

true

Listener

LoadBalancerName

The unique name of the load balancer (32 alphanumeric or hyphen characters maximum, but cannot start or end with a hyphen).

true

string

Scheme

The type of load balancer. Use this parameter only for load balancers in a VPC. To create an internal load balancer, set this parameter to internal.

false

string

SecurityGroups.member.N

One or more security groups you want to assign to the load balancer. In a VPC, if this parameter is not specified, the default security group is assigned.

false

string

Subnets.member.N

One or more subnet IDs in your VPC to attach to the load balancer.

false

string

Tags.member.N

One or more tags assigned to the load balancer.

false

Tag

Responses
HTTP Code 200
HTTP Code Description Schema

200

CreateLoadBalancerOutput

Response 200

Response 200

Name Description Required Schema Default Example

DNSName

The DNS name of the load balancer.

false

string

ResponseMetadata

Information about the response.

false

ResponseMetadata