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 regional 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) –

    Used for web ACLs that are scoped for regional applications. A regional application can be an Application Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync GraphQL API, an Amazon Cognito user pool, an App Runner service, or an Amazon Web Services Verified Access instance.

    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

  • WAFV2.Client.exceptions.WAFInternalErrorException

  • WAFV2.Client.exceptions.WAFNonexistentItemException

  • WAFV2.Client.exceptions.WAFInvalidParameterException

  • WAFV2.Client.exceptions.WAFInvalidOperationException