Network.AWS.ELBv2.CreateListener

Creates a listener for the specified Application Load Balancer or Network Load Balancer.

To update a listener, use ModifyListener . When you are finished with a listener, you can delete it using DeleteListener . If you are finished with both the listener and the load balancer, you can delete them both using DeleteLoadBalancer .

This operation is idempotent, which means that it completes at most one time. If you attempt to create multiple listeners with the same settings, each call succeeds.

For more information, see Listeners for Your Application Load Balancers in the Application Load Balancers Guide and Listeners for Your Network Load Balancers in the Network Load Balancers Guide .

Creating a Request

createListener

Arguments

:: Text

clLoadBalancerARN

-> ProtocolEnum

clProtocol

-> Natural

clPort

-> CreateListener

Creates a value of CreateListener with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• clSSLPolicy - [HTTPS listeners] The security policy that defines which ciphers and protocols are supported. The default is the current predefined security policy.
• clCertificates - [HTTPS listeners] The SSL server certificate. You must provide exactly one certificate.
• clLoadBalancerARN - The Amazon Resource Name (ARN) of the load balancer.
• clProtocol - The protocol for connections from clients to the load balancer. For Application Load Balancers, the supported protocols are HTTP and HTTPS. For Network Load Balancers, the supported protocol is TCP.
• clPort - The port on which the load balancer is listening.
• clDefaultActions - The default action for the listener. For Application Load Balancers, the protocol of the specified target group must be HTTP or HTTPS. For Network Load Balancers, the protocol of the specified target group must be TCP.

data CreateListener

See: createListener smart constructor.

Instances

Eq CreateListener

Defined in Network.AWS.ELBv2.CreateListener

Methods

(==) :: CreateListener -> CreateListener -> Bool

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

Data CreateListener

Defined in Network.AWS.ELBv2.CreateListener

Methods

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

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

toConstr :: CreateListener -> Constr

dataTypeOf :: CreateListener -> DataType

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

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

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

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

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

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

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

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

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

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

Read CreateListener

Defined in Network.AWS.ELBv2.CreateListener

Methods

readsPrec :: Int -> ReadS CreateListener

readList :: ReadS [CreateListener]

readPrec :: ReadPrec CreateListener

readListPrec :: ReadPrec [CreateListener]

Show CreateListener

Defined in Network.AWS.ELBv2.CreateListener

Methods

showsPrec :: Int -> CreateListener -> ShowS

show :: CreateListener -> String

showList :: [CreateListener] -> ShowS

Generic CreateListener

Defined in Network.AWS.ELBv2.CreateListener

Associated Types

type Rep CreateListener :: Type -> Type

Methods

from :: CreateListener -> Rep CreateListener x

to :: Rep CreateListener x -> CreateListener

Hashable CreateListener

Defined in Network.AWS.ELBv2.CreateListener

Methods

hashWithSalt :: Int -> CreateListener -> Int

hash :: CreateListener -> Int

AWSRequest CreateListener

Defined in Network.AWS.ELBv2.CreateListener

Associated Types

type Rs CreateListener :: Type

Methods

request :: CreateListener -> Request CreateListener

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

ToHeaders CreateListener

Defined in Network.AWS.ELBv2.CreateListener

Methods

toHeaders :: CreateListener -> [Header]

ToPath CreateListener

Defined in Network.AWS.ELBv2.CreateListener

Methods

toPath :: CreateListener -> ByteString

ToQuery CreateListener

Defined in Network.AWS.ELBv2.CreateListener

Methods

toQuery :: CreateListener -> QueryString

NFData CreateListener

Defined in Network.AWS.ELBv2.CreateListener

Methods

rnf :: CreateListener -> ()

type Rep CreateListener

Defined in Network.AWS.ELBv2.CreateListener

type Rep CreateListener = D1 (MetaData "CreateListener" "Network.AWS.ELBv2.CreateListener" "amazonka-elbv2-1.6.1-E4uu6EqNDMk4f08ZYDVKwx" False) (C1 (MetaCons "CreateListener'" PrefixI True) ((S1 (MetaSel (Just "_clSSLPolicy") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 (MetaSel (Just "_clCertificates") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [Certificate])) :*: S1 (MetaSel (Just "_clLoadBalancerARN") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text))) :*: (S1 (MetaSel (Just "_clProtocol") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 ProtocolEnum) :*: (S1 (MetaSel (Just "_clPort") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Nat) :*: S1 (MetaSel (Just "_clDefaultActions") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 [Action])))))

type Rs CreateListener

Defined in Network.AWS.ELBv2.CreateListener

type Rs CreateListener = CreateListenerResponse

Request Lenses

clSSLPolicy :: Lens' CreateListener (Maybe Text)

HTTPS listeners

The security policy that defines which ciphers and protocols are supported. The default is the current predefined security policy.

clCertificates :: Lens' CreateListener [Certificate]

HTTPS listeners

The SSL server certificate. You must provide exactly one certificate.

clLoadBalancerARN :: Lens' CreateListener Text

The Amazon Resource Name (ARN) of the load balancer.

clProtocol :: Lens' CreateListener ProtocolEnum

The protocol for connections from clients to the load balancer. For Application Load Balancers, the supported protocols are HTTP and HTTPS. For Network Load Balancers, the supported protocol is TCP.

clPort :: Lens' CreateListener Natural

The port on which the load balancer is listening.

clDefaultActions :: Lens' CreateListener [Action]

The default action for the listener. For Application Load Balancers, the protocol of the specified target group must be HTTP or HTTPS. For Network Load Balancers, the protocol of the specified target group must be TCP.

Destructuring the Response

createListenerResponse

Arguments

:: Int

clrsResponseStatus

-> CreateListenerResponse

Creates a value of CreateListenerResponse with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• clrsListeners - Information about the listener.
• clrsResponseStatus - -- | The response status code.

data CreateListenerResponse

See: createListenerResponse smart constructor.

Instances

Eq CreateListenerResponse

Defined in Network.AWS.ELBv2.CreateListener

Methods

(==) :: CreateListenerResponse -> CreateListenerResponse -> Bool

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

Data CreateListenerResponse

Defined in Network.AWS.ELBv2.CreateListener

Methods

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

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

toConstr :: CreateListenerResponse -> Constr

dataTypeOf :: CreateListenerResponse -> DataType

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

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

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

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

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

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

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

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

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

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

Read CreateListenerResponse

Defined in Network.AWS.ELBv2.CreateListener

Methods

readsPrec :: Int -> ReadS CreateListenerResponse

readList :: ReadS [CreateListenerResponse]

readPrec :: ReadPrec CreateListenerResponse

readListPrec :: ReadPrec [CreateListenerResponse]

Show CreateListenerResponse

Defined in Network.AWS.ELBv2.CreateListener

Methods

showsPrec :: Int -> CreateListenerResponse -> ShowS

show :: CreateListenerResponse -> String

showList :: [CreateListenerResponse] -> ShowS

Generic CreateListenerResponse

Defined in Network.AWS.ELBv2.CreateListener

Associated Types

type Rep CreateListenerResponse :: Type -> Type

Methods

from :: CreateListenerResponse -> Rep CreateListenerResponse x

to :: Rep CreateListenerResponse x -> CreateListenerResponse

NFData CreateListenerResponse

Defined in Network.AWS.ELBv2.CreateListener

Methods

rnf :: CreateListenerResponse -> ()

type Rep CreateListenerResponse

Defined in Network.AWS.ELBv2.CreateListener

type Rep CreateListenerResponse = D1 (MetaData "CreateListenerResponse" "Network.AWS.ELBv2.CreateListener" "amazonka-elbv2-1.6.1-E4uu6EqNDMk4f08ZYDVKwx" False) (C1 (MetaCons "CreateListenerResponse'" PrefixI True) (S1 (MetaSel (Just "_clrsListeners") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [Listener])) :*: S1 (MetaSel (Just "_clrsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Int)))

Response Lenses

clrsListeners :: Lens' CreateListenerResponse [Listener]

Information about the listener.

clrsResponseStatus :: Lens' CreateListenerResponse Int

• - | The response status code.