listeners_list_only
Lists listeners
in a region or regions, for all properties use listeners
Overview
Name | listeners_list_only |
Type | Resource |
Description | Specifies a listener for an Application Load Balancer, Network Load Balancer, or Gateway Load Balancer. |
Id | aws.elasticloadbalancingv2.listeners_list_only |
Fields
Name | Datatype | Description |
---|---|---|
listener_arn | string | |
mutual_authentication | object | The mutual authentication configuration information. |
alpn_policy | array | [TLS listener] The name of the Application-Layer Protocol Negotiation (ALPN) policy. |
ssl_policy | string | [HTTPS and TLS listeners] The security policy that defines which protocols and ciphers are supported. Updating the security policy can result in interruptions if the load balancer is handling a high volume of traffic. 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. 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. 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. |
region | string | AWS region. |
Methods
Name | Accessible by | Required Params |
---|---|---|
list_resources | SELECT | region |
SELECT
examples
Lists all listeners
in a region.
SELECT
region,
listener_arn
FROM aws.elasticloadbalancingv2.listeners_list_only
WHERE region = 'us-east-1';
Permissions
For permissions required to operate on the listeners_list_only
resource, see listeners