Route53Resolver / Paginator / ListFirewallRuleGroupAssociations

ListFirewallRuleGroupAssociations#

class Route53Resolver.Paginator.ListFirewallRuleGroupAssociations#
paginator = client.get_paginator('list_firewall_rule_group_associations')
paginate(**kwargs)#

Creates an iterator that will paginate through responses from Route53Resolver.Client.list_firewall_rule_group_associations().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    FirewallRuleGroupId='string',
    VpcId='string',
    Priority=123,
    Status='COMPLETE'|'DELETING'|'UPDATING',
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters:
  • FirewallRuleGroupId (string) – The unique identifier of the firewall rule group that you want to retrieve the associations for. Leave this blank to retrieve associations for any rule group.

  • VpcId (string) – The unique identifier of the VPC that you want to retrieve the associations for. Leave this blank to retrieve associations for any VPC.

  • Priority (integer) – The setting that determines the processing order of the rule group among the rule groups that are associated with a single VPC. DNS Firewall filters VPC traffic starting from the rule group with the lowest numeric priority setting.

  • Status (string) – The association Status setting that you want DNS Firewall to filter on for the list. If you don’t specify this, then DNS Firewall returns all associations, regardless of status.

  • PaginationConfig (dict) –

    A dictionary that provides parameters to control pagination.

    • MaxItems (integer) –

      The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.

    • PageSize (integer) –

      The size of each page.

    • StartingToken (string) –

      A token to specify where to start paginating. This is the NextToken from a previous response.

Return type:

dict

Returns:

Response Syntax

{
    'FirewallRuleGroupAssociations': [
        {
            'Id': 'string',
            'Arn': 'string',
            'FirewallRuleGroupId': 'string',
            'VpcId': 'string',
            'Name': 'string',
            'Priority': 123,
            'MutationProtection': 'ENABLED'|'DISABLED',
            'ManagedOwnerName': 'string',
            'Status': 'COMPLETE'|'DELETING'|'UPDATING',
            'StatusMessage': 'string',
            'CreatorRequestId': 'string',
            'CreationTime': 'string',
            'ModificationTime': 'string'
        },
    ]
}

Response Structure

  • (dict) –

    • FirewallRuleGroupAssociations (list) –

      A list of your firewall rule group associations.

      This might be a partial list of the associations that you have defined. For information, see MaxResults.

      • (dict) –

        An association between a firewall rule group and a VPC, which enables DNS filtering for the VPC.

        • Id (string) –

          The identifier for the association.

        • Arn (string) –

          The Amazon Resource Name (ARN) of the firewall rule group association.

        • FirewallRuleGroupId (string) –

          The unique identifier of the firewall rule group.

        • VpcId (string) –

          The unique identifier of the VPC that is associated with the rule group.

        • Name (string) –

          The name of the association.

        • Priority (integer) –

          The setting that determines the processing order of the rule group among the rule groups that are associated with a single VPC. DNS Firewall filters VPC traffic starting from rule group with the lowest numeric priority setting.

        • MutationProtection (string) –

          If enabled, this setting disallows modification or removal of the association, to help prevent against accidentally altering DNS firewall protections.

        • ManagedOwnerName (string) –

          The owner of the association, used only for associations that are not managed by you. If you use Firewall Manager to manage your DNS Firewalls, then this reports Firewall Manager as the managed owner.

        • Status (string) –

          The current status of the association.

        • StatusMessage (string) –

          Additional information about the status of the response, if available.

        • CreatorRequestId (string) –

          A unique string defined by you to identify the request. This allows you to retry failed requests without the risk of running the operation twice. This can be any unique string, for example, a timestamp.

        • CreationTime (string) –

          The date and time that the association was created, in Unix time format and Coordinated Universal Time (UTC).

        • ModificationTime (string) –

          The date and time that the association was last modified, in Unix time format and Coordinated Universal Time (UTC).