DCAAS API¶
The Direct Connect Class¶
The direct connect high-level interface is available through the dcaas
member of a Connection
object. The
dcaas
member will only be added if the
otcextensions.sdk.register_otc_extensions(conn)
method is called.
DCAAS Virtual Gateway¶
-
class
otcextensions.sdk.dcaas.v2._proxy.
Proxy
(session, statsd_client=None, statsd_prefix=None, prometheus_counter=None, prometheus_histogram=None, influxdb_config=None, influxdb_client=None, *args, **kwargs) -
virtual_gateways
(**query) Retrieve a generator of virtual gateways
- Returns
A generator of virtual gateways
VirtualGateway
instances
-
create_virtual_gateway
(**attrs) Create a new virtual gateway from attributes
- Parameters
attrs (dict) – Keyword arguments which will be used to create a
VirtualGateway
, comprised of the properties on the VirtualGateway class.- Returns
The results of virtual gateway creation
- Return type
VirtualGateway
-
get_virtual_gateway
(virtual_gateway) Get a virtual_gateway
- Parameters
virtual_gateway – The value can be the ID of a virtual_gateway or a
VirtualGateway
instance.- Returns
Virtual gateway instance
- Return type
VirtualGateway
-
delete_virtual_gateway
(virtual_gateway, ignore_missing=True) Delete a virtual_gateway
- Parameters
virtual_gateway – The value can be the ID of a virtual gateway or a
VirtualGateway
instance.ignore_missing (bool) – When set to
False
ResourceNotFound
will be raised when the virtual gateway does not exist. When set toTrue
, no exception will be set when attempting to delete a nonexistent zone.
- Returns
None
-
update_virtual_gateway
(virtual_gateway, **attrs) Update virtual gateway attributes
- Parameters
virtual_gateway – The id or an instance of
VirtualGateway
attrs (dict) – attributes for update on
VirtualGateway
- Return type
VirtualGateway
-
find_virtual_gateway
(name_or_id, ignore_missing=True, **attrs) Find a single virtual gateway
- Parameters
name_or_id – The name or ID of a virtual gateway
ignore_missing (bool) – When set to
False
ResourceNotFound
will be raised when the zone does not exist. When set toTrue
, no exception will be set when attempting to delete a nonexistent virtual gateway.
- Returns
None
-
DCAAS Connection¶
-
class
otcextensions.sdk.dcaas.v2._proxy.
Proxy
(session, statsd_client=None, statsd_prefix=None, prometheus_counter=None, prometheus_histogram=None, influxdb_config=None, influxdb_client=None, *args, **kwargs) -
connections
(**query) Retrieve a generator of connections
- Returns
A generator of connections
Connection
instances
-
create_connection
(**attrs) Create a new connection from attributes
- Parameters
attrs (dict) – Keyword arguments which will be used to create a
Connection
, comprised of the properties on the Connection class.- Returns
The results of connection creation
- Return type
-
get_connection
(connection) Get a connection
- Parameters
connection – The value can be the ID of a connection or a
Connection
instance.- Returns
Connection instance
- Return type
-
delete_connection
(connection, ignore_missing=True) Delete a connection
- Parameters
connection – The value can be the ID of a connection or a
Connection
instance.ignore_missing (bool) – When set to
False
ResourceNotFound
will be raised when the connection does not exist. When set toTrue
, no exception will be set when attempting to delete a nonexistent connection.
- Returns
None
-
update_connection
(connection, **attrs) Update connection attributes
- Parameters
connection – The id or an instance of
Connection
attrs (dict) – attributes for update on
Connection
- Return type
-
find_connection
(name_or_id, ignore_missing=True, **attrs) Find a single connection
- Parameters
name_or_id – The name or ID of a connection
ignore_missing (bool) – When set to
False
ResourceNotFound
will be raised when the connection does not exist. When set toTrue
, no exception will be set when attempting to delete a nonexistent connection.
- Returns
None
-
DCAAS Virtual Interface¶
-
class
otcextensions.sdk.dcaas.v2._proxy.
Proxy
(session, statsd_client=None, statsd_prefix=None, prometheus_counter=None, prometheus_histogram=None, influxdb_config=None, influxdb_client=None, *args, **kwargs) -
virtual_interfaces
(**query) Retrieve a generator of virtual interfaces
- Returns
A generator of virtual interfaces
VirtualInterface
instances
-
create_virtual_interface
(**attrs) Create a new virtual interface from attributes
- Parameters
attrs (dict) – Keyword arguments which will be used to create a
VirtualInterface
, comprised of the properties on the Connection class.- Returns
The results of virtual interface creation
- Return type
VirtualInterface
-
get_virtual_interface
(virtual_interface) Get a virtual_interface
- Parameters
virtual_interface – The value can be the ID of a virtual_interface or a
VirtualInterface
instance.- Returns
Virtual interface instance
- Return type
VirtualInterface
-
delete_virtual_interface
(virtual_interface, ignore_missing=True) Delete a virtual interface
- Parameters
virtual_interface – The value can be the ID of a virtual interface or a
VirtualInterface
instance.ignore_missing (bool) – When set to
False
ResourceNotFound
will be raised when the virtual interface does not exist. When set toTrue
, no exception will be set when attempting to delete a nonexistent virtual interface.
- Returns
None
-
update_virtual_interface
(virtual_interface, **attrs) Update virtual interface attributes
- Parameters
virtual_interface – The id or an instance of
VirtualInterface
attrs (dict) – attributes for update on
VirtualInterface
- Return type
VirtualInterface
-
find_virtual_interface
(name_or_id, ignore_missing=True, **attrs) Find a single virtual interface
- Parameters
name_or_id – The name or ID of a virtual interface
ignore_missing (bool) – When set to
False
ResourceNotFound
will be raised when the virtual interface does not exist. When set toTrue
, no exception will be set when attempting to delete a nonexistent virtual interface.
- Returns
None
-