resolver_query_log_config_associations
Creates, updates, deletes, gets or lists a resolver_query_log_config_associations resource.
Overview
| Name | resolver_query_log_config_associations |
| Type | Resource |
| Id | aws.route53resolver.resolver_query_log_config_associations |
Fields
The following fields are returned by SELECT queries:
- get_resolver_query_log_config_association
- list_resolver_query_log_config_associations
| Name | Datatype | Description |
|---|---|---|
creation_time | string | The date and time that the VPC was associated with the query logging configuration, in Unix time format and Coordinated Universal Time (UTC). |
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. (NONE, DESTINATION_NOT_FOUND, ACCESS_DENIED, INTERNAL_SERVICE_ERROR) |
error_message | string | Contains additional information about the error. If the value or Error is null, the value of ErrorMessage also is null. |
id | string | The ID of the query logging association. |
resolver_query_log_config_id | string | The ID of the query logging configuration that a VPC is associated with. |
resource_id | 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. (CREATING, ACTIVE, ACTION_NEEDED, DELETING, FAILED) |
| Name | Datatype | Description |
|---|---|---|
creation_time | string | The date and time that the VPC was associated with the query logging configuration, in Unix time format and Coordinated Universal Time (UTC). |
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. (NONE, DESTINATION_NOT_FOUND, ACCESS_DENIED, INTERNAL_SERVICE_ERROR) |
error_message | string | Contains additional information about the error. If the value or Error is null, the value of ErrorMessage also is null. |
id | string | The ID of the query logging association. |
resolver_query_log_config_id | string | The ID of the query logging configuration that a VPC is associated with. |
resource_id | 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. (CREATING, ACTIVE, ACTION_NEEDED, DELETING, FAILED) |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get_resolver_query_log_config_association | select | region | 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. | |
list_resolver_query_log_config_associations | select | region | Lists 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.
| Name | Datatype | Description |
|---|---|---|
region | string | AWS region (default: us-east-1) |
SELECT examples
- get_resolver_query_log_config_association
- list_resolver_query_log_config_associations
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
;
Lists information about associations between Amazon VPCs and query logging configurations.
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
;