Amazon Route 53
API Reference (API Version 2012-12-12)
AWS Documentation » Amazon Route 53 » API Reference » Actions on Resource Record Sets » GET GetChange
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Did this page help you?  Yes | No |  Tell us about it...

GET GetChange

Topics

Description

This action returns the current status of a change batch request. The status is one of the following values:

  • PENDING indicates that the changes in this request have not replicated to all Route 53 DNS servers. This is the initial status of all change batch requests.

  • INSYNC indicates that the changes have replicated to all Route 53 DNS servers.

Requests

Syntax

GET /2012-12-12/change/change ID

Headers

The request must include the headers that are required in all Route 53 requests. For more information, see Common Headers.

Parameters

change ID (Required)

The ID of the change batch request. The value that you specify here is the value that POST ChangeResourceRecordSets returned in the Id element when you submitted the request.

Type: String

Default: None

Responses

Syntax

HTTP/1.1 200 OK
<?xml version="1.0" encoding="UTF-8"?>
<GetChangeResponse xmlns="https://route53.amazonaws.com/doc/2012-12-12/">
   <ChangeInfo>
      <Id>unique identifier for the change batch request</Id>
      <Status>PENDING | INSYNC</Status>
      <SubmittedAt>date and time in Coordinated Universal Time 
         format</SubmittedAt>
   </ChangeInfo>
</GetChangeResponse>

Elements

GetChangeResponse

A complex type that contains the ChangeInfo element.

Type: Complex

Children: ChangeInfo

ChangeInfo

A complex type that contains information about the specified change batch.

Type: Complex

Parent: GetChangeResponse

Children: Id, Status, SubmittedAt

Id

The ID of the change batch. This is the value that you specified in the change ID parameter when you submitted the request.

Type: String

Parent: ChangeInfo

Status

The current status of the change batch request:

  • PENDING indicates that the changes in this request have not replicated to all Route 53 DNS servers.

  • INSYNC indicates that the changes have replicated to all Route 53 DNS servers.

Type: String

Valid Values: PENDING | INSYNC

Parent: ChangeInfo

SubmittedAt

The date and time that the change batch request was submitted. The Z after the time indicates that the time is listed in Coordinated Universal Time (UTC), which is synonymous with Greenwich Mean Time in this context.

Type: Timestamp

Parent: ChangeInfo

Headers

The response will include the headers in all Route 53 responses. For more information, see Common Headers.

Errors

Route 53 returns the following errors for this action.

InvalidInput

The input is not valid.

NoSuchChange

A change with the specified change ID does not exist.

Example

Request

GET /2012-12-12/change/C2682N5HXP0BZ4

Response

HTTP/1.1 200 OK
<?xml version="1.0" encoding="UTF-8"?>
<GetChangeResponse xmlns="https://route53.amazonaws.com/doc/2012-12-12/">
   <ChangeInfo>
      <Id>C2682N5HXP0BZ4</Id>
      <Status>INSYNC</Status>
      <SubmittedAt>2011-09-10T01:36:41.958Z</SubmittedAt>
   </ChangeInfo>
</GetChangeResponse>
Document Conventions« PreviousNext »
Terms of UseDid this page help you?  Yes | No |  Tell us about it...