Load Balancer v2 API¶

The LoadBalancer Class¶

The load_balancer high-level interface is available through the load_balancer member of a Connection object. The load_balancer member will only be added if the service is detected.

Load Balancer Operations¶

class openstack.load_balancer.v2._proxy.Proxy(session, statsd_client=None, statsd_prefix=None, prometheus_counter=None, prometheus_histogram=None, influxdb_config=None, influxdb_client=None, *args, **kwargs)

create_load_balancer(**attrs)

Create a new load balancer from attributes

Parameters:: attrs (dict) – Keyword arguments which will be used to create a LoadBalancer, comprised of the properties on the LoadBalancer class.
Returns:: The results of load balancer creation
Return type:: LoadBalancer

get_load_balancer(*attrs)

Get a load balancer

Parameters:: load_balancer – The value can be the ID of a load balancer or LoadBalancer instance.
Returns:: One LoadBalancer

get_load_balancer_statistics(load_balancer)

Get the load balancer statistics

Parameters:: load_balancer – The value can be the ID of a load balancer or LoadBalancer instance.
Returns:: One LoadBalancerStats

load_balancers(**query)

Retrieve a generator of load balancers

Returns:: A generator of load balancer instances

delete_load_balancer(load_balancer, ignore_missing=True, cascade=False)

Delete a load balancer

Parameters:

load_balancer – The load_balancer can be either the ID or a LoadBalancer instance
ignore_missing (bool) – When set to False ResourceNotFound will be raised when the load balancer does not exist. When set to True, no exception will be set when attempting to delete a nonexistent load balancer.
cascade (bool) – If true will delete all child objects of the load balancer.

Returns:

None

find_load_balancer(name_or_id, ignore_missing=True)

Find a single load balancer

Parameters:

name_or_id – The name or ID of a load balancer
ignore_missing (bool) – When set to False ResourceNotFound will be raised when the load balancer does not exist. When set to True, no exception will be set when attempting to delete a nonexistent load balancer.

Returns:

None

update_load_balancer(load_balancer, **attrs)

Update a load balancer

Parameters:

load_balancer – The load_balancer can be either the ID or a LoadBalancer instance
attrs (dict) – The attributes to update on the load balancer represented by load_balancer.

Returns:

The updated load_balancer

Return type:

LoadBalancer

wait_for_load_balancer(name_or_id, status='ACTIVE', failures=['ERROR'], interval=2, wait=300)

Wait for load balancer status

Parameters:

name_or_id – The name or ID of the load balancer.
status – Desired status.
failures (list) – Statuses that would be interpreted as failures. Default to [‘ERROR’].
interval – Number of seconds to wait between consecutive checks. Defaults to 2.
wait – Maximum number of seconds to wait before the status to be reached. Defaults to 300.

Returns:

The load balancer is returned on success.

Raises:

ResourceTimeout if transition to the desired status failed to occur within the specified wait time.

Raises:

ResourceFailure if the resource has transited to one of the failure statuses.

Raises:

AttributeError if the resource does not have a status attribute.

failover_load_balancer(load_balancer, **attrs)

Failover a load balancer

Parameters:: load_balancer – The value can be the ID of a load balancer or LoadBalancer instance.
Returns:: None

Listener Operations¶

create_listener(**attrs)

Create a new listener from attributes

Parameters:: attrs (dict) – Keyword arguments which will be used to create a Listener, comprised of the properties on the Listener class.
Returns:: The results of listener creation
Return type:: Listener

delete_listener(listener, ignore_missing=True)

Delete a listener

Parameters:

listener – The value can be either the ID of a listener or a Listener instance.
ignore_missing (bool) – When set to False ResourceNotFound will be raised when the listner does not exist. When set to True, no exception will be set when attempting to delete a nonexistent listener.

Returns:

None

find_listener(name_or_id, ignore_missing=True)

Find a single listener

Parameters:

name_or_id – The name or ID of a listener.
ignore_missing (bool) – When set to False ResourceNotFound will be raised when the resource does not exist. When set to True, None will be returned when attempting to find a nonexistent resource.

Returns:

One Listener or None

get_listener(listener)

Get a single listener

Parameters:: listener – The value can be the ID of a listener or a Listener instance.
Returns:: One Listener
Raises:: ResourceNotFound when no resource can be found.

get_listener_statistics(listener)

Get the listener statistics

Parameters:: listener – The value can be the ID of a listener or a Listener instance.
Returns:: One ListenerStats
Raises:: ResourceNotFound when no resource can be found.

listeners(**query)

Return a generator of listeners

Parameters:: query (dict) – Optional query parameters to be sent to limit the resources being returned. Valid parameters are:
Returns:: A generator of listener objects
Return type:: Listener

update_listener(listener, **attrs)

Update a listener

Parameters:

listener – Either the id of a listener or a Listener instance.
attrs (dict) – The attributes to update on the listener represented by listener.

Returns:

The updated listener

Return type:

Listener

Pool Operations¶

create_pool(**attrs)

Create a new pool from attributes

Parameters:: attrs (dict) – Keyword arguments which will be used to create a Pool, comprised of the properties on the Pool class.
Returns:: The results of Pool creation
Return type:: Pool

get_pool(*attrs)

Get a pool

Parameters:: pool – Value is either a pool ID or a Pool instance.
Returns:: One Pool

pools(**query)

Retrieve a generator of pools

Returns:: A generator of Pool instances

delete_pool(pool, ignore_missing=True)

Delete a pool

Parameters:

pool – The pool is either a pool ID or a Pool instance
ignore_missing (bool) – When set to False ResourceNotFound will be raised when the pool does not exist. When set to True, no exception will be set when attempting to delete a nonexistent pool.

Returns:

None

find_pool(name_or_id, ignore_missing=True)

Find a single pool

Parameters:

name_or_id – The name or ID of a pool
ignore_missing (bool) – When set to False ResourceNotFound will be raised when the pool does not exist. When set to True, no exception will be set when attempting to delete a nonexistent pool.

Returns:

None

update_pool(pool, **attrs)

Update a pool

Parameters:

pool – Either the id of a pool or a Pool instance.
attrs (dict) – The attributes to update on the pool represented by pool.

Returns:

The updated pool

Return type:

Pool

Member Operations¶

create_member(pool, **attrs)

Create a new member from attributes

Parameters:

pool – The pool can be either the ID of a pool or a Pool instance that the member will be created in.
attrs (dict) – Keyword arguments which will be used to create a Member, comprised of the properties on the Member class.

Returns:

The results of member creation

Return type:

Member

delete_member(member, pool, ignore_missing=True)

Delete a member

Parameters:

member – The member can be either the ID of a member or a Member instance.
pool – The pool can be either the ID of a pool or a Pool instance that the member belongs to.
ignore_missing (bool) – When set to False ResourceNotFound will be raised when the member does not exist. When set to True, no exception will be set when attempting to delete a nonexistent member.

Returns:

None

find_member(name_or_id, pool, ignore_missing=True)

Find a single member

Parameters:

name_or_id (str) – The name or ID of a member.
pool – The pool can be either the ID of a pool or a Pool instance that the member belongs to.
ignore_missing (bool) – When set to False ResourceNotFound will be raised when the resource does not exist. When set to True, None will be returned when attempting to find a nonexistent resource.

Returns:

One Member or None

get_member(member, pool)

Get a single member

Parameters:

member – The member can be the ID of a member or a Member instance.
pool – The pool can be either the ID of a pool or a Pool instance that the member belongs to.

Returns:

One Member

Raises:

ResourceNotFound when no resource can be found.

members(pool, **query)

Return a generator of members

Parameters:

pool – The pool can be either the ID of a pool or a Pool instance that the member belongs to.
query (dict) – Optional query parameters to be sent to limit the resources being returned. Valid parameters are:

Returns:

A generator of member objects

Return type:

Member

update_member(member, pool, **attrs)

Update a member

Parameters:

member – Either the ID of a member or a Member instance.
pool – The pool can be either the ID of a pool or a Pool instance that the member belongs to.
attrs (dict) – The attributes to update on the member represented by member.

Returns:

The updated member

Return type:

Member

Health Monitor Operations¶

find_health_monitor(name_or_id, ignore_missing=True)

Find a single health monitor

Parameters:

name_or_id – The name or ID of a health monitor
ignore_missing (bool) – When set to False ResourceNotFound will be raised when the health monitor does not exist. When set to True, no exception will be set when attempting to find a nonexistent health monitor.

Returns:

The openstack.load_balancer.v2.healthmonitor.HealthMonitor object matching the given name or id or None if nothing matches.

Raises:

openstack.exceptions.DuplicateResource if more than one resource is found for this request.

Raises:

openstack.exceptions.ResourceNotFound if nothing is found and ignore_missing is False.

create_health_monitor(**attrs)

Create a new health monitor from attributes

Parameters:: attrs (dict) – Keyword arguments which will be used to create a HealthMonitor, comprised of the properties on the HealthMonitor class.
Returns:: The results of HealthMonitor creation
Return type:: HealthMonitor

get_health_monitor(healthmonitor)

Get a health monitor

Parameters:: healthmonitor – The value can be the ID of a health monitor or HealthMonitor instance.
Returns:: One health monitor
Return type:: HealthMonitor

health_monitors(**query)

Retrieve a generator of health monitors

Parameters:: query (dict) – Optional query parameters to be sent to limit the resources being returned. Valid parameters are: ‘name’, ‘created_at’, ‘updated_at’, ‘delay’, ‘expected_codes’, ‘http_method’, ‘max_retries’, ‘max_retries_down’, ‘pool_id’, ‘provisioning_status’, ‘operating_status’, ‘timeout’, ‘project_id’, ‘type’, ‘url_path’, ‘is_admin_state_up’.
Returns:: A generator of health monitor instances

delete_health_monitor(healthmonitor, ignore_missing=True)

Delete a health monitor

Parameters:

healthmonitor – The healthmonitor can be either the ID of the health monitor or a HealthMonitor instance
ignore_missing (bool) – When set to False ResourceNotFound will be raised when the healthmonitor does not exist. When set to True, no exception will be set when attempting to delete a nonexistent healthmonitor.

Returns:

None

update_health_monitor(healthmonitor, **attrs)

Update a health monitor

Parameters:

healthmonitor – The healthmonitor can be either the ID of the health monitor or a HealthMonitor instance
attrs (dict) – The attributes to update on the health monitor represented by healthmonitor.

Returns:

The updated health monitor

Return type:

HealthMonitor

L7 Policy Operations¶

create_l7_policy(**attrs)

Create a new l7policy from attributes

Parameters:: attrs (dict) – Keyword arguments which will be used to create a L7Policy, comprised of the properties on the L7Policy class.
Returns:: The results of l7policy creation
Return type:: L7Policy

delete_l7_policy(l7_policy, ignore_missing=True)

Delete a l7policy

Parameters:

l7_policy – The value can be either the ID of a l7policy or a L7Policy instance.
ignore_missing (bool) – When set to False ResourceNotFound will be raised when the l7policy does not exist. When set to True, no exception will be set when attempting to delete a nonexistent l7policy.

Returns:

None

find_l7_policy(name_or_id, ignore_missing=True)

Find a single l7policy

Parameters:

name_or_id – The name or ID of a l7policy.
ignore_missing (bool) – When set to False ResourceNotFound will be raised when the resource does not exist. When set to True, None will be returned when attempting to find a nonexistent resource.

Returns:

One L7Policy or None

get_l7_policy(l7_policy)

Get a single l7policy

Parameters:: l7_policy – The value can be the ID of a l7policy or a L7Policy instance.
Returns:: One L7Policy
Raises:: ResourceNotFound when no resource can be found.

l7_policies(**query)

Return a generator of l7policies

Parameters:: query (dict) – Optional query parameters to be sent to limit the resources being returned. Valid parameters are:
Returns:: A generator of l7policy objects
Return type:: L7Policy

update_l7_policy(l7_policy, **attrs)

Update a l7policy

Parameters:

l7_policy – Either the id of a l7policy or a L7Policy instance.
attrs (dict) – The attributes to update on the l7policy represented by l7policy.

Returns:

The updated l7policy

Return type:

L7Policy

L7 Rule Operations¶

create_l7_rule(l7_policy, **attrs)

Create a new l7rule from attributes

Parameters:

l7_policy – The l7_policy can be either the ID of a l7policy or L7Policy instance that the l7rule will be created in.
attrs (dict) – Keyword arguments which will be used to create a L7Rule, comprised of the properties on the L7Rule class.

Returns:

The results of l7rule creation

Return type:

L7Rule

delete_l7_rule(l7rule, l7_policy, ignore_missing=True)

Delete a l7rule

Parameters:

l7rule – The l7rule can be either the ID of a l7rule or a L7Rule instance.
l7_policy – The l7_policy can be either the ID of a l7policy or L7Policy instance that the l7rule belongs to.
ignore_missing (bool) – When set to False ResourceNotFound will be raised when the l7rule does not exist. When set to True, no exception will be set when attempting to delete a nonexistent l7rule.

Returns:

None

find_l7_rule(name_or_id, l7_policy, ignore_missing=True)

Find a single l7rule

Parameters:

name_or_id (str) – The name or ID of a l7rule.
l7_policy – The l7_policy can be either the ID of a l7policy or L7Policy instance that the l7rule belongs to.
ignore_missing (bool) – When set to False ResourceNotFound will be raised when the resource does not exist. When set to True, None will be returned when attempting to find a nonexistent resource.

Returns:

One L7Rule or None

get_l7_rule(l7rule, l7_policy)

Get a single l7rule

Parameters:

l7rule – The l7rule can be the ID of a l7rule or a L7Rule instance.
l7_policy – The l7_policy can be either the ID of a l7policy or L7Policy instance that the l7rule belongs to.

Returns:

One L7Rule

Raises:

ResourceNotFound when no resource can be found.

l7_rules(l7_policy, **query)

Return a generator of l7rules

Parameters:

l7_policy – The l7_policy can be either the ID of a l7_policy or L7Policy instance that the l7rule belongs to.
query (dict) – Optional query parameters to be sent to limit the resources being returned. Valid parameters are:

Returns:

A generator of l7rule objects

Return type:

L7Rule

update_l7_rule(l7rule, l7_policy, **attrs)

Update a l7rule

Parameters:

l7rule – Either the ID of a l7rule or a L7Rule instance.
l7_policy – The l7_policy can be either the ID of a l7policy or L7Policy instance that the l7rule belongs to.
attrs (dict) – The attributes to update on the l7rule represented by l7rule.

Returns:

The updated l7rule

Return type:

L7Rule

Provider Operations¶

providers(**query)

Retrieve a generator of providers

Returns:: A generator of providers instances

provider_flavor_capabilities(provider, **query)

Retrieve a generator of provider flavor capabilities

Returns:: A generator of provider flavor capabilities instances

Flavor Profile Operations¶

create_flavor_profile(**attrs)

Create a new flavor profile from attributes

Parameters:: attrs (dict) – Keyword arguments which will be used to create a FlavorProfile, comprised of the properties on the FlavorProfile class.
Returns:: The results of profile creation creation
Return type:: FlavorProfile

get_flavor_profile(*attrs)

Get a flavor profile

Parameters:: flavor_profile – The value can be the name of a flavor profile or FlavorProfile instance.
Returns:: One FlavorProfile

flavor_profiles(**query)

Retrieve a generator of flavor profiles

Returns:: A generator of flavor profiles instances

delete_flavor_profile(flavor_profile, ignore_missing=True)

Delete a flavor profile

Parameters:

flavor_profile – The flavor_profile can be either the ID or a FlavorProfile instance
ignore_missing (bool) – When set to False ResourceNotFound will be raised when the flavor profile does not exist. When set to True, no exception will be set when attempting to delete a nonexistent flavor profile.

Returns:

None

find_flavor_profile(name_or_id, ignore_missing=True)

Find a single flavor profile

Parameters:

name_or_id – The name or ID of a flavor profile
ignore_missing (bool) – When set to False ResourceNotFound will be raised when the flavor profile does not exist. When set to True, no exception will be set when attempting to delete a nonexistent flavor profile.

Returns:

None

update_flavor_profile(flavor_profile, **attrs)

Update a flavor profile

Parameters:

flavor_profile – The flavor_profile can be either the ID or a FlavorProfile instance
attrs (dict) – The attributes to update on the flavor profile represented by flavor_profile.

Returns:

The updated flavor profile

Return type:

FlavorProfile

Flavor Operations¶

create_flavor(**attrs)

Create a new flavor from attributes

Parameters:: attrs (dict) – Keyword arguments which will be used to create a Flavor, comprised of the properties on the Flavorclass.
Returns:: The results of flavor creation creation
Return type:: Flavor

get_flavor(*attrs)

Get a flavor

Parameters:: flavor – The value can be the ID of a flavor or Flavor instance.
Returns:: One Flavor

flavors(**query)

Retrieve a generator of flavors

Returns:: A generator of flavor instances

delete_flavor(flavor, ignore_missing=True)

Delete a flavor

Parameters:

flavor – The flavorcan be either the ID or a Flavor instance
ignore_missing (bool) – When set to False ResourceNotFound will be raised when the flavor does not exist. When set to True, no exception will be set when attempting to delete a nonexistent flavor.

Returns:

None

find_flavor(name_or_id, ignore_missing=True)

Find a single flavor

Parameters:

name_or_id – The name or ID of a flavor
ignore_missing (bool) – When set to False ResourceNotFound will be raised when the flavor does not exist. When set to True, no exception will be set when attempting to delete a nonexistent flavor.

Returns:

None

update_flavor(flavor, **attrs)

Update a flavor

Parameters:

flavor – The flavor can be either the ID or a Flavor instance
attrs (dict) – The attributes to update on the flavor represented by flavor.

Returns:

The updated flavor

Return type:

Flavor

Quota Operations¶

quotas(**query)

Return a generator of quotas

Parameters:: query (dict) – Optional query parameters to be sent to limit the resources being returned. Currently no query parameter is supported.
Returns:: A generator of quota objects
Return type:: Quota

get_quota(quota)

Get a quota

Parameters:: quota – The value can be the ID of a quota or a Quota instance. The ID of a quota is the same as the project ID for the quota.
Returns:: One Quota
Raises:: ResourceNotFound when no resource can be found.

update_quota(quota, **attrs)

Update a quota

Parameters:

quota – Either the ID of a quota or a Quota instance. The ID of a quota is the same as the project ID for the quota.
attrs (dict) – The attributes to update on the quota represented by quota.

Returns:

The updated quota

Return type:

Quota

get_quota_default()

Get a default quota

Returns:: One QuotaDefault

delete_quota(quota, ignore_missing=True)

Delete a quota (i.e. reset to the default quota)

Parameters:

quota – The value can be either the ID of a quota or a Quota instance. The ID of a quota is the same as the project ID for the quota.
ignore_missing (bool) – When set to False ResourceNotFound will be raised when quota does not exist. When set to True, no exception will be set when attempting to delete a nonexistent quota.

Returns:

None

Amphora Operations¶

amphorae(**query)

Retrieve a generator of amphorae

Returns:: A generator of amphora instances

get_amphora(*attrs)

Get a amphora

Parameters:: amphora – The value can be the ID of an amphora or Amphora instance.
Returns:: One Amphora

find_amphora(amphora_id, ignore_missing=True)

Find a single amphora

Parameters:

amphora_id – The ID of a amphora
ignore_missing (bool) – When set to False ResourceNotFound will be raised when the amphora does not exist. When set to True, no exception will be set when attempting to find a nonexistent amphora.

Returns:

None

configure_amphora(amphora_id, **attrs)

Update the configuration of an amphora agent

Parameters:: amphora_id – The ID of an amphora
Returns:: None

failover_amphora(amphora_id, **attrs)

Failover an amphora

Parameters:: amphora_id – The ID of an amphora
Returns:: None

Availability Zone Profile Operations¶

create_availability_zone_profile(**attrs)

Create a new availability zone profile from attributes

Parameters:: attrs (dict) – Keyword arguments which will be used to create a AvailabilityZoneProfile comprised of the properties on the AvailabilityZoneProfile class.
Returns:: The results of profile creation
Return type:: AvailabilityZoneProfile

get_availability_zone_profile(*attrs)

Get an availability zone profile

Parameters:: availability_zone_profile – The value can be the ID of an availability_zone profile or AvailabilityZoneProfile instance.
Returns:: One AvailabilityZoneProfile

availability_zone_profiles(**query)

Retrieve a generator of availability zone profiles

Returns:: A generator of availability zone profiles instances

delete_availability_zone_profile(availability_zone_profile, ignore_missing=True)

Delete an availability zone profile

Parameters:

availability_zone_profile – The availability_zone_profile can be either the ID or a AvailabilityZoneProfile instance
ignore_missing (bool) – When set to False ResourceNotFound will be raised when the availability zone profile does not exist. When set to True, no exception will be set when attempting to delete a nonexistent availability zone profile.

Returns:

None

find_availability_zone_profile(name_or_id, ignore_missing=True)

Find a single availability zone profile

Parameters:

name_or_id – The name or ID of a availability zone profile
ignore_missing (bool) – When set to False ResourceNotFound will be raised when the availability zone profile does not exist. When set to True, no exception will be set when attempting to delete a nonexistent availability zone profile.

Returns:

None

update_availability_zone_profile(availability_zone_profile, **attrs)

Update an availability zone profile

Parameters:

availability_zone_profile – The availability_zone_profile can be either the ID or a AvailabilityZoneProfile instance
attrs (dict) – The attributes to update on the availability_zone profile represented by availability_zone_profile.

Returns:

The updated availability zone profile

Return type:

AvailabilityZoneProfile

Availability Zone Operations¶

create_availability_zone(**attrs)

Create a new availability zone from attributes

Parameters:: attrs (dict) – Keyword arguments which will be used to create a AvailabilityZone comprised of the properties on the AvailabilityZoneclass.
Returns:: The results of availability_zone creation creation
Return type:: AvailabilityZone

get_availability_zone(*attrs)

Get an availability zone

Parameters:: availability_zone – The value can be the ID of a availability_zone or AvailabilityZone instance.
Returns:: One AvailabilityZone

availability_zones(**query)

Retrieve a generator of availability zones

Returns:: A generator of availability zone instances

delete_availability_zone(availability_zone, ignore_missing=True)

Delete an availability_zone

Parameters:

availability_zone – The availability_zone can be either the ID or a AvailabilityZone instance
ignore_missing (bool) – When set to False ResourceNotFound will be raised when the availability zone does not exist. When set to True, no exception will be set when attempting to delete a nonexistent availability zone.

Returns:

None

find_availability_zone(name_or_id, ignore_missing=True)

Find a single availability zone

Parameters:

name_or_id – The name or ID of a availability zone
ignore_missing (bool) – When set to False ResourceNotFound will be raised when the availability zone does not exist. When set to True, no exception will be set when attempting to delete a nonexistent availability zone.

Returns:

None

update_availability_zone(availability_zone, **attrs)

Update an availability zone

Parameters:

availability_zone – The availability_zone can be either the ID or a AvailabilityZone instance
attrs (dict) – The attributes to update on the availability_zone represented by availability_zone.

Returns:

The updated availability_zone

Return type:

AvailabilityZone

Load Balancer v2 API

Load Balancer v2 API¶

The LoadBalancer Class¶

Load Balancer Operations¶

Listener Operations¶

Pool Operations¶

Member Operations¶

Health Monitor Operations¶

L7 Policy Operations¶

L7 Rule Operations¶

Provider Operations¶

Flavor Profile Operations¶

Flavor Operations¶

Quota Operations¶

Amphora Operations¶

Availability Zone Profile Operations¶

Availability Zone Operations¶

openstacksdk 3.0.1.dev4

Page Contents