WAFV2 / Client / list_available_managed_rule_group_versions

list_available_managed_rule_group_versions#

WAFV2.Client.list_available_managed_rule_group_versions(**kwargs)#

Returns a list of the available versions for the specified managed rule group.

See also: AWS API Documentation

Request Syntax

response = client.list_available_managed_rule_group_versions(
    VendorName='string',
    Name='string',
    Scope='CLOUDFRONT'|'REGIONAL',
    NextMarker='string',
    Limit=123
)
Parameters:

  • VendorName (string) –

    [REQUIRED]

    The name of the managed rule group vendor. You use this, along with the rule group name, to identify the rule group.

  • Name (string) –

    [REQUIRED]

    The name of the managed rule group. You use this, along with the vendor name, to identify the rule group.

  • Scope (string) –

    [REQUIRED]

    Specifies whether this is for an Amazon CloudFront distribution or for a regional application. A regional application can be an Application Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner service.

    To work with CloudFront, you must also specify the Region US East (N. Virginia) as follows:

    • CLI - Specify the Region when you use the CloudFront scope: --scope=CLOUDFRONT --region=us-east-1.

    • API and SDKs - For all calls, use the Region endpoint us-east-1.

  • NextMarker (string) – When you request a list of objects with a Limit setting, if the number of objects that are still available for retrieval exceeds the limit, WAF returns a NextMarker value in the response. To retrieve the next batch of objects, provide the marker from the prior call in your next request.

  • Limit (integer) – The maximum number of objects that you want WAF to return for this request. If more objects are available, in the response, WAF provides a NextMarker value that you can use in a subsequent call to get the next batch of objects.

Return type:

dict

Returns:

Response Syntax

{
    'NextMarker': 'string',
    'Versions': [
        {
            'Name': 'string',
            'LastUpdateTimestamp': datetime(2015, 1, 1)
        },
    ],
    'CurrentDefaultVersion': 'string'
}

Response Structure

  • (dict) –

    • NextMarker (string) –

      When you request a list of objects with a Limit setting, if the number of objects that are still available for retrieval exceeds the limit, WAF returns a NextMarker value in the response. To retrieve the next batch of objects, provide the marker from the prior call in your next request.

    • Versions (list) –

      The versions that are currently available for the specified managed rule group.

      • (dict) –

        Describes a single version of a managed rule group.

        • Name (string) –

          The version name.

        • LastUpdateTimestamp (datetime) –

          The date and time that the managed rule group owner updated the rule group version information.

    • CurrentDefaultVersion (string) –

      The name of the version that’s currently set as the default.

Exceptions

  • WAFV2.Client.exceptions.WAFInternalErrorException

  • WAFV2.Client.exceptions.WAFInvalidParameterException

  • WAFV2.Client.exceptions.WAFNonexistentItemException

  • WAFV2.Client.exceptions.WAFInvalidOperationException