Copyright | (c) 2013-2015 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay <brendan.g.hay@gmail.com> |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | None |
Language | Haskell2010 |
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.
- changeResourceRecordSets :: Text -> ChangeBatch -> ChangeResourceRecordSets
- data ChangeResourceRecordSets
- crrsHostedZoneId :: Lens' ChangeResourceRecordSets Text
- crrsChangeBatch :: Lens' ChangeResourceRecordSets ChangeBatch
- changeResourceRecordSetsResponse :: Int -> ChangeInfo -> ChangeResourceRecordSetsResponse
- data ChangeResourceRecordSetsResponse
- crrsrsStatus :: Lens' ChangeResourceRecordSetsResponse Int
- crrsrsChangeInfo :: Lens' ChangeResourceRecordSetsResponse ChangeInfo
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:
data ChangeResourceRecordSets Source
A complex type that contains a change batch.
See: changeResourceRecordSets
smart constructor.
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:
data ChangeResourceRecordSetsResponse Source
A complex type containing the response for the request.
See: changeResourceRecordSetsResponse
smart constructor.
Response Lenses
crrsrsStatus :: Lens' ChangeResourceRecordSetsResponse Int Source
The response status code.
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.