Skip to content

List Resolver Query Log Config Associations

route53resolver_list_resolver_query_log_config_associations R Documentation

Lists information about associations between Amazon VPCs and query logging configurations

Description

Lists information about associations between Amazon VPCs and query logging configurations.

Usage

route53resolver_list_resolver_query_log_config_associations(MaxResults,
  NextToken, Filters, SortBy, SortOrder)

Arguments

MaxResults

The maximum number of query logging associations that you want to return in the response to a list_resolver_query_log_config_associations request. If you don't specify a value for MaxResults, Resolver returns up to 100 query logging associations.

NextToken

For the first list_resolver_query_log_config_associations request, omit this value.

If there are more than MaxResults query logging associations that match the values that you specify for Filters, you can submit another list_resolver_query_log_config_associations request to get the next group of associations. In the next request, specify the value of NextToken from the previous response.

Filters

An optional specification to return a subset of query logging associations.

If you submit a second or subsequent list_resolver_query_log_config_associations request and specify the NextToken parameter, you must use the same values for Filters, if any, as in the previous request.

SortBy

The element that you want Resolver to sort query logging associations by.

If you submit a second or subsequent list_resolver_query_log_config_associations request and specify the NextToken parameter, you must use the same value for SortBy, if any, as in the previous request.

Valid values include the following elements:

  • CreationTime: The ID of the query logging association.

  • Error: If the value of Status is FAILED, the value of Error indicates the cause:

    • DESTINATION_NOT_FOUND: The specified destination (for example, an Amazon S3 bucket) was deleted.

    • ACCESS_DENIED: Permissions don't allow sending logs to the destination.

    If Status is a value other than FAILED, ERROR is null.

  • Id: The ID of the query logging association

  • ResolverQueryLogConfigId: The ID of the query logging configuration

  • ResourceId: The ID of the VPC that is associated with the query logging configuration

  • Status: The current status of the configuration. Valid values include the following:

    • CREATING: Resolver is creating an association between an Amazon VPC and a query logging configuration.

    • CREATED: The association between an Amazon VPC and a query logging configuration was successfully created. Resolver is logging queries that originate in the specified VPC.

    • DELETING: Resolver is deleting this query logging association.

    • FAILED: Resolver either couldn't create or couldn't delete the query logging association. Here are two common causes:

      • The specified destination (for example, an Amazon S3 bucket) was deleted.

      • Permissions don't allow sending logs to the destination.

SortOrder

If you specified a value for SortBy, the order that you want query logging associations to be listed in, ASCENDING or DESCENDING.

If you submit a second or subsequent list_resolver_query_log_config_associations request and specify the NextToken parameter, you must use the same value for SortOrder, if any, as in the previous request.

Value

A list with the following syntax:

list(
  NextToken = "string",
  TotalCount = 123,
  TotalFilteredCount = 123,
  ResolverQueryLogConfigAssociations = list(
    list(
      Id = "string",
      ResolverQueryLogConfigId = "string",
      ResourceId = "string",
      Status = "CREATING"|"ACTIVE"|"ACTION_NEEDED"|"DELETING"|"FAILED",
      Error = "NONE"|"DESTINATION_NOT_FOUND"|"ACCESS_DENIED"|"INTERNAL_SERVICE_ERROR",
      ErrorMessage = "string",
      CreationTime = "string"
    )
  )
)

Request syntax

svc$list_resolver_query_log_config_associations(
  MaxResults = 123,
  NextToken = "string",
  Filters = list(
    list(
      Name = "string",
      Values = list(
        "string"
      )
    )
  ),
  SortBy = "string",
  SortOrder = "ASCENDING"|"DESCENDING"
)