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¶
-
MaxResultsThe maximum number of query logging associations that you want to return in the response to a
list_resolver_query_log_config_associationsrequest. If you don't specify a value forMaxResults, Resolver returns up to 100 query logging associations. -
NextTokenFor the first
list_resolver_query_log_config_associationsrequest, omit this value.If there are more than
MaxResultsquery logging associations that match the values that you specify forFilters, you can submit anotherlist_resolver_query_log_config_associationsrequest to get the next group of associations. In the next request, specify the value ofNextTokenfrom the previous response. -
FiltersAn optional specification to return a subset of query logging associations.
If you submit a second or subsequent
list_resolver_query_log_config_associationsrequest and specify theNextTokenparameter, you must use the same values forFilters, if any, as in the previous request. -
SortByThe element that you want Resolver to sort query logging associations by.
If you submit a second or subsequent
list_resolver_query_log_config_associationsrequest and specify theNextTokenparameter, you must use the same value forSortBy, 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 ofStatusisFAILED, the value ofErrorindicates 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
Statusis a value other thanFAILED,ERRORis 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.
-
SortOrderIf you specified a value for
SortBy, the order that you want query logging associations to be listed in,ASCENDINGorDESCENDING.If you submit a second or subsequent
list_resolver_query_log_config_associationsrequest and specify theNextTokenparameter, you must use the same value forSortOrder, 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"
)
)
)