libZSservicesZSamazonka-route53resolverZSamazonka-route53resolver
Copyright(c) 2013-2021 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay+amazonka@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone

Amazonka.Route53Resolver.ListResolverQueryLogConfigAssociations

Description

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

This operation returns paginated results.

Synopsis

Creating a Request

data ListResolverQueryLogConfigAssociations Source #

Constructors

ListResolverQueryLogConfigAssociations' 

Fields

  • filters :: Maybe [Filter]

    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.

  • nextToken :: Maybe Text

    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.

  • sortOrder :: Maybe 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.

  • maxResults :: Maybe Natural

    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.

  • sortBy :: Maybe Text

    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 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.

Instances

Instances details
Eq ListResolverQueryLogConfigAssociations Source # 
Instance details

Defined in Amazonka.Route53Resolver.ListResolverQueryLogConfigAssociations

Read ListResolverQueryLogConfigAssociations Source # 
Instance details

Defined in Amazonka.Route53Resolver.ListResolverQueryLogConfigAssociations

Show ListResolverQueryLogConfigAssociations Source # 
Instance details

Defined in Amazonka.Route53Resolver.ListResolverQueryLogConfigAssociations

Generic ListResolverQueryLogConfigAssociations Source # 
Instance details

Defined in Amazonka.Route53Resolver.ListResolverQueryLogConfigAssociations

NFData ListResolverQueryLogConfigAssociations Source # 
Instance details

Defined in Amazonka.Route53Resolver.ListResolverQueryLogConfigAssociations

Hashable ListResolverQueryLogConfigAssociations Source # 
Instance details

Defined in Amazonka.Route53Resolver.ListResolverQueryLogConfigAssociations

ToJSON ListResolverQueryLogConfigAssociations Source # 
Instance details

Defined in Amazonka.Route53Resolver.ListResolverQueryLogConfigAssociations

AWSPager ListResolverQueryLogConfigAssociations Source # 
Instance details

Defined in Amazonka.Route53Resolver.ListResolverQueryLogConfigAssociations

AWSRequest ListResolverQueryLogConfigAssociations Source # 
Instance details

Defined in Amazonka.Route53Resolver.ListResolverQueryLogConfigAssociations

ToHeaders ListResolverQueryLogConfigAssociations Source # 
Instance details

Defined in Amazonka.Route53Resolver.ListResolverQueryLogConfigAssociations

ToPath ListResolverQueryLogConfigAssociations Source # 
Instance details

Defined in Amazonka.Route53Resolver.ListResolverQueryLogConfigAssociations

ToQuery ListResolverQueryLogConfigAssociations Source # 
Instance details

Defined in Amazonka.Route53Resolver.ListResolverQueryLogConfigAssociations

type Rep ListResolverQueryLogConfigAssociations Source # 
Instance details

Defined in Amazonka.Route53Resolver.ListResolverQueryLogConfigAssociations

type Rep ListResolverQueryLogConfigAssociations = D1 ('MetaData "ListResolverQueryLogConfigAssociations" "Amazonka.Route53Resolver.ListResolverQueryLogConfigAssociations" "libZSservicesZSamazonka-route53resolverZSamazonka-route53resolver" 'False) (C1 ('MetaCons "ListResolverQueryLogConfigAssociations'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "filters") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Filter])) :*: S1 ('MetaSel ('Just "nextToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :*: (S1 ('MetaSel ('Just "sortOrder") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe SortOrder)) :*: (S1 ('MetaSel ('Just "maxResults") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)) :*: S1 ('MetaSel ('Just "sortBy") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))))))
type AWSResponse ListResolverQueryLogConfigAssociations Source # 
Instance details

Defined in Amazonka.Route53Resolver.ListResolverQueryLogConfigAssociations

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 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.

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 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.

Destructuring the Response

data ListResolverQueryLogConfigAssociationsResponse Source #

Constructors

ListResolverQueryLogConfigAssociationsResponse' 

Fields

  • totalFilteredCount :: Maybe Int

    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.

  • resolverQueryLogConfigAssociations :: Maybe [ResolverQueryLogConfigAssociation]

    A list that contains one ResolverQueryLogConfigAssociations element for each query logging association that matches the values that you specified for Filter.

  • nextToken :: Maybe Text

    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.

  • totalCount :: Maybe Int

    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.

  • httpStatus :: Int

    The response's http status code.

Instances

Instances details
Eq ListResolverQueryLogConfigAssociationsResponse Source # 
Instance details

Defined in Amazonka.Route53Resolver.ListResolverQueryLogConfigAssociations

Read ListResolverQueryLogConfigAssociationsResponse Source # 
Instance details

Defined in Amazonka.Route53Resolver.ListResolverQueryLogConfigAssociations

Show ListResolverQueryLogConfigAssociationsResponse Source # 
Instance details

Defined in Amazonka.Route53Resolver.ListResolverQueryLogConfigAssociations

Generic ListResolverQueryLogConfigAssociationsResponse Source # 
Instance details

Defined in Amazonka.Route53Resolver.ListResolverQueryLogConfigAssociations

NFData ListResolverQueryLogConfigAssociationsResponse Source # 
Instance details

Defined in Amazonka.Route53Resolver.ListResolverQueryLogConfigAssociations

type Rep ListResolverQueryLogConfigAssociationsResponse Source # 
Instance details

Defined in Amazonka.Route53Resolver.ListResolverQueryLogConfigAssociations

type Rep ListResolverQueryLogConfigAssociationsResponse = D1 ('MetaData "ListResolverQueryLogConfigAssociationsResponse" "Amazonka.Route53Resolver.ListResolverQueryLogConfigAssociations" "libZSservicesZSamazonka-route53resolverZSamazonka-route53resolver" 'False) (C1 ('MetaCons "ListResolverQueryLogConfigAssociationsResponse'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "totalFilteredCount") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Int)) :*: S1 ('MetaSel ('Just "resolverQueryLogConfigAssociations") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [ResolverQueryLogConfigAssociation]))) :*: (S1 ('MetaSel ('Just "nextToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 ('MetaSel ('Just "totalCount") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Int)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))))

newListResolverQueryLogConfigAssociationsResponse Source #

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.