org.jclouds.ultradns.ws.features

Interface RoundRobinPoolApi

public interface RoundRobinPoolApi

Author:

Adrian Cole

See Also:

RoundRobinPoolAsyncApi

Method Summary

Methods

Modifier and Type	Method and Description
String	addAAAARecordWithAddressAndTTL(String lbPoolID, String ipv6Address, com.google.common.primitives.UnsignedInteger ttl) adds a new AAAA record to the pool
String	addARecordWithAddressAndTTL(String lbPoolID, String ipv4Address, com.google.common.primitives.UnsignedInteger ttl) adds a new A record to the pool
String	createAAAAPoolForHostname(String name, String hostname) creates a round robin pool for AAAA (ipv6) records
String	createAPoolForHostname(String name, String hostname) creates a round robin pool for A (ipv4) records
void	delete(String id) removes a pool and all its records and probes
void	deleteRecord(String guid) deletes a specific pooled resource record
com.google.common.collect.FluentIterable<RoundRobinPool>	list() Returns all round robin pools in the zone.
com.google.common.collect.FluentIterable<ResourceRecordMetadata>	listRecords(String poolId) Returns all records in the round robin pool.
void	updateRecordWithAddressAndTTL(String lbPoolID, String guid, String address, com.google.common.primitives.UnsignedInteger ttl) updates an existing A or AAAA record in the pool.

Method Detail

createAPoolForHostname

String createAPoolForHostname(String name,
                            String hostname)
                              throws UltraDNSWSExceptions.ResourceAlreadyExistsException

creates a round robin pool for A (ipv4) records

Parameters:

name - name of the RR pool

hostname - dname of the RR pool {ex. www.jclouds.org.}

Returns:

the guid of the new record

Throws:

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

addARecordWithAddressAndTTL

String addARecordWithAddressAndTTL(String lbPoolID,
                                 String ipv4Address,
                                 com.google.common.primitives.UnsignedInteger ttl)
                                   throws UltraDNSWSExceptions.ResourceAlreadyExistsException

adds a new A record to the pool

Parameters:

lbPoolID - the pool to add the record to.

ipv4Address - the ipv4 address

ttl - the ttl of the record

Returns:

the guid of the new record

Throws:

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

createAAAAPoolForHostname

String createAAAAPoolForHostname(String name,
                               String hostname)
                                 throws UltraDNSWSExceptions.ResourceAlreadyExistsException

creates a round robin pool for AAAA (ipv6) records

Parameters:

name - name of the RR pool

hostname - hostname {ex. www.jclouds.org.}

Returns:

the guid of the new record

Throws:

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

addAAAARecordWithAddressAndTTL

String addAAAARecordWithAddressAndTTL(String lbPoolID,
                                    String ipv6Address,
                                    com.google.common.primitives.UnsignedInteger ttl)
                                      throws UltraDNSWSExceptions.ResourceAlreadyExistsException

adds a new AAAA record to the pool

Parameters:

lbPoolID - the pool to add the record to.

ipv6Address - the ipv6 address

ttl - the ttl of the record

Returns:

the guid of the new record

Throws:

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

updateRecordWithAddressAndTTL

void updateRecordWithAddressAndTTL(String lbPoolID,
                                 String guid,
                                 String address,
                                 com.google.common.primitives.UnsignedInteger ttl)
                                   throws ResourceNotFoundException

updates an existing A or AAAA record in the pool.

Parameters:

lbPoolID - the pool to add the record to.

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

address - the ipv4 or ipv6 address

ttl - the ttl of the record

Throws:

ResourceNotFoundException - if the guid doesn't exist

list

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

Returns all round robin pools in the zone.

Throws:

ResourceNotFoundException - if the zone doesn't exist

listRecords

com.google.common.collect.FluentIterable<ResourceRecordMetadata> listRecords(String poolId)
                                                                             throws ResourceNotFoundException

Returns all records in the round robin pool.

Throws:

ResourceNotFoundException - if the pool doesn't exist

deleteRecord

void deleteRecord(String guid)

deletes a specific pooled resource record

Parameters:

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

delete

void delete(String id)

removes a pool and all its records and probes

Parameters:

id - the id