org.jclouds.rackspace.cloudloadbalancers.v1.features

Interface LoadBalancerApi

public interface LoadBalancerApi

Provides synchronous access to CloudLoadBalancers LoadBalancer features.

Author:

Everett Toews

See Also:

LoadBalancerAsyncApi

Method Summary

Methods

Modifier and Type	Method and Description
LoadBalancer	create(LoadBalancerRequest lb) Create a new load balancer with the configuration defined by the request.
Metadata	createMetadata(int id, Map<String,String> metadata) When a metadata item is added, it is assigned a unique identifier that can be used for mutating operations such as changing the value attribute or removing it.
void	delete(int id) Delete a load balancer.
boolean	deleteMetadata(int id, Iterable<Integer> metadataIds) Batch delete metadata given the specified ids.
boolean	deleteMetadatum(int id, int metadatumId) Delete metadatum.
LoadBalancer	get(int id) Get a load balancer.
Metadata	getMetadata(int id) List a load balancer's metadata.
PagedIterable<LoadBalancer>	list() List the load balancers.
IterableWithMarker<LoadBalancer>	list(PaginationOptions options) List the load balancers with full control of pagination.
void	update(int id, LoadBalancerAttributes attrs) Update the properties of a load balancer.
boolean	updateMetadatum(int id, int metadatumId, String value) Update metadatum.

Method Detail

create

LoadBalancer create(LoadBalancerRequest lb)

Create a new load balancer with the configuration defined by the request.

Returns:

The object will contain a unique identifier and status of the request. Using the identifier, the caller can check on the progress of the operation by performing a get(int).

update

void update(int id,
          LoadBalancerAttributes attrs)

Update the properties of a load balancer.

list

PagedIterable<LoadBalancer> list()

List the load balancers.

list

IterableWithMarker<LoadBalancer> list(PaginationOptions options)

List the load balancers with full control of pagination.

get

LoadBalancer get(int id)

Get a load balancer.

delete

void delete(int id)

Delete a load balancer.

createMetadata

Metadata createMetadata(int id,
                      Map<String,String> metadata)

When a metadata item is added, it is assigned a unique identifier that can be used for mutating operations such as changing the value attribute or removing it. Key and value must be 256 characters or less. All UTF-8 characters are valid.

getMetadata

Metadata getMetadata(int id)

List a load balancer's metadata.

updateMetadatum

boolean updateMetadatum(int id,
                      int metadatumId,
                      String value)

Update metadatum. Key and value must be 256 characters or less. All UTF-8 characters are valid.

Returns:

true on a successful update, false if the metadatum was not found

deleteMetadatum

boolean deleteMetadatum(int id,
                      int metadatumId)

Delete metadatum.

Returns:

true on a successful removal, false if the metadatum was not found

See Also:

deleteMetadata(int, Iterable)

deleteMetadata

boolean deleteMetadata(int id,
                     Iterable<Integer> metadataIds)

Batch delete metadata given the specified ids. The current default limit is ten ids per request. Any and all configuration data is immediately purged and is not recoverable. If one or more of the items in the list cannot be removed due to its current status, an exception is thrown along with the ids of the ones the system identified as potential failures for this request.

Returns:

true on a successful removal, false if the metadata was not found