Copyright	(c) 2013-2021 Brendan Hay
License	Mozilla Public License, v. 2.0.
Maintainer	Brendan Hay <brendan.g.hay+amazonka@gmail.com>
Stability	auto-generated
Portability	non-portable (GHC extensions)
Safe Haskell	None

Amazonka.ELB.CreateLoadBalancer

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

Creates a Classic Load Balancer.

You can add listeners, security groups, subnets, and tags when you create your load balancer, or you can add them later using CreateLoadBalancerListeners, ApplySecurityGroupsToLoadBalancer, AttachLoadBalancerToSubnets, and AddTags.

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 Classic Load Balancer in the Classic Load Balancers Guide.

Synopsis

data CreateLoadBalancer = CreateLoadBalancer' {
- securityGroups :: Maybe [Text]
- subnets :: Maybe [Text]
- availabilityZones :: Maybe [Text]
- scheme :: Maybe Text
- tags :: Maybe (NonEmpty Tag)
- loadBalancerName :: Text
- listeners :: [Listener]
}
newCreateLoadBalancer :: Text -> CreateLoadBalancer
createLoadBalancer_securityGroups :: Lens' CreateLoadBalancer (Maybe [Text])
createLoadBalancer_subnets :: Lens' CreateLoadBalancer (Maybe [Text])
createLoadBalancer_availabilityZones :: Lens' CreateLoadBalancer (Maybe [Text])
createLoadBalancer_scheme :: Lens' CreateLoadBalancer (Maybe Text)
createLoadBalancer_tags :: Lens' CreateLoadBalancer (Maybe (NonEmpty Tag))
createLoadBalancer_loadBalancerName :: Lens' CreateLoadBalancer Text
createLoadBalancer_listeners :: Lens' CreateLoadBalancer [Listener]
data CreateLoadBalancerResponse = CreateLoadBalancerResponse' {
- dNSName :: Maybe Text
- httpStatus :: Int
}
newCreateLoadBalancerResponse :: Int -> CreateLoadBalancerResponse
createLoadBalancerResponse_dNSName :: Lens' CreateLoadBalancerResponse (Maybe Text)
createLoadBalancerResponse_httpStatus :: Lens' CreateLoadBalancerResponse Int

Creating a Request

data CreateLoadBalancer Source #

Contains the parameters for CreateLoadBalancer.

See: newCreateLoadBalancer smart constructor.

Constructors

CreateLoadBalancer'

Fields

securityGroups :: Maybe [Text]
The IDs of the security groups to assign to the load balancer.
subnets :: Maybe [Text]
The IDs of the subnets in your VPC to attach to the load balancer. Specify one subnet per Availability Zone specified in AvailabilityZones.
availabilityZones :: Maybe [Text]
One or more Availability Zones from the same region as the load balancer.
You must specify at least one Availability Zone.
You can add more Availability Zones after you create the load balancer using EnableAvailabilityZonesForLoadBalancer.
scheme :: Maybe Text
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 DNS name that resolves to public IP addresses. For more information about Internet-facing and Internal load balancers, see Load Balancer Scheme in the Elastic Load Balancing User Guide.
Specify internal to create a load balancer with a DNS name that resolves to private IP addresses.
tags :: Maybe (NonEmpty Tag)
A list of tags to assign to the load balancer.
For more information about tagging your load balancer, see Tag Your Classic Load Balancer in the Classic Load Balancers Guide.
loadBalancerName :: Text
The name of the load balancer.
This name must be unique within your set of load balancers for the region, must have a maximum of 32 characters, must contain only alphanumeric characters or hyphens, and cannot begin or end with a hyphen.
listeners :: [Listener]
The listeners.
For more information, see Listeners for Your Classic Load Balancer in the Classic Load Balancers Guide.

Instances

Instances details

Eq CreateLoadBalancer Source #
Instance details Defined in Amazonka.ELB.CreateLoadBalancer Methods (==) :: CreateLoadBalancer -> CreateLoadBalancer -> Bool # (/=) :: CreateLoadBalancer -> CreateLoadBalancer -> Bool #
Read CreateLoadBalancer Source #
Instance details Defined in Amazonka.ELB.CreateLoadBalancer Methods readsPrec :: Int -> ReadS CreateLoadBalancer # readList :: ReadS [CreateLoadBalancer] # readPrec :: ReadPrec CreateLoadBalancer # readListPrec :: ReadPrec [CreateLoadBalancer] #
Show CreateLoadBalancer Source #
Instance details Defined in Amazonka.ELB.CreateLoadBalancer Methods showsPrec :: Int -> CreateLoadBalancer -> ShowS # show :: CreateLoadBalancer -> String # showList :: [CreateLoadBalancer] -> ShowS #
Generic CreateLoadBalancer Source #
Instance details Defined in Amazonka.ELB.CreateLoadBalancer Associated Types type Rep CreateLoadBalancer :: Type -> Type # Methods from :: CreateLoadBalancer -> Rep CreateLoadBalancer x # to :: Rep CreateLoadBalancer x -> CreateLoadBalancer #
NFData CreateLoadBalancer Source #
Instance details Defined in Amazonka.ELB.CreateLoadBalancer Methods rnf :: CreateLoadBalancer -> () #
Hashable CreateLoadBalancer Source #
Instance details Defined in Amazonka.ELB.CreateLoadBalancer Methods hashWithSalt :: Int -> CreateLoadBalancer -> Int # hash :: CreateLoadBalancer -> Int #
AWSRequest CreateLoadBalancer Source #
Instance details Defined in Amazonka.ELB.CreateLoadBalancer Associated Types type AWSResponse CreateLoadBalancer # Methods request :: CreateLoadBalancer -> Request CreateLoadBalancer # response :: MonadResource m => Logger -> Service -> Proxy CreateLoadBalancer -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse CreateLoadBalancer))) #
ToHeaders CreateLoadBalancer Source #
Instance details Defined in Amazonka.ELB.CreateLoadBalancer Methods toHeaders :: CreateLoadBalancer -> [Header] #
ToPath CreateLoadBalancer Source #
Instance details Defined in Amazonka.ELB.CreateLoadBalancer Methods toPath :: CreateLoadBalancer -> ByteString #
ToQuery CreateLoadBalancer Source #
Instance details Defined in Amazonka.ELB.CreateLoadBalancer Methods toQuery :: CreateLoadBalancer -> QueryString #
type Rep CreateLoadBalancer Source #
Instance details Defined in Amazonka.ELB.CreateLoadBalancer type Rep CreateLoadBalancer = D1 ('MetaData "CreateLoadBalancer" "Amazonka.ELB.CreateLoadBalancer" "libZSservicesZSamazonka-elbZSamazonka-elb" 'False) (C1 ('MetaCons "CreateLoadBalancer'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "securityGroups") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Text])) :: (S1 ('MetaSel ('Just "subnets") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Text])) :: S1 ('MetaSel ('Just "availabilityZones") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Text])))) :: ((S1 ('MetaSel ('Just "scheme") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "tags") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe (NonEmpty Tag)))) :: (S1 ('MetaSel ('Just "loadBalancerName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :: S1 ('MetaSel ('Just "listeners") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 [Listener])))))
type AWSResponse CreateLoadBalancer Source #
Instance details Defined in Amazonka.ELB.CreateLoadBalancer type AWSResponse CreateLoadBalancer = CreateLoadBalancerResponse

newCreateLoadBalancer Source #

Arguments

:: Text	`$sel:loadBalancerName:CreateLoadBalancer'`
-> CreateLoadBalancer

Create a value of CreateLoadBalancer with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:securityGroups:CreateLoadBalancer', createLoadBalancer_securityGroups - The IDs of the security groups to assign to the load balancer.

$sel:subnets:CreateLoadBalancer', createLoadBalancer_subnets - The IDs of the subnets in your VPC to attach to the load balancer. Specify one subnet per Availability Zone specified in AvailabilityZones.

$sel:availabilityZones:CreateLoadBalancer', createLoadBalancer_availabilityZones - One or more Availability Zones from the same region as the load balancer.

You must specify at least one Availability Zone.

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

$sel:scheme:CreateLoadBalancer', createLoadBalancer_scheme - 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 DNS name that resolves to public IP addresses. For more information about Internet-facing and Internal load balancers, see Load Balancer Scheme in the Elastic Load Balancing User Guide.

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

$sel:tags:CreateLoadBalancer', createLoadBalancer_tags - A list of tags to assign to the load balancer.

For more information about tagging your load balancer, see Tag Your Classic Load Balancer in the Classic Load Balancers Guide.

$sel:loadBalancerName:CreateLoadBalancer', createLoadBalancer_loadBalancerName - The name of the load balancer.

This name must be unique within your set of load balancers for the region, must have a maximum of 32 characters, must contain only alphanumeric characters or hyphens, and cannot begin or end with a hyphen.

$sel:listeners:CreateLoadBalancer', createLoadBalancer_listeners - The listeners.

For more information, see Listeners for Your Classic Load Balancer in the Classic Load Balancers Guide.

Request Lenses

createLoadBalancer_securityGroups :: Lens' CreateLoadBalancer (Maybe [Text]) Source #

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

createLoadBalancer_subnets :: Lens' CreateLoadBalancer (Maybe [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.

createLoadBalancer_availabilityZones :: Lens' CreateLoadBalancer (Maybe [Text]) Source #

One or more Availability Zones from the same region as the load balancer.

You must specify at least one Availability Zone.

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

createLoadBalancer_scheme :: 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 DNS name that resolves to public IP addresses. For more information about Internet-facing and Internal load balancers, see Load Balancer Scheme in the Elastic Load Balancing User Guide.

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

createLoadBalancer_tags :: 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 Tag Your Classic Load Balancer in the Classic Load Balancers Guide.

createLoadBalancer_loadBalancerName :: Lens' CreateLoadBalancer Text Source #

The name of the load balancer.

This name must be unique within your set of load balancers for the region, must have a maximum of 32 characters, must contain only alphanumeric characters or hyphens, and cannot begin or end with a hyphen.

createLoadBalancer_listeners :: Lens' CreateLoadBalancer [Listener] Source #

The listeners.

For more information, see Listeners for Your Classic Load Balancer in the Classic Load Balancers Guide.

Destructuring the Response

data CreateLoadBalancerResponse Source #

Contains the output for CreateLoadBalancer.

See: newCreateLoadBalancerResponse smart constructor.

Constructors

CreateLoadBalancerResponse'
Fields dNSName :: Maybe Text The DNS name of the load balancer. httpStatus :: Int The response's http status code.

Instances

Instances details

Eq CreateLoadBalancerResponse Source #
Instance details Defined in Amazonka.ELB.CreateLoadBalancer Methods (==) :: CreateLoadBalancerResponse -> CreateLoadBalancerResponse -> Bool # (/=) :: CreateLoadBalancerResponse -> CreateLoadBalancerResponse -> Bool #
Read CreateLoadBalancerResponse Source #
Instance details Defined in Amazonka.ELB.CreateLoadBalancer Methods readsPrec :: Int -> ReadS CreateLoadBalancerResponse # readList :: ReadS [CreateLoadBalancerResponse] # readPrec :: ReadPrec CreateLoadBalancerResponse # readListPrec :: ReadPrec [CreateLoadBalancerResponse] #
Show CreateLoadBalancerResponse Source #
Instance details Defined in Amazonka.ELB.CreateLoadBalancer Methods showsPrec :: Int -> CreateLoadBalancerResponse -> ShowS # show :: CreateLoadBalancerResponse -> String # showList :: [CreateLoadBalancerResponse] -> ShowS #
Generic CreateLoadBalancerResponse Source #
Instance details Defined in Amazonka.ELB.CreateLoadBalancer Associated Types type Rep CreateLoadBalancerResponse :: Type -> Type # Methods from :: CreateLoadBalancerResponse -> Rep CreateLoadBalancerResponse x # to :: Rep CreateLoadBalancerResponse x -> CreateLoadBalancerResponse #
NFData CreateLoadBalancerResponse Source #
Instance details Defined in Amazonka.ELB.CreateLoadBalancer Methods rnf :: CreateLoadBalancerResponse -> () #
type Rep CreateLoadBalancerResponse Source #
Instance details Defined in Amazonka.ELB.CreateLoadBalancer type Rep CreateLoadBalancerResponse = D1 ('MetaData "CreateLoadBalancerResponse" "Amazonka.ELB.CreateLoadBalancer" "libZSservicesZSamazonka-elbZSamazonka-elb" 'False) (C1 ('MetaCons "CreateLoadBalancerResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "dNSName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))

newCreateLoadBalancerResponse Source #

Arguments

:: Int	`$sel:httpStatus:CreateLoadBalancerResponse'`
-> CreateLoadBalancerResponse

Create a value of CreateLoadBalancerResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:dNSName:CreateLoadBalancerResponse', createLoadBalancerResponse_dNSName - The DNS name of the load balancer.

$sel:httpStatus:CreateLoadBalancerResponse', createLoadBalancerResponse_httpStatus - The response's http status code.

Response Lenses

createLoadBalancerResponse_dNSName :: Lens' CreateLoadBalancerResponse (Maybe Text) Source #

The DNS name of the load balancer.

createLoadBalancerResponse_httpStatus :: Lens' CreateLoadBalancerResponse Int Source #

The response's http status code.