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 |
true |
string |
||
Listeners.member.N |
One or more listeners. |
true |
|||
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 |
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 |
Responses
HTTP Code 200
HTTP Code | Description | Schema |
---|---|---|
200 |
CreateLoadBalancerOutput |
Response 200
Name | Description | Required | Schema | Default | Example |
---|---|---|---|---|---|
DNSName |
The DNS name of the load balancer. |
false |
string |
||
ResponseMetadata |
Information about the response. |
false |