amazonka-route53resolver-2.0: Amazon Route 53 Resolver SDK.
Copyright(c) 2013-2023 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellSafe-Inferred
LanguageHaskell2010

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.

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

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

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

Instances

Instances details
ToJSON 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

AWSPager ListResolverQueryLogConfigAssociations Source # 
Instance details

Defined in Amazonka.Route53Resolver.ListResolverQueryLogConfigAssociations

AWSRequest ListResolverQueryLogConfigAssociations Source # 
Instance details

Defined in Amazonka.Route53Resolver.ListResolverQueryLogConfigAssociations

Generic 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

NFData ListResolverQueryLogConfigAssociations Source # 
Instance details

Defined in Amazonka.Route53Resolver.ListResolverQueryLogConfigAssociations

Eq ListResolverQueryLogConfigAssociations Source # 
Instance details

Defined in Amazonka.Route53Resolver.ListResolverQueryLogConfigAssociations

Hashable ListResolverQueryLogConfigAssociations Source # 
Instance details

Defined in Amazonka.Route53Resolver.ListResolverQueryLogConfigAssociations

type AWSResponse 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" "amazonka-route53resolver-2.0-GFukx1WIgCPEXMh1BiYlp6" 'False) (C1 ('MetaCons "ListResolverQueryLogConfigAssociations'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "filters") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Filter])) :*: S1 ('MetaSel ('Just "maxResults") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural))) :*: (S1 ('MetaSel ('Just "nextToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 ('MetaSel ('Just "sortBy") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "sortOrder") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe SortOrder))))))

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

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

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

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

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.

Destructuring the Response

data ListResolverQueryLogConfigAssociationsResponse Source #

Constructors

ListResolverQueryLogConfigAssociationsResponse' 

Fields

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

  • resolverQueryLogConfigAssociations :: Maybe [ResolverQueryLogConfigAssociation]

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

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

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

  • httpStatus :: Int

    The response's http status code.

Instances

Instances details
Generic 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

NFData ListResolverQueryLogConfigAssociationsResponse Source # 
Instance details

Defined in Amazonka.Route53Resolver.ListResolverQueryLogConfigAssociations

Eq 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" "amazonka-route53resolver-2.0-GFukx1WIgCPEXMh1BiYlp6" 'False) (C1 ('MetaCons "ListResolverQueryLogConfigAssociationsResponse'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "nextToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "resolverQueryLogConfigAssociations") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [ResolverQueryLogConfigAssociation]))) :*: (S1 ('MetaSel ('Just "totalCount") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Int)) :*: (S1 ('MetaSel ('Just "totalFilteredCount") '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:

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: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: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: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:httpStatus:ListResolverQueryLogConfigAssociationsResponse', listResolverQueryLogConfigAssociationsResponse_httpStatus - The response's http status code.

Response Lenses

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