Route53Resolver / Client / get_resolver_query_log_config_association

get_resolver_query_log_config_association#

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

        • ACTIVE: 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