Package com.google.cloud.dns

Class ChangeRequest

java.lang.Object

com.google.cloud.dns.ChangeRequestInfo

com.google.cloud.dns.ChangeRequest

All Implemented Interfaces:

Serializable

public class ChangeRequest
extends ChangeRequestInfo

An immutable class representing an atomic update to a collection of RecordSets within a Zone.

See Also:

Google Cloud DNS documentation, Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	ChangeRequest.Builder	A builder for ChangeRequests.

Nested classes/interfaces inherited from class com.google.cloud.dns.ChangeRequestInfo

ChangeRequestInfo.Status

Method Summary

Modifier and Type	Method	Description
ChangeRequest	applyTo(String zoneName, Dns.ChangeRequestOption... options)	Applies this change request to the zone identified by zoneName.
boolean	equals(Object obj)
Dns	getDns()	Returns the change request's Dns object used to issue requests.
String	getZone()	Returns the name of the Zone associated with this change request.
int	hashCode()
boolean	isDone()	Returns true if the change request has been completed.
ChangeRequest	reload(Dns.ChangeRequestOption... options)	Retrieves the up-to-date information about the change request from Google Cloud DNS.
ChangeRequest.Builder	toBuilder()	Creates a builder populated with values of this ChangeRequestInfo.

Methods inherited from class com.google.cloud.dns.ChangeRequestInfo

getAdditions, getDeletions, getGeneratedId, getStartTimeMillis, getStatus, newBuilder, status, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Method Detail

getZone

public String getZone()

Returns the name of the Zone associated with this change request.

getDns

public Dns getDns()

Returns the change request's Dns object used to issue requests.

applyTo

public ChangeRequest applyTo(String zoneName,
                             Dns.ChangeRequestOption... options)

Applies this change request to the zone identified by zoneName.

Throws:

DnsException - upon failure or if zone is not found

reload

public ChangeRequest reload(Dns.ChangeRequestOption... options)

Retrieves the up-to-date information about the change request from Google Cloud DNS. Parameter options can be used to restrict the fields to be included in the updated object the same way as in Dns.getChangeRequest(String, String, Dns.ChangeRequestOption...). If options are provided, any field other than generatedId which is not included in the options will be null regardless of whether they are initialized or not in this instance.

Returns:

an object with the updated information or null if it does not exist

Throws:

DnsException - upon failure of the API call or if the associated zone was not found

isDone

public boolean isDone()

Returns true if the change request has been completed. If the status is not ChangeRequestInfo.Status.DONE already, the method makes an API call to Google Cloud DNS to update the change request first.

Throws:

DnsException - upon failure of the API call or if the associated zone was not found

toBuilder

public ChangeRequest.Builder toBuilder()

Description copied from class: ChangeRequestInfo

Creates a builder populated with values of this ChangeRequestInfo.

Overrides:

toBuilder in class ChangeRequestInfo

equals

public final boolean equals(Object obj)

Overrides:

equals in class ChangeRequestInfo

hashCode

public final int hashCode()

Overrides:

hashCode in class ChangeRequestInfo