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