org.jclouds.dynect.v3.features

Interface RecordApi

public interface RecordApi

Author:

Adrian Cole

See Also:

RecordAsyncApi

Method Summary

Methods

Modifier and Type	Method and Description
Record<? extends Map<String,Object>>	get(RecordId recordId) retrieves a resource record without regard to type
Record<AData>	getA(String fqdn, long recordId) Gets the ARecord or null if not present.
Record<AAAAData>	getAAAA(String fqdn, long recordId) Gets the AAAARecord or null if not present.
Record<CNAMEData>	getCNAME(String fqdn, long recordId) Gets the CNAMERecord or null if not present.
Record<MXData>	getMX(String fqdn, long recordId) Gets the MXRecord or null if not present.
Record<NSData>	getNS(String fqdn, long recordId) Gets the NSRecord or null if not present.
Record<PTRData>	getPTR(String fqdn, long recordId) Gets the PTRRecord or null if not present.
SOARecord	getSOA(String fqdn, long recordId) Gets the SOARecord or null if not present.
Record<SRVData>	getSRV(String fqdn, long recordId) Gets the SRVRecord or null if not present.
Record<TXTData>	getTXT(String fqdn, long recordId) Gets the TXTRecord or null if not present.
com.google.common.collect.FluentIterable<RecordId>	list() Retrieves a list of resource record ids for all records of any type in the given zone.
com.google.common.collect.FluentIterable<RecordId>	listByFQDNAndType(String fqdn, String type) Retrieves a list of resource record ids for all records of the fqdn and type in the given zone
Job	scheduleCreate(CreateRecord<?> newRecord) Schedules addition of a new record into the current session.
Job	scheduleDelete(RecordId recordId) Schedules deletion of a record into the current session.

Method Detail

list

com.google.common.collect.FluentIterable<RecordId> list()
                                                        throws DynECTExceptions.JobStillRunningException

Retrieves a list of resource record ids for all records of any type in the given zone.

Throws:

DynECTExceptions.JobStillRunningException - if a different job in the session is still running

listByFQDNAndType

com.google.common.collect.FluentIterable<RecordId> listByFQDNAndType(String fqdn,
                                                                   String type)
                                                                     throws DynECTExceptions.JobStillRunningException

Retrieves a list of resource record ids for all records of the fqdn and type in the given zone

Throws:

DynECTExceptions.JobStillRunningException - if a different job in the session is still running

scheduleCreate

Job scheduleCreate(CreateRecord<?> newRecord)
                   throws DynECTExceptions.JobStillRunningException

Schedules addition of a new record into the current session. Calling ZoneApi.publish(String) will publish the zone, creating the record.

Parameters:

newRecord - record to create

Returns:

job relating to the scheduled creation.

Throws:

DynECTExceptions.JobStillRunningException - if a different job in the session is still running

scheduleDelete

@Nullable
Job scheduleDelete(RecordId recordId)
                   throws DynECTExceptions.JobStillRunningException

Schedules deletion of a record into the current session. Calling ZoneApi.publish(String) will publish the changes, deleting the record.

Parameters:

recordId - record to delete

Returns:

job relating to the scheduled deletion or null, if the record never existed.

Throws:

DynECTExceptions.JobStillRunningException - if a different job in the session is still running

get

Record<? extends Map<String,Object>> get(RecordId recordId)
                                         throws DynECTExceptions.JobStillRunningException

retrieves a resource record without regard to type

Returns:

null if not found

Throws:

DynECTExceptions.JobStillRunningException - if a different job in the session is still running

getAAAA

Record<AAAAData> getAAAA(String fqdn,
                       long recordId)
                         throws DynECTExceptions.JobStillRunningException

Gets the AAAARecord or null if not present.

Parameters:

fqdn - RecordId.getFQDN()

recordId - RecordId.getId()

Returns:

null if not found

Throws:

DynECTExceptions.JobStillRunningException - if a different job in the session is still running

getA

Record<AData> getA(String fqdn,
                 long recordId)
                   throws DynECTExceptions.JobStillRunningException

Gets the ARecord or null if not present.

Parameters:

fqdn - RecordId.getFQDN()

recordId - RecordId.getId()

Returns:

null if not found

Throws:

DynECTExceptions.JobStillRunningException - if a different job in the session is still running

getCNAME

Record<CNAMEData> getCNAME(String fqdn,
                         long recordId)
                           throws DynECTExceptions.JobStillRunningException

Gets the CNAMERecord or null if not present.

Parameters:

fqdn - RecordId.getFQDN()

recordId - RecordId.getId()

Returns:

null if not found

Throws:

DynECTExceptions.JobStillRunningException - if a different job in the session is still running

getMX

Record<MXData> getMX(String fqdn,
                   long recordId)
                     throws DynECTExceptions.JobStillRunningException

Gets the MXRecord or null if not present.

Parameters:

fqdn - RecordId.getFQDN()

recordId - RecordId.getId()

Returns:

null if not found

Throws:

DynECTExceptions.JobStillRunningException - if a different job in the session is still running

getNS

Record<NSData> getNS(String fqdn,
                   long recordId)
                     throws DynECTExceptions.JobStillRunningException

Gets the NSRecord or null if not present.

Parameters:

fqdn - RecordId.getFQDN()

recordId - RecordId.getId()

Returns:

null if not found

Throws:

DynECTExceptions.JobStillRunningException - if a different job in the session is still running

getPTR

Record<PTRData> getPTR(String fqdn,
                     long recordId)
                       throws DynECTExceptions.JobStillRunningException

Gets the PTRRecord or null if not present.

Parameters:

fqdn - RecordId.getFQDN()

recordId - RecordId.getId()

Returns:

null if not found

Throws:

DynECTExceptions.JobStillRunningException - if a different job in the session is still running

getSOA

SOARecord getSOA(String fqdn,
               long recordId)
                 throws DynECTExceptions.JobStillRunningException

Gets the SOARecord or null if not present.

Parameters:

fqdn - RecordId.getFQDN()

recordId - RecordId.getId()

Returns:

null if not found

Throws:

DynECTExceptions.JobStillRunningException - if a different job in the session is still running

getSRV

Record<SRVData> getSRV(String fqdn,
                     long recordId)
                       throws DynECTExceptions.JobStillRunningException

Gets the SRVRecord or null if not present.

Parameters:

fqdn - RecordId.getFQDN()

recordId - RecordId.getId()

Returns:

null if not found

Throws:

DynECTExceptions.JobStillRunningException - if a different job in the session is still running

getTXT

Record<TXTData> getTXT(String fqdn,
                     long recordId)
                       throws DynECTExceptions.JobStillRunningException

Gets the TXTRecord or null if not present.

Parameters:

fqdn - RecordId.getFQDN()

recordId - RecordId.getId()

Returns:

null if not found

Throws:

DynECTExceptions.JobStillRunningException - if a different job in the session is still running