amazonka-route53-1.4.0: Amazon Route 53 SDK.

Copyright(c) 2013-2016 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone
LanguageHaskell2010

Network.AWS.Route53.ChangeResourceRecordSets

Contents

Description

Use this action to create or change your authoritative DNS information. To use this action, send a POST request to the '/Route 53 API version/hostedzone/hosted Zone ID/rrset' resource. The request body must include a 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 POST ChangeResourceRecordSets in the Amazon Route 53 API Reference.

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, Amazon Route 53 returns an InvalidChangeBatch error.

In response to a ChangeResourceRecordSets request, your DNS data is changed on all Amazon Route 53 DNS servers. Initially, the status of a change is PENDING. This means the change has not yet propagated to all the authoritative Amazon 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.

Synopsis

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.