Copyright | (c) 2013-2021 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay <brendan.g.hay+amazonka@gmail.com> |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | None |
Lists information about associations between Amazon VPCs and query logging configurations.
This operation returns paginated results.
Synopsis
- data ListResolverQueryLogConfigAssociations = ListResolverQueryLogConfigAssociations' {}
- newListResolverQueryLogConfigAssociations :: ListResolverQueryLogConfigAssociations
- listResolverQueryLogConfigAssociations_filters :: Lens' ListResolverQueryLogConfigAssociations (Maybe [Filter])
- listResolverQueryLogConfigAssociations_nextToken :: Lens' ListResolverQueryLogConfigAssociations (Maybe Text)
- listResolverQueryLogConfigAssociations_sortOrder :: Lens' ListResolverQueryLogConfigAssociations (Maybe SortOrder)
- listResolverQueryLogConfigAssociations_maxResults :: Lens' ListResolverQueryLogConfigAssociations (Maybe Natural)
- listResolverQueryLogConfigAssociations_sortBy :: Lens' ListResolverQueryLogConfigAssociations (Maybe Text)
- data ListResolverQueryLogConfigAssociationsResponse = ListResolverQueryLogConfigAssociationsResponse' {}
- newListResolverQueryLogConfigAssociationsResponse :: Int -> ListResolverQueryLogConfigAssociationsResponse
- listResolverQueryLogConfigAssociationsResponse_totalFilteredCount :: Lens' ListResolverQueryLogConfigAssociationsResponse (Maybe Int)
- listResolverQueryLogConfigAssociationsResponse_resolverQueryLogConfigAssociations :: Lens' ListResolverQueryLogConfigAssociationsResponse (Maybe [ResolverQueryLogConfigAssociation])
- listResolverQueryLogConfigAssociationsResponse_nextToken :: Lens' ListResolverQueryLogConfigAssociationsResponse (Maybe Text)
- listResolverQueryLogConfigAssociationsResponse_totalCount :: Lens' ListResolverQueryLogConfigAssociationsResponse (Maybe Int)
- listResolverQueryLogConfigAssociationsResponse_httpStatus :: Lens' ListResolverQueryLogConfigAssociationsResponse Int
Creating a Request
data ListResolverQueryLogConfigAssociations Source #
See: newListResolverQueryLogConfigAssociations
smart constructor.
ListResolverQueryLogConfigAssociations' | |
|
Instances
newListResolverQueryLogConfigAssociations :: ListResolverQueryLogConfigAssociations Source #
Create a value of ListResolverQueryLogConfigAssociations
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:filters:ListResolverQueryLogConfigAssociations'
, listResolverQueryLogConfigAssociations_filters
- An optional specification to return a subset of query logging
associations.
If you submit a second or subsequent
ListResolverQueryLogConfigAssociations
request and specify the
NextToken
parameter, you must use the same values for Filters
, if
any, as in the previous request.
$sel:nextToken:ListResolverQueryLogConfigAssociations'
, listResolverQueryLogConfigAssociations_nextToken
- For the first ListResolverQueryLogConfigAssociations
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
ListResolverQueryLogConfigAssociations
request to get the next group
of associations. In the next request, specify the value of NextToken
from the previous response.
$sel:sortOrder:ListResolverQueryLogConfigAssociations'
, listResolverQueryLogConfigAssociations_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
ListResolverQueryLogConfigAssociations
request and specify the
NextToken
parameter, you must use the same value for SortOrder
, if
any, as in the previous request.
$sel:maxResults:ListResolverQueryLogConfigAssociations'
, listResolverQueryLogConfigAssociations_maxResults
- The maximum number of query logging associations that you want to return
in the response to a ListResolverQueryLogConfigAssociations
request.
If you don't specify a value for MaxResults
, Resolver returns up to
100 query logging associations.
$sel:sortBy:ListResolverQueryLogConfigAssociations'
, listResolverQueryLogConfigAssociations_sortBy
- The element that you want Resolver to sort query logging associations
by.
If you submit a second or subsequent
ListResolverQueryLogConfigAssociations
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 ofStatus
isFAILED
, the value ofError
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 thanFAILED
,ERROR
is null.Id
: The ID of the query logging associationResolverQueryLogConfigId
: The ID of the query logging configurationResourceId
: The ID of the VPC that is associated with the query logging configurationStatus
: 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.
Request Lenses
listResolverQueryLogConfigAssociations_filters :: Lens' ListResolverQueryLogConfigAssociations (Maybe [Filter]) Source #
An optional specification to return a subset of query logging associations.
If you submit a second or subsequent
ListResolverQueryLogConfigAssociations
request and specify the
NextToken
parameter, you must use the same values for Filters
, if
any, as in the previous request.
listResolverQueryLogConfigAssociations_nextToken :: Lens' ListResolverQueryLogConfigAssociations (Maybe Text) Source #
For the first ListResolverQueryLogConfigAssociations
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
ListResolverQueryLogConfigAssociations
request to get the next group
of associations. In the next request, specify the value of NextToken
from the previous response.
listResolverQueryLogConfigAssociations_sortOrder :: Lens' ListResolverQueryLogConfigAssociations (Maybe SortOrder) Source #
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
ListResolverQueryLogConfigAssociations
request and specify the
NextToken
parameter, you must use the same value for SortOrder
, if
any, as in the previous request.
listResolverQueryLogConfigAssociations_maxResults :: Lens' ListResolverQueryLogConfigAssociations (Maybe Natural) Source #
The maximum number of query logging associations that you want to return
in the response to a ListResolverQueryLogConfigAssociations
request.
If you don't specify a value for MaxResults
, Resolver returns up to
100 query logging associations.
listResolverQueryLogConfigAssociations_sortBy :: Lens' ListResolverQueryLogConfigAssociations (Maybe Text) Source #
The element that you want Resolver to sort query logging associations by.
If you submit a second or subsequent
ListResolverQueryLogConfigAssociations
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 ofStatus
isFAILED
, the value ofError
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 thanFAILED
,ERROR
is null.Id
: The ID of the query logging associationResolverQueryLogConfigId
: The ID of the query logging configurationResourceId
: The ID of the VPC that is associated with the query logging configurationStatus
: 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.
Destructuring the Response
data ListResolverQueryLogConfigAssociationsResponse Source #
See: newListResolverQueryLogConfigAssociationsResponse
smart constructor.
ListResolverQueryLogConfigAssociationsResponse' | |
|
Instances
newListResolverQueryLogConfigAssociationsResponse Source #
:: Int |
|
-> ListResolverQueryLogConfigAssociationsResponse |
Create a value of ListResolverQueryLogConfigAssociationsResponse
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:totalFilteredCount:ListResolverQueryLogConfigAssociationsResponse'
, listResolverQueryLogConfigAssociationsResponse_totalFilteredCount
- The total number of query logging associations that were created by the
current account in the specified Region and that match the filters that
were specified in the ListResolverQueryLogConfigAssociations
request.
For the total number of associations that were created by the current
account in the specified Region, see TotalCount
.
$sel:resolverQueryLogConfigAssociations:ListResolverQueryLogConfigAssociationsResponse'
, listResolverQueryLogConfigAssociationsResponse_resolverQueryLogConfigAssociations
- A list that contains one ResolverQueryLogConfigAssociations
element
for each query logging association that matches the values that you
specified for Filter
.
$sel:nextToken:ListResolverQueryLogConfigAssociations'
, listResolverQueryLogConfigAssociationsResponse_nextToken
- If there are more than MaxResults
query logging associations, you can
submit another ListResolverQueryLogConfigAssociations
request to get
the next group of associations. In the next request, specify the value
of NextToken
from the previous response.
$sel:totalCount:ListResolverQueryLogConfigAssociationsResponse'
, listResolverQueryLogConfigAssociationsResponse_totalCount
- The total number of query logging associations that were created by the
current account in the specified Region. This count can differ from the
number of associations that are returned in a
ListResolverQueryLogConfigAssociations
response, depending on the
values that you specify in the request.
$sel:httpStatus:ListResolverQueryLogConfigAssociationsResponse'
, listResolverQueryLogConfigAssociationsResponse_httpStatus
- The response's http status code.
Response Lenses
listResolverQueryLogConfigAssociationsResponse_totalFilteredCount :: Lens' ListResolverQueryLogConfigAssociationsResponse (Maybe Int) Source #
The total number of query logging associations that were created by the
current account in the specified Region and that match the filters that
were specified in the ListResolverQueryLogConfigAssociations
request.
For the total number of associations that were created by the current
account in the specified Region, see TotalCount
.
listResolverQueryLogConfigAssociationsResponse_resolverQueryLogConfigAssociations :: Lens' ListResolverQueryLogConfigAssociationsResponse (Maybe [ResolverQueryLogConfigAssociation]) Source #
A list that contains one ResolverQueryLogConfigAssociations
element
for each query logging association that matches the values that you
specified for Filter
.
listResolverQueryLogConfigAssociationsResponse_nextToken :: Lens' ListResolverQueryLogConfigAssociationsResponse (Maybe Text) Source #
If there are more than MaxResults
query logging associations, you can
submit another ListResolverQueryLogConfigAssociations
request to get
the next group of associations. In the next request, specify the value
of NextToken
from the previous response.
listResolverQueryLogConfigAssociationsResponse_totalCount :: Lens' ListResolverQueryLogConfigAssociationsResponse (Maybe Int) Source #
The total number of query logging associations that were created by the
current account in the specified Region. This count can differ from the
number of associations that are returned in a
ListResolverQueryLogConfigAssociations
response, depending on the
values that you specify in the request.
listResolverQueryLogConfigAssociationsResponse_httpStatus :: Lens' ListResolverQueryLogConfigAssociationsResponse Int Source #
The response's http status code.