Skip to main content

resolver_query_log_config_associations

Creates, updates, deletes, gets or lists a resolver_query_log_config_associations resource.

Overview

Nameresolver_query_log_config_associations
TypeResource
Idaws.route53resolver.resolver_query_log_config_associations

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
creation_timestringThe date and time that the VPC was associated with the query logging configuration, in Unix time format and Coordinated Universal Time (UTC).
errorstringIf 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. (NONE, DESTINATION_NOT_FOUND, ACCESS_DENIED, INTERNAL_SERVICE_ERROR)
error_messagestringContains additional information about the error. If the value or Error is null, the value of ErrorMessage also is null.
idstringThe ID of the query logging association.
resolver_query_log_config_idstringThe ID of the query logging configuration that a VPC is associated with.
resource_idstringThe ID of the Amazon VPC that is associated with the query logging configuration.
statusstringThe 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. (CREATING, ACTIVE, ACTION_NEEDED, DELETING, FAILED)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_resolver_query_log_config_associationselectregionGets 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.
list_resolver_query_log_config_associationsselectregionLists information about associations between Amazon VPCs and query logging configurations.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
regionstringAWS region (default: us-east-1)

SELECT examples

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.

SELECT
creation_time,
error,
error_message,
id,
resolver_query_log_config_id,
resource_id,
status
FROM aws.route53resolver.resolver_query_log_config_associations
WHERE region = '{{ region }}' -- required
;