Copyright	(c) 2013-2021 Brendan Hay
License	Mozilla Public License, v. 2.0.
Maintainer	Brendan Hay <brendan.g.hay+amazonka@gmail.com>
Stability	auto-generated
Portability	non-portable (GHC extensions)
Safe Haskell	None

Amazonka.ELBV2.CreateListener

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

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

For more information, see the following:

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.

Synopsis

data CreateListener = CreateListener' {
- sslPolicy :: Maybe Text
- protocol :: Maybe ProtocolEnum
- certificates :: Maybe [Certificate]
- alpnPolicy :: Maybe [Text]
- tags :: Maybe (NonEmpty Tag)
- port :: Maybe Natural
- loadBalancerArn :: Text
- defaultActions :: [Action]
}
newCreateListener :: Text -> CreateListener
createListener_sslPolicy :: Lens' CreateListener (Maybe Text)
createListener_protocol :: Lens' CreateListener (Maybe ProtocolEnum)
createListener_certificates :: Lens' CreateListener (Maybe [Certificate])
createListener_alpnPolicy :: Lens' CreateListener (Maybe [Text])
createListener_tags :: Lens' CreateListener (Maybe (NonEmpty Tag))
createListener_port :: Lens' CreateListener (Maybe Natural)
createListener_loadBalancerArn :: Lens' CreateListener Text
createListener_defaultActions :: Lens' CreateListener [Action]
data CreateListenerResponse = CreateListenerResponse' {
- listeners :: Maybe [Listener]
- httpStatus :: Int
}
newCreateListenerResponse :: Int -> CreateListenerResponse
createListenerResponse_listeners :: Lens' CreateListenerResponse (Maybe [Listener])
createListenerResponse_httpStatus :: Lens' CreateListenerResponse Int

Creating a Request

data CreateListener Source #

See: newCreateListener smart constructor.

Constructors

CreateListener'

Fields

sslPolicy :: Maybe Text
HTTPS and TLS listeners
The security policy that defines which protocols and ciphers are supported.
For more information, see Security policies in the Application Load Balancers Guide and Security policies in the Network Load Balancers Guide.
protocol :: Maybe 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 protocols are TCP, TLS, UDP, and TCP_UDP. You can’t specify the UDP or TCP_UDP protocol if dual-stack mode is enabled. You cannot specify a protocol for a Gateway Load Balancer.
certificates :: Maybe [Certificate]
HTTPS and TLS listeners
The default certificate for the listener. You must provide exactly one certificate. Set CertificateArn to the certificate ARN but do not set IsDefault.
alpnPolicy :: Maybe [Text]
TLS listeners
The name of the Application-Layer Protocol Negotiation (ALPN) policy. You can specify one policy name. The following are the possible values:
- ```
HTTP1Only
```
- ```
HTTP2Only
```
- ```
HTTP2Optional
```
- ```
HTTP2Preferred
```
- ```
None
```
For more information, see ALPN policies in the Network Load Balancers Guide.
tags :: Maybe (NonEmpty Tag)
The tags to assign to the listener.
port :: Maybe Natural
The port on which the load balancer is listening. You cannot specify a port for a Gateway Load Balancer.
loadBalancerArn :: Text
The Amazon Resource Name (ARN) of the load balancer.
defaultActions :: [Action]
The actions for the default rule.

Instances

Instances details

Eq CreateListener Source #
Instance details Defined in Amazonka.ELBV2.CreateListener Methods (==) :: CreateListener -> CreateListener -> Bool # (/=) :: CreateListener -> CreateListener -> Bool #
Read CreateListener Source #
Instance details Defined in Amazonka.ELBV2.CreateListener Methods readsPrec :: Int -> ReadS CreateListener # readList :: ReadS [CreateListener] # readPrec :: ReadPrec CreateListener # readListPrec :: ReadPrec [CreateListener] #
Show CreateListener Source #
Instance details Defined in Amazonka.ELBV2.CreateListener Methods showsPrec :: Int -> CreateListener -> ShowS # show :: CreateListener -> String # showList :: [CreateListener] -> ShowS #
Generic CreateListener Source #
Instance details Defined in Amazonka.ELBV2.CreateListener Associated Types type Rep CreateListener :: Type -> Type # Methods from :: CreateListener -> Rep CreateListener x # to :: Rep CreateListener x -> CreateListener #
NFData CreateListener Source #
Instance details Defined in Amazonka.ELBV2.CreateListener Methods rnf :: CreateListener -> () #
Hashable CreateListener Source #
Instance details Defined in Amazonka.ELBV2.CreateListener Methods hashWithSalt :: Int -> CreateListener -> Int # hash :: CreateListener -> Int #
AWSRequest CreateListener Source #
Instance details Defined in Amazonka.ELBV2.CreateListener Associated Types type AWSResponse CreateListener # Methods request :: CreateListener -> Request CreateListener # response :: MonadResource m => Logger -> Service -> Proxy CreateListener -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse CreateListener))) #
ToHeaders CreateListener Source #
Instance details Defined in Amazonka.ELBV2.CreateListener Methods toHeaders :: CreateListener -> [Header] #
ToPath CreateListener Source #
Instance details Defined in Amazonka.ELBV2.CreateListener Methods toPath :: CreateListener -> ByteString #
ToQuery CreateListener Source #
Instance details Defined in Amazonka.ELBV2.CreateListener Methods toQuery :: CreateListener -> QueryString #
type Rep CreateListener Source #
Instance details Defined in Amazonka.ELBV2.CreateListener type Rep CreateListener = D1 ('MetaData "CreateListener" "Amazonka.ELBV2.CreateListener" "libZSservicesZSamazonka-elbv2ZSamazonka-elbv2" 'False) (C1 ('MetaCons "CreateListener'" 'PrefixI 'True) (((S1 ('MetaSel ('Just "sslPolicy") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "protocol") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe ProtocolEnum))) :: (S1 ('MetaSel ('Just "certificates") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Certificate])) :: S1 ('MetaSel ('Just "alpnPolicy") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Text])))) :: ((S1 ('MetaSel ('Just "tags") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe (NonEmpty Tag))) :: S1 ('MetaSel ('Just "port") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural))) :: (S1 ('MetaSel ('Just "loadBalancerArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: S1 ('MetaSel ('Just "defaultActions") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 [Action])))))
type AWSResponse CreateListener Source #
Instance details Defined in Amazonka.ELBV2.CreateListener type AWSResponse CreateListener = CreateListenerResponse

newCreateListener Source #

Arguments

:: Text	`$sel:loadBalancerArn:CreateListener'`
-> CreateListener

Create a value of CreateListener with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:sslPolicy:CreateListener', createListener_sslPolicy - [HTTPS and TLS listeners] The security policy that defines which protocols and ciphers are supported.

For more information, see Security policies in the Application Load Balancers Guide and Security policies in the Network Load Balancers Guide.

$sel:protocol:CreateListener', createListener_protocol - 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 protocols are TCP, TLS, UDP, and TCP_UDP. You can’t specify the UDP or TCP_UDP protocol if dual-stack mode is enabled. You cannot specify a protocol for a Gateway Load Balancer.

$sel:certificates:CreateListener', createListener_certificates - [HTTPS and TLS listeners] The default certificate for the listener. You must provide exactly one certificate. Set CertificateArn to the certificate ARN but do not set IsDefault.

$sel:alpnPolicy:CreateListener', createListener_alpnPolicy - [TLS listeners] The name of the Application-Layer Protocol Negotiation (ALPN) policy. You can specify one policy name. The following are the possible values:

```
HTTP1Only
```
```
HTTP2Only
```
```
HTTP2Optional
```
```
HTTP2Preferred
```
```
None
```

For more information, see ALPN policies in the Network Load Balancers Guide.

$sel:tags:CreateListener', createListener_tags - The tags to assign to the listener.

$sel:port:CreateListener', createListener_port - The port on which the load balancer is listening. You cannot specify a port for a Gateway Load Balancer.

$sel:loadBalancerArn:CreateListener', createListener_loadBalancerArn - The Amazon Resource Name (ARN) of the load balancer.

$sel:defaultActions:CreateListener', createListener_defaultActions - The actions for the default rule.

Request Lenses

createListener_sslPolicy :: Lens' CreateListener (Maybe Text) Source #

HTTPS and TLS listeners: The security policy that defines which protocols and ciphers are supported.

For more information, see Security policies in the Application Load Balancers Guide and Security policies in the Network Load Balancers Guide.

createListener_protocol :: Lens' CreateListener (Maybe ProtocolEnum) Source #

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 protocols are TCP, TLS, UDP, and TCP_UDP. You can’t specify the UDP or TCP_UDP protocol if dual-stack mode is enabled. You cannot specify a protocol for a Gateway Load Balancer.

createListener_certificates :: Lens' CreateListener (Maybe [Certificate]) Source #

HTTPS and TLS listeners: The default certificate for the listener. You must provide exactly one certificate. Set CertificateArn to the certificate ARN but do not set IsDefault.

createListener_alpnPolicy :: Lens' CreateListener (Maybe [Text]) Source #

TLS listeners: The name of the Application-Layer Protocol Negotiation (ALPN) policy. You can specify one policy name. The following are the possible values:

```
HTTP1Only
```
```
HTTP2Only
```
```
HTTP2Optional
```
```
HTTP2Preferred
```
```
None
```

For more information, see ALPN policies in the Network Load Balancers Guide.

createListener_tags :: Lens' CreateListener (Maybe (NonEmpty Tag)) Source #

The tags to assign to the listener.

createListener_port :: Lens' CreateListener (Maybe Natural) Source #

The port on which the load balancer is listening. You cannot specify a port for a Gateway Load Balancer.

createListener_loadBalancerArn :: Lens' CreateListener Text Source #

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

createListener_defaultActions :: Lens' CreateListener [Action] Source #

The actions for the default rule.

Destructuring the Response

data CreateListenerResponse Source #

See: newCreateListenerResponse smart constructor.

Constructors

CreateListenerResponse'
Fields listeners :: Maybe [Listener] Information about the listener. httpStatus :: Int The response's http status code.

Instances

Instances details

Eq CreateListenerResponse Source #
Instance details Defined in Amazonka.ELBV2.CreateListener Methods (==) :: CreateListenerResponse -> CreateListenerResponse -> Bool # (/=) :: CreateListenerResponse -> CreateListenerResponse -> Bool #
Read CreateListenerResponse Source #
Instance details Defined in Amazonka.ELBV2.CreateListener Methods readsPrec :: Int -> ReadS CreateListenerResponse # readList :: ReadS [CreateListenerResponse] # readPrec :: ReadPrec CreateListenerResponse # readListPrec :: ReadPrec [CreateListenerResponse] #
Show CreateListenerResponse Source #
Instance details Defined in Amazonka.ELBV2.CreateListener Methods showsPrec :: Int -> CreateListenerResponse -> ShowS # show :: CreateListenerResponse -> String # showList :: [CreateListenerResponse] -> ShowS #
Generic CreateListenerResponse Source #
Instance details Defined in Amazonka.ELBV2.CreateListener Associated Types type Rep CreateListenerResponse :: Type -> Type # Methods from :: CreateListenerResponse -> Rep CreateListenerResponse x # to :: Rep CreateListenerResponse x -> CreateListenerResponse #
NFData CreateListenerResponse Source #
Instance details Defined in Amazonka.ELBV2.CreateListener Methods rnf :: CreateListenerResponse -> () #
type Rep CreateListenerResponse Source #
Instance details Defined in Amazonka.ELBV2.CreateListener type Rep CreateListenerResponse = D1 ('MetaData "CreateListenerResponse" "Amazonka.ELBV2.CreateListener" "libZSservicesZSamazonka-elbv2ZSamazonka-elbv2" 'False) (C1 ('MetaCons "CreateListenerResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "listeners") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Listener])) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))

newCreateListenerResponse Source #

Arguments

:: Int	`$sel:httpStatus:CreateListenerResponse'`
-> CreateListenerResponse

Create a value of CreateListenerResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:listeners:CreateListenerResponse', createListenerResponse_listeners - Information about the listener.

$sel:httpStatus:CreateListenerResponse', createListenerResponse_httpStatus - The response's http status code.

Response Lenses

createListenerResponse_listeners :: Lens' CreateListenerResponse (Maybe [Listener]) Source #

Information about the listener.

createListenerResponse_httpStatus :: Lens' CreateListenerResponse Int Source #

The response's http status code.