get_resolver_query_log_config_association

get_resolver_query_log_config_association(**kwargs)

Gets information about a specified association between a Resolver query logging configuration and an Amazon VPC. When you associate a VPC with a query logging configuration, Resolver logs DNS queries that originate in that VPC.

See also: AWS API Documentation

Request Syntax

response = client.get_resolver_query_log_config_association(
    ResolverQueryLogConfigAssociationId='string'
)
Parameters
ResolverQueryLogConfigAssociationId (string) --

[REQUIRED]

The ID of the Resolver query logging configuration association that you want to get information about.

Return type
dict
Returns
Response Syntax
{
    'ResolverQueryLogConfigAssociation': {
        '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'
    }
}

Response Structure

  • (dict) --
    • ResolverQueryLogConfigAssociation (dict) --

      Information about the Resolver query logging configuration association that you specified in a GetQueryLogConfigAssociation request.

      • Id (string) --

        The ID of the query logging association.

      • ResolverQueryLogConfigId (string) --

        The ID of the query logging configuration that a VPC is associated with.

      • ResourceId (string) --

        The ID of the Amazon VPC that is associated with the query logging configuration.

      • Status (string) --

        The status of the specified query logging association. 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.
      • Error (string) --

        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 the value of Status is a value other than FAILED , Error is null.

      • ErrorMessage (string) --

        Contains additional information about the error. If the value or Error is null, the value of ErrorMessage also is null.

      • CreationTime (string) --

        The date and time that the VPC was associated with the query logging configuration, in Unix time format and Coordinated Universal Time (UTC).

Exceptions

  • Route53Resolver.Client.exceptions.ResourceNotFoundException
  • Route53Resolver.Client.exceptions.InvalidRequestException
  • Route53Resolver.Client.exceptions.InvalidParameterException
  • Route53Resolver.Client.exceptions.InternalServiceErrorException
  • Route53Resolver.Client.exceptions.ThrottlingException
  • Route53Resolver.Client.exceptions.AccessDeniedException