| Copyright | (c) 2013-2015 Brendan Hay |
|---|---|
| License | Mozilla Public License, v. 2.0. |
| Maintainer | Brendan Hay <brendan.g.hay@gmail.com> |
| Stability | auto-generated |
| Portability | non-portable (GHC extensions) |
| Safe Haskell | None |
| Language | Haskell2010 |
Network.AWS.ELB.CreateLoadBalancer
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 load balancer receives incoming traffic and routes it to the registered instances. For more information, see How Elastic Load Balancing Works in the Elastic Load Balancing Developer Guide.
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 Load Balancing Developer Guide.
See: AWS API Reference for CreateLoadBalancer.
- createLoadBalancer :: Text -> CreateLoadBalancer
- data CreateLoadBalancer
- clbSecurityGroups :: Lens' CreateLoadBalancer [Text]
- clbSubnets :: Lens' CreateLoadBalancer [Text]
- clbAvailabilityZones :: Lens' CreateLoadBalancer [Text]
- clbScheme :: Lens' CreateLoadBalancer (Maybe Text)
- clbTags :: Lens' CreateLoadBalancer (Maybe (NonEmpty Tag))
- clbLoadBalancerName :: Lens' CreateLoadBalancer Text
- clbListeners :: Lens' CreateLoadBalancer [Listener]
- createLoadBalancerResponse :: Int -> CreateLoadBalancerResponse
- data CreateLoadBalancerResponse
- clbrsDNSName :: Lens' CreateLoadBalancerResponse (Maybe Text)
- clbrsResponseStatus :: Lens' CreateLoadBalancerResponse Int
Creating a Request
Arguments
| :: Text | |
| -> CreateLoadBalancer |
Creates a value of CreateLoadBalancer with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
data CreateLoadBalancer Source
See: createLoadBalancer smart constructor.
Instances
Request Lenses
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.
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.
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.
clbTags :: Lens' CreateLoadBalancer (Maybe (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.
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.
clbListeners :: Lens' CreateLoadBalancer [Listener] Source
The listeners.
For more information, see Listeners for Your Load Balancer in the Elastic Load Balancing Developer Guide.
Destructuring the Response
createLoadBalancerResponse Source
Arguments
| :: Int | |
| -> CreateLoadBalancerResponse |
Creates a value of CreateLoadBalancerResponse with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
data CreateLoadBalancerResponse Source
See: createLoadBalancerResponse smart constructor.
Response Lenses
clbrsDNSName :: Lens' CreateLoadBalancerResponse (Maybe Text) Source
The DNS name of the load balancer.
clbrsResponseStatus :: Lens' CreateLoadBalancerResponse Int Source
The response status code.