libcloud.loadbalancer.drivers.dimensiondata module

class libcloud.loadbalancer.drivers.dimensiondata.DimensionDataLBDriver(key, secret=None, secure=True, host=None, port=None, api_version=None, region='dd-na', **kwargs)[source]

Bases: Driver

DimensionData node driver.

Parameters:

  • key (str) – API key or username to be used (required)

  • secret (str) – Secret password to be used (required)

  • secure (bool) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default.

  • host (str) – Override hostname used for connections.

  • port (int) – Override port used for connections.

  • api_version (str) – Optional API version. Only used by drivers which support multiple API versions.

  • region (str) – Optional driver region. Only used by drivers which support multiple regions.

Return type:

None

api_version = 1.0
balancer_attach_member(balancer, member)[source]

Attach a member to balancer

Parameters:

  • balancer (LoadBalancer) – LoadBalancer which should be used

  • member (Member) – Member to join to the balancer

Returns:

Member after joining the balancer.

Return type:

Member

balancer_detach_member(balancer, member)[source]

Detach member from balancer

Parameters:

  • balancer (LoadBalancer) – LoadBalancer which should be used

  • member (Member) – Member which should be used

Returns:

True if member detach was successful, otherwise False.

Return type:

bool

balancer_list_members(balancer)[source]

Return list of members attached to balancer.

In Dimension Data terminology these are the members of the pools within a virtual listener.

Parameters:

balancer (LoadBalancer) – LoadBalancer which should be used

Return type:

list of Member

connectionCls

alias of DimensionDataConnection

create_balancer(name, port=None, protocol=None, algorithm=None, members=None, ex_listener_ip_address=None)[source]

Create a new load balancer instance

Parameters:

  • name (str) – Name of the new load balancer (required)

  • port (int) – An integer in the range of 1-65535. If not supplied, it will be taken to mean ‘Any Port’

  • protocol (str) – Loadbalancer protocol, defaults to http.

  • members (list of Member) – list of Members to attach to balancer (optional)

  • algorithm (Algorithm) – Load balancing algorithm, defaults to ROUND_ROBIN.

  • ex_listener_ip_address (str) – Must be a valid IPv4 in dot-decimal notation (x.x.x.x).

Return type:

LoadBalancer

destroy_balancer(balancer)[source]

Destroy a load balancer (virtual listener)

Parameters:

balancer (LoadBalancer) – LoadBalancer which should be used

Returns:

True if the destroy was successful, otherwise False.

Return type:

bool

ex_create_node(network_domain_id, name, ip, ex_description, connection_limit=25000, connection_rate_limit=2000)[source]

Create a new node

Parameters:

  • network_domain_id – Network Domain ID (required)

  • name (str) – name of the node (required)

  • ip (str) – IPv4 address of the node (required)

  • ex_description (str) – Description of the node (required)

  • connection_limit (int) – Maximum number of concurrent connections per sec

  • connection_rate_limit (int) – Maximum number of concurrent sessions

Returns:

Instance of DimensionDataVIPNode

Return type:

DimensionDataVIPNode

ex_create_pool(network_domain_id, name, balancer_method, ex_description, health_monitors=None, service_down_action='NONE', slow_ramp_time=30)[source]

Create a new pool

Parameters:

  • network_domain_id – Network Domain ID (required)

  • name (str) – name of the node (required)

  • balancer_method (str) – The load balancer algorithm (required)

  • ex_description (str) – Description of the node (required)

  • health_monitors (list of DimensionDataDefaultHealthMonitor) – A list of health monitors to use for the pool.

  • service_down_action (str) – What to do when node is unavailable NONE, DROP or RESELECT

  • slow_ramp_time (int) – Number of seconds to stagger ramp up of nodes

Returns:

Instance of DimensionDataPool

Return type:

DimensionDataPool

ex_create_pool_member(pool, node, port=None)[source]

Create a new member in an existing pool from an existing node

Parameters:

  • pool (DimensionDataPool) – Instance of DimensionDataPool (required)

  • node (DimensionDataVIPNode) – Instance of DimensionDataVIPNode (required)

  • port (str) – Port the the service will listen on

Returns:

The node member, instance of DimensionDataPoolMember

Return type:

DimensionDataPoolMember

ex_create_virtual_listener(network_domain_id, name, ex_description, port=None, pool=None, listener_ip_address=None, persistence_profile=None, fallback_persistence_profile=None, irule=None, protocol='TCP', connection_limit=25000, connection_rate_limit=2000, source_port_preservation='PRESERVE')[source]

Create a new virtual listener (load balancer)

Parameters:

  • network_domain_id – Network Domain ID (required)

  • name (str) – name of the listener (required)

  • ex_description (str) – Description of the node (required)

  • port (int) – An integer in the range of 1-65535. If not supplied, it will be taken to mean ‘Any Port’

  • pool (DimensionDataPool) – The pool to use for the listener

  • listener_ip_address (str) – The IPv4 Address of the virtual listener

  • persistence_profile (DimensionDataPersistenceProfile) – Persistence profile

  • fallback_persistence_profile (DimensionDataPersistenceProfile) – Fallback persistence profile

  • irule (DimensionDataDefaultiRule) – The iRule to apply

  • protocol (str) – For STANDARD type, ANY, TCP or UDP for PERFORMANCE_LAYER_4 choice of ANY, TCP, UDP, HTTP

  • connection_limit (int) – Maximum number of concurrent connections per sec

  • connection_rate_limit (int) – Maximum number of concurrent sessions

  • source_port_preservation (str) – Choice of PRESERVE, PRESERVE_STRICT or CHANGE

Returns:

Instance of the listener

Return type:

DimensionDataVirtualListener

ex_destroy_node(node_id)[source]

Destroy a specific node

Parameters:

node_id (str) – The ID of of a DimensionDataVIPNode

Returns:

True for success, False for failure

Return type:

bool

ex_destroy_pool(pool)[source]

Destroy an existing pool

Parameters:

pool (DimensionDataPool) – The instance of DimensionDataPool to destroy

Returns:

True for success, False for failure

Return type:

bool

ex_destroy_pool_member(member, destroy_node=False)[source]

Destroy a specific member of a pool

Parameters:

  • pool (DimensionDataPoolMember) – The instance of a pool member

  • destroy_node (bool) – Also destroy the associated node

Returns:

True for success, False for failure

Return type:

bool

ex_get_current_network_domain()[source]

Get the current network domain ID of the driver.

Returns:

ID of the network domain

Return type:

str

ex_get_default_health_monitors(network_domain_id)[source]

Get the default health monitors available for a network domain

Parameters:

network_domain_id (str) – The ID of of a DimensionDataNetworkDomain

Return type:

list of DimensionDataDefaultHealthMonitor

ex_get_default_irules(network_domain_id)[source]

Get the default iRules available for a network domain

Parameters:

network_domain_id (str) – The ID of of a DimensionDataNetworkDomain

Return type:

list of DimensionDataDefaultiRule

ex_get_default_persistence_profiles(network_domain_id)[source]

Get the default persistence profiles available for a network domain

Parameters:

network_domain_id (str) – The ID of of a DimensionDataNetworkDomain

Return type:

list of DimensionDataPersistenceProfile

ex_get_node(node_id)[source]

Get the node specified by node_id

Returns:

Returns an instance of DimensionDataVIPNode

Return type:

Instance of DimensionDataVIPNode

ex_get_nodes(ex_network_domain_id=None)[source]

Get the nodes within this geography or in given network.

Parameters:

ex_network_domain_id (str) – UUID of Network Domain if not None returns only balancers in the given network if None then returns all pools for the organization

Returns:

Returns an list of DimensionDataVIPNode

Return type:

list of DimensionDataVIPNode

ex_get_pool(pool_id)[source]

Get a specific pool inside the current geography

Parameters:

pool_id (str) – The identifier of the pool

Returns:

Returns an instance of DimensionDataPool

Return type:

DimensionDataPool

ex_get_pool_member(pool_member_id)[source]

Get a specific member of a pool

Parameters:

pool (str) – The id of a pool member

Returns:

Returns an instance of DimensionDataPoolMember

Return type:

DimensionDataPoolMember

ex_get_pool_members(pool_id)[source]

Get the members of a pool

Parameters:

pool (DimensionDataPool) – The instance of a pool

Returns:

Returns an list of DimensionDataPoolMember

Return type:

list of DimensionDataPoolMember

ex_get_pools(ex_network_domain_id=None)[source]

Get all of the pools inside the current geography or in given network.

Parameters:

ex_network_domain_id (str) – UUID of Network Domain if not None returns only balancers in the given network if None then returns all pools for the organization

Returns:

Returns a list of type DimensionDataPool

Return type:

list of DimensionDataPool

ex_set_current_network_domain(network_domain_id)[source]

Set the network domain (part of the network) of the driver

Parameters:

network_domain_id (str) – ID of the pool (required)

ex_set_node_state(node, enabled)[source]

Change the state of a node (enable/disable)

Parameters:

  • pool (DimensionDataNode) – The instance of DimensionDataNode to update

  • enabled (bool) – The target state of the node

Returns:

The instance of DimensionDataNode

Return type:

DimensionDataNode

ex_set_pool_member_state(member, enabled=True)[source]
ex_update_node(node)[source]

Update the properties of a node

Parameters:

pool (DimensionDataNode) – The instance of DimensionDataNode to update

Returns:

The instance of DimensionDataNode

Return type:

DimensionDataNode

ex_update_pool(pool)[source]

Update the properties of an existing pool only method, serviceDownAction and slowRampTime are updated

Parameters:

pool (DimensionDataPool) – The instance of DimensionDataPool to update

Returns:

True for success, False for failure

Return type:

bool

ex_wait_for_state(state, func, poll_interval=2, timeout=60, *args, **kwargs)[source]

Wait for the function which returns a instance with field status to match

Keep polling func until one of the desired states is matched

Parameters:

  • state (str or list) – Either the desired state (str) or a list of states

  • func (function) – The function to call, e.g. ex_get_vlan

  • poll_interval (int) – The number of seconds to wait between checks

  • timeout (int) – The total number of seconds to wait to reach a state

  • args (Positional arguments) – The arguments for func

  • kwargs (Keyword arguments) – The arguments for func

get_balancer(balancer_id)[source]

Return a LoadBalancer object.

Parameters:

balancer_id (str) – id of a load balancer you want to fetch

Return type:

LoadBalancer

list_balancers(ex_network_domain_id=None)[source]

List all loadbalancers inside a geography or in given network.

In Dimension Data terminology these are known as virtual listeners

Parameters:

ex_network_domain_id (str) – UUID of Network Domain if not None returns only balancers in the given network if None then returns all pools for the organization

Return type:

list of LoadBalancer

list_protocols()[source]

Return a list of supported protocols.

Since all protocols are support by Dimension Data, this is a list of common protocols.

Return type:

list of str

name = 'Dimension Data Load Balancer'
network_domain_id = None
selected_region = None
type = 'dimensiondata'
website = 'https://cloud.dimensiondata.com/'