List Resolver Query Log Configs
route53resolver_list_resolver_query_log_configs |
R Documentation |
Description
Lists information about the specified query logging configurations. Each
configuration defines where you want Resolver to save DNS query logs and
specifies the VPCs that you want to log queries for.
Usage
route53resolver_list_resolver_query_log_configs(MaxResults, NextToken,
Filters, SortBy, SortOrder)
Arguments
MaxResults |
The maximum number of query logging configurations that you want
to return in the response to a
list_resolver_query_log_configs request. If you don't
specify a value for MaxResults , Resolver returns up to 100
query logging configurations. |
NextToken |
For the first list_resolver_query_log_configs
request, omit this value.
If there are more than MaxResults query logging
configurations that match the values that you specify for
Filters , you can submit another
list_resolver_query_log_configs request to get the next
group of configurations. In the next request, specify the value of
NextToken from the previous response. |
Filters |
An optional specification to return a subset of query logging
configurations.
If you submit a second or subsequent
list_resolver_query_log_configs 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
configurations by.
If you submit a second or subsequent
list_resolver_query_log_configs 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:
Arn : The ARN of the query logging
configuration
AssociationCount : The number of VPCs that are
associated with the specified configuration
CreationTime : The date and time that Resolver
returned when the configuration was created
CreatorRequestId : The value that was specified for
CreatorRequestId when the configuration was
created
DestinationArn : The location that logs are sent
to
Id : The ID of the configuration
Name : The name of the configuration
OwnerId : The Amazon Web Services account number of
the account that created the configuration
ShareStatus : Whether the configuration is shared
with other Amazon Web Services accounts or shared with the current
account by another Amazon Web Services account. Sharing is configured
through Resource Access Manager (RAM).
Status : The current status of the configuration.
Valid values include the following:
CREATING : Resolver is creating the query logging
configuration.
CREATED : The query logging configuration was
successfully created. Resolver is logging queries that originate in the
specified VPC.
DELETING : Resolver is deleting this query logging
configuration.
FAILED : Resolver either couldn't create or couldn't
delete the query logging configuration. 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 configurations to be listed in,
ASCENDING or DESCENDING .
If you submit a second or subsequent
list_resolver_query_log_configs 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,
ResolverQueryLogConfigs = list(
list(
Id = "string",
OwnerId = "string",
Status = "CREATING"|"CREATED"|"DELETING"|"FAILED",
ShareStatus = "NOT_SHARED"|"SHARED_WITH_ME"|"SHARED_BY_ME",
AssociationCount = 123,
Arn = "string",
Name = "string",
DestinationArn = "string",
CreatorRequestId = "string",
CreationTime = "string"
)
)
)
Request syntax
svc$list_resolver_query_log_configs(
MaxResults = 123,
NextToken = "string",
Filters = list(
list(
Name = "string",
Values = list(
"string"
)
)
),
SortBy = "string",
SortOrder = "ASCENDING"|"DESCENDING"
)