View a markdown version of this page

GetHostedZoneChangeBatch - Amazon Route 53

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 ChangeResourceRecordSets returns in ChangeInfo/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 ListResourceRecordSets returns. 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: