org.jclouds.ultradns.ws.features

Interface TrafficControllerPoolApi

public interface TrafficControllerPoolApi

See Also:

,

Method Summary

Modifier and Type	Method and Description
String	addRecordToPoolWithTTL(String rdata, String lbPoolID, int ttl) adds a new record to the pool with default weight.
String	addRecordToPoolWithTTLAndWeight(String rdata, String lbPoolID, int ttl, int weight) adds a new record to the pool with a specified weight.
String	createForDNameAndType(String name, String dname, int rrType) creates a traffic controller pool.
void	delete(String id) removes a pool and all its records and probes
void	deleteRecord(String poolRecordID) deletes a specific pooled resource record
String	getNameByDName(String dname) Retrieves the name of the specified pool by dname.
PoolRecordSpec	getRecordSpec(String poolRecordID)
com.google.common.collect.FluentIterable<TrafficControllerPool>	list() Returns all traffic controller pools in the zone.
com.google.common.collect.FluentIterable<TrafficControllerPoolRecordDetail>	listRecords(String poolId) Returns all records in the traffic controller pool.
void	updateRecord(String poolRecordID, UpdatePoolRecord update) This request updates an existing pool record.

Method Detail

createForDNameAndType

@Named(value="addTCLBPool")
 @POST
String createForDNameAndType(String name,
                                                                String dname,
                                                                int rrType)
                                                         throws UltraDNSWSExceptions.ResourceAlreadyExistsException

creates a traffic controller pool.

Parameters:

name - name of the TC pool

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

rrType - the record type supported.

Returns:

the guid of the new record

Throws:

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

list

@Named(value="getLoadBalancingPoolsByZone")
 @POST
com.google.common.collect.FluentIterable<TrafficControllerPool> list()
                                                                                                                 throws ResourceNotFoundException

Returns all traffic controller pools in the zone.

Throws:

ResourceNotFoundException - if the zone doesn't exist

listRecords

@Named(value="getPoolRecords")
 @POST
com.google.common.collect.FluentIterable<TrafficControllerPoolRecordDetail> listRecords(String poolId)
                                                                                                                       throws ResourceNotFoundException

Returns all records in the traffic controller pool.

Throws:

ResourceNotFoundException - if the pool doesn't exist

getNameByDName

@Nullable
 @Named(value="getPoolForPoolHostName>")
 @POST
String getNameByDName(String dname)

Retrieves the name of the specified pool by dname.

Parameters:

dname - TrafficControllerPool.getDName() ex. jclouds.org.

Returns:

null if not found

delete

@Named(value="deleteLBPool")
 @POST
void delete(String id)

removes a pool and all its records and probes

Parameters:

id - the id

addRecordToPoolWithTTL

@Named(value="addPoolRecord")
 @POST
String addRecordToPoolWithTTL(String rdata,
                                                                   String lbPoolID,
                                                                   int ttl)
                                                            throws UltraDNSWSExceptions.ResourceAlreadyExistsException

adds a new record to the pool with default weight.

Parameters:

rdata - the ipv4 address or hostname

lbPoolID - the pool to add the record to.

ttl - the ttl of the record

Returns:

the id of the new record

Throws:

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

addRecordToPoolWithTTLAndWeight

@Named(value="addPoolRecord")
 @POST
String addRecordToPoolWithTTLAndWeight(String rdata,
                                                                            String lbPoolID,
                                                                            int ttl,
                                                                            int weight)
                                                                     throws UltraDNSWSExceptions.ResourceAlreadyExistsException

adds a new record to the pool with a specified weight.

Parameters:

rdata - the ipv4 address or hostname

lbPoolID - the pool to add the record to.

ttl - the ttl of the record

weight - the weight of the record

Returns:

the id of the new record

Throws:

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

getRecordSpec

@Named(value="getPoolRecordSpec>")
 @POST
 @Nullable
PoolRecordSpec getRecordSpec(String poolRecordID)

Parameters:

poolRecordID - TrafficControllerPoolRecordDetail.getId()

Returns:

null if not found

updateRecord

@Named(value="updatePoolRecord>")
 @POST
void updateRecord(String poolRecordID,
                                                           UpdatePoolRecord update)
                                                    throws ResourceNotFoundException

This request updates an existing pool record.

Parameters:

poolRecordID - TrafficControllerPoolRecordDetail.getId()

update - what to update, usually primed via UpdatePoolRecord.pointingTo(PoolRecordSpec, String) or UpdatePoolRecord.Builder.from(PoolRecordSpec)

Throws:

ResourceNotFoundException - if the record doesn't exist

deleteRecord

@Named(value="deletePoolRecord")
 @POST
void deleteRecord(String poolRecordID)

deletes a specific pooled resource record

Parameters:

poolRecordID - TrafficControllerPoolRecord#getId()