Skip to main content

listener_rules_list_only

Lists listener_rules in a region or regions, for all properties use listener_rules

Overview

Namelistener_rules_list_only
TypeResource
DescriptionSpecifies a listener rule. The listener must be associated with an Application Load Balancer. Each rule consists of a priority, one or more actions, and one or more conditions.
For more information, see [Quotas for your Application Load Balancers](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-limits.html) in the *User Guide for Application Load Balancers*.
Idaws.elasticloadbalancingv2.listener_rules_list_only

Fields

NameDatatypeDescription
listener_arnstringThe Amazon Resource Name (ARN) of the listener.
rule_arnstring
actionsarrayThe actions.
The rule must include exactly one of the following types of actions: forward, fixed-response, or redirect, and it must be the last action to be performed. If the rule is for an HTTPS listener, it can also optionally include an authentication action.
priorityintegerThe rule priority. A listener can't have multiple rules with the same priority.
If you try to reorder rules by updating their priorities, do not specify a new priority if an existing rule already uses this priority, as this can cause an error. If you need to reuse a priority with a different rule, you must remove it as a priority first, and then specify it in a subsequent update.
conditionsarrayThe conditions.
The rule can optionally include up to one of each of the following conditions: http-request-method, host-header, path-pattern, and source-ip. A rule can also optionally include one or more of each of the following conditions: http-header and query-string.
is_defaultboolean
regionstringAWS region.

Methods

NameAccessible byRequired Params
list_resourcesSELECTregion

SELECT examples

Lists all listener_rules in a region.

SELECT
region,
rule_arn
FROM aws.elasticloadbalancingv2.listener_rules_list_only
WHERE region = 'us-east-1';

Permissions

For permissions required to operate on the listener_rules_list_only resource, see listener_rules