listener_rules_list_only
Lists listener_rules
in a region or regions, for all properties use listener_rules
Overview
Name | listener_rules_list_only |
Type | Resource |
Description | Specifies 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*. |
Id | aws.elasticloadbalancingv2.listener_rules_list_only |
Fields
Name | Datatype | Description |
---|---|---|
listener_arn | string | The Amazon Resource Name (ARN) of the listener. |
rule_arn | string | |
actions | array | The 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. |
priority | integer | The 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. |
conditions | array | The 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_default | boolean | |
region | string | AWS region. |
Methods
Name | Accessible by | Required Params |
---|---|---|
list_resources | SELECT | region |
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