Network.AWS.ELBv2.CreateLoadBalancer

Creates an Application Load Balancer.

To create listeners for your load balancer, use CreateListener . You can add security groups, subnets, and tags when you create your load balancer, or you can add them later using SetSecurityGroups , SetSubnets , 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 Application Load Balancer in the Application Load Balancers Guide .

For more information, see Application Load Balancers in the Application Load Balancers Guide .

Creating a Request

createLoadBalancer

Arguments

:: Text

clbName

-> 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:

• clbSecurityGroups - The IDs of the security groups to assign to the load balancer.
• clbScheme - The nodes of an Internet-facing load balancer have public IP addresses. The DNS name of an Internet-facing load balancer is publicly resolvable to the public IP addresses of the nodes. Therefore, Internet-facing load balancers can route requests from clients over the Internet. The nodes of an internal load balancer have only private IP addresses. The DNS name of an internal load balancer is publicly resolvable to the private IP addresses of the nodes. Therefore, internal load balancers can only route requests from clients with access to the VPC for the load balancer. The default is an Internet-facing load balancer.
• clbTags - One or more tags to assign to the load balancer.
• clbName - The name of the load balancer. This name must be unique within your AWS account, can have a maximum of 32 characters, must contain only alphanumeric characters or hyphens, and must not begin or end with a hyphen.
• clbSubnets - The IDs of the subnets to attach to the load balancer. You can specify only one subnet per Availability Zone. You must specify subnets from at least two Availability Zones.

data CreateLoadBalancer

Contains the parameters for CreateLoadBalancer.

See: createLoadBalancer smart constructor.

Instances

Eq CreateLoadBalancer

Methods

(==) :: CreateLoadBalancer -> CreateLoadBalancer -> Bool

(/=) :: CreateLoadBalancer -> CreateLoadBalancer -> Bool

Data CreateLoadBalancer

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> CreateLoadBalancer -> c CreateLoadBalancer

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c CreateLoadBalancer

toConstr :: CreateLoadBalancer -> Constr

dataTypeOf :: CreateLoadBalancer -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c CreateLoadBalancer)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c CreateLoadBalancer)

gmapT :: (forall b. Data b => b -> b) -> CreateLoadBalancer -> CreateLoadBalancer

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> CreateLoadBalancer -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> CreateLoadBalancer -> r

gmapQ :: (forall d. Data d => d -> u) -> CreateLoadBalancer -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> CreateLoadBalancer -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> CreateLoadBalancer -> m CreateLoadBalancer

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> CreateLoadBalancer -> m CreateLoadBalancer

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> CreateLoadBalancer -> m CreateLoadBalancer

Read CreateLoadBalancer

Methods

readsPrec :: Int -> ReadS CreateLoadBalancer

readList :: ReadS [CreateLoadBalancer]

readPrec :: ReadPrec CreateLoadBalancer

readListPrec :: ReadPrec [CreateLoadBalancer]

Show CreateLoadBalancer

Methods

showsPrec :: Int -> CreateLoadBalancer -> ShowS

show :: CreateLoadBalancer -> String

showList :: [CreateLoadBalancer] -> ShowS

Generic CreateLoadBalancer

Associated Types

type Rep CreateLoadBalancer :: * -> *

Methods

from :: CreateLoadBalancer -> Rep CreateLoadBalancer x

to :: Rep CreateLoadBalancer x -> CreateLoadBalancer

Hashable CreateLoadBalancer

Methods

hashWithSalt :: Int -> CreateLoadBalancer -> Int

hash :: CreateLoadBalancer -> Int

NFData CreateLoadBalancer

Methods

rnf :: CreateLoadBalancer -> ()

AWSRequest CreateLoadBalancer

Associated Types

type Rs CreateLoadBalancer :: *

Methods

request :: CreateLoadBalancer -> Request CreateLoadBalancer

response :: MonadResource m => Logger -> Service -> Proxy * CreateLoadBalancer -> ClientResponse -> m (Response CreateLoadBalancer)

ToPath CreateLoadBalancer

Methods

toPath :: CreateLoadBalancer -> ByteString

ToHeaders CreateLoadBalancer

Methods

toHeaders :: CreateLoadBalancer -> [Header]

ToQuery CreateLoadBalancer

Methods

toQuery :: CreateLoadBalancer -> QueryString

type Rep CreateLoadBalancer

type Rep CreateLoadBalancer = D1 (MetaData "CreateLoadBalancer" "Network.AWS.ELBv2.CreateLoadBalancer" "amazonka-elbv2-1.4.5-J8ZeSE6X9TjH6Y7FrPuIXa" False) (C1 (MetaCons "CreateLoadBalancer'" PrefixI True) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_clbSecurityGroups") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [Text]))) (S1 (MetaSel (Just Symbol "_clbScheme") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe LoadBalancerSchemeEnum)))) ((:*:) (S1 (MetaSel (Just Symbol "_clbTags") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe (List1 Tag)))) ((:*:) (S1 (MetaSel (Just Symbol "_clbName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text)) (S1 (MetaSel (Just Symbol "_clbSubnets") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 [Text]))))))

type Rs CreateLoadBalancer

type Rs CreateLoadBalancer = CreateLoadBalancerResponse

Request Lenses

clbSecurityGroups :: Lens' CreateLoadBalancer [Text]

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

clbScheme :: Lens' CreateLoadBalancer (Maybe LoadBalancerSchemeEnum)

The nodes of an Internet-facing load balancer have public IP addresses. The DNS name of an Internet-facing load balancer is publicly resolvable to the public IP addresses of the nodes. Therefore, Internet-facing load balancers can route requests from clients over the Internet. The nodes of an internal load balancer have only private IP addresses. The DNS name of an internal load balancer is publicly resolvable to the private IP addresses of the nodes. Therefore, internal load balancers can only route requests from clients with access to the VPC for the load balancer. The default is an Internet-facing load balancer.

clbTags :: Lens' CreateLoadBalancer (Maybe (NonEmpty Tag))

One or more tags to assign to the load balancer.

clbName :: Lens' CreateLoadBalancer Text

The name of the load balancer. This name must be unique within your AWS account, can have a maximum of 32 characters, must contain only alphanumeric characters or hyphens, and must not begin or end with a hyphen.

clbSubnets :: Lens' CreateLoadBalancer [Text]

The IDs of the subnets to attach to the load balancer. You can specify only one subnet per Availability Zone. You must specify subnets from at least two Availability Zones.

Destructuring the Response

createLoadBalancerResponse

Arguments

:: Int

clbrsResponseStatus

-> 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:

• clbrsLoadBalancers - Information about the load balancer.
• clbrsResponseStatus - -- | The response status code.

data CreateLoadBalancerResponse

Contains the output of CreateLoadBalancer.

See: createLoadBalancerResponse smart constructor.

Instances

Eq CreateLoadBalancerResponse

Methods

(==) :: CreateLoadBalancerResponse -> CreateLoadBalancerResponse -> Bool

(/=) :: CreateLoadBalancerResponse -> CreateLoadBalancerResponse -> Bool

Data CreateLoadBalancerResponse

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> CreateLoadBalancerResponse -> c CreateLoadBalancerResponse

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c CreateLoadBalancerResponse

toConstr :: CreateLoadBalancerResponse -> Constr

dataTypeOf :: CreateLoadBalancerResponse -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c CreateLoadBalancerResponse)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c CreateLoadBalancerResponse)

gmapT :: (forall b. Data b => b -> b) -> CreateLoadBalancerResponse -> CreateLoadBalancerResponse

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> CreateLoadBalancerResponse -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> CreateLoadBalancerResponse -> r

gmapQ :: (forall d. Data d => d -> u) -> CreateLoadBalancerResponse -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> CreateLoadBalancerResponse -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> CreateLoadBalancerResponse -> m CreateLoadBalancerResponse

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> CreateLoadBalancerResponse -> m CreateLoadBalancerResponse

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> CreateLoadBalancerResponse -> m CreateLoadBalancerResponse

Read CreateLoadBalancerResponse

Methods

readsPrec :: Int -> ReadS CreateLoadBalancerResponse

readList :: ReadS [CreateLoadBalancerResponse]

readPrec :: ReadPrec CreateLoadBalancerResponse

readListPrec :: ReadPrec [CreateLoadBalancerResponse]

Show CreateLoadBalancerResponse

Methods

showsPrec :: Int -> CreateLoadBalancerResponse -> ShowS

show :: CreateLoadBalancerResponse -> String

showList :: [CreateLoadBalancerResponse] -> ShowS

Generic CreateLoadBalancerResponse

Associated Types

type Rep CreateLoadBalancerResponse :: * -> *

Methods

from :: CreateLoadBalancerResponse -> Rep CreateLoadBalancerResponse x

to :: Rep CreateLoadBalancerResponse x -> CreateLoadBalancerResponse

NFData CreateLoadBalancerResponse

Methods

rnf :: CreateLoadBalancerResponse -> ()

type Rep CreateLoadBalancerResponse

type Rep CreateLoadBalancerResponse = D1 (MetaData "CreateLoadBalancerResponse" "Network.AWS.ELBv2.CreateLoadBalancer" "amazonka-elbv2-1.4.5-J8ZeSE6X9TjH6Y7FrPuIXa" False) (C1 (MetaCons "CreateLoadBalancerResponse'" PrefixI True) ((:*:) (S1 (MetaSel (Just Symbol "_clbrsLoadBalancers") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [LoadBalancer]))) (S1 (MetaSel (Just Symbol "_clbrsResponseStatus") NoSourceUnpackedness SourceStrict DecidedUnpack) (Rec0 Int))))

Response Lenses

clbrsLoadBalancers :: Lens' CreateLoadBalancerResponse [LoadBalancer]

Information about the load balancer.

clbrsResponseStatus :: Lens' CreateLoadBalancerResponse Int

• - | The response status code.