changes

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

Overview

Name	changes
Type	Resource
Id	aws.route53.changes

Fields

The following fields are returned by SELECT queries:

get_change

Name	Datatype	Description
comment	string	A comment you can provide.
id	string	This element contains an ID that you use when performing a GetChange action to get detailed information about the change.
status	string	The current state of the request. PENDING indicates that this request has not yet been applied to all Amazon Route 53 DNS servers.
submitted_at	string	The date and time that the change request was submitted in ISO 8601 format and Coordinated Universal Time (UTC). For example, the value 2017-03-27T17:48:16.751Z represents March 27, 2017 at 17:48:16.751 UTC.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_change	select	id, region		Returns the current status of a change batch request. The status is one of the following values: PENDING indicates that the changes in this request have not propagated to all Amazon Route 53 DNS servers managing the hosted zone. This is the initial status of all change batch requests. INSYNC indicates that the changes have propagated to all Route 53 DNS servers managing the hosted zone.
change_cidr_collection	exec	cidr_collection_id, region, Changes		Creates, changes, or deletes CIDR blocks within a collection. Contains authoritative IP information mapping blocks to one or multiple locations. A change request can update multiple locations in a collection at a time, which is helpful if you want to move one or more CIDR blocks from one location to another in one transaction, without downtime. Limits The max number of CIDR blocks included in the request is 1000. As a result, big updates require multiple API calls. PUT and DELETE_IF_EXISTS Use ChangeCidrCollection to perform the following actions: PUT: Create a CIDR block within the specified collection. DELETE_IF_EXISTS: Delete an existing CIDR block from the collection.
change_tags_for_resource	exec	resource_type, resource_id, region		Adds, edits, or deletes tags for a health check or a hosted zone. For information about using tags for cost allocation, see Using Cost Allocation Tags in the Billing and Cost Management User Guide.

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
cidr_collection_id	string	The UUID of the CIDR collection to update.
id	string	The ID of the change batch request. The value that you specify here is the value that ChangeResourceRecordSets returned in the Id element when you submitted the request.
region	string	AWS region (default: us-east-1)
resource_id	string	The ID of the resource for which you want to add, change, or delete tags.
resource_type	string	The type of the resource. The resource type for health checks is healthcheck. The resource type for hosted zones is hostedzone.

SELECT examples

get_change

Returns the current status of a change batch request. The status is one of the following values: PENDING indicates that the changes in this request have not propagated to all Amazon Route 53 DNS servers managing the hosted zone. This is the initial status of all change batch requests. INSYNC indicates that the changes have propagated to all Route 53 DNS servers managing the hosted zone.

SELECT
comment,
id,
status,
submitted_at
FROM aws.route53.changes
WHERE id = '{{ id }}' -- required
AND region = '{{ region }}' -- required
;

Lifecycle Methods

change_cidr_collection

Creates, changes, or deletes CIDR blocks within a collection. Contains authoritative IP information mapping blocks to one or multiple locations. A change request can update multiple locations in a collection at a time, which is helpful if you want to move one or more CIDR blocks from one location to another in one transaction, without downtime. Limits The max number of CIDR blocks included in the request is 1000. As a result, big updates require multiple API calls. PUT and DELETE_IF_EXISTS Use ChangeCidrCollection to perform the following actions: PUT: Create a CIDR block within the specified collection. DELETE_IF_EXISTS: Delete an existing CIDR block from the collection.

EXEC aws.route53.changes.change_cidr_collection 
@cidr_collection_id='{{ cidr_collection_id }}' --required, 
@region='{{ region }}' --required 
@@json=
'{
"CollectionVersion": {{ CollectionVersion }}, 
"Changes": "{{ Changes }}"
}'
;

change_tags_for_resource

Adds, edits, or deletes tags for a health check or a hosted zone. For information about using tags for cost allocation, see Using Cost Allocation Tags in the Billing and Cost Management User Guide.

EXEC aws.route53.changes.change_tags_for_resource 
@resource_type='{{ resource_type }}' --required, 
@resource_id='{{ resource_id }}' --required, 
@region='{{ region }}' --required 
@@json=
'{
"AddTags": "{{ AddTags }}", 
"RemoveTagKeys": "{{ RemoveTagKeys }}"
}'
;