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

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)

ToQuery CreateLoadBalancer

Methods

toQuery :: CreateLoadBalancer -> QueryString

ToPath CreateLoadBalancer

Methods

toPath :: CreateLoadBalancer -> ByteString

ToHeaders CreateLoadBalancer

Methods

toHeaders :: CreateLoadBalancer -> [Header]

type Rep CreateLoadBalancer

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

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.

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

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.ELB.CreateLoadBalancer" "amazonka-elb-1.5.0-3ZJtYTLyhL9IxSfJq1CfvG" False) (C1 (MetaCons "CreateLoadBalancerResponse'" PrefixI True) ((:*:) (S1 (MetaSel (Just Symbol "_clbrsDNSName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_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.