Network API

updated: 2020-11-20 23:01

Network API

For details on how to use network, see Using OpenStack Network

The Network Class

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

Network Operations

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

A generator of networks hosted by a DHCP agent.

Parameters

  • agent – Either the agent id of an instance of Agent

  • query – kwargs query: Optional query parameters to be sent to limit the resources being returned.

Returns

A generator of networks

add_dhcp_agent_to_network(agent, network)

Add a DHCP Agent to a network

Parameters

  • agent – Either the agent id of an instance of Agent

  • network – Network instance

Returns

remove_dhcp_agent_from_network(agent, network)

Remove a DHCP Agent from a network

Parameters

  • agent – Either the agent id of an instance of Agent

  • network – Network instance

Returns

create_network(**attrs)

Create a new network from attributes

Parameters

attrs (dict) – Keyword arguments which will be used to create a Network, comprised of the properties on the Network class.

Returns

The results of network creation

Return type

Network

delete_network(network, ignore_missing=True, if_revision=None)

Delete a network

Parameters

  • network – The value can be either the ID of a network or a Network instance.

  • ignore_missing (bool) – When set to False ResourceNotFound will be raised when the network does not exist. When set to True, no exception will be set when attempting to delete a nonexistent network.

  • if_revision (int) – Revision to put in If-Match header of update request to perform compare-and-swap update.

Returns

None

find_network(name_or_id, ignore_missing=True, **args)

Find a single network

Parameters

  • name_or_id – The name or ID of a network.

  • 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.

  • args (dict) – Any additional parameters to be passed into underlying methods. such as query filters.

Returns

One Network or None

get_network(network)

Get a single network

Parameters

network – The value can be the ID of a network or a Network instance.

Returns

One Network

Raises

ResourceNotFound when no resource can be found.

networks(**query)

Return a generator of networks

Parameters

query (kwargs) –

Optional query parameters to be sent to limit the resources being returned. Available parameters include:

  • description: The network description.

  • ipv4_address_scope_id: The ID of the IPv4 address scope for

    the network.

  • ipv6_address_scope_id: The ID of the IPv6 address scope for

    the network.

  • is_admin_state_up: Network administrative state

  • is_port_security_enabled: The port security status.

  • is_router_external: Network is external or not.

  • is_shared: Whether the network is shared across projects.

  • name: The name of the network.

  • status: Network status

  • project_id: Owner tenant ID

  • provider_network_type: Network physical mechanism

  • provider_physical_network: Physical network

  • provider_segmentation_id: VLAN ID for VLAN networks or Tunnel

    ID for GENEVE/GRE/VXLAN networks

Returns

A generator of network objects

Return type

Network

update_network(network, if_revision=None, **attrs)

Update a network

Parameters

  • network – Either the id of a network or an instance of type Network.

  • if_revision (int) – Revision to put in If-Match header of update request to perform compare-and-swap update.

  • attrs (dict) – The attributes to update on the network represented by network.

Returns

The updated network

Return type

Network

find_network_ip_availability(name_or_id, ignore_missing=True, **args)

Find IP availability of a network

Parameters

  • name_or_id – The name or ID of a network.

  • 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.

  • args (dict) – Any additional parameters to be passed into underlying methods. such as query filters.

Returns

One NetworkIPAvailability or None

get_network_ip_availability(network)

Get IP availability of a network

Parameters

network – The value can be the ID of a network or a Network instance.

Returns

One NetworkIPAvailability

Raises

ResourceNotFound when no resource can be found.

network_ip_availabilities(**query)

Return a generator of network ip availabilities

Parameters

query (kwargs) –

Optional query parameters to be sent to limit the resources being returned. Available parameters include:

  • ip_version: IP version of the network

  • network_id: ID of network to use when listening network IP

    availability.

  • network_name: The name of the network for the particular

    network IP availability.

  • project_id: Owner tenant ID

Returns

A generator of network ip availability objects

Return type

NetworkIPAvailability

Port Operations

class openstack.network.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_port(**attrs)

Create a new port from attributes

Parameters

attrs (dict) – Keyword arguments which will be used to create a Port, comprised of the properties on the Port class.

Returns

The results of port creation

Return type

Port

create_ports(data)

Create ports from the list of attributes

Parameters

data (list) – List of dicts of attributes which will be used to create a Port, comprised of the properties on the Port class.

Returns

A generator of port objects

Return type

Port

delete_port(port, ignore_missing=True, if_revision=None)

Delete a port

Parameters

  • port – The value can be either the ID of a port or a Port instance.

  • ignore_missing (bool) – When set to False ResourceNotFound will be raised when the port does not exist. When set to True, no exception will be set when attempting to delete a nonexistent port.

  • if_revision (int) – Revision to put in If-Match header of update request to perform compare-and-swap update.

Returns

None

find_port(name_or_id, ignore_missing=True, **args)

Find a single port

Parameters

  • name_or_id – The name or ID of a port.

  • 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.

  • args (dict) – Any additional parameters to be passed into underlying methods. such as query filters.

Returns

One Port or None

get_port(port)

Get a single port

Parameters

port – The value can be the ID of a port or a Port instance.

Returns

One Port

Raises

ResourceNotFound when no resource can be found.

ports(**query)

Return a generator of ports

Parameters

query (kwargs) –

Optional query parameters to be sent to limit the resources being returned. Available parameters include:

  • description: The port description.

  • device_id: Port device ID.

  • device_owner: Port device owner (e.g. network:dhcp).

  • ip_address: IP addresses of an allowed address pair.

  • is_admin_state_up: The administrative state of the port.

  • is_port_security_enabled: The port security status.

  • mac_address: Port MAC address.

  • name: The port name.

  • network_id: ID of network that owns the ports.

  • project_id: The ID of the project who owns the network.

  • status: The port status. Value is ACTIVE or DOWN.

  • subnet_id: The ID of the subnet.

Returns

A generator of port objects

Return type

Port

update_port(port, if_revision=None, **attrs)

Update a port

Parameters

  • port – Either the id of a port or a Port instance.

  • if_revision (int) – Revision to put in If-Match header of update request to perform compare-and-swap update.

  • attrs (dict) – The attributes to update on the port represented by port.

Returns

The updated port

Return type

Port

Router Operations

class openstack.network.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_router(**attrs)

Create a new router from attributes

Parameters

attrs (dict) – Keyword arguments which will be used to create a Router, comprised of the properties on the Router class.

Returns

The results of router creation

Return type

Router

delete_router(router, ignore_missing=True, if_revision=None)

Delete a router

Parameters

  • router – The value can be either the ID of a router or a Router instance.

  • ignore_missing (bool) – When set to False ResourceNotFound will be raised when the router does not exist. When set to True, no exception will be set when attempting to delete a nonexistent router.

  • if_revision (int) – Revision to put in If-Match header of update request to perform compare-and-swap update.

Returns

None

find_router(name_or_id, ignore_missing=True, **args)

Find a single router

Parameters

  • name_or_id – The name or ID of a router.

  • 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.

  • args (dict) – Any additional parameters to be passed into underlying methods. such as query filters.

Returns

One Router or None

get_router(router)

Get a single router

Parameters

router – The value can be the ID of a router or a Router instance.

Returns

One Router

Raises

ResourceNotFound when no resource can be found.

routers(**query)

Return a generator of routers

Parameters

query (dict) –

Optional query parameters to be sent to limit

the resources being returned. Valid parameters are:

  • description: The description of a router.

  • flavor_id: The ID of the flavor.

  • is_admin_state_up: Router administrative state is up or not

  • is_distributed: The distributed state of a router

  • is_ha: The highly-available state of a router

  • name: Router name

  • project_id: The ID of the project this router is associated

    with.

  • status: The status of the router.

Returns

A generator of router objects

Return type

Router

update_router(router, if_revision=None, **attrs)

Update a router

Parameters

  • router – Either the id of a router or a Router instance.

  • if_revision (int) – Revision to put in If-Match header of update request to perform compare-and-swap update.

  • attrs (dict) – The attributes to update on the router represented by router.

Returns

The updated router

Return type

Router

add_interface_to_router(router, subnet_id=None, port_id=None)

Add Interface to a router

Parameters

  • router – Either the router ID or an instance of Router

  • subnet_id – ID of the subnet

  • port_id – ID of the port

Returns

Router with updated interface

Return type

class

~openstack.network.v2.router.Router

remove_interface_from_router(router, subnet_id=None, port_id=None)

Remove Interface from a router

Parameters

  • router – Either the router ID or an instance of Router

  • subnet – ID of the subnet

  • port – ID of the port

Returns

Router with updated interface

Return type

class

~openstack.network.v2.router.Router

add_extra_routes_to_router(router, body)

Add extra routes to a router

Parameters

  • router – Either the router ID or an instance of Router

  • body – The request body as documented in the api-ref.

Returns

Router with updated extra routes

Return type

class

~openstack.network.v2.router.Router

remove_extra_routes_from_router(router, body)

Remove extra routes from a router

Parameters

  • router – Either the router ID or an instance of Router

  • body – The request body as documented in the api-ref.

Returns

Router with updated extra routes

Return type

class

~openstack.network.v2.router.Router

add_gateway_to_router(router, **body)

Add Gateway to a router

Parameters

  • router – Either the router ID or an instance of Router

  • body – Body with the gateway information

Returns

Router with updated interface

Return type

class

~openstack.network.v2.router.Router

remove_gateway_from_router(router, **body)

Remove Gateway from a router

Parameters

  • router – Either the router ID or an instance of Router

  • body – Body with the gateway information

Returns

Router with updated interface

Return type

class

~openstack.network.v2.router.Router

Floating IP Operations

class openstack.network.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_ip(**attrs)

Create a new floating ip from attributes

Parameters

attrs (dict) – Keyword arguments which will be used to create a FloatingIP, comprised of the properties on the FloatingIP class.

Returns

The results of floating ip creation

Return type

FloatingIP

delete_ip(floating_ip, ignore_missing=True, if_revision=None)

Delete a floating ip

Parameters

  • floating_ip – The value can be either the ID of a floating ip or a FloatingIP instance.

  • ignore_missing (bool) – When set to False ResourceNotFound will be raised when the floating ip does not exist. When set to True, no exception will be set when attempting to delete a nonexistent ip.

  • if_revision (int) – Revision to put in If-Match header of update request to perform compare-and-swap update.

Returns

None

find_available_ip()

Find an available IP

Returns

One FloatingIP or None

find_ip(name_or_id, ignore_missing=True, **args)

Find a single IP

Parameters

  • name_or_id – The name or ID of an IP.

  • 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.

  • args (dict) – Any additional parameters to be passed into underlying methods. such as query filters.

Returns

One FloatingIP or None

get_ip(floating_ip)

Get a single floating ip

Parameters

floating_ip – The value can be the ID of a floating ip or a FloatingIP instance.

Returns

One FloatingIP

Raises

ResourceNotFound when no resource can be found.

ips(**query)

Return a generator of ips

Parameters

query (dict) –

Optional query parameters to be sent to limit

the resources being returned. Valid parameters are:

  • description: The description of a floating IP.

  • fixed_ip_address: The fixed IP address associated with a

    floating IP address.

  • floating_ip_address: The IP address of a floating IP.

  • floating_network_id: The ID of the network associated with

    a floating IP.

  • port_id: The ID of the port to which a floating IP is

    associated.

  • project_id: The ID of the project a floating IP is

    associated with.

  • router_id: The ID of an associated router.

  • status: The status of a floating IP, which can be ACTIVE

    or DOWN.

Returns

A generator of floating IP objects

Return type

FloatingIP

update_ip(floating_ip, if_revision=None, **attrs)

Update a ip

Parameters

  • floating_ip – Either the id of a ip or a FloatingIP instance.

  • if_revision (int) – Revision to put in If-Match header of update request to perform compare-and-swap update.

  • attrs (dict) – The attributes to update on the ip represented by value.

Returns

The updated ip

Return type

FloatingIP

Pool Operations

class openstack.network.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_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

delete_pool(pool, ignore_missing=True)

Delete a pool

Parameters

  • pool – The value can be either the ID of a pool 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, **args)

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 resource does not exist. When set to True, None will be returned when attempting to find a nonexistent resource.

  • args (dict) – Any additional parameters to be passed into underlying methods. such as query filters.

Returns

One Pool or None

get_pool(pool)

Get a single pool

Parameters

pool – The value can be the ID of a pool or a Pool instance.

Returns

One Pool

Raises

ResourceNotFound when no resource can be found.

pools(**query)

Return a generator of pools

Parameters

query (dict) –

Optional query parameters to be sent to limit

the resources being returned. Valid parameters are:

  • description: The description for the pool.

  • is_admin_state_up: The administrative state of the pool.

  • lb_algorithm: The load-balancer algorithm used, which is one

    of round-robin, least-connections and so on.

  • name: The name of the node pool.

  • project_id: The ID of the project the pool is associated

    with.

  • protocol: The protocol used by the pool, which is one of

    TCP, HTTP or HTTPS.

  • provider: The name of the provider of the load balancer

    service.

  • subnet_id: The subnet on which the members of the pool are

    located.

  • virtual_ip_id: The ID of the virtual IP used.

Returns

A generator of pool objects

Return type

Pool

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

create_pool_member(pool, **attrs)

Create a new pool 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 PoolMember, comprised of the properties on the PoolMember class.

Returns

The results of pool member creation

Return type

PoolMember

delete_pool_member(pool_member, pool, ignore_missing=True)

Delete a pool member

Parameters

  • pool_member – The member can be either the ID of a pool member or a PoolMember 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 pool member does not exist. When set to True, no exception will be set when attempting to delete a nonexistent pool member.

Returns

None

find_pool_member(name_or_id, pool, ignore_missing=True, **args)

Find a single pool member

Parameters

  • name_or_id (str) – The name or ID of a pool 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.

  • args (dict) – Any additional parameters to be passed into underlying methods. such as query filters.

Returns

One PoolMember or None

get_pool_member(pool_member, pool)

Get a single pool member

Parameters

  • pool_member – The member can be the ID of a pool member or a PoolMember instance.

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

Returns

One PoolMember

Raises

ResourceNotFound when no resource can be found.

pool_members(pool, **query)

Return a generator of pool 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:

    • address: The IP address of the pool member.

    • is_admin_state_up: The administrative state of the pool

      member.

    • name: Name of the pool member.

    • project_id: The ID of the project this pool member is

      associated with.

    • protocol_port: The port on which the application is hosted.

    • subnet_id: Subnet ID in which to access this pool member.

    • weight: A positive integer value that indicates the relative

      portion of traffic that this member should receive from the pool.

Returns

A generator of pool member objects

Return type

PoolMember

update_pool_member(pool_member, pool, **attrs)

Update a pool member

Parameters

  • pool_member – Either the ID of a pool member or a PoolMember 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 pool member represented by pool_member.

Returns

The updated pool member

Return type

PoolMember

Auto Allocated Topology Operations

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

Get the auto-allocated topology of a given tenant

Parameters

project – The value is the ID or name of a project

Returns

The auto-allocated topology

Return type

AutoAllocatedTopology

delete_auto_allocated_topology(project=None, ignore_missing=False)

Delete auto-allocated topology

Parameters

  • project – The value is the ID or name of a project

  • ignore_missing – When set to False ResourceNotFound will be raised when the topology does not exist. When set to True, no exception will be raised when attempting to delete nonexistant topology

Returns

None

validate_auto_allocated_topology(project=None)

Validate the resources for auto allocation

Parameters

project – The value is the ID or name of a project

Returns

Whether all resources are correctly configured or not

Return type

ValidateTopology

Security Group Operations

class openstack.network.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_security_group(**attrs)

Create a new security group from attributes

Parameters

attrs (dict) – Keyword arguments which will be used to create a SecurityGroup, comprised of the properties on the SecurityGroup class.

Returns

The results of security group creation

Return type

SecurityGroup

delete_security_group(security_group, ignore_missing=True, if_revision=None)

Delete a security group

Parameters

  • security_group – The value can be either the ID of a security group or a SecurityGroup instance.

  • ignore_missing (bool) – When set to False ResourceNotFound will be raised when the security group does not exist. When set to True, no exception will be set when attempting to delete a nonexistent security group.

  • if_revision (int) – Revision to put in If-Match header of update request to perform compare-and-swap update.

Returns

None

find_security_group(name_or_id, ignore_missing=True, **args)

Find a single security group

Parameters

  • name_or_id – The name or ID of a security group.

  • 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.

  • args (dict) – Any additional parameters to be passed into underlying methods. such as query filters.

Returns

One SecurityGroup or None

get_security_group(security_group)

Get a single security group

Parameters

security_group – The value can be the ID of a security group or a SecurityGroup instance.

Returns

One SecurityGroup

Raises

ResourceNotFound when no resource can be found.

security_groups(**query)

Return a generator of security groups

Parameters

query (dict) –

Optional query parameters to be sent to limit

the resources being returned. Valid parameters are:

  • description: Security group description

  • ìd: The id of a security group, or list of security group ids

  • name: The name of a security group

  • project_id: The ID of the project this security group is

    associated with.

Returns

A generator of security group objects

Return type

SecurityGroup

update_security_group(security_group, if_revision=None, **attrs)

Update a security group

Parameters

  • security_group – Either the id of a security group or a SecurityGroup instance.

  • if_revision (int) – Revision to put in If-Match header of update request to perform compare-and-swap update.

  • attrs (dict) – The attributes to update on the security group represented by security_group.

Returns

The updated security group

Return type

SecurityGroup

create_security_group_rule(**attrs)

Create a new security group rule from attributes

Parameters

attrs (dict) – Keyword arguments which will be used to create a SecurityGroupRule, comprised of the properties on the SecurityGroupRule class.

Returns

The results of security group rule creation

Return type

            SecurityGroupRule

create_security_group_rules(data)

Create new security group rules from the list of attributes

Parameters

data (list) – List of dicts of attributes which will be used to create a SecurityGroupRule, comprised of the properties on the SecurityGroupRule class.

Returns

A generator of security group rule objects

Return type

            SecurityGroupRule

delete_security_group_rule(security_group_rule, ignore_missing=True, if_revision=None)

Delete a security group rule

Parameters

  • security_group_rule – The value can be either the ID of a security group rule or a SecurityGroupRule instance.

  • ignore_missing (bool) – When set to False ResourceNotFound will be raised when the security group rule does not exist. When set to True, no exception will be set when attempting to delete a nonexistent security group rule.

  • if_revision (int) – Revision to put in If-Match header of update request to perform compare-and-swap update.

Returns

None

find_security_group_rule(name_or_id, ignore_missing=True, **args)

Find a single security group rule

Parameters

  • name_or_id (str) – The ID of a security group rule.

  • 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.

  • args (dict) – Any additional parameters to be passed into underlying methods. such as query filters.

Returns

One SecurityGroupRule or None

get_security_group_rule(security_group_rule)

Get a single security group rule

Parameters

security_group_rule – The value can be the ID of a security group rule or a             SecurityGroupRule instance.

Returns

            SecurityGroupRule

Raises

ResourceNotFound when no resource can be found.

security_group_rules(**query)

Return a generator of security group rules

Parameters

query (kwargs) –

Optional query parameters to be sent to limit the resources being returned. Available parameters include:

  • description: The security group rule description

  • direction: Security group rule direction

  • ether_type: Must be IPv4 or IPv6, and addresses represented

    in CIDR must match the ingress or egress rule.

  • project_id: The ID of the project this security group rule

    is associated with.

  • protocol: Security group rule protocol

  • remote_group_id: ID of a remote security group

  • security_group_id: ID of security group that owns the rules

Returns

A generator of security group rule objects

Return type

SecurityGroupRule

Availability Zone Operations

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

Return a generator of availability zones

Parameters

query (dict) –

optional query parameters to be set to limit the

returned resources. Valid parameters include:

  • name: The name of an availability zone.

  • resource: The type of resource for the availability zone.

Returns

A generator of availability zone objects

Return type

AvailabilityZone

Address Scope Operations

class openstack.network.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_address_scope(**attrs)

Create a new address scope from attributes

Parameters

attrs (dict) – Keyword arguments which will be used to create a AddressScope, comprised of the properties on the AddressScope class.

Returns

The results of address scope creation

Return type

AddressScope

delete_address_scope(address_scope, ignore_missing=True)

Delete an address scope

Parameters

  • address_scope – The value can be either the ID of an address scope or a AddressScope instance.

  • ignore_missing (bool) – When set to False ResourceNotFound will be raised when the address scope does not exist. When set to True, no exception will be set when attempting to delete a nonexistent address scope.

Returns

None

find_address_scope(name_or_id, ignore_missing=True, **args)

Find a single address scope

Parameters

  • name_or_id – The name or ID of an address scope.

  • 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.

  • args (dict) – Any additional parameters to be passed into underlying methods. such as query filters.

Returns

One AddressScope or None

get_address_scope(address_scope)

Get a single address scope

Parameters

address_scope – The value can be the ID of an address scope or a AddressScope instance.

Returns

One AddressScope

Raises

ResourceNotFound when no resource can be found.

address_scopes(**query)

Return a generator of address scopes

Parameters

query (dict) –

Optional query parameters to be sent to limit

the resources being returned.

  • name: Address scope name

  • ip_version: Address scope IP address version

  • tenant_id: Owner tenant ID

  • shared: Address scope is shared (boolean)

Returns

A generator of address scope objects

Return type

AddressScope

update_address_scope(address_scope, **attrs)

Update an address scope

Parameters

  • address_scope – Either the ID of an address scope or a AddressScope instance.

  • attrs (dict) – The attributes to update on the address scope represented by value.

Returns

The updated address scope

Return type

AddressScope

Quota Operations

class openstack.network.v2._proxy.Proxy(session, statsd_client=None, statsd_prefix=None, prometheus_counter=None, prometheus_histogram=None, influxdb_config=None, influxdb_client=None, *args, **kwargs)
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

get_quota(quota, details=False)

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.

  • details – If set to True, details about quota usage will be returned.

Returns

One Quota

Raises

ResourceNotFound when no resource can be found.

get_quota_default(quota)

Get a default quota

Parameters

quota – The value can be the ID of a default quota or a QuotaDefault instance. The ID of a default quota is the same as the project ID for the default quota.

Returns

One QuotaDefault

Raises

ResourceNotFound when no resource can be found.

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

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

QoS Operations

class openstack.network.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_qos_bandwidth_limit_rule(qos_policy, **attrs)

Create a new bandwidth limit rule

Parameters

  • attrs (dict) – Keyword arguments which will be used to create a QoSBandwidthLimitRule, comprised of the properties on the QoSBandwidthLimitRule class.

  • qos_policy – The value can be the ID of the QoS policy that the rule belongs or a QoSPolicy instance.

Returns

The results of resource creation

Return type

QoSBandwidthLimitRule

delete_qos_bandwidth_limit_rule(qos_rule, qos_policy, ignore_missing=True)

Delete a bandwidth limit rule

Parameters

  • qos_rule – The value can be either the ID of a bandwidth limit rule or a QoSBandwidthLimitRule instance.

  • qos_policy – The value can be the ID of the QoS policy that the rule belongs or a QoSPolicy instance.

  • ignore_missing (bool) – When set to False ResourceNotFound will be raised when the resource does not exist. When set to True, no exception will be set when attempting to delete a nonexistent bandwidth limit rule.

Returns

None

find_qos_bandwidth_limit_rule(qos_rule_id, qos_policy, ignore_missing=True, **args)

Find a bandwidth limit rule

Parameters

  • qos_rule_id – The ID of a bandwidth limit rule.

  • qos_policy – The value can be the ID of the QoS policy that the rule belongs or a QoSPolicy instance.

  • 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.

  • args (dict) – Any additional parameters to be passed into underlying methods. such as query filters.

Returns

One QoSBandwidthLimitRule or None

get_qos_bandwidth_limit_rule(qos_rule, qos_policy)

Get a single bandwidth limit rule

Parameters

  • qos_rule – The value can be the ID of a minimum bandwidth rule or a QoSBandwidthLimitRule instance.

  • qos_policy – The value can be the ID of the QoS policy that the rule belongs or a QoSPolicy instance.

Returns

One QoSBandwidthLimitRule

Raises

ResourceNotFound when no resource can be found.

qos_bandwidth_limit_rules(qos_policy, **query)

Return a generator of bandwidth limit rules

Parameters

  • qos_policy – The value can be the ID of the QoS policy that the rule belongs or a QoSPolicy instance.

  • query (kwargs) – Optional query parameters to be sent to limit the resources being returned.

Returns

A generator of bandwidth limit rule objects

Return type

QoSBandwidthLimitRule

update_qos_bandwidth_limit_rule(qos_rule, qos_policy, **attrs)

Update a bandwidth limit rule

Parameters

  • qos_rule – Either the id of a bandwidth limit rule or a QoSBandwidthLimitRule instance.

  • qos_policy – The value can be the ID of the QoS policy that the rule belongs or a QoSPolicy instance.

Attrs kwargs

The attributes to update on the bandwidth limit rule represented by value.

Returns

The updated minimum bandwidth rule

Return type

QoSBandwidthLimitRule

create_qos_dscp_marking_rule(qos_policy, **attrs)

Create a new QoS DSCP marking rule

Parameters

  • attrs (dict) – Keyword arguments which will be used to create a QoSDSCPMarkingRule, comprised of the properties on the QosDscpMarkingRule class.

  • qos_policy – The value can be the ID of the QoS policy that the rule belongs or a QoSPolicy instance.

Returns

The results of router creation

Return type

QoSDSCPMarkingRule

delete_qos_dscp_marking_rule(qos_rule, qos_policy, ignore_missing=True)

Delete a QoS DSCP marking rule

Parameters

  • qos_rule – The value can be either the ID of a minimum bandwidth rule or a QoSDSCPMarkingRule instance.

  • qos_policy – The value can be the ID of the QoS policy that the rule belongs or a QoSPolicy instance.

  • ignore_missing (bool) – When set to False ResourceNotFound will be raised when the resource does not exist. When set to True, no exception will be set when attempting to delete a nonexistent minimum bandwidth rule.

Returns

None

find_qos_dscp_marking_rule(qos_rule_id, qos_policy, ignore_missing=True, **args)

Find a QoS DSCP marking rule

Parameters

  • qos_rule_id – The ID of a QoS DSCP marking rule.

  • qos_policy – The value can be the ID of the QoS policy that the rule belongs or a QoSPolicy instance.

  • 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.

  • args (dict) – Any additional parameters to be passed into underlying methods. such as query filters.

Returns

One QoSDSCPMarkingRule or None

get_qos_dscp_marking_rule(qos_rule, qos_policy)

Get a single QoS DSCP marking rule

Parameters

  • qos_rule – The value can be the ID of a minimum bandwidth rule or a QoSDSCPMarkingRule instance.

  • qos_policy – The value can be the ID of the QoS policy that the rule belongs or a QoSPolicy instance.

Returns

One QoSDSCPMarkingRule

Raises

ResourceNotFound when no resource can be found.

qos_dscp_marking_rules(qos_policy, **query)

Return a generator of QoS DSCP marking rules

Parameters

  • qos_policy – The value can be the ID of the QoS policy that the rule belongs or a QoSPolicy instance.

  • query (kwargs) – Optional query parameters to be sent to limit the resources being returned.

Returns

A generator of QoS DSCP marking rule objects

Return type

QoSDSCPMarkingRule

update_qos_dscp_marking_rule(qos_rule, qos_policy, **attrs)

Update a QoS DSCP marking rule

Parameters

  • qos_rule – Either the id of a minimum bandwidth rule or a QoSDSCPMarkingRule instance.

  • qos_policy – The value can be the ID of the QoS policy that the rule belongs or a QoSPolicy instance.

Attrs kwargs

The attributes to update on the QoS DSCP marking rule represented by value.

Returns

The updated QoS DSCP marking rule

Return type

QoSDSCPMarkingRule

create_qos_minimum_bandwidth_rule(qos_policy, **attrs)

Create a new minimum bandwidth rule

Parameters

  • attrs (dict) – Keyword arguments which will be used to create a QoSMinimumBandwidthRule, comprised of the properties on the QoSMinimumBandwidthRule class.

  • qos_policy – The value can be the ID of the QoS policy that the rule belongs or a QoSPolicy instance.

Returns

The results of resource creation

Return type

QoSMinimumBandwidthRule

delete_qos_minimum_bandwidth_rule(qos_rule, qos_policy, ignore_missing=True)

Delete a minimum bandwidth rule

Parameters

  • qos_rule – The value can be either the ID of a minimum bandwidth rule or a QoSMinimumBandwidthRule instance.

  • qos_policy – The value can be the ID of the QoS policy that the rule belongs or a QoSPolicy instance.

  • ignore_missing (bool) – When set to False ResourceNotFound will be raised when the resource does not exist. When set to True, no exception will be set when attempting to delete a nonexistent minimum bandwidth rule.

Returns

None

find_qos_minimum_bandwidth_rule(qos_rule_id, qos_policy, ignore_missing=True, **args)

Find a minimum bandwidth rule

Parameters

  • qos_rule_id – The ID of a minimum bandwidth rule.

  • qos_policy – The value can be the ID of the QoS policy that the rule belongs or a QoSPolicy instance.

  • 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.

  • args (dict) – Any additional parameters to be passed into underlying methods. such as query filters.

Returns

One QoSMinimumBandwidthRule or None

get_qos_minimum_bandwidth_rule(qos_rule, qos_policy)

Get a single minimum bandwidth rule

Parameters

  • qos_rule – The value can be the ID of a minimum bandwidth rule or a QoSMinimumBandwidthRule instance.

  • qos_policy – The value can be the ID of the QoS policy that the rule belongs or a QoSPolicy instance.

Returns

One QoSMinimumBandwidthRule

Raises

ResourceNotFound when no resource can be found.

qos_minimum_bandwidth_rules(qos_policy, **query)

Return a generator of minimum bandwidth rules

Parameters

  • qos_policy – The value can be the ID of the QoS policy that the rule belongs or a QoSPolicy instance.

  • query (kwargs) – Optional query parameters to be sent to limit the resources being returned.

Returns

A generator of minimum bandwidth rule objects

Return type

QoSMinimumBandwidthRule

update_qos_minimum_bandwidth_rule(qos_rule, qos_policy, **attrs)

Update a minimum bandwidth rule

Parameters

  • qos_rule – Either the id of a minimum bandwidth rule or a QoSMinimumBandwidthRule instance.

  • qos_policy – The value can be the ID of the QoS policy that the rule belongs or a QoSPolicy instance.

Attrs kwargs

The attributes to update on the minimum bandwidth rule represented by value.

Returns

The updated minimum bandwidth rule

Return type

QoSMinimumBandwidthRule

create_qos_policy(**attrs)

Create a new QoS policy from attributes

Parameters

attrs (dict) – Keyword arguments which will be used to create a QoSPolicy, comprised of the properties on the QoSPolicy class.

Returns

The results of QoS policy creation

Return type

QoSPolicy

delete_qos_policy(qos_policy, ignore_missing=True)

Delete a QoS policy

Parameters

  • qos_policy – The value can be either the ID of a QoS policy or a QoSPolicy instance.

  • ignore_missing (bool) – When set to False ResourceNotFound will be raised when the QoS policy does not exist. When set to True, no exception will be set when attempting to delete a nonexistent QoS policy.

Returns

None

find_qos_policy(name_or_id, ignore_missing=True, **args)

Find a single QoS policy

Parameters

  • name_or_id – The name or ID of a QoS policy.

  • 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.

  • args (dict) – Any additional parameters to be passed into underlying methods. such as query filters.

Returns

One QoSPolicy or None

get_qos_policy(qos_policy)

Get a single QoS policy

Parameters

qos_policy – The value can be the ID of a QoS policy or a QoSPolicy instance.

Returns

One QoSPolicy

Raises

ResourceNotFound when no resource can be found.

qos_policies(**query)

Return a generator of QoS policies

Parameters

query (dict) –

Optional query parameters to be sent to limit

the resources being returned. Valid parameters are:

  • description: The description of a QoS policy.

  • is_shared: Whether the policy is shared among projects.

  • name: The name of a QoS policy.

  • project_id: The ID of the project who owns the network.

Returns

A generator of QoS policy objects

Return type

QoSPolicy

update_qos_policy(qos_policy, **attrs)

Update a QoS policy

Parameters

qos_policy – Either the id of a QoS policy or a QoSPolicy instance.

Attrs kwargs

The attributes to update on the QoS policy represented by value.

Returns

The updated QoS policy

Return type

QoSPolicy

find_qos_rule_type(rule_type_name, ignore_missing=True)

Find a single QoS rule type details

Parameters

  • rule_type_name – The name of a QoS rule type.

  • 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 QoSRuleType or None

get_qos_rule_type(qos_rule_type)

Get details about single QoS rule type

Parameters

qos_rule_type – The value can be the name of a QoS policy rule type or a QoSRuleType instance.

Returns

One QoSRuleType

Raises

ResourceNotFound when no resource can be found.

qos_rule_types(**query)

Return a generator of QoS rule types

Parameters

query (dict) –

Optional query parameters to be sent to limit the

resources returned. Valid parameters include:

  • type: The type of the QoS rule type.

Returns

A generator of QoS rule type objects

Return type

QoSRuleType

Agent Operations

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

Return a generator of network agents

Parameters

query (dict) –

Optional query parameters to be sent to limit the

resources being returned.

  • agent_type: Agent type.

  • availability_zone: The availability zone for an agent.

  • binary: The name of the agent’s application binary.

  • description: The description of the agent.

  • host: The host (host name or host address) the agent is

    running on.

  • topic: The message queue topic used.

  • is_admin_state_up: The administrative state of the agent.

  • is_alive: Whether the agent is alive.

Returns

A generator of agents

Return type

Agent

delete_agent(agent, ignore_missing=True)

Delete a network agent

Parameters

  • agent – The value can be the ID of a agent or a Agent instance.

  • ignore_missing (bool) – When set to False ResourceNotFound will be raised when the agent does not exist. When set to True, no exception will be set when attempting to delete a nonexistent agent.

Returns

None

get_agent(agent)

Get a single network agent

Parameters

agent – The value can be the ID of a agent or a Agent instance.

Returns

One Agent

Return type

Agent

Raises

ResourceNotFound when no resource can be found.

update_agent(agent, **attrs)

Update a network agent

Parameters

  • agent – The value can be the ID of a agent or a Agent instance.

  • attrs (dict) – The attributes to update on the agent represented by value.

Returns

One Agent

Return type

Agent

network_hosting_dhcp_agents(network, **query)

A generator of DHCP agents hosted on a network.

Parameters

  • network – The instance of Network

  • query (dict) – Optional query parameters to be sent to limit the resources returned.

Returns

A generator of hosted DHCP agents

routers_hosting_l3_agents(router, **query)

Return a generator of L3 agent hosting a router

Parameters

  • router – Either the router id or an instance of Router

  • query (kwargs) – Optional query parameters to be sent to limit the resources returned

Returns

A generator of Router L3 Agents

Return type

RouterL3Agents

agent_hosted_routers(agent, **query)

Return a generator of routers hosted by a L3 agent

Parameters

  • agent – Either the agent id of an instance of Agent

  • query (kwargs) – Optional query parameters to be sent to limit the resources returned

Returns

A generator of routers

Return type

L3AgentRouters

add_router_to_agent(agent, router)

Add router to L3 agent

Parameters

  • agent – Either the id of an agent Agent instance

  • router – A router instance

Returns

Agent with attached router

Return type

Agent

remove_router_from_agent(agent, router)

Remove router from L3 agent

Parameters

  • agent – Either the id of an agent or an Agent instance

  • router – A router instance

Returns

Agent with removed router

Return type

Agent

RBAC Operations

class openstack.network.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_rbac_policy(**attrs)

Create a new RBAC policy from attributes

Parameters

attrs (dict) – Keyword arguments which will be used to create a RBACPolicy, comprised of the properties on the RBACPolicy class.

Returns

The results of RBAC policy creation

Return type

RBACPolicy

delete_rbac_policy(rbac_policy, ignore_missing=True)

Delete a RBAC policy

Parameters

  • rbac_policy – The value can be either the ID of a RBAC policy or a RBACPolicy instance.

  • ignore_missing (bool) – When set to False ResourceNotFound will be raised when the RBAC policy does not exist. When set to True, no exception will be set when attempting to delete a nonexistent RBAC policy.

Returns

None

find_rbac_policy(rbac_policy, ignore_missing=True, **args)

Find a single RBAC policy

Parameters

  • rbac_policy – The ID of a RBAC policy.

  • 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.

  • args (dict) – Any additional parameters to be passed into underlying methods. such as query filters.

Returns

One RBACPolicy or None

get_rbac_policy(rbac_policy)

Get a single RBAC policy

Parameters

rbac_policy – The value can be the ID of a RBAC policy or a RBACPolicy instance.

Returns

One RBACPolicy

Raises

ResourceNotFound when no resource can be found.

rbac_policies(**query)

Return a generator of RBAC policies

Parameters

query (dict) –

Optional query parameters to be sent to limit

the resources being returned. Available parameters include:

  • action: RBAC policy action

  • object_type: Type of the object that the RBAC policy affects

  • target_project_id: ID of the tenant that the RBAC policy

    affects

  • project_id: Owner tenant ID

Returns

A generator of rbac objects

Return type

RBACPolicy

update_rbac_policy(rbac_policy, **attrs)

Update a RBAC policy

Parameters

  • rbac_policy – Either the id of a RBAC policy or a RBACPolicy instance.

  • attrs (dict) – The attributes to update on the RBAC policy represented by rbac_policy.

Returns

The updated RBAC policy

Return type

RBACPolicy

Listener Operations

class openstack.network.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_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 listner 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, **args)

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.

  • args (dict) – Any additional parameters to be passed into underlying methods. such as query filters.

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.

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:

  • connection_limit: The maximum number of connections

    permitted for the load-balancer.

  • default_pool_id: The ID of the default pool.

  • default_tls_container_ref: A reference to a container of TLS

    secret.

  • description: The description of a listener.

  • is_admin_state_up: The administrative state of the listener.

  • name: The name of a listener.

  • project_id: The ID of the project associated with a listener.

  • protocol: The protocol of the listener.

  • protocol_port: Port the listener will listen to.

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

Subnet Operations

class openstack.network.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_subnet(**attrs)

Create a new subnet from attributes

Parameters

attrs (dict) – Keyword arguments which will be used to create a Subnet, comprised of the properties on the Subnet class.

Returns

The results of subnet creation

Return type

Subnet

delete_subnet(subnet, ignore_missing=True, if_revision=None)

Delete a subnet

Parameters

  • subnet – The value can be either the ID of a subnet or a Subnet instance.

  • ignore_missing (bool) – When set to False ResourceNotFound will be raised when the subnet does not exist. When set to True, no exception will be set when attempting to delete a nonexistent subnet.

  • if_revision (int) – Revision to put in If-Match header of update request to perform compare-and-swap update.

Returns

None

find_subnet(name_or_id, ignore_missing=True, **args)

Find a single subnet

Parameters

  • name_or_id – The name or ID of a subnet.

  • 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.

  • args (dict) – Any additional parameters to be passed into underlying methods. such as query filters.

Returns

One Subnet or None

get_subnet(subnet)

Get a single subnet

Parameters

subnet – The value can be the ID of a subnet or a Subnet instance.

Returns

One Subnet

Raises

ResourceNotFound when no resource can be found.

subnets(**query)

Return a generator of subnets

Parameters

query (dict) –

Optional query parameters to be sent to limit the resources being returned. Available parameters include:

  • cidr: Subnet CIDR

  • description: The subnet description

  • gateway_ip: Subnet gateway IP address

  • ip_version: Subnet IP address version

  • ipv6_address_mode: The IPv6 address mode

  • ipv6_ra_mode: The IPv6 router advertisement mode

  • is_dhcp_enabled: Subnet has DHCP enabled (boolean)

  • name: Subnet name

  • network_id: ID of network that owns the subnets

  • project_id: Owner tenant ID

  • subnet_pool_id: The subnet pool ID from which to obtain a

    CIDR.

Returns

A generator of subnet objects

Return type

Subnet

update_subnet(subnet, if_revision=None, **attrs)

Update a subnet

Parameters

  • subnet – Either the id of a subnet or a Subnet instance.

  • if_revision (int) – Revision to put in If-Match header of update request to perform compare-and-swap update.

  • attrs (dict) – The attributes to update on the subnet represented by subnet.

Returns

The updated subnet

Return type

Subnet

create_subnet_pool(**attrs)

Create a new subnet pool from attributes

Parameters

attrs (dict) – Keyword arguments which will be used to create a SubnetPool, comprised of the properties on the SubnetPool class.

Returns

The results of subnet pool creation

Return type

SubnetPool

delete_subnet_pool(subnet_pool, ignore_missing=True)

Delete a subnet pool

Parameters

  • subnet_pool – The value can be either the ID of a subnet pool or a SubnetPool instance.

  • ignore_missing (bool) – When set to False ResourceNotFound will be raised when the subnet pool does not exist. When set to True, no exception will be set when attempting to delete a nonexistent subnet pool.

Returns

None

find_subnet_pool(name_or_id, ignore_missing=True, **args)

Find a single subnet pool

Parameters

  • name_or_id – The name or ID of a subnet pool.

  • 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.

  • args (dict) – Any additional parameters to be passed into underlying methods. such as query filters.

Returns

One SubnetPool or None

get_subnet_pool(subnet_pool)

Get a single subnet pool

Parameters

subnet_pool – The value can be the ID of a subnet pool or a SubnetPool instance.

Returns

One SubnetPool

Raises

ResourceNotFound when no resource can be found.

subnet_pools(**query)

Return a generator of subnet pools

Parameters

query (kwargs) –

Optional query parameters to be sent to limit the resources being returned. Available parameters include:

  • address_scope_id: Subnet pool address scope ID

  • description: The subnet pool description

  • ip_version: The IP address family

  • is_default: Subnet pool is the default (boolean)

  • is_shared: Subnet pool is shared (boolean)

  • name: Subnet pool name

  • project_id: Owner tenant ID

Returns

A generator of subnet pool objects

Return type

SubnetPool

update_subnet_pool(subnet_pool, **attrs)

Update a subnet pool

Parameters

  • subnet_pool – Either the ID of a subnet pool or a SubnetPool instance.

  • attrs (dict) – The attributes to update on the subnet pool represented by subnet_pool.

Returns

The updated subnet pool

Return type

SubnetPool

Load Balancer Operations

class openstack.network.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

delete_load_balancer(load_balancer, ignore_missing=True)

Delete a load balancer

Parameters

  • load_balancer – The value can be the ID of a load balancer 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.

Returns

None

find_load_balancer(name_or_id, ignore_missing=True, **args)

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 resource does not exist. When set to True, None will be returned when attempting to find a nonexistent resource.

  • args (dict) – Any additional parameters to be passed into underlying methods. such as query filters.

Returns

One LoadBalancer or None

get_load_balancer(load_balancer)

Get a single load balancer

Parameters

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

Returns

One LoadBalancer

Raises

ResourceNotFound when no resource can be found.

load_balancers(**query)

Return a generator of load balancers

Parameters

query (dict) – Optional query parameters to be sent to limit the resources being returned.

Returns

A generator of load balancer objects

Return type

LoadBalancer

update_load_balancer(load_balancer, **attrs)

Update a load balancer

Parameters

  • load_balancer – Either the id of a load balancer 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

Health Monitor Operations

class openstack.network.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_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 health monitor creation

Return type

HealthMonitor

delete_health_monitor(health_monitor, ignore_missing=True)

Delete a health monitor

Parameters

  • health_monitor – The value can be either the ID of a health monitor or a HealthMonitor instance.

  • 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 delete a nonexistent health monitor.

Returns

None

find_health_monitor(name_or_id, ignore_missing=True, **args)

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 resource does not exist. When set to True, None will be returned when attempting to find a nonexistent resource.

  • args (dict) – Any additional parameters to be passed into underlying methods. such as query filters.

Returns

One HealthMonitor or None

get_health_monitor(health_monitor)

Get a single health monitor

Parameters

health_monitor – The value can be the ID of a health monitor or a HealthMonitor instance.

Returns

One HealthMonitor

Raises

ResourceNotFound when no resource can be found.

health_monitors(**query)

Return a generator of health monitors

Parameters

query (dict) –

Optional query parameters to be sent to limit

the resources being returned. Valid parameters are:

  • delay: the time in milliseconds between sending probes.

  • expected_codes: The expected HTTP codes for a pssing HTTP(S)

    monitor.

  • http_method: The HTTP method a monitor uses for requests.

  • is_admin_state_up: The administrative state of a health

    monitor.

  • max_retries: The maximum consecutive health probe attempts.

  • project_id: The ID of the project this health monitor is

    associated with.

  • timeout: The maximum number of milliseconds for a monitor to

    wait for a connection to be established before it times out.

  • type: The type of probe sent by the load balancer for health

    check, which can be PING, TCP, HTTP or HTTPS.

  • url_path: The path portion of a URI that will be probed.

Returns

A generator of health monitor objects

Return type

HealthMonitor

update_health_monitor(health_monitor, **attrs)

Update a health monitor

Parameters

  • health_monitor – Either the id of a health monitor or a HealthMonitor instance.

  • attrs (dict) – The attributes to update on the health monitor represented by value.

Returns

The updated health monitor

Return type

HealthMonitor

Metering Label Operations

class openstack.network.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_metering_label(**attrs)

Create a new metering label from attributes

Parameters

attrs (dict) – Keyword arguments which will be used to create a MeteringLabel, comprised of the properties on the MeteringLabel class.

Returns

The results of metering label creation

Return type

MeteringLabel

delete_metering_label(metering_label, ignore_missing=True)

Delete a metering label

Parameters

  • metering_label – The value can be either the ID of a metering label or a MeteringLabel instance.

  • ignore_missing (bool) – When set to False ResourceNotFound will be raised when the metering label does not exist. When set to True, no exception will be set when attempting to delete a nonexistent metering label.

Returns

None

find_metering_label(name_or_id, ignore_missing=True, **args)

Find a single metering label

Parameters

  • name_or_id – The name or ID of a metering label.

  • 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.

  • args (dict) – Any additional parameters to be passed into underlying methods. such as query filters.

Returns

One MeteringLabel or None

get_metering_label(metering_label)

Get a single metering label

Parameters

metering_label – The value can be the ID of a metering label or a MeteringLabel instance.

Returns

One MeteringLabel

Raises

ResourceNotFound when no resource can be found.

metering_labels(**query)

Return a generator of metering labels

Parameters

query (dict) –

Optional query parameters to be sent to limit

the resources being returned. Valid parameters are:

  • description: Description of a metering label.

  • name: Name of a metering label.

  • is_shared: Boolean indicating whether a metering label is

    shared.

  • project_id: The ID of the project a metering label is

    associated with.

Returns

A generator of metering label objects

Return type

MeteringLabel

update_metering_label(metering_label, **attrs)

Update a metering label

Parameters

  • metering_label – Either the id of a metering label or a MeteringLabel instance.

  • attrs (dict) – The attributes to update on the metering label represented by metering_label.

Returns

The updated metering label

Return type

MeteringLabel

create_metering_label_rule(**attrs)

Create a new metering label rule from attributes

Parameters

attrs (dict) – Keyword arguments which will be used to create a             MeteringLabelRule, comprised of the properties on the MeteringLabelRule class.

Returns

The results of metering label rule creation

Return type

                MeteringLabelRule

delete_metering_label_rule(metering_label_rule, ignore_missing=True)

Delete a metering label rule

Parameters

  • metering_label_rule – The value can be either the ID of a metering label rule or a             MeteringLabelRule instance.

  • ignore_missing (bool) – When set to False ResourceNotFound will be raised when the metering label rule does not exist. When set to True, no exception will be set when attempting to delete a nonexistent metering label rule.

Returns

None

find_metering_label_rule(name_or_id, ignore_missing=True, **args)

Find a single metering label rule

Parameters

  • name_or_id – The name or ID of a metering label rule.

  • 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.

  • args (dict) – Any additional parameters to be passed into underlying methods. such as query filters.

Returns

One MeteringLabelRule or None

get_metering_label_rule(metering_label_rule)

Get a single metering label rule

Parameters

metering_label_rule – The value can be the ID of a metering label rule or a             MeteringLabelRule instance.

Returns

One             MeteringLabelRule

Raises

ResourceNotFound when no resource can be found.

metering_label_rules(**query)

Return a generator of metering label rules

Parameters

query (dict) –

Optional query parameters to be sent to limit

the resources being returned. Valid parameters are:

  • direction: The direction in which metering label rule is

    applied.

  • metering_label_id: The ID of a metering label this rule is

    associated with.

  • project_id: The ID of the project the metering label rule is

    associated with.

  • remote_ip_prefix: The remote IP prefix to be associated with

    this metering label rule.

Returns

A generator of metering label rule objects

Return type

MeteringLabelRule

update_metering_label_rule(metering_label_rule, **attrs)

Update a metering label rule

Parameters

  • metering_label_rule – Either the id of a metering label rule or a MeteringLabelRule instance.

  • attrs (dict) – The attributes to update on the metering label rule represented by metering_label_rule.

Returns

The updated metering label rule

Return type

MeteringLabelRule

Segment Operations

class openstack.network.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_segment(**attrs)

Create a new segment from attributes

Parameters

attrs (dict) – Keyword arguments which will be used to create a Segment, comprised of the properties on the Segment class.

Returns

The results of segment creation

Return type

Segment

delete_segment(segment, ignore_missing=True)

Delete a segment

Parameters

  • segment – The value can be either the ID of a segment or a Segment instance.

  • ignore_missing (bool) – When set to False ResourceNotFound will be raised when the segment does not exist. When set to True, no exception will be set when attempting to delete a nonexistent segment.

Returns

None

find_segment(name_or_id, ignore_missing=True, **args)

Find a single segment

Parameters

  • name_or_id – The name or ID of a segment.

  • 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.

  • args (dict) – Any additional parameters to be passed into underlying methods. such as query filters.

Returns

One Segment or None

get_segment(segment)

Get a single segment

Parameters

segment – The value can be the ID of a segment or a Segment instance.

Returns

One Segment

Raises

ResourceNotFound when no resource can be found.

segments(**query)

Return a generator of segments

Parameters

query (kwargs) –

Optional query parameters to be sent to limit the resources being returned. Available parameters include:

  • description: The segment description

  • name: Name of the segments

  • network_id: ID of the network that owns the segments

  • network_type: Network type for the segments

  • physical_network: Physical network name for the segments

  • segmentation_id: Segmentation ID for the segments

Returns

A generator of segment objects

Return type

Segment

update_segment(segment, **attrs)

Update a segment

Parameters

segment – Either the id of a segment or a Segment instance.

Attrs kwargs

The attributes to update on the segment represented by value.

Returns

The update segment

Return type

Segment

Flavor Operations

class openstack.network.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_flavor(**attrs)

Create a new network service flavor from attributes

Parameters

attrs (dict) – Keyword arguments which will be used to create a Flavor, comprised of the properties on the Flavor class.

Returns

The results of flavor creation

Return type

Flavor

delete_flavor(flavor, ignore_missing=True)

Delete a network service flavor

Parameters

  • flavor – The value can be either the ID of a flavor 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, **args)

Find a single network service 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 resource does not exist. When set to True, None will be returned when attempting to find a nonexistent resource.

  • args (dict) – Any additional parameters to be passed into underlying methods. such as query filters.

Returns

One Flavor or None

get_flavor(flavor)

Get a single network service flavor

Parameters

flavor – The value can be the ID of a flavor or a Flavor instance.

Returns

One Flavor

Raises

ResourceNotFound when no resource can be found.

update_flavor(flavor, **attrs)

Update a network service flavor

Parameters

flavor – Either the id of a flavor or a Flavor instance.

Attrs kwargs

The attributes to update on the flavor represented by value.

Returns

The updated flavor

Return type

Flavor

flavors(**query)

Return a generator of network service flavors

Parameters

query (dict) –

Optional query parameters to be sent to limit

the resources being returned. Valid parameters include:

  • description: The description of a flavor.

  • is_enabled: Whether a flavor is enabled.

  • name: The name of a flavor.

  • service_type: The service type to which a falvor applies.

Returns

A generator of flavor objects

Return type

Flavor

Service Profile Operations

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

Associate network flavor with service profile.

Parameters

  • flavor – Either the id of a flavor or a Flavor instance.

  • service_profile – The value can be either the ID of a service profile or a ServiceProfile instance.

Returns

disassociate_flavor_from_service_profile(flavor, service_profile)

Disassociate network flavor from service profile.

Parameters

  • flavor – Either the id of a flavor or a Flavor instance.

  • service_profile – The value can be either the ID of a service profile or a ServiceProfile instance.

Returns

create_service_profile(**attrs)

Create a new network service flavor profile from attributes

Parameters

attrs (dict) – Keyword arguments which will be used to create a ServiceProfile, comprised of the properties on the ServiceProfile class.

Returns

The results of service profile creation

Return type

ServiceProfile

delete_service_profile(service_profile, ignore_missing=True)

Delete a network service flavor profile

Parameters

  • service_profile – The value can be either the ID of a service profile or a ServiceProfile instance.

  • ignore_missing (bool) – When set to False ResourceNotFound will be raised when the service profile does not exist. When set to True, no exception will be set when attempting to delete a nonexistent service profile.

Returns

None

find_service_profile(name_or_id, ignore_missing=True, **args)

Find a single network service flavor profile

Parameters

  • name_or_id – The name or ID of a service profile.

  • 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.

  • args (dict) – Any additional parameters to be passed into underlying methods. such as query filters.

Returns

One ServiceProfile or None

get_service_profile(service_profile)

Get a single network service flavor profile

Parameters

service_profile – The value can be the ID of a service_profile or a ServiceProfile instance.

Returns

One ServiceProfile

Raises

ResourceNotFound when no resource can be found.

service_profiles(**query)

Return a generator of network service flavor profiles

Parameters

query (dict) –

Optional query parameters to be sent to limit the

resources returned. Available parameters inclue:

  • description: The description of the service flavor profile

  • driver: Provider driver for the service flavor profile

  • is_enabled: Whether the profile is enabled

  • project_id: The owner project ID

Returns

A generator of service profile objects

Return type

ServiceProfile

update_service_profile(service_profile, **attrs)

Update a network flavor service profile

Parameters

service_profile – Either the id of a service profile or a ServiceProfile instance.

Attrs kwargs

The attributes to update on the service profile represented by value.

Returns

The updated service profile

Return type

ServiceProfile

Tag Operations

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

Replace tags of a specified resource with specified tags

Parameters

  • resource – Resource instance.

  • tags ("list") – New tags to be set.

Returns

The updated resource

Return type

Resource

VPN Operations

class openstack.network.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_vpn_service(**attrs)

Create a new vpn service from attributes

Parameters

attrs (dict) – Keyword arguments which will be used to create a VPNService, comprised of the properties on the VPNService class.

Returns

The results of vpn service creation

Return type

VPNService

delete_vpn_service(vpn_service, ignore_missing=True)

Delete a vpn service

Parameters

  • vpn_service – The value can be either the ID of a vpn service or a VPNService instance.

  • ignore_missing (bool) – When set to False ResourceNotFound will be raised when the vpn service does not exist. When set to True, no exception will be set when attempting to delete a nonexistent vpn service.

Returns

None

find_vpn_service(name_or_id, ignore_missing=True, **args)

Find a single vpn service

Parameters

  • name_or_id – The name or ID of a vpn service.

  • 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.

  • args (dict) – Any additional parameters to be passed into underlying methods. such as query filters.

Returns

One VPNService or None

get_vpn_service(vpn_service)

Get a single vpn service

Parameters

vpn_service – The value can be the ID of a vpn service or a VPNService instance.

Returns

One VPNService

Raises

ResourceNotFound when no resource can be found.

vpn_services(**query)

Return a generator of vpn services

Parameters

query (dict) – Optional query parameters to be sent to limit the resources being returned.

Returns

A generator of vpn service objects

Return type

VPNService

update_vpn_service(vpn_service, **attrs)

Update a vpn service

Parameters

  • vpn_service – Either the id of a vpn service or a VPNService instance.

  • attrs (dict) – The attributes to update on the VPN service represented by vpn_service.

Returns

The updated vpnservice

Return type

VPNService

Extension Operations

class openstack.network.v2._proxy.Proxy(session, statsd_client=None, statsd_prefix=None, prometheus_counter=None, prometheus_histogram=None, influxdb_config=None, influxdb_client=None, *args, **kwargs)
find_extension(name_or_id, ignore_missing=True, **args)

Find a single extension

Parameters

  • name_or_id – The name or ID of a extension.

  • 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.

  • args (dict) – Any additional parameters to be passed into underlying methods. such as query filters.

Returns

One Extension or None

extensions(**query)

Return a generator of extensions

Parameters

query (dict) – Optional query parameters to be sent to limit the resources being returned. Currently no parameter is supported.

Returns

A generator of extension objects

Return type

Extension

Service Provider Operations

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

Return a generator of service providers

Parameters

query (kwargs) – Optional query parameters to be sent to limit the resources being returned.

Returns

A generator of service provider objects

Return type

ServiceProvider

updated: 2020-11-20 23:01
Creative Commons Attribution 3.0 License

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.

questions?