WAFV2 / Client / list_resources_for_web_acl

list_resources_for_web_acl#

WAFV2.Client.list_resources_for_web_acl(**kwargs)#

Retrieves an array of the Amazon Resource Names (ARNs) for the resources that are associated with the specified web ACL.

For Amazon CloudFront, don’t use this call. Instead, use the CloudFront call ListDistributionsByWebACLId. For information, see ListDistributionsByWebACLId in the Amazon CloudFront API Reference.

Required permissions for customer-managed IAM policies

This call requires permissions that are specific to the protected resource type. For details, see Permissions for ListResourcesForWebACL in the WAF Developer Guide.

See also: AWS API Documentation

Request Syntax

response = client.list_resources_for_web_acl(
    WebACLArn='string',
    ResourceType='APPLICATION_LOAD_BALANCER'|'API_GATEWAY'|'APPSYNC'|'COGNITO_USER_POOL'|'APP_RUNNER_SERVICE'|'VERIFIED_ACCESS_INSTANCE'
)
Parameters:
  • WebACLArn (string) –

    [REQUIRED]

    The Amazon Resource Name (ARN) of the web ACL.

  • ResourceType (string) –

    Retrieves the web ACLs that are used by the specified resource type.

    For Amazon CloudFront, don’t use this call. Instead, use the CloudFront call ListDistributionsByWebACLId. For information, see ListDistributionsByWebACLId in the Amazon CloudFront API Reference.

    Note

    If you don’t provide a resource type, the call uses the resource type APPLICATION_LOAD_BALANCER.

    Default: APPLICATION_LOAD_BALANCER

Return type:

dict

Returns:

Response Syntax

{
    'ResourceArns': [
        'string',
    ]
}

Response Structure

  • (dict) –

    • ResourceArns (list) –

      The array of Amazon Resource Names (ARNs) of the associated resources.

      • (string) –

Exceptions