listener

Gets an individual listener resource

Overview

Name	listener
Type	Resource
Description	listener
Id	awscc.elasticloadbalancingv2.listener

Fields

Name	Datatype	Description
ssl_policy	string	[HTTPS and TLS listeners] The security policy that defines which protocols and ciphers are supported.<br/> For more information, see [Security policies](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/create-https-listener.html#describe-ssl-policies) in the *Application Load Balancers Guide* and [Security policies](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/create-tls-listener.html#describe-ssl-policies) in the *Network Load Balancers Guide*.
load_balancer_arn	string	The Amazon Resource Name (ARN) of the load balancer.
default_actions	array	The actions for the default rule. You cannot define a condition for a default rule.<br/> To create additional rules for an Application Load Balancer, use [AWS::ElasticLoadBalancingV2::ListenerRule](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-elasticloadbalancingv2-listenerrule.html).
port	integer	The port on which the load balancer is listening. You cannot specify a port for a Gateway Load Balancer.
certificates	array	The default SSL server certificate for a secure listener. You must provide exactly one certificate if the listener protocol is HTTPS or TLS.<br/> To create a certificate list for a secure listener, use [AWS::ElasticLoadBalancingV2::ListenerCertificate](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-elasticloadbalancingv2-listenercertificate.html).
protocol	string	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.
listener_arn	string
alpn_policy	array	[TLS listener] The name of the Application-Layer Protocol Negotiation (ALPN) policy.
mutual_authentication	object	The mutual authentication configuration information.
region	string	AWS region.

Methods

Currently only SELECT is supported for this resource resource.

Example

SELECT
region,
ssl_policy,
load_balancer_arn,
default_actions,
port,
certificates,
protocol,
listener_arn,
alpn_policy,
mutual_authentication
FROM awscc.elasticloadbalancingv2.listener
WHERE data__Identifier = '<ListenerArn>';

Permissions

To operate on the listener resource, the following permissions are required:

Delete

elasticloadbalancing:DeleteListener,
elasticloadbalancing:DescribeListeners

Read

elasticloadbalancing:DescribeListeners

Update

elasticloadbalancing:ModifyListener,
elasticloadbalancing:DescribeListeners,
cognito-idp:DescribeUserPoolClient