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

Methods

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

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

Data 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

Methods

readsPrec :: Int -> ReadS CreateListener

readList :: ReadS [CreateListener]

readPrec :: ReadPrec CreateListener

readListPrec :: ReadPrec [CreateListener]

Show CreateListener

Methods

showsPrec :: Int -> CreateListener -> ShowS

show :: CreateListener -> String

showList :: [CreateListener] -> ShowS

Generic CreateListener

Associated Types

type Rep CreateListener :: * -> *

Methods

from :: CreateListener -> Rep CreateListener x

to :: Rep CreateListener x -> CreateListener

Hashable CreateListener

Methods

hashWithSalt :: Int -> CreateListener -> Int

hash :: CreateListener -> Int

NFData CreateListener

Methods

rnf :: CreateListener -> ()

AWSRequest CreateListener

Associated Types

type Rs CreateListener :: *

Methods

request :: CreateListener -> Request CreateListener

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

ToQuery CreateListener

Methods

toQuery :: CreateListener -> QueryString

ToPath CreateListener

Methods

toPath :: CreateListener -> ByteString

ToHeaders CreateListener

Methods

toHeaders :: CreateListener -> [Header]

type Rep CreateListener

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

type Rs 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

Methods

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

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

Data CreateListenerResponse

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

Methods

readsPrec :: Int -> ReadS CreateListenerResponse

readList :: ReadS [CreateListenerResponse]

readPrec :: ReadPrec CreateListenerResponse

readListPrec :: ReadPrec [CreateListenerResponse]

Show CreateListenerResponse

Methods

showsPrec :: Int -> CreateListenerResponse -> ShowS

show :: CreateListenerResponse -> String

showList :: [CreateListenerResponse] -> ShowS

Generic CreateListenerResponse

Associated Types

type Rep CreateListenerResponse :: * -> *

Methods

from :: CreateListenerResponse -> Rep CreateListenerResponse x

to :: Rep CreateListenerResponse x -> CreateListenerResponse

NFData CreateListenerResponse

Methods

rnf :: CreateListenerResponse -> ()

type Rep CreateListenerResponse

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

Response Lenses

clrsListeners :: Lens' CreateListenerResponse [Listener]

Information about the listener.

clrsResponseStatus :: Lens' CreateListenerResponse Int

• - | The response status code.