Did this page help you?

   Yes   No   Tell us about it...

com.amazonaws.services.route53.model
Class ChangeResourceRecordSetsRequest

java.lang.Object
  extended by com.amazonaws.AmazonWebServiceRequest
      extended by com.amazonaws.services.route53.model.ChangeResourceRecordSetsRequest
All Implemented Interfaces:
Serializable

public class ChangeResourceRecordSetsRequest
extends AmazonWebServiceRequest
implements Serializable

Container for the parameters to the ChangeResourceRecordSets operation.

Use this action to create or change your authoritative DNS information. To use this action, send a POST request to the 2012-12-12/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 .

IMPORTANT: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 Also:
AmazonRoute53.changeResourceRecordSets(ChangeResourceRecordSetsRequest), Serialized Form

Constructor Summary
ChangeResourceRecordSetsRequest()
          Default constructor for a new ChangeResourceRecordSetsRequest object.
ChangeResourceRecordSetsRequest(String hostedZoneId, ChangeBatch changeBatch)
          Constructs a new ChangeResourceRecordSetsRequest object.
 
Method Summary
 boolean equals(Object obj)
           
 ChangeBatch getChangeBatch()
          A complex type that contains an optional comment and the Changes element.
 String getHostedZoneId()
          Alias resource record sets only: The value of the hosted zone ID for the AWS resource.
 int hashCode()
           
 void setChangeBatch(ChangeBatch changeBatch)
          A complex type that contains an optional comment and the Changes element.
 void setHostedZoneId(String hostedZoneId)
          Alias resource record sets only: The value of the hosted zone ID for the AWS resource.
 String toString()
          Returns a string representation of this object; useful for testing and debugging.
 ChangeResourceRecordSetsRequest withChangeBatch(ChangeBatch changeBatch)
          A complex type that contains an optional comment and the Changes element.
 ChangeResourceRecordSetsRequest withHostedZoneId(String hostedZoneId)
          Alias resource record sets only: The value of the hosted zone ID for the AWS resource.
 
Methods inherited from class com.amazonaws.AmazonWebServiceRequest
copyPrivateRequestParameters, getRequestClientOptions, getRequestCredentials, setRequestCredentials
 
Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait
 

Constructor Detail

ChangeResourceRecordSetsRequest

public ChangeResourceRecordSetsRequest()
Default constructor for a new ChangeResourceRecordSetsRequest object. Callers should use the setter or fluent setter (with...) methods to initialize this object after creating it.


ChangeResourceRecordSetsRequest

public ChangeResourceRecordSetsRequest(String hostedZoneId,
                                       ChangeBatch changeBatch)
Constructs a new ChangeResourceRecordSetsRequest object. Callers should use the setter or fluent setter (with...) methods to initialize any additional object members.

Parameters:
hostedZoneId - Alias resource record sets only: The value of the hosted zone ID for the AWS resource.

For more information, an example, and several ways to get the hosted zone ID for the LoadBalancer, see Creating Alias Resource Record Sets for Elastic Load Balancing in the Amazon Route 53 Developer Guide.

changeBatch - A complex type that contains an optional comment and the Changes element.
Method Detail

getHostedZoneId

public String getHostedZoneId()
Alias resource record sets only: The value of the hosted zone ID for the AWS resource.

For more information, an example, and several ways to get the hosted zone ID for the LoadBalancer, see Creating Alias Resource Record Sets for Elastic Load Balancing in the Amazon Route 53 Developer Guide.

Constraints:
Length: 0 - 32

Returns:
Alias resource record sets only: The value of the hosted zone ID for the AWS resource.

For more information, an example, and several ways to get the hosted zone ID for the LoadBalancer, see Creating Alias Resource Record Sets for Elastic Load Balancing in the Amazon Route 53 Developer Guide.


setHostedZoneId

public void setHostedZoneId(String hostedZoneId)
Alias resource record sets only: The value of the hosted zone ID for the AWS resource.

For more information, an example, and several ways to get the hosted zone ID for the LoadBalancer, see Creating Alias Resource Record Sets for Elastic Load Balancing in the Amazon Route 53 Developer Guide.

Constraints:
Length: 0 - 32

Parameters:
hostedZoneId - Alias resource record sets only: The value of the hosted zone ID for the AWS resource.

For more information, an example, and several ways to get the hosted zone ID for the LoadBalancer, see Creating Alias Resource Record Sets for Elastic Load Balancing in the Amazon Route 53 Developer Guide.


withHostedZoneId

public ChangeResourceRecordSetsRequest withHostedZoneId(String hostedZoneId)
Alias resource record sets only: The value of the hosted zone ID for the AWS resource.

For more information, an example, and several ways to get the hosted zone ID for the LoadBalancer, see Creating Alias Resource Record Sets for Elastic Load Balancing in the Amazon Route 53 Developer Guide.

Returns a reference to this object so that method calls can be chained together.

Constraints:
Length: 0 - 32

Parameters:
hostedZoneId - Alias resource record sets only: The value of the hosted zone ID for the AWS resource.

For more information, an example, and several ways to get the hosted zone ID for the LoadBalancer, see Creating Alias Resource Record Sets for Elastic Load Balancing in the Amazon Route 53 Developer Guide.

Returns:
A reference to this updated object so that method calls can be chained together.

getChangeBatch

public ChangeBatch getChangeBatch()
A complex type that contains an optional comment and the Changes element.

Returns:
A complex type that contains an optional comment and the Changes element.

setChangeBatch

public void setChangeBatch(ChangeBatch changeBatch)
A complex type that contains an optional comment and the Changes element.

Parameters:
changeBatch - A complex type that contains an optional comment and the Changes element.

withChangeBatch

public ChangeResourceRecordSetsRequest withChangeBatch(ChangeBatch changeBatch)
A complex type that contains an optional comment and the Changes element.

Returns a reference to this object so that method calls can be chained together.

Parameters:
changeBatch - A complex type that contains an optional comment and the Changes element.
Returns:
A reference to this updated object so that method calls can be chained together.

toString

public String toString()
Returns a string representation of this object; useful for testing and debugging.

Overrides:
toString in class Object
Returns:
A string representation of this object.
See Also:
Object.toString()

hashCode

public int hashCode()
Overrides:
hashCode in class Object

equals

public boolean equals(Object obj)
Overrides:
equals in class Object


Copyright © 2010 Amazon Web Services, Inc. All Rights Reserved.