org.jclouds.ultradns.ws.features

Interface ResourceRecordApi

public interface ResourceRecordApi

Author:

Adrian Cole

See Also:

ResourceRecordAsyncApi

Method Summary

Methods

Modifier and Type	Method and 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<ResourceRecordMetadata>	list() Returns all the specified record types in the zone.
com.google.common.collect.FluentIterable<ResourceRecordMetadata>	listByName(String hostName) Returns all the specified record types in the zone with the fully qualified hostName
com.google.common.collect.FluentIterable<ResourceRecordMetadata>	listByNameAndType(String hostName, int rrType)
com.google.common.collect.FluentIterable<ResourceRecordMetadata>	listByNameAndType(String hostName, String type)
com.google.common.collect.FluentIterable<ResourceRecordMetadata>	listByNameAndType(String hostName, com.google.common.primitives.UnsignedInteger rrType) Returns all the specified record types in the zone with the fully qualified hostName and rrType
void	update(String guid, ResourceRecord updated) updates an existing resource record in the zone.

Method Detail

create

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

void update(String guid,
          ResourceRecord updated)
            throws ResourceNotFoundException

updates an existing resource record in the zone.

Parameters:

guid - the global unique identifier for the resource record ResourceRecordMetadata.getGuid()

updated - the record to update.

Throws:

ResourceNotFoundException - if the guid doesn't exist

list

com.google.common.collect.FluentIterable<ResourceRecordMetadata> list()
                                                                      throws ResourceNotFoundException

Returns all the specified record types in the zone.

Throws:

ResourceNotFoundException - if the zone doesn't exist

listByName

com.google.common.collect.FluentIterable<ResourceRecordMetadata> 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

com.google.common.collect.FluentIterable<ResourceRecordMetadata> listByNameAndType(String hostName,
                                                                                 com.google.common.primitives.UnsignedInteger 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

listByNameAndType

com.google.common.collect.FluentIterable<ResourceRecordMetadata> listByNameAndType(String hostName,
                                                                                 int rrType)
                                                                                   throws ResourceNotFoundException

Throws:

ResourceNotFoundException

See Also:

listByNameAndType(String, UnsignedInteger)

listByNameAndType

com.google.common.collect.FluentIterable<ResourceRecordMetadata> listByNameAndType(String hostName,
                                                                                 String type)
                                                                                   throws ResourceNotFoundException

Parameters:

type - the literal type defined in ResourceTypeToValue. ex AAAA

Throws:

ResourceNotFoundException

See Also:

listByNameAndType(String, UnsignedInteger)

delete

void delete(String guid)

deletes a specific resource record/

Parameters:

guid - the global unique identifier for the resource record ResourceRecordMetadata.getGuid()