amazonka-elb-0.3.5: Amazon Elastic Load Balancing SDK.

Safe HaskellNone
LanguageHaskell2010

Network.AWS.ELB.CreateLoadBalancer

Contents

Description

Creates a load balancer.

If the call completes successfully, a new load balancer is created with a unique Domain Name Service (DNS) name. The DNS name includes the name of the AWS region in which the load balancer was created. For example, the DNS name might end with either of the following:

'us-east-1.elb.amazonaws.com' 'us-west-2.elb.amazonaws.com' For information about the AWS regions supported by Elastic Load Balancing, see Regions and Endpoints in the Amazon Web Services General Reference.

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 Elastic Load Balancing Limits in the Elastic LoadBalancing Developer Guide.

Elastic Load Balancing supports load balancing your EC2 instances launched in either the EC2-Classic or EC2-VPC platform. For more information, see Elastic Load Balancing in EC2-Classic or Elastic Load Balancing in a VPC in the Elastic Load Balancing DeveloperGuide.

http://docs.aws.amazon.com/ElasticLoadBalancing/latest/APIReference/API_CreateLoadBalancer.html

Synopsis

Request

Request constructor

Request lenses

clbAvailabilityZones :: Lens' CreateLoadBalancer [Text] Source

One or more Availability Zones from the same region as the load balancer. Traffic is equally distributed across all specified Availability Zones.

You must specify at least one Availability Zone.

You can add more Availability Zones after you create the load balancer using EnableAvailabilityZonesForLoadBalancer.

clbListeners :: Lens' CreateLoadBalancer [Listener] Source

The listeners.

For more information, see Listener Configurations for Elastic Load Balancing in the Elastic Load Balancing Developer Guide.

clbLoadBalancerName :: Lens' CreateLoadBalancer Text Source

The name of the load balancer.

This name must be unique within your AWS account, must have a maximum of 32 characters, must contain only alphanumeric characters or hyphens, and cannot begin or end with a hyphen.

clbScheme :: Lens' CreateLoadBalancer (Maybe Text) Source

The type of a load balancer. Valid only for load balancers in a VPC.

By default, Elastic Load Balancing creates an Internet-facing load balancer with a publicly resolvable DNS name, which resolves to public IP addresses. For more information about Internet-facing and Internal load balancers, see Internet-facing and Internal Load Balancers in the Elastic Load Balancing Developer Guide.

Specify internal to create an internal load balancer with a DNS name that resolves to private IP addresses.

clbSecurityGroups :: Lens' CreateLoadBalancer [Text] Source

The IDs of the security groups to assign to the load balancer.

clbSubnets :: Lens' CreateLoadBalancer [Text] Source

The IDs of the subnets in your VPC to attach to the load balancer. Specify one subnet per Availability Zone specified in AvailabilityZones.

clbTags :: Lens' CreateLoadBalancer (NonEmpty Tag) Source

A list of tags to assign to the load balancer.

For more information about tagging your load balancer, see Tagging in the Elastic Load Balancing Developer Guide.

Response

Response constructor

createLoadBalancerResponse :: CreateLoadBalancerResponse Source

CreateLoadBalancerResponse constructor.

The fields accessible through corresponding lenses are:

Response lenses

clbrDNSName :: Lens' CreateLoadBalancerResponse (Maybe Text) Source

The DNS name of the load balancer.