Skip to content

Retrieves the firewall rule group associations that you have defined

Description

Retrieves the firewall rule group associations that you have defined. Each association enables DNS filtering for a VPC with one rule group.

A single call might return only a partial list of the associations. For information, see MaxResults.

Usage

route53resolver_list_firewall_rule_group_associations(
  FirewallRuleGroupId, VpcId, Priority, Status, MaxResults, NextToken)

Arguments

  • FirewallRuleGroupId

    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

    The unique identifier of the VPC that you want to retrieve the associations for. Leave this blank to retrieve associations for any VPC.

  • Priority

    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

    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.

  • MaxResults

    The maximum number of objects that you want Resolver to return for this request. If more objects are available, in the response, Resolver provides a NextToken value that you can use in a subsequent call to get the next batch of objects.

    If you don't specify a value for MaxResults, Resolver returns up to 100 objects.

  • NextToken

    For the first call to this list request, omit this value.

    When you request a list of objects, Resolver returns at most the number of objects specified in MaxResults. If more objects are available for retrieval, Resolver returns a NextToken value in the response. To retrieve the next batch of objects, use the token that was returned for the prior request in your next request.

Value

A list with the following syntax:

list(
  NextToken = "string",
  FirewallRuleGroupAssociations = list(
    list(
      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"
    )
  )
)

Request syntax

svc$list_firewall_rule_group_associations(
  FirewallRuleGroupId = "string",
  VpcId = "string",
  Priority = 123,
  Status = "COMPLETE"|"DELETING"|"UPDATING",
  MaxResults = 123,
  NextToken = "string"
)