Package org.jclouds.ultradns.ws.features

Interface ResourceRecordApi

public interface ResourceRecordApi

See Also:

,

Method Summary

Modifier and Type	Method	Description
String	create(ResourceRecord toCreate)	creates a resource record in the zone.
void	delete(String guid)	deletes a specific resource record
com.google.common.collect.FluentIterable<ResourceRecordDetail>	list()	Returns all the specified record types in the zone.
com.google.common.collect.FluentIterable<ResourceRecordDetail>	listByName(String hostName)	Returns all the specified record types in the zone with the fully qualified hostName
com.google.common.collect.FluentIterable<ResourceRecordDetail>	listByNameAndType(String hostName, int rrType)	Returns all the specified record types in the zone with the fully qualified hostName and rrType
void	update(String guid, ResourceRecord toCreate)	updates an existing resource record in the zone.

Method Detail

create

@Named("createResourceRecord")
@POST
String create(ResourceRecord toCreate)
       throws UltraDNSWSExceptions.ResourceAlreadyExistsException

creates a resource record in the zone.

Parameters:

toCreate - the new record to create.

Returns:

the guid of the new record

Throws:

UltraDNSWSExceptions.ResourceAlreadyExistsException - if a record already exists with the same attrs

update

@Named("updateResourceRecord")
@POST
void update(String guid,
            ResourceRecord toCreate)
     throws ResourceNotFoundException

updates an existing resource record in the zone.

Parameters:

guid - the global unique identifier for the resource record {@see ResourceRecordMetadata#getGuid()}

updated - the record to update.

Throws:

ResourceNotFoundException - if the guid doesn't exist

list

@Named("getResourceRecordsOfZone")
@POST
com.google.common.collect.FluentIterable<ResourceRecordDetail> list()
                                                             throws ResourceNotFoundException

Returns all the specified record types in the zone.

Throws:

ResourceNotFoundException - if the zone doesn't exist

listByName

@Named("getResourceRecordsOfDNameByType")
@POST
com.google.common.collect.FluentIterable<ResourceRecordDetail> listByName(String hostName)
                                                                   throws ResourceNotFoundException

Returns all the specified record types in the zone with the fully qualified hostName

Parameters:

hostName - fully qualified hostname including the trailing dot.

Throws:

ResourceNotFoundException - if the zone doesn't exist

listByNameAndType

@Named("getResourceRecordsOfDNameByType")
@POST
com.google.common.collect.FluentIterable<ResourceRecordDetail> listByNameAndType(String hostName,
                                                                                 int rrType)
                                                                          throws ResourceNotFoundException

Returns all the specified record types in the zone with the fully qualified hostName and rrType

Parameters:

hostName - fully qualified hostname including the trailing dot.

rrType - type value (ex. for A, this is 1

Throws:

ResourceNotFoundException - if the zone doesn't exist

delete

@Named("deleteResourceRecord")
@POST
void delete(String guid)

deletes a specific resource record

Parameters:

guid - the global unique identifier for the resource record {@see ResourceRecordMetadata#getGuid()}