Skip to content

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"
)