GetHostedZoneChangeBatch
Returns one change batch from the change history of a hosted zone, including every change in the batch. Each resource record set is in the same form that ListResourceRecordSets returns. For example, the name is in lowercase and ends with a dot. For an UPSERT or a DELETE, the response doesn't contain the values that the resource record set had before the change.
If the change batch isn't in the hosted zone's retained change history, for example because it's in another hosted zone, it expired, or it's from before RetentionStartsAt, Route 53 returns a NoSuchChange error. If Change History isn't turned on for the hosted zone, Route 53 returns a FeatureNotEnabled error.
Request Syntax
GET /2013-04-01/hostedzone/Id/changebatches/ChangeId HTTP/1.1
URI Request Parameters
The request uses the following URI parameters.
- ChangeId
-
The ID of the change batch that you want to get. This is the ID that
ChangeResourceRecordSetsreturns inChangeInfo/Id. You can specify the ID with or without the/change/prefix.Length Constraints: Maximum length of 32.
Required: Yes
- Id
-
The ID of the hosted zone that contains the change batch.
Length Constraints: Maximum length of 32.
Required: Yes
Request Body
The request does not have a request body.
Response Syntax
HTTP/1.1 200
<?xml version="1.0" encoding="UTF-8"?>
<GetHostedZoneChangeBatchResponse>
<ChangeBatch>
<Changes>
<Change>
<Action>string</Action>
<ResourceRecordSet>
<AliasTarget>
<DNSName>string</DNSName>
<EvaluateTargetHealth>boolean</EvaluateTargetHealth>
<HostedZoneId>string</HostedZoneId>
</AliasTarget>
<AZAffinity>
<LocationId>string</LocationId>
<LocationType>string</LocationType>
</AZAffinity>
<CidrRoutingConfig>
<CollectionId>string</CollectionId>
<LocationName>string</LocationName>
</CidrRoutingConfig>
<Failover>string</Failover>
<GeoLocation>
<ContinentCode>string</ContinentCode>
<CountryCode>string</CountryCode>
<SubdivisionCode>string</SubdivisionCode>
</GeoLocation>
<GeoProximityLocation>
<AWSRegion>string</AWSRegion>
<Bias>integer</Bias>
<Coordinates>
<Latitude>string</Latitude>
<Longitude>string</Longitude>
</Coordinates>
<LocalZoneGroup>string</LocalZoneGroup>
</GeoProximityLocation>
<HealthCheckId>string</HealthCheckId>
<MultiValueAnswer>boolean</MultiValueAnswer>
<Name>string</Name>
<Region>string</Region>
<ResourceRecords>
<ResourceRecord>
<Value>string</Value>
</ResourceRecord>
</ResourceRecords>
<SetIdentifier>string</SetIdentifier>
<TrafficPolicyInstanceId>string</TrafficPolicyInstanceId>
<TTL>long</TTL>
<Type>string</Type>
<Weight>long</Weight>
</ResourceRecordSet>
</Change>
</Changes>
<Comment>string</Comment>
</ChangeBatch>
<ChangeBatchSummary>
<ChangeCount>long</ChangeCount>
<ChangeId>string</ChangeId>
<Comment>string</Comment>
<Operation>string</Operation>
<RequestId>string</RequestId>
<SubmittedAt>timestamp</SubmittedAt>
<SubmittedBy>string</SubmittedBy>
</ChangeBatchSummary>
</GetHostedZoneChangeBatchResponse>
Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in XML format by the service.
- GetHostedZoneChangeBatchResponse
-
Root level tag for the GetHostedZoneChangeBatchResponse parameters.
Required: Yes
- ChangeBatch
-
The changes in the change batch. Each resource record set is in the same form that
ListResourceRecordSetsreturns. For example, the name is in lowercase and ends with a dot.Type: ChangeBatch object
- ChangeBatchSummary
-
A summary of the change batch, including who submitted it and when.
Type: ChangeBatchSummary object
Errors
For information about the errors that are common to all actions, see Common Error Types.
- FeatureNotEnabled
-
This error occurs when a feature that the operation requires isn't turned on for the hosted zone. For example, the tier of the hosted zone doesn't include Change History. To resolve this error, turn on the feature, or move the hosted zone to a tier that includes it.
- message
-
A message that explains which feature isn't turned on.
HTTP Status Code: 403
- InvalidInput
-
The input is not valid.
- message
HTTP Status Code: 400
- NoSuchChange
-
A change with the specified change ID does not exist.
HTTP Status Code: 404
- NoSuchHostedZone
-
No hosted zone exists with the ID that you specified.
- message
HTTP Status Code: 404
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: