amazonka-route53-1.3.1: Amazon Route 53 SDK.

Copyright(c) 2013-2015 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <>
Portabilitynon-portable (GHC extensions)
Safe HaskellNone




Use this action to create or change your authoritative DNS information. To use this action, send a POST request to the '2013-04-01/hostedzone/hosted Zone ID/rrset' resource. The request body must include an XML document with a ChangeResourceRecordSetsRequest element.

Changes are a list of change items and are considered transactional. For more information on transactional changes, also known as change batches, see Creating, Changing, and Deleting Resource Record Sets Using the Route 53 API in the Amazon Route 53 Developer Guide.

Due to the nature of transactional changes, you cannot delete the same resource record set more than once in a single change batch. If you attempt to delete the same change batch more than once, Route 53 returns an InvalidChangeBatch error.

In response to a ChangeResourceRecordSets request, your DNS data is changed on all Route 53 DNS servers. Initially, the status of a change is PENDING. This means the change has not yet propagated to all the authoritative Route 53 DNS servers. When the change is propagated to all hosts, the change returns a status of INSYNC.

Note the following limitations on a ChangeResourceRecordSets request:

  • A request cannot contain more than 100 Change elements.
  • A request cannot contain more than 1000 ResourceRecord elements.

The sum of the number of characters (including spaces) in all Value elements in a request cannot exceed 32,000 characters.

See: AWS API Reference for ChangeResourceRecordSets.


Creating a Request

changeResourceRecordSets Source

Creates a value of ChangeResourceRecordSets with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

Request Lenses

crrsHostedZoneId :: Lens' ChangeResourceRecordSets Text Source

The ID of the hosted zone that contains the resource record sets that you want to change.

crrsChangeBatch :: Lens' ChangeResourceRecordSets ChangeBatch Source

A complex type that contains an optional comment and the Changes element.

Destructuring the Response

changeResourceRecordSetsResponse Source

Creates a value of ChangeResourceRecordSetsResponse with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

Response Lenses

crrsrsChangeInfo :: Lens' ChangeResourceRecordSetsResponse ChangeInfo Source

A complex type that contains information about changes made to your hosted zone.

This element contains an ID that you use when performing a GetChange action to get detailed information about the change.