distributions_by_web_acl_ids

Creates, updates, deletes, gets or lists a distributions_by_web_acl_ids resource.

Overview

Name	distributions_by_web_acl_ids
Type	Resource
Id	aws.cloudfront.distributions_by_web_acl_ids

Fields

The following fields are returned by SELECT queries:

list_distributions_by_web_acl_id

Name	Datatype	Description
is_truncated	boolean	A flag that indicates whether more distributions remain to be listed. If your results were truncated, you can make a follow-up pagination request using the Marker request parameter to retrieve more distributions in the list.
items	string	A complex type that contains one DistributionSummary element for each distribution that was created by the current Amazon Web Services account.
marker	string	The value you provided for the Marker request parameter.
max_items	integer	The value you provided for the MaxItems request parameter.
next_marker	string	If IsTruncated is true, this element is present and contains the value you can use for the Marker request parameter to continue listing your distributions where they left off.
quantity	integer	The number of distributions that were created by the current Amazon Web Services account.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list_distributions_by_web_acl_id	select	web_acl_id, region	Marker, MaxItems	List the distributions that are associated with a specified WAF web ACL.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
region	string	AWS region (default: us-east-1)
web_acl_id	string	The ID of the WAF web ACL that you want to list the associated distributions. If you specify "null" for the ID, the request returns a list of the distributions that aren't associated with a web ACL. For WAFV2, this is the ARN of the web ACL, such as arn:aws:wafv2:us-east-1:123456789012:global/webacl/ExampleWebACL/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111. For WAF Classic, this is the ID of the web ACL, such as a1b2c3d4-5678-90ab-cdef-EXAMPLE11111.
Marker	string	Use Marker and MaxItems to control pagination of results. If you have more than MaxItems distributions that satisfy the request, the response includes a NextMarker element. To get the next page of results, submit another request. For the value of Marker, specify the value of NextMarker from the last response. (For the first request, omit Marker.)
MaxItems	string	The maximum number of distributions that you want CloudFront to return in the response body. The maximum and default values are both 100.

SELECT examples

list_distributions_by_web_acl_id

List the distributions that are associated with a specified WAF web ACL.

SELECT
is_truncated,
items,
marker,
max_items,
next_marker,
quantity
FROM aws.cloudfront.distributions_by_web_acl_ids
WHERE web_acl_id = '{{ web_acl_id }}' -- required
AND region = '{{ region }}' -- required
AND Marker = '{{ Marker }}'
AND MaxItems = '{{ MaxItems }}'
;