Network.AWS.ELB.CreateLoadBalancer

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 Balancer Guide .

Creating a Request

createLoadBalancer

Arguments

:: Text

clbLoadBalancerName

-> 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.
• clbSubnets - The IDs of the subnets in your VPC to attach to the load balancer. Specify one subnet per Availability Zone specified in AvailabilityZones .
• clbAvailabilityZones - 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 .
• clbScheme - 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.
• clbTags - 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 Balancer Guide .
• clbLoadBalancerName - 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.
• clbListeners - The listeners. For more information, see Listeners for Your Classic Load Balancer in the Classic Load Balancer Guide .

data CreateLoadBalancer

Contains the parameters for CreateLoadBalancer.

See: createLoadBalancer smart constructor.

Instances

Eq CreateLoadBalancer

Defined in Network.AWS.ELB.CreateLoadBalancer

Methods

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

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

Data CreateLoadBalancer

Defined in Network.AWS.ELB.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

Defined in Network.AWS.ELB.CreateLoadBalancer

Methods

readsPrec :: Int -> ReadS CreateLoadBalancer

readList :: ReadS [CreateLoadBalancer]

readPrec :: ReadPrec CreateLoadBalancer

readListPrec :: ReadPrec [CreateLoadBalancer]

Show CreateLoadBalancer

Defined in Network.AWS.ELB.CreateLoadBalancer

Methods

showsPrec :: Int -> CreateLoadBalancer -> ShowS

show :: CreateLoadBalancer -> String

showList :: [CreateLoadBalancer] -> ShowS

Generic CreateLoadBalancer

Defined in Network.AWS.ELB.CreateLoadBalancer

Associated Types

type Rep CreateLoadBalancer :: Type -> Type

Methods

from :: CreateLoadBalancer -> Rep CreateLoadBalancer x

to :: Rep CreateLoadBalancer x -> CreateLoadBalancer

Hashable CreateLoadBalancer

Defined in Network.AWS.ELB.CreateLoadBalancer

Methods

hashWithSalt :: Int -> CreateLoadBalancer -> Int

hash :: CreateLoadBalancer -> Int

AWSRequest CreateLoadBalancer

Defined in Network.AWS.ELB.CreateLoadBalancer

Associated Types

type Rs CreateLoadBalancer :: Type

Methods

request :: CreateLoadBalancer -> Request CreateLoadBalancer

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

ToHeaders CreateLoadBalancer

Defined in Network.AWS.ELB.CreateLoadBalancer

Methods

toHeaders :: CreateLoadBalancer -> [Header]

ToPath CreateLoadBalancer

Defined in Network.AWS.ELB.CreateLoadBalancer

Methods

toPath :: CreateLoadBalancer -> ByteString

ToQuery CreateLoadBalancer

Defined in Network.AWS.ELB.CreateLoadBalancer

Methods

toQuery :: CreateLoadBalancer -> QueryString

NFData CreateLoadBalancer

Defined in Network.AWS.ELB.CreateLoadBalancer

Methods

rnf :: CreateLoadBalancer -> ()

type Rep CreateLoadBalancer

Defined in Network.AWS.ELB.CreateLoadBalancer

type Rep CreateLoadBalancer = D1 (MetaData "CreateLoadBalancer" "Network.AWS.ELB.CreateLoadBalancer" "amazonka-elb-1.6.1-Ih5hIKrYl5yJOuBwSBSzZS" False) (C1 (MetaCons "CreateLoadBalancer'" PrefixI True) ((S1 (MetaSel (Just "_clbSecurityGroups") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [Text])) :*: (S1 (MetaSel (Just "_clbSubnets") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [Text])) :*: S1 (MetaSel (Just "_clbAvailabilityZones") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [Text])))) :*: ((S1 (MetaSel (Just "_clbScheme") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :*: S1 (MetaSel (Just "_clbTags") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe (List1 Tag)))) :*: (S1 (MetaSel (Just "_clbLoadBalancerName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text) :*: S1 (MetaSel (Just "_clbListeners") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 [Listener])))))

type Rs CreateLoadBalancer

Defined in Network.AWS.ELB.CreateLoadBalancer

type Rs CreateLoadBalancer = CreateLoadBalancerResponse

Request Lenses

clbSecurityGroups :: Lens' CreateLoadBalancer [Text]

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

clbSubnets :: Lens' CreateLoadBalancer [Text]

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]

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 .

clbScheme :: Lens' CreateLoadBalancer (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.

clbTags :: Lens' CreateLoadBalancer (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 Balancer Guide .

clbLoadBalancerName :: Lens' CreateLoadBalancer 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.

clbListeners :: Lens' CreateLoadBalancer [Listener]

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

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:

• clbrsDNSName - The DNS name of the load balancer.
• clbrsResponseStatus - -- | The response status code.

data CreateLoadBalancerResponse

Contains the output for CreateLoadBalancer.

See: createLoadBalancerResponse smart constructor.

Instances

Eq CreateLoadBalancerResponse

Defined in Network.AWS.ELB.CreateLoadBalancer

Methods

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

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

Data CreateLoadBalancerResponse

Defined in Network.AWS.ELB.CreateLoadBalancer

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

Defined in Network.AWS.ELB.CreateLoadBalancer

Methods

readsPrec :: Int -> ReadS CreateLoadBalancerResponse

readList :: ReadS [CreateLoadBalancerResponse]

readPrec :: ReadPrec CreateLoadBalancerResponse

readListPrec :: ReadPrec [CreateLoadBalancerResponse]

Show CreateLoadBalancerResponse

Defined in Network.AWS.ELB.CreateLoadBalancer

Methods

showsPrec :: Int -> CreateLoadBalancerResponse -> ShowS

show :: CreateLoadBalancerResponse -> String

showList :: [CreateLoadBalancerResponse] -> ShowS

Generic CreateLoadBalancerResponse

Defined in Network.AWS.ELB.CreateLoadBalancer

Associated Types

type Rep CreateLoadBalancerResponse :: Type -> Type

Methods

from :: CreateLoadBalancerResponse -> Rep CreateLoadBalancerResponse x

to :: Rep CreateLoadBalancerResponse x -> CreateLoadBalancerResponse

NFData CreateLoadBalancerResponse

Defined in Network.AWS.ELB.CreateLoadBalancer

Methods

rnf :: CreateLoadBalancerResponse -> ()

type Rep CreateLoadBalancerResponse

Defined in Network.AWS.ELB.CreateLoadBalancer

type Rep CreateLoadBalancerResponse = D1 (MetaData "CreateLoadBalancerResponse" "Network.AWS.ELB.CreateLoadBalancer" "amazonka-elb-1.6.1-Ih5hIKrYl5yJOuBwSBSzZS" False) (C1 (MetaCons "CreateLoadBalancerResponse'" PrefixI True) (S1 (MetaSel (Just "_clbrsDNSName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :*: S1 (MetaSel (Just "_clbrsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Int)))

Response Lenses

clbrsDNSName :: Lens' CreateLoadBalancerResponse (Maybe Text)

The DNS name of the load balancer.

clbrsResponseStatus :: Lens' CreateLoadBalancerResponse Int

• - | The response status code.