/AWS1/CL_EL2=>CREATELISTENER()
¶
About CreateListener¶
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.
Method Signature¶
IMPORTING¶
Required arguments:¶
IV_LOADBALANCERARN
TYPE /AWS1/EL2LOADBALANCERARN
/AWS1/EL2LOADBALANCERARN
¶
The Amazon Resource Name (ARN) of the load balancer.
IT_DEFAULTACTIONS
TYPE /AWS1/CL_EL2ACTION=>TT_ACTIONS
TT_ACTIONS
¶
The actions for the default rule.
Optional arguments:¶
IV_PROTOCOL
TYPE /AWS1/EL2PROTOCOLENUM
/AWS1/EL2PROTOCOLENUM
¶
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.
IV_PORT
TYPE /AWS1/EL2PORT
/AWS1/EL2PORT
¶
The port on which the load balancer is listening. You cannot specify a port for a Gateway Load Balancer.
IV_SSLPOLICY
TYPE /AWS1/EL2SSLPOLICYNAME
/AWS1/EL2SSLPOLICYNAME
¶
[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.
IT_CERTIFICATES
TYPE /AWS1/CL_EL2CERTIFICATE=>TT_CERTIFICATELIST
TT_CERTIFICATELIST
¶
[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 setIsDefault
.
IT_ALPNPOLICY
TYPE /AWS1/CL_EL2ALPNPOLICYNAME_W=>TT_ALPNPOLICYNAME
TT_ALPNPOLICYNAME
¶
[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.
IT_TAGS
TYPE /AWS1/CL_EL2TAG=>TT_TAGLIST
TT_TAGLIST
¶
The tags to assign to the listener.
IO_MUTUALAUTHENTICATION
TYPE REF TO /AWS1/CL_EL2MUTUALAUTHNATTRS
/AWS1/CL_EL2MUTUALAUTHNATTRS
¶
The mutual authentication configuration information.