libcloud.compute.drivers package¶
Submodules¶
libcloud.compute.drivers.abiquo module¶
Abiquo Compute Driver
The driver implements the compute Abiquo functionality for the Abiquo API. This version is compatible with the following versions of Abiquo:
- Abiquo 3.4 (http://wiki.abiquo.com/display/ABI34/The+Abiquo+API)
-
class
libcloud.compute.drivers.abiquo.
AbiquoNodeDriver
(user_id, secret, endpoint, **kwargs)[source]¶ Bases:
libcloud.compute.base.NodeDriver
Implements the
NodeDriver
‘s for the Abiquo Compute ProviderInitializes Abiquo Driver
Initializes the
NodeDriver
object and populate the cache.Parameters: - user_id (
str
) – identifier of Abiquo user (required) - secret (
str
) – password of the Abiquo user (required) - endpoint (
str
that can be parsed as URL) – Abiquo API endpoint (required)
-
AR_MIME_TYPE
= 'application/vnd.abiquo.acceptedrequest+xml'¶
-
DCRS_MIME_TYPE
= 'application/vnd.abiquo.datacenterrepositories+xml'¶
-
DCR_MIME_TYPE
= 'application/vnd.abiquo.datacenterrepository+xml'¶
-
DCS_MIME_TYPE
= 'application/vnd.abiquo.datacenters+xml'¶
-
ENT_MIME_TYPE
= 'application/vnd.abiquo.enterprise+xml'¶
-
GIGABYTE
= 1073741824¶
-
NICS_MIME_TYPE
= 'application/vnd.abiquo.nics+xml'¶
-
NODES_MIME_TYPE
= 'application/vnd.abiquo.virtualmachines+xml'¶
-
NODE_MIME_TYPE
= 'application/vnd.abiquo.virtualmachine+xml'¶
-
USER_MIME_TYPE
= 'application/vnd.abiquo.user+xml'¶
-
VAPPS_MIME_TYPE
= 'application/vnd.abiquo.virtualappliances+xml'¶
-
VAPP_MIME_TYPE
= 'application/vnd.abiquo.virtualappliance+xml'¶
-
VDCS_MIME_TYPE
= 'application/vnd.abiquo.virtualdatacenters+xml'¶
-
VDC_MIME_TYPE
= 'application/vnd.abiquo.virtualdatacenter+xml'¶
-
VMTPLS_MIME_TYPE
= 'application/vnd.abiquo.virtualmachinetemplates+xml'¶
-
VMTPL_MIME_TYPE
= 'application/vnd.abiquo.virtualmachinetemplate+xml'¶
-
VM_TASK_MIME_TYPE
= 'application/vnd.abiquo.virtualmachinetask+xml'¶
-
connectionCls
¶ alias of
AbiquoConnection
-
create_node
(**kwargs)[source]¶ Create a new node instance in Abiquo
All the
Node`s need to be defined inside a VirtualAppliance (called :class:`NodeGroup
here). If there is no group name defined, ‘libcloud’ name will be used instead.This method wraps these Abiquo actions:
- Create a group if it does not exist.
- Register a new node in the group.
- Deploy the node and boot it.
- Retrieves it again to get schedule-time attributes (such as ips and vnc ports).
The rest of the driver methods has been created in a way that, if any of these actions fail, the user can not reach an inconsistent state
Parameters: - name (
str
) – The name for this new node (required) - size (
NodeSize
) – The size of resources allocated to this node. - image (
NodeImage
) – OS Image to boot on node. (required) - location (
NodeLocation
) – Which data center to create a node in. If empty, undefined behavior will be selected. (optional) - group_name (c{str}) – Which group this node belongs to. If empty, it will be created into ‘libcloud’ group. If it does not found any group in the target location (random location if you have not set the parameter), then it will create a new group with this name.
Returns: The newly created node.
Return type: Node
-
destroy_node
(node)[source]¶ Destroy a node
Depending on the provider, this may destroy all data associated with the node, including backups.
Parameters: node ( Node
) – The node to be destroyedReturns: True if the destroy was successful, otherwise False Return type: bool
-
ex_create_group
(name, location=None)[source]¶ Create an empty group.
You can specify the location as well.
Parameters: - group (
str
) – name of the group (required) - location (
NodeLocation
) – location were to create the group
Returns: the created group
Return type: - group (
-
ex_destroy_group
(group)[source]¶ Destroy a group.
Be careful! Destroying a group means destroying all the
Node
instances there and the group itself!If there is currently any action over any
Node
of theNodeGroup
, then the method will raise an exception.Parameters: name ( NodeGroup
) – The group (required)Returns: If the group was destroyed successfully Return type: bool
-
ex_list_groups
(location=None)[source]¶ List all groups.
Parameters: location (a NodeLocation
instance.) – filter the groups by location (optional)Returns: the list of NodeGroup
-
ex_populate_cache
()[source]¶ Populate the cache.
For each connection, it is good to store some objects that will be useful for further requests, such as the ‘user’ and the ‘enterprise’ objects.
Executes the ‘login’ resource after setting the connection parameters and, if the execution is successful, it sets the ‘user’ object into cache. After that, it also requests for the ‘enterprise’ and ‘locations’ data.
List of locations should remain the same for a single libcloud connection. However, this method is public and you are able to refresh the list of locations any time.
-
ex_run_node
(node)[source]¶ Runs a node
Here there is a bit difference between Abiquo states and libcloud states, so this method is created to have better compatibility. In libcloud, if the node is not running, then it does not exist (avoiding UNKNOWN and temporal states). In Abiquo, you can define a node, and then deploy it.
If the node is in
NodeState.TERMINATED
libcloud’s state and in ‘NOT_DEPLOYED’ Abiquo state, there is a way to run and recover it for libcloud using this method. There is no way to reach this state if you are using only libcloud, but you may have used another Abiquo client and now you want to recover your node to be used by libcloud.Parameters: node ( Node
) – The node to runReturns: The node itself, but with the new state Return type: Node
-
list_images
(location=None)[source]¶ List images on Abiquo Repositories
Parameters: location ( NodeLocation
) – The location to list images for.Returns: list of node image objects Return type: list
ofNodeImage
-
list_locations
()[source]¶ Return list of locations where the user has access to.
Returns: the list of NodeLocation
available for the current userReturn type: list
ofNodeLocation
-
list_nodes
(location=None)[source]¶ List all nodes.
Parameters: location (a NodeLocation
instance.) – Filter the groups by location (optional)Returns: List of node objects Return type: list
ofNode
-
list_sizes
(location=None)[source]¶ List sizes on a provider.
Abiquo does not work with sizes. However, this method returns a list of predefined ones (copied from
DummyNodeDriver
but without price neither bandwidth) to help the users to create their own.If you call the method
AbiquoNodeDriver.create_node
with the size informed, it will just override the ‘ram’ value of the ‘image’ template. So it is no too much usefull work with sizes...Returns: The list of sizes Return type: list
ofNodeSizes
-
name
= 'Abiquo'¶
-
reboot_node
(node)[source]¶ Reboot a node.
Parameters: node ( Node
) – The node to be rebootedReturns: True if the reboot was successful, otherwise False Return type: bool
-
timeout
= 2000¶
-
type
= 'abiquo'¶
-
website
= 'http://www.abiquo.com/'¶
- user_id (
-
class
libcloud.compute.drivers.abiquo.
NodeGroup
(driver, name='libcloud', nodes=[], uri='')[source]¶ Bases:
object
Group of virtual machines that can be managed together
All
Node`s in Abiquo must be defined inside a Virtual Appliance. We offer a way to handle virtual appliances (called NodeGroup to maintain some kind of name conventions here) inside the :class:`AbiquoNodeDriver
without breaking compatibility of the rest of libcloud API.If the user does not want to handle groups, all the virtual machines will be created inside a group named ‘libcloud’
Initialize a new group object.
-
DEFAULT_GROUP_NAME
= 'libcloud'¶
-
destroy
()[source]¶ Destroys the group delegating the execution to
AbiquoNodeDriver
.
-
libcloud.compute.drivers.auroracompute module¶
-
class
libcloud.compute.drivers.auroracompute.
AuroraComputeRegion
[source]¶ Bases:
object
-
AMS
= 'Amsterdam'¶
-
BCN
= 'Barcelona'¶
-
LAX
= 'Los Angeles'¶
-
MIA
= 'Miami'¶
-
RTD
= 'Rotterdam'¶
-
TYO
= 'Tokyo'¶
-
-
class
libcloud.compute.drivers.auroracompute.
AuroraComputeNodeDriver
(key, secret, path=None, host=None, url=None, region=None)[source]¶ Bases:
libcloud.compute.drivers.cloudstack.CloudStackNodeDriver
-
name
= 'PCextreme AuroraCompute'¶
-
type
= 'aurora_compute'¶
-
website
= 'https://www.pcextreme.com/aurora/compute'¶
-
libcloud.compute.drivers.azure module¶
Driver for Microsoft Azure Virtual Machines service.
http://azure.microsoft.com/en-us/services/virtual-machines/
-
class
libcloud.compute.drivers.azure.
AzureHTTPResponse
(status, message, headers, body)[source]¶ Bases:
object
-
class
libcloud.compute.drivers.azure.
AzureNodeDriver
(subscription_id=None, key_file=None, **kwargs)[source]¶ Bases:
libcloud.compute.base.NodeDriver
subscription_id contains the Azure subscription id in the form of GUID key_file contains the Azure X509 certificate in .pem form
-
NODE_STATE_MAP
= {'StartingRole': 'pending', 'StoppedDeallocated': 'terminated', 'FailedStartingRole': 'terminated', 'UnresponsiveRole': 'terminated', 'ReadyRole': 'running', 'StoppedVM': 'stopped', 'BusyRole': 'pending', 'StoppingRole': 'pending', 'Provisioning': 'pending', 'FailedStartingVM': 'terminated', 'RoleStateUnknown': 'unknown', 'CreatingVM': 'pending', 'StoppingVM': 'pending', 'DeletingVM': 'pending', 'StartingVM': 'pending', 'CyclingRole': 'terminated', 'CreatingRole': 'pending', 'RestartingRole': 'rebooting'}¶
-
connectionCls
¶ alias of
AzureServiceManagementConnection
-
create_node
(name, size, image, ex_cloud_service_name, ex_storage_service_name=None, ex_new_deployment=False, ex_deployment_slot='Production', ex_deployment_name=None, ex_admin_user_id='azureuser', ex_custom_data=None, ex_virtual_network_name=None, ex_network_config=None, auth=None, **kwargs)[source]¶ Create Azure Virtual Machine
Reference: http://bit.ly/1fIsCb7 [www.windowsazure.com/en-us/documentation/]
We default to:
- 3389/TCP - RDP - 1st Microsoft instance.
- RANDOM/TCP - RDP - All succeeding Microsoft instances.
- 22/TCP - SSH - 1st Linux instance
- RANDOM/TCP - SSH - All succeeding Linux instances.
The above replicates the standard behavior of the Azure UI. You can retrieve the assigned ports to each instance by using the following private function:
_get_endpoint_ports(service_name) Returns public,private port key pair.
@inherits:
NodeDriver.create_node
Parameters: - image (NodeImage) – The image to use when creating this node
- size (NodeSize) – The size of the instance to create
- ex_cloud_service_name (
str
) – Required. Name of the Azure Cloud Service. - ex_storage_service_name (
str
) – Optional: Name of the Azure Storage Service. - ex_new_deployment (
boolean
) – Optional. Tells azure to create a new deployment rather than add to an existing one. - ex_deployment_slot (
str
) – Optional: Valid values: production| staging. Defaults to production. - ex_deployment_name (
str
) – Optional. The name of the deployment. If this is not passed in we default to using the Cloud Service name. - ex_custom_data (
str
) – Optional script or other data which is injected into the VM when it’s beginning provisioned. - ex_admin_user_id (
str
) – Optional. Defaults to ‘azureuser’. - ex_virtual_network_name (
str
) – Optional. If this is not passed in no virtual network is used. - ex_network_config (ConfigurationSet) – Optional. The ConfigurationSet to use for network configuration
-
destroy_node
(node, ex_cloud_service_name=None, ex_deployment_slot='Production')[source]¶ Remove Azure Virtual Machine
This removes the instance, but does not remove the disk. You will need to use destroy_volume. Azure sometimes has an issue where it will hold onto a blob lease for an extended amount of time.
Parameters: - ex_cloud_service_name (
str
) – Required. Name of the Azure Cloud Service. - ex_deployment_slot (
str
) – Optional: The name of the deployment slot. If this is not passed in we default to production.
- ex_cloud_service_name (
-
ex_create_cloud_service
(name, location, description=None, extended_properties=None)[source]¶ Create an azure cloud service.
Parameters: - name (
str
) – Name of the service to create - location (
str
) – Standard azure location string - description (
str
) – Optional description - extended_properties (
dict
) – Optional extended_properties
Return type: bool
- name (
-
ex_create_storage_service
(name, location, description=None, affinity_group=None, extended_properties=None)[source]¶ Create an azure storage service.
Parameters: - name (
str
) – Name of the service to create - location (
str
) – Standard azure location string - description (
str
) – (Optional) Description of storage service. - affinity_group (
str
) – (Optional) Azure affinity group. - extended_properties (
dict
) – (Optional) Additional configuration options support by Azure.
Return type: bool
- name (
-
ex_destroy_cloud_service
(name)[source]¶ Delete an azure cloud service.
Parameters: name ( str
) – Name of the cloud service to destroy.Return type: bool
-
ex_destroy_storage_service
(name)[source]¶ Destroy storage service. Storage service must not have any active blobs. Sometimes Azure likes to hold onto volumes after they are deleted for an inordinate amount of time, so sleep before calling this method after volume deletion.
Parameters: name ( str
) – Name of storage service.Return type: bool
-
ex_set_instance_endpoints
(node, endpoints, ex_deployment_slot='Production')[source]¶ For example:
endpoint = ConfigurationSetInputEndpoint( name='SSH', protocol='tcp', port=port, local_port='22', load_balanced_endpoint_set_name=None, enable_direct_server_return=False ) { 'name': 'SSH', 'protocol': 'tcp', 'port': port, 'local_port': '22' }
-
features
= {'create_node': ['password']}¶
-
list_nodes
(ex_cloud_service_name)[source]¶ List all nodes
ex_cloud_service_name parameter is used to scope the request to a specific Cloud Service. This is a required parameter as nodes cannot exist outside of a Cloud Service nor be shared between a Cloud Service within Azure.
Parameters: ex_cloud_service_name ( str
) – Cloud Service nameReturn type: list
ofNode
-
list_volumes
(node=None)[source]¶ Lists volumes of the disks in the image repository that are associated with the specified subscription.
Pass Node object to scope the list of volumes to a single instance.
Return type: list
ofStorageVolume
-
name
= 'Azure Virtual machines'¶
-
reboot_node
(node, ex_cloud_service_name=None, ex_deployment_slot=None)[source]¶ Reboots a node.
ex_cloud_service_name parameter is used to scope the request to a specific Cloud Service. This is a required parameter as nodes cannot exist outside of a Cloud Service nor be shared between a Cloud Service within Azure.
Parameters: - ex_cloud_service_name (
str
) – Cloud Service name - ex_deployment_slot (
str
) – Options are “production” (default) or “Staging”. (Optional)
Return type: bool
- ex_cloud_service_name (
-
class
service_location
(is_affinity_group, service_location)¶ Bases:
tuple
-
is_affinity_group
¶ Alias for field number 0
-
service_location
¶ Alias for field number 1
-
-
AzureNodeDriver.
type
= 'azure'¶
-
AzureNodeDriver.
website
= 'http://azure.microsoft.com/en-us/services/virtual-machines/'¶
-
-
class
libcloud.compute.drivers.azure.
AzureNodeLocation
(id, name, country, driver, available_services, virtual_machine_role_sizes)[source]¶
-
class
libcloud.compute.drivers.azure.
AzureXmlSerializer
[source]¶ Bases:
object
-
static
add_role_to_xml
(role_name, system_configuration_set, os_virtual_hard_disk, role_type, network_configuration_set, availability_set_name, data_virtual_hard_disks, vm_image_name, role_size)[source]¶
-
static
capture_role_to_xml
(post_capture_action, target_image_name, target_image_label, provisioning_configuration)[source]¶
-
static
change_deployment_to_xml
(configuration, treat_warnings_as_error, mode, extended_properties)[source]¶
-
static
create_deployment_to_xml
(name, package_url, label, configuration, start_deployment, treat_warnings_as_error, extended_properties)[source]¶
-
static
create_hosted_service_to_xml
(service_name, label, description, location, affinity_group=None, extended_properties=None)[source]¶
-
static
create_storage_service_input_to_xml
(service_name, description, label, affinity_group, location, geo_replication_enabled, extended_properties)[source]¶
-
static
create_storage_service_to_xml
(service_name, label, description, location, affinity_group, extended_properties=None)[source]¶
-
static
data_to_xml
(data, xml=None)[source]¶ - Creates an xml fragment from the specified data.
- data: Array of tuples, where first: xml element name
- second: xml element text third: conversion function
-
static
data_virtual_hard_disk_to_xml
(host_caching, disk_label, disk_name, lun, logical_disk_size_in_gb, media_link, source_media_link)[source]¶
-
static
doc_from_xml
(document_element_name, inner_xml=None)[source]¶ Wraps the specified xml in an xml root element with default azure namespaces
-
static
role_to_xml
(availability_set_name, data_virtual_hard_disks, network_configuration_set, os_virtual_hard_disk, vm_image_name, role_name, role_size, role_type, system_configuration_set, xml)[source]¶
-
static
update_role_to_xml
(role_name, os_virtual_hard_disk, role_type, network_configuration_set, availability_set_name, data_virtual_hard_disks, vm_image_name, role_size)[source]¶
-
static
update_storage_service_input_to_xml
(description, label, geo_replication_enabled, extended_properties)[source]¶
-
static
upgrade_deployment_to_xml
(mode, package_url, configuration, label, role_to_upgrade, force, extended_properties)[source]¶
-
static
-
class
libcloud.compute.drivers.azure.
CertificateSetting
(thumbprint='', store_name='', store_location='')[source]¶ Bases:
libcloud.compute.drivers.azure.WindowsAzureData
Initializes a certificate setting.
- thumbprint:
- Specifies the thumbprint of the certificate to be provisioned. The thumbprint must specify an existing service certificate.
- store_name:
- Specifies the name of the certificate store from which retrieve certificate.
- store_location:
- Specifies the target certificate store location on the virtual machine The only supported value is LocalMachine.
-
class
libcloud.compute.drivers.azure.
ConfigurationSetInputEndpoint
(name='', protocol='', port='', local_port='', load_balanced_endpoint_set_name='', enable_direct_server_return=False)[source]¶
-
class
libcloud.compute.drivers.azure.
ConfigurationSetInputEndpoints
[source]¶ Bases:
libcloud.compute.drivers.azure.WindowsAzureDataTypedList
-
list_type
¶ alias of
ConfigurationSetInputEndpoint
-
xml_element_name
= 'InputEndpoint'¶
-
-
class
libcloud.compute.drivers.azure.
ConfigurationSets
[source]¶ Bases:
libcloud.compute.drivers.azure.WindowsAzureDataTypedList
-
list_type
¶ alias of
ConfigurationSet
-
-
class
libcloud.compute.drivers.azure.
Deployments
[source]¶ Bases:
libcloud.compute.drivers.azure.WindowsAzureDataTypedList
-
list_type
¶ alias of
Deployment
-
-
class
libcloud.compute.drivers.azure.
Disks
[source]¶ Bases:
libcloud.compute.drivers.azure.WindowsAzureDataTypedList
-
class
libcloud.compute.drivers.azure.
HostedService
[source]¶ Bases:
libcloud.compute.drivers.azure.WindowsAzureData
,libcloud.utils.misc.ReprMixin
-
class
libcloud.compute.drivers.azure.
HostedServices
[source]¶ Bases:
libcloud.compute.drivers.azure.WindowsAzureDataTypedList
,libcloud.utils.misc.ReprMixin
-
list_type
¶ alias of
HostedService
-
-
class
libcloud.compute.drivers.azure.
Images
[source]¶ Bases:
libcloud.compute.drivers.azure.WindowsAzureDataTypedList
-
class
libcloud.compute.drivers.azure.
InputEndpoints
[source]¶ Bases:
libcloud.compute.drivers.azure.WindowsAzureDataTypedList
-
list_type
¶ alias of
InputEndpoint
-
-
class
libcloud.compute.drivers.azure.
InstanceEndpoints
[source]¶ Bases:
libcloud.compute.drivers.azure.WindowsAzureDataTypedList
-
list_type
¶ alias of
InstanceEndpoint
-
-
class
libcloud.compute.drivers.azure.
KeyPairs
[source]¶ Bases:
libcloud.compute.drivers.azure.WindowsAzureDataTypedList
-
list_type
¶ alias of
AzureKeyPair
-
-
class
libcloud.compute.drivers.azure.
LinuxConfigurationSet
(host_name=None, user_name=None, user_password=None, disable_ssh_password_authentication=None, custom_data=None)[source]¶
-
class
libcloud.compute.drivers.azure.
Locations
[source]¶ Bases:
libcloud.compute.drivers.azure.WindowsAzureDataTypedList
-
class
libcloud.compute.drivers.azure.
OSVirtualHardDisk
(source_image_name=None, media_link=None, host_caching=None, disk_label=None, disk_name=None)[source]¶
-
class
libcloud.compute.drivers.azure.
OperatingSystemFamilies
[source]¶ Bases:
libcloud.compute.drivers.azure.WindowsAzureDataTypedList
-
list_type
¶ alias of
OperatingSystemFamily
-
-
class
libcloud.compute.drivers.azure.
OperatingSystems
[source]¶ Bases:
libcloud.compute.drivers.azure.WindowsAzureDataTypedList
-
list_type
¶ alias of
OperatingSystem
-
-
class
libcloud.compute.drivers.azure.
PublicKeys
[source]¶ Bases:
libcloud.compute.drivers.azure.WindowsAzureDataTypedList
-
class
libcloud.compute.drivers.azure.
RoleInstanceList
[source]¶ Bases:
libcloud.compute.drivers.azure.WindowsAzureDataTypedList
-
list_type
¶ alias of
RoleInstance
-
-
class
libcloud.compute.drivers.azure.
RoleList
[source]¶ Bases:
libcloud.compute.drivers.azure.WindowsAzureDataTypedList
-
class
libcloud.compute.drivers.azure.
ScalarListOf
(list_type, xml_element_name)[source]¶ Bases:
list
A list of scalar types which carries with it the type that’s expected to go in it along with its xml element name. Used for deserializaion and construction of the lists
-
class
libcloud.compute.drivers.azure.
StoredCertificateSettings
[source]¶ Bases:
libcloud.compute.drivers.azure.WindowsAzureDataTypedList
-
list_type
¶ alias of
CertificateSetting
-
-
class
libcloud.compute.drivers.azure.
SubscriptionCertificates
[source]¶ Bases:
libcloud.compute.drivers.azure.WindowsAzureDataTypedList
-
list_type
¶ alias of
SubscriptionCertificate
-
-
class
libcloud.compute.drivers.azure.
VMImages
[source]¶ Bases:
libcloud.compute.drivers.azure.WindowsAzureDataTypedList
-
class
libcloud.compute.drivers.azure.
VirtualIPs
[source]¶ Bases:
libcloud.compute.drivers.azure.WindowsAzureDataTypedList
-
libcloud.compute.drivers.azure.
WINDOWS_SERVER_REGEX
= <_sre.SRE_Pattern object at 0x35f5cc0>¶ Sizes must be hardcoded because Microsoft doesn’t provide an API to fetch them From http://msdn.microsoft.com/en-us/library/windowsazure/dn197896.aspx
Prices are for Linux instances in East US data center. To see what pricing will actually be, visit: http://azure.microsoft.com/en-gb/pricing/details/virtual-machines/
-
class
libcloud.compute.drivers.azure.
WindowsAzureData
[source]¶ Bases:
object
This is the base of data class. It is only used to check whether it is instance or not.
-
class
libcloud.compute.drivers.azure.
WindowsAzureDataTypedList
[source]¶ Bases:
libcloud.compute.drivers.azure.WindowsAzureData
-
list_type
= None¶
-
xml_element_name
= None¶
-
libcloud.compute.drivers.bluebox module¶
libcloud driver for the Blue Box Blocks API
This driver implements all libcloud functionality for the Blue Box Blocks API.
Blue Box home page http://bluebox.net Blue Box API documentation https://boxpanel.bluebox .net/public/the_vault/index.php/Blocks_API
-
class
libcloud.compute.drivers.bluebox.
BlueboxConnection
(user_id, key, secure=True, host=None, port=None, url=None, timeout=None, proxy_url=None, backoff=None, retry_delay=None)[source]¶ Bases:
libcloud.common.base.ConnectionUserAndKey
Connection class for the Bluebox driver
-
allow_insecure
= False¶
-
host
= 'boxpanel.bluebox.net'¶
-
responseCls
¶ alias of
BlueboxResponse
-
secure
= True¶
-
-
class
libcloud.compute.drivers.bluebox.
BlueboxNodeDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region=None, **kwargs)[source]¶ Bases:
libcloud.compute.base.NodeDriver
Bluebox Blocks node driver
Parameters: - key (
str
) – API key or username to be used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections. - api_version (
str
) – Optional API version. Only used by drivers which support multiple API versions. - region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
Return type: None
-
api_name
= 'bluebox'¶
-
connectionCls
¶ alias of
BlueboxConnection
-
features
= {'create_node': ['ssh_key', 'password']}¶
-
name
= 'Bluebox Blocks'¶
-
type
= 'bluebox'¶
-
website
= 'http://bluebox.net'¶
- key (
-
class
libcloud.compute.drivers.bluebox.
BlueboxNodeSize
(id, name, cpu, ram, disk, price, driver)[source]¶
-
class
libcloud.compute.drivers.bluebox.
BlueboxResponse
(response, connection)[source]¶ Bases:
libcloud.common.base.JsonResponse
Parameters: - response (
httplib.HTTPResponse
) – HTTP response object. (optional) - connection (
Connection
) – Parent connection object.
- response (
libcloud.compute.drivers.brightbox module¶
Brightbox Driver
-
class
libcloud.compute.drivers.brightbox.
BrightboxNodeDriver
(key, secret=None, secure=True, host=None, port=None, api_version='1.0', **kwargs)[source]¶ Bases:
libcloud.compute.base.NodeDriver
Brightbox node driver
-
NODE_STATE_MAP
= {'creating': 'pending', 'deleted': 'terminated', 'failed': 'unknown', 'inactive': 'unknown', 'active': 'running', 'deleting': 'unknown', 'unavailable': 'unknown'}¶
-
connectionCls
¶ alias of
BrightboxConnection
-
create_node
(**kwargs)[source]¶ Create a new Brightbox node
Reference: https://api.gb1.brightbox.com/1.0/#server_create_server
@inherits:
NodeDriver.create_node
Parameters: - ex_userdata (
str
) – User data - ex_servergroup (
str
orlist
ofstr
) – Name or list of server group ids to add server to
- ex_userdata (
-
ex_create_cloud_ip
(reverse_dns=None)[source]¶ Requests a new cloud IP address for the account
@note: This is an API extension for use on Brightbox
Parameters: reverse_dns ( str
) – Reverse DNS hostnameReturn type: dict
-
ex_destroy_cloud_ip
(cloud_ip_id)[source]¶ Release the cloud IP address from the account’s ownership
@note: This is an API extension for use on Brightbox
Parameters: cloud_ip_id ( str
) – The id of the cloud ip.Returns: True if the unmap was successful. Return type: bool
-
ex_list_cloud_ips
()[source]¶ List Cloud IPs
@note: This is an API extension for use on Brightbox
Return type: list
ofdict
-
ex_map_cloud_ip
(cloud_ip_id, interface_id)[source]¶ Maps (or points) a cloud IP address at a server’s interface or a load balancer to allow them to respond to public requests
@note: This is an API extension for use on Brightbox
Parameters: - cloud_ip_id (
str
) – The id of the cloud ip. - interface_id (
str
) – The Interface ID or LoadBalancer ID to which this Cloud IP should be mapped to
Returns: True if the mapping was successful.
Return type: bool
- cloud_ip_id (
-
ex_unmap_cloud_ip
(cloud_ip_id)[source]¶ Unmaps a cloud IP address from its current destination making it available to remap. This remains in the account’s pool of addresses
@note: This is an API extension for use on Brightbox
Parameters: cloud_ip_id ( str
) – The id of the cloud ip.Returns: True if the unmap was successful. Return type: bool
-
ex_update_cloud_ip
(cloud_ip_id, reverse_dns)[source]¶ Update some details of the cloud IP address
@note: This is an API extension for use on Brightbox
Parameters: - cloud_ip_id (
str
) – The id of the cloud ip. - reverse_dns (
str
) – Reverse DNS hostname
Return type: dict
- cloud_ip_id (
-
name
= 'Brightbox'¶
-
type
= 'brightbox'¶
-
website
= 'http://www.brightbox.co.uk/'¶
-
libcloud.compute.drivers.bsnl module¶
-
class
libcloud.compute.drivers.bsnl.
BSNLNodeDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region='bsnl-in', **kwargs)[source]¶ Bases:
libcloud.compute.drivers.dimensiondata.DimensionDataNodeDriver
BSNL node driver, based on Dimension Data driver
-
api_version
= 1.0¶
-
connectionCls
¶ alias of
DimensionDataConnection
-
features
= {'create_node': ['password']}¶
-
name
= 'BSNL'¶
-
selected_region
= None¶
-
type
= 'bsnl'¶
-
website
= 'http://www.bsnlcloud.com/'¶
-
libcloud.compute.drivers.ciscoccs module¶
Cisco CCS Driver
-
class
libcloud.compute.drivers.ciscoccs.
CiscoCCSNodeDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region='cisco-na', **kwargs)[source]¶ Bases:
libcloud.compute.drivers.dimensiondata.DimensionDataNodeDriver
Cisco CCS node driver, based on Dimension Data driver
-
api_version
= 1.0¶
-
connectionCls
¶ alias of
DimensionDataConnection
-
features
= {'create_node': ['password']}¶
-
name
= 'CiscoCCS'¶
-
selected_region
= None¶
-
type
= 'ciscoccs'¶
-
website
= 'http://www.cisco.com/'¶
-
libcloud.compute.drivers.cloudsigma module¶
Drivers for CloudSigma API v1.0 and v2.0.
-
class
libcloud.compute.drivers.cloudsigma.
CloudSigmaNodeDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region=None, **kwargs)[source]¶ Bases:
libcloud.compute.base.NodeDriver
Parameters: - key (
str
) – API key or username to be used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections. - api_version (
str
) – Optional API version. Only used by drivers which support multiple API versions. - region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
Return type: None
-
name
= 'CloudSigma'¶
-
website
= 'http://www.cloudsigma.com/'¶
- key (
-
class
libcloud.compute.drivers.cloudsigma.
CloudSigma_1_0_NodeDriver
(key, secret=None, secure=True, host=None, port=None, region='zrh', **kwargs)[source]¶ Bases:
libcloud.compute.drivers.cloudsigma.CloudSigmaNodeDriver
-
IMAGING_TIMEOUT
= 1200¶
-
NODE_STATE_MAP
= {'active': 'running', 'dumped': 'terminated', 'stopped': 'terminated', 'dead': 'terminated'}¶
-
connectionCls
¶ alias of
CloudSigma_1_0_Connection
-
create_node
(**kwargs)[source]¶ Creates a CloudSigma instance
@inherits:
NodeDriver.create_node
Parameters: - name (
str
) – String with a name for this new node (required) - smp (
int
) – Number of virtual processors or None to calculate based on the cpu speed. - nic_model (
str
) – e1000, rtl8139 or virtio (is not specified, e1000 is used) - vnc_password (
bool
) – If not set, VNC access is disabled. - drive_type (
str
) – Drive type (ssd|hdd). Defaults to hdd.
- name (
-
destroy_node
(node)[source]¶ Destroy a node (all the drives associated with it are NOT destroyed).
If a node is still running, it’s stopped before it’s destroyed.
@inherits:
NodeDriver.destroy_node
-
ex_destroy_drive
(drive_uuid)[source]¶ Destroy a drive.
Parameters: drive_uuid ( str
) – Drive uuid which should be usedReturn type: bool
-
ex_destroy_node_and_drives
(node)[source]¶ Destroy a node and all the drives associated with it.
Parameters: node ( libcloud.compute.base.Node
) – Node which should be usedReturn type: bool
-
ex_drive_destroy
(drive_uuid)[source]¶ Destroy a drive with a specified uuid. If the drive is currently mounted an exception is thrown.
Parameters: drive_uuid ( str
) – Drive uuid which should be usedReturn type: bool
-
ex_set_node_configuration
(node, **kwargs)[source]¶ Update a node configuration. Changing most of the parameters requires node to be stopped.
Parameters: - node (
libcloud.compute.base.Node
) – Node which should be used - kwargs (
dict
) – keyword arguments
Return type: bool
- node (
-
ex_shutdown_node
(node)[source]¶ Stop (shutdown) a node.
@inherits:
CloudSigmaBaseNodeDriver.ex_stop_node
-
ex_start_node
(node)[source]¶ Start a node.
Parameters: node ( libcloud.compute.base.Node
) – Node which should be usedReturn type: bool
-
ex_static_ip_destroy
(ip_address)[source]¶ Destroy a static IP address.
Parameters: ip_address ( str
) – IP address which should be usedReturn type: bool
-
ex_static_ip_list
()[source]¶ Return a list of available static IP addresses.
Return type: list
ofstr
-
ex_stop_node
(node)[source]¶ Stop (shutdown) a node.
Parameters: node ( libcloud.compute.base.Node
) – Node which should be usedReturn type: bool
-
list_images
(location=None)[source]¶ Return a list of available standard images (this call might take up to 15 seconds to return).
@inherits:
NodeDriver.list_images
-
name
= 'CloudSigma (API v1.0)'¶
-
reboot_node
(node)[source]¶ Reboot a node.
Because Cloudsigma API does not provide native reboot call, it’s emulated using stop and start.
@inherits:
NodeDriver.reboot_node
-
type
= 'cloudsigma'¶
-
website
= 'http://www.cloudsigma.com/'¶
-
-
class
libcloud.compute.drivers.cloudsigma.
CloudSigma_2_0_NodeDriver
(key, secret, secure=True, host=None, port=None, region='zrh', **kwargs)[source]¶ Bases:
libcloud.compute.drivers.cloudsigma.CloudSigmaNodeDriver
Driver for CloudSigma API v2.0.
-
DRIVE_TRANSITION_SLEEP_INTERVAL
= 5¶
-
DRIVE_TRANSITION_TIMEOUT
= 500¶
-
NODE_STATE_MAP
= {'unavailable': 'error', 'paused': 'paused', 'running': 'running', 'stopped': 'stopped', 'stopping': 'pending', 'starting': 'pending'}¶
-
api_name
= 'cloudsigma_zrh'¶
-
connectionCls
¶ alias of
CloudSigma_2_0_Connection
-
create_node
(name, size, image, ex_metadata=None, ex_vnc_password=None, ex_avoid=None, ex_vlan=None)[source]¶ Create a new server.
Server creation consists multiple steps depending on the type of the image used.
Installation CD:
- Create a server and attach installation cd
- Start a server
Pre-installed image:
- Clone provided library drive so we can use it
- Resize cloned drive to the desired size
- Create a server and attach cloned drive
- Start a server
Parameters: - ex_metadata (
dict
) – Key / value pairs to associate with the created node. (optional) - ex_vnc_password (
str
) – Password to use for VNC access. If not provided, random password is generated. - ex_avoid (
list
) – A list of server UUIDs to avoid when starting this node. (optional) - ex_vlan (
str
) – Optional UUID of a VLAN network to use. If specified, server will have two nics assigned - 1 with a public ip and 1 with the provided VLAN.
-
destroy_node
(node)[source]¶ Destroy the node and all the associated drives.
Returns: True
on success,False
otherwise.Return type: bool
-
ex_attach_firewall_policy
(policy, node, nic_mac=None)[source]¶ Attach firewall policy to a public NIC interface on the server.
Parameters: - policy (
CloudSigmaFirewallPolicy
) – Firewall policy to attach. - node (
libcloud.compute.base.Node
) – Node to attach policy to. - nic_mac (
str
) – Optional MAC address of the NIC to add the policy to. If not specified, first public interface is used instead.
Returns: Node object to which the policy was attached to.
Return type: - policy (
-
ex_clone_drive
(drive, name=None, ex_avoid=None)[source]¶ Clone a library or a standard drive.
Parameters: - drive (
libcloud.compute.base.NodeImage
orCloudSigmaDrive
) – Drive to clone. - name (
str
) – Optional name for the cloned drive. - ex_avoid (
list
) – A list of other drive uuids to avoid when creating this drive. If provided, drive will attempt to be created on a different physical infrastructure from other drives specified using this argument. (optional)
Returns: New cloned drive.
Return type: - drive (
-
ex_clone_node
(node, name=None, random_vnc_password=None)[source]¶ Clone the provided node.
Parameters: - name (
str
) – Optional name for the cloned node. - random_vnc_password (
bool
) – If True, a new random VNC password will be generated for the cloned node. Otherwise password from the cloned node will be reused.
Returns: Cloned node.
Return type: - name (
-
ex_close_vnc_tunnel
(node)[source]¶ Close a VNC server to the provided node.
Parameters: node ( libcloud.compute.base.Node
) – Node to close the VNC tunnel to.Returns: True
on success,False
otherwise.Return type: bool
-
ex_create_drive
(name, size, media='disk', ex_avoid=None)[source]¶ Create a new drive.
Parameters: - name (
str
) – Drive name. - size (
int
) – Drive size in bytes. - media (
str
) – Drive media type (cdrom, disk). - ex_avoid (
list
) – A list of other drive uuids to avoid when creating this drive. If provided, drive will attempt to be created on a different physical infrastructure from other drives specified using this argument. (optional)
Returns: Created drive object.
Return type: - name (
-
ex_create_firewall_policy
(name, rules=None)[source]¶ Create a firewall policy.
Parameters: - name (
str
) – Policy name. - rules (
list
ofdict
) – List of firewall policy rules to associate with this policy. (optional)
Returns: Created firewall policy object.
Return type: - name (
-
ex_create_subscription
(amount, period, resource, auto_renew=False)[source]¶ Create a new subscription.
Parameters: - amount (
int
) – Subscription amount. For example, in dssd case this would be disk size in gigabytes. - period (
str
) – Subscription period. For example: 30 days, 1 week, 1 month, ... - resource (
str
) – Resource the purchase the subscription for. - auto_renew (
bool
) – True to automatically renew the subscription.
- amount (
-
ex_create_tag
(name, resource_uuids=None)[source]¶ Create a tag.
Parameters: - name (
str
) – Tag name. - resource_uuids (
list
ofstr
) – Optional list of resource UUIDs to assign this tag go.
Returns: Created tag object.
Return type: - name (
-
ex_delete_firewall_policy
(policy)[source]¶ Delete a firewall policy.
Parameters: policy ( CloudSigmaFirewallPolicy
) – Policy to delete to.Returns: True
on success,False
otherwise.Return type: bool
-
ex_delete_tag
(tag)[source]¶ Delete a tag.
Parameters: tag ( CloudSigmaTag
) – Tag to delete.Returns: True
on success,False
otherwise.Return type: bool
-
ex_edit_node
(node, params)[source]¶ Edit a node.
Parameters: - node (
libcloud.compute.base.Node
) – Node to edit. - params (
dict
) – Node parameters to update.
:return Edited node. :rtype:
libcloud.compute.base.Node
- node (
-
ex_get_balance
()[source]¶ Retrieve account balance information.
Returns: Dictionary with two items (“balance” and “currency”). Return type: dict
-
ex_get_drive
(drive_id)[source]¶ Retrieve information about a single drive.
Parameters: drive_id ( str
) – ID of the drive to retrieve.Returns: Drive object. Return type: CloudSigmaDrive
-
ex_get_pricing
()[source]¶ Retrieve pricing information that are applicable to the cloud.
Returns: Dictionary with pricing information. Return type: dict
-
ex_get_tag
(tag_id)[source]¶ Retrieve a single tag.
Parameters: tag_id ( str
) – ID of the tag to retrieve.Return type: list
ofCloudSigmaTag
objects
-
ex_get_usage
()[source]¶ Retrieve account current usage information.
Returns: Dictionary with two items (“balance” and “usage”). Return type: dict
-
ex_list_capabilities
()[source]¶ Retrieve all the basic and sensible limits of the API.
Return type: dict
-
ex_list_drives_availability_groups
()[source]¶ Return which drives share the same physical storage host.
Returns: A list of drive UUIDs which share the same physical storage host. Drives which share the same host will be stored under the same list index. Return type: list
oflist
-
ex_list_firewall_policies
()[source]¶ List firewall policies.
Return type: list
ofCloudSigmaFirewallPolicy
-
ex_list_library_drives
()[source]¶ Return a list of all the available library drives (pre-installed and installation CDs).
Return type: list
ofCloudSigmaDrive
objects
-
ex_list_servers_availability_groups
()[source]¶ Return which running servers share the same physical compute host.
Returns: A list of server UUIDs which share the same physical compute host. Servers which share the same host will be stored under the same list index. Return type: list
oflist
-
ex_list_subscriptions
(status='all', resources=None)[source]¶ List subscriptions for this account.
Parameters: - status (
str
) – Only return subscriptions with the provided status (optional). - resources (
list
) – Only return subscriptions for the provided resources (optional).
Return type: list
- status (
List all the available tags.
Return type: list
ofCloudSigmaTag
objects
-
ex_list_user_drives
()[source]¶ Return a list of all the available user’s drives.
Return type: list
ofCloudSigmaDrive
objects
-
ex_open_vnc_tunnel
(node)[source]¶ Open a VNC tunnel to the provided node and return the VNC url.
Parameters: node ( libcloud.compute.base.Node
) – Node to open the VNC tunnel to.Returns: URL of the opened VNC tunnel. Return type: str
-
ex_resize_drive
(drive, size)[source]¶ Resize a drive.
Parameters: - drive – Drive to resize.
- size (
int
) – New drive size in bytes.
Returns: Drive object which is being resized.
Return type:
-
ex_start_node
(node, ex_avoid=None)[source]¶ Start a node.
Parameters: - node (
libcloud.compute.base.Node
) – Node to start. - ex_avoid (
list
) – A list of other server uuids to avoid when starting this node. If provided, node will attempt to be started on a different physical infrastructure from other servers specified using this argument. (optional)
- node (
-
ex_tag_resource
(resource, tag)[source]¶ Associate tag with the provided resource.
Parameters: - resource (
libcloud.compute.base.Node
orCloudSigmaDrive
) – Resource to associate a tag with. - tag (
CloudSigmaTag
) – Tag to associate with the resources.
Returns: Updated tag object.
Return type: - resource (
-
ex_tag_resources
(resources, tag)[source]¶ Associate tag with the provided resources.
Parameters: - resources (
list
oflibcloud.compute.base.Node
orCloudSigmaDrive
) – Resources to associate a tag with. - tag (
CloudSigmaTag
) – Tag to associate with the resources.
Returns: Updated tag object.
Return type: - resources (
-
ex_toggle_subscription_auto_renew
(subscription)[source]¶ Toggle subscription auto renew status.
Parameters: subscription ( CloudSigmaSubscription
) – Subscription to toggle the auto renew flag for.Returns: True
on success,False
otherwise.Return type: bool
-
list_images
()[source]¶ Return a list of available pre-installed library drives.
Note: If you want to list all the available library drives (both pre-installed and installation CDs), use
ex_list_library_drives()
method.
-
list_nodes
(ex_tag=None)[source]¶ List available nodes.
Parameters: ex_tag ( CloudSigmaTag
) – If specified, only return servers tagged with the provided tag.
-
name
= 'CloudSigma (API v2.0)'¶
-
website
= 'http://www.cloudsigma.com/'¶
-
-
exception
libcloud.compute.drivers.cloudsigma.
CloudSigmaError
(http_code, error_type, error_msg, error_point, driver)[source]¶ Bases:
libcloud.common.types.ProviderError
Represents CloudSigma API error.
Parameters: - http_code (
int
) – HTTP status code. - error_type (
str
) – Type of error (validation / notexist / backend / permissions database / concurrency / billing / payment) - error_msg (
str
) – A description of the error that occurred. - error_point (
str
orNone
) – Point at which the error occurred. Can be None.
- http_code (
-
class
libcloud.compute.drivers.cloudsigma.
CloudSigmaNodeSize
(id, name, cpu, ram, disk, bandwidth, price, driver)[source]¶
-
class
libcloud.compute.drivers.cloudsigma.
CloudSigmaDrive
(id, name, size, media, status, driver, extra=None)[source]¶ Bases:
libcloud.compute.base.NodeImage
Represents a CloudSigma drive.
Parameters: - id (
str
) – Drive ID. - name (
str
) – Drive name. - size (
int
) – Drive size (in bytes). - media (
str
) – Drive media (cdrom / disk). - status (
str
) – Drive status (unmounted / mounted).
- id (
-
class
libcloud.compute.drivers.cloudsigma.
CloudSigmaTag
(id, name, resources=None)[source]¶ Bases:
object
Represents a CloudSigma tag object.
Parameters: - id (
str
) – Tag ID. - name (
str
) – Tag name. - resource – IDs of resources which are associated with this tag.
- id (
-
class
libcloud.compute.drivers.cloudsigma.
CloudSigmaSubscription
(id, resource, amount, period, status, price, start_time, end_time, auto_renew, subscribed_object=None)[source]¶ Bases:
object
Represents CloudSigma subscription.
Parameters: - id (
str
) – Subscription ID. - resource (
str
) – Resource (e.g vlan, ip, etc.). - period (
str
) – Subscription period. - status (
str
) – Subscription status (active / inactive). - price (
str
) – Subscription price. - start_time (
datetime.datetime
) – Start time for this subscription. - end_time (
datetime.datetime
) – End time for this subscription. - auto_renew (
bool
) – True if the subscription is auto renewed. - subscribed_object (
str
) – Optional UUID of the subscribed object.
- id (
-
class
libcloud.compute.drivers.cloudsigma.
CloudSigmaFirewallPolicy
(id, name, rules)[source]¶ Bases:
object
Represents a CloudSigma firewall policy.
Parameters: - id (
str
) – Policy ID. - name (
str
) – Policy name. - rules (
list
ofCloudSigmaFirewallPolicyRule
objects) – Rules associated with this policy.
- id (
-
class
libcloud.compute.drivers.cloudsigma.
CloudSigmaFirewallPolicyRule
(action, direction, ip_proto=None, src_ip=None, src_port=None, dst_ip=None, dst_port=None, comment=None)[source]¶ Bases:
object
Represents a CloudSigma firewall policy rule.
Parameters: - action (
str
) – Action (drop / accept). - direction (
str
) – Rule direction (in / out / both)> - ip_proto (
str
.) – IP protocol (tcp / udp). - src_ip (
str
) – Source IP in CIDR notation. - src_port (
str
) – Source port or a port range. - dst_ip (
str
) – Destination IP in CIDR notation. - src_port – Destination port or a port range.
- comment (
str
) – Comment associated with the policy.
- action (
libcloud.compute.drivers.cloudstack module¶
-
class
libcloud.compute.drivers.cloudstack.
CloudStackAddress
(id, address, driver, associated_network_id=None, vpc_id=None, virtualmachine_id=None)[source]¶ Bases:
object
A public IP address.
Parameters: - id (
str
) – UUID of the Public IP - address (
str
) – The public IP address - associated_network_id (
str
) – The ID of the network where this address has been associated with - vpc_id (
str
) – VPC the ip belongs to - virtualmachine_id (
str
) – The ID of virutal machine this address is assigned to
- id (
-
class
libcloud.compute.drivers.cloudstack.
CloudStackAffinityGroup
(id, account, description, domain, domainid, name, group_type, virtualmachine_ids)[source]¶ Bases:
object
Class representing a CloudStack AffinityGroup.
A CloudStack Affinity Group.
- @note: This is a non-standard extension API, and only works for
- CloudStack.
Parameters: - id (
str
) – CloudStack Affinity Group ID - account (
str
) – An account for the affinity group. Must be used with domainId. - description (
str
) – optional description of the affinity group - domain (
str
) – the domain name of the affinity group - domainid (
str
) – domain ID of the account owning the affinity group - name (
str
) – name of the affinity group - group_type (
CloudStackAffinityGroupType
) – the type of the affinity group - virtualmachine_ids (
str
) – virtual machine Ids associated with this affinity group
Return type:
-
class
libcloud.compute.drivers.cloudstack.
CloudStackAffinityGroupType
(type_name)[source]¶ Bases:
object
Class representing a CloudStack AffinityGroupType.
A CloudStack Affinity Group Type.
- @note: This is a non-standard extension API, and only works for
- CloudStack.
Parameters: type_name ( str
) – the type of the affinity groupReturn type: CloudStackAffinityGroupType
-
class
libcloud.compute.drivers.cloudstack.
CloudStackDiskOffering
(id, name, size, customizable)[source]¶ Bases:
object
A disk offering within CloudStack.
-
class
libcloud.compute.drivers.cloudstack.
CloudStackEgressFirewallRule
(id, network_id, cidr_list, protocol, icmp_code=None, icmp_type=None, start_port=None, end_port=None)[source]¶ Bases:
object
A egress firewall rule.
A egress firewall rule.
- @note: This is a non-standard extension API, and only works for
- CloudStack.
Parameters: - id (
int
) – Firewall Rule ID - network_id (
str
) – the id network network for the egress firwall services - protocol (
str
) – TCP/IP Protocol (TCP, UDP) - cidr_list (
str
) – cidr list - icmp_code (
int
) – Error code for this icmp message - icmp_type (
int
) – Type of the icmp message being sent - start_port (
int
) – start of port range - end_port (
int
) – end of port range
Return type:
-
class
libcloud.compute.drivers.cloudstack.
CloudStackFirewallRule
(id, address, cidr_list, protocol, icmp_code=None, icmp_type=None, start_port=None, end_port=None)[source]¶ Bases:
object
A firewall rule.
A Firewall rule.
- @note: This is a non-standard extension API, and only works for
- CloudStack.
Parameters: - id (
int
) – Firewall Rule ID - address (
CloudStackAddress
) – External IP address - cidr_list (
str
) – cidr list - protocol (
str
) – TCP/IP Protocol (TCP, UDP) - icmp_code (
int
) – Error code for this icmp message - icmp_type (
int
) – Type of the icmp message being sent - start_port (
int
) – start of port range - end_port (
int
) – end of port range
Return type:
-
class
libcloud.compute.drivers.cloudstack.
CloudStackIPForwardingRule
(node, id, address, protocol, start_port, end_port=None)[source]¶ Bases:
object
A NAT/firewall forwarding rule.
A NAT/firewall forwarding rule.
- @note: This is a non-standard extension API, and only works for
- CloudStack.
Parameters: - node (
Node
) – Node for rule - id (
int
) – Rule ID - address (
CloudStackAddress
) – External IP address - protocol (
str
) – TCP/IP Protocol (TCP, UDP) - start_port (
int
) – Start port for the rule - end_port (
int
) – End port for the rule
Return type:
-
class
libcloud.compute.drivers.cloudstack.
CloudStackNetwork
(displaytext, name, networkofferingid, id, zoneid, driver, extra=None)[source]¶ Bases:
object
Class representing a CloudStack Network.
-
class
libcloud.compute.drivers.cloudstack.
CloudStackNetworkACL
(id, protocol, acl_id, action, cidr_list, start_port, end_port, traffic_type=None)[source]¶ Bases:
object
a ACL rule in the given network (the network has to belong to VPC)
a ACL rule in the given network (the network has to belong to VPC)
- @note: This is a non-standard extension API, and only works for
- Cloudstack.
Parameters: id – the ID of the ACL Item :type id
int
Parameters: - protocol (
string
) – the protocol for the ACL rule. Valid values are TCP/UDP/ICMP/ALL or valid protocol number - acl_id (
str
) – Name of the network ACL List - action (
string
) – scl entry action, allow or deny - cidr_list (
str
) – the cidr list to allow traffic from/to - start_port (
str
) – the starting port of ACL - end_port (
str
) – the ending port of ACL - traffic_type (
str
) – the traffic type for the ACL,can be Ingress or Egress, defaulted to Ingress if not specified
Return type:
-
class
libcloud.compute.drivers.cloudstack.
CloudStackNetworkACLList
(acl_id, name, vpc_id, driver, description=None)[source]¶ Bases:
object
a Network ACL for the given VPC
a Network ACL for the given VPC
- @note: This is a non-standard extension API, and only works for
- Cloudstack.
Parameters: - acl_id (
int
) – ACL ID - name (
str
) – Name of the network ACL List - vpc_id (
string
) – Id of the VPC associated with this network ACL List - description (
str
) – Description of the network ACL List
Return type:
-
class
libcloud.compute.drivers.cloudstack.
CloudStackNetworkOffering
(name, display_text, guest_ip_type, id, service_offering_id, for_vpc, driver, extra=None)[source]¶ Bases:
object
Class representing a CloudStack Network Offering.
-
class
libcloud.compute.drivers.cloudstack.
CloudStackNic
(id, network_id, net_mask, gateway, ip_address, is_default, mac_address, driver, extra=None)[source]¶ Bases:
object
Class representing a CloudStack Network Interface.
-
class
libcloud.compute.drivers.cloudstack.
CloudStackNode
(id, name, state, public_ips, private_ips, driver, size=None, image=None, extra=None, created_at=None)[source]¶ Bases:
libcloud.compute.base.Node
Subclass of Node so we can expose our extension methods.
Parameters: - id (
str
) – Node ID. - name (
str
) – Node name. - state (
libcloud.compute.types.NodeState
) – Node state. - public_ips (
list
) – Public IP addresses associated with this node. - private_ips (
list
) – Private IP addresses associated with this node. - driver (
NodeDriver
) – Driver this node belongs to. - size (
NodeSize
) – Size of this node. (optional) - image (
NodeImage
) – Image of this node. (optional) - created_at – The datetime this node was created (optional)
- extra (
dict
) – Optional provider specific attributes associated with this node.
-
ex_create_ip_forwarding_rule
(address, protocol, start_port, end_port=None)[source]¶ Add a NAT/firewall forwarding rule for a port or ports.
- id (
-
class
libcloud.compute.drivers.cloudstack.
CloudStackNodeDriver
(key, secret=None, secure=True, host=None, path=None, port=None, url=None, *args, **kwargs)[source]¶ Bases:
libcloud.common.cloudstack.CloudStackDriverMixIn
,libcloud.compute.base.NodeDriver
Driver for the CloudStack API.
Variables: - host – The host where the API can be reached.
- path – The path where the API can be reached.
- async_poll_frequency – How often (in seconds) to poll for async job completion.
Inherits: NodeDriver.__init__
Parameters: - host (
str
) – The host where the API can be reached. (required) - path (
str
) – The path where the API can be reached. (required) - url (
str
) – Full URL to the API endpoint. Mutually exclusive with host and path argument.
-
NODE_STATE_MAP
= {'Destroyed': 'terminated', 'Expunging': 'pending', 'Running': 'running', 'Stopped': 'stopped', 'Error': 'terminated', 'Stopping': 'pending', 'Migrating': 'migrating', 'Starting': 'rebooting'}¶
-
VOLUME_STATE_MAP
= {'Expunging': 'deleting', 'Ready': 'available', 'Snapshotting': 'backup', 'Creating': 'creating', 'UploadError': 'error', 'Destroying': 'deleting', 'Destroy': 'deleted', 'Allocated': 'available', 'Migrating': 'migrating', 'Expunged': 'deleted'}¶
-
api_name
= 'cloudstack'¶
-
attach_volume
(node, volume, device=None)[source]¶ @inherits:
NodeDriver.attach_volume
:type node:CloudStackNode
Return type: bool
-
create_key_pair
(name, **kwargs)[source]¶ Create a new key pair object.
Parameters: - name (
str
) – Key pair name. - name – Name of the keypair (required)
- projectid (
str
) – An optional project for the ssh key - domainid (
str
) – An optional domainId for the ssh key. If the account parameter is used, domainId must also be used. - account (
str
) – An optional account for the ssh key. Must be used with domainId.
Returns: Created key pair object.
Return type: - name (
-
create_node
(**kwargs)[source]¶ Create a new node
@inherits:
NodeDriver.create_node
Parameters: - networks (
list
ofCloudStackNetwork
) – Optional list of networks to launch the server into. - project (
CloudStackProject
) – Optional project to create the new node under. - diskoffering (
CloudStackDiskOffering
) – Optional disk offering to add to the new node. - ex_keyname (
str
) – Name of existing keypair - ex_userdata (
str
) – String containing user data - ex_security_groups (
list
ofstr
) – List of security groups to assign to the node - ex_displayname (
str
) – String containing instance display name - ex_ip_address (
str
) – String with ipaddress for the default nic - ex_start_vm (
bool
) – Boolean to specify to start VM after creation Default Cloudstack behaviour is to start a VM, if not specified. - ex_rootdisksize (
str
) – String with rootdisksize for the template - ex_affinity_groups (
list
ofCloudStackAffinityGroup
) – List of affinity groups to assign to the node
Return type: - networks (
-
create_volume
(size, name, location=None, snapshot=None, ex_volume_type=None)[source]¶ Creates a data volume Defaults to the first location
-
create_volume_snapshot
(volume, name=None)[source]¶ Create snapshot from volume
Parameters: - volume (
StorageVolume
) – Instance ofStorageVolume
- name (str) – The name of the snapshot is disregarded by CloudStack drivers
Return type: VolumeSnapshot
- volume (
-
delete_key_pair
(key_pair, **kwargs)[source]¶ Delete an existing key pair.
Parameters: - key_pair (
libcloud.compute.base.KeyPair
) – Key pair object. - projectid (
str
) – The project associated with keypair - domainid (
str
) – The domain ID associated with the keypair - account (
str
) – The account associated with the keypair. Must be used with the domainId parameter.
Returns: True of False based on success of Keypair deletion
Return type: bool
- key_pair (
-
destroy_node
(node, ex_expunge=False)[source]¶ @inherits:
NodeDriver.reboot_node
:type node:CloudStackNode
Parameters: ex_expunge ( bool
) – If true is passed, the vm is expunged immediately. False by default.Return type: bool
-
ex_allocate_public_ip
(vpc_id=None, network_id=None, location=None)[source]¶ Allocate a public IP.
Parameters: - vpc_id (
str
) – VPC the ip belongs to - network_id (''str'') – Network where this IP is connected to.
- location (
NodeLocation
) – Zone
Return type: - vpc_id (
-
ex_attach_nic_to_node
(node, network, ip_address=None)[source]¶ Add an extra Nic to a VM
Parameters: - network (:class:'CloudStackNetwork`) – NetworkOffering object
- node (:class:'CloudStackNode`) – Node Object
- ip_address (
str
) – Optional, specific IP for this Nic
Return type: bool
Creates a new Security Group Ingress rule
Parameters: - securitygroupname (
str
) – The name of the security group. Mutually exclusive with securitygroupid. - protocol (
str
) – Can be TCP, UDP or ICMP. Sometime other protocols can be used like AH, ESP or GRE. - cidrlist (
str
) – Source address CIDR for which this rule applies. - startport (
int
) – Start port of the range for this ingress rule. Applies to protocols TCP and UDP. - endport (
int
) – End port of the range for this ingress rule. It can be None to set only one port. Applies to protocols TCP and UDP. - icmptype (
int
) – Type of the ICMP packet (eg: 8 for Echo Request). -1 or None means “all types”. Applies to protocol ICMP. - icmpcode (
int
) – Code of the ICMP packet for the specified type. If the specified type doesn’t require a code set this value to 0. -1 or None means “all codes”. Applies to protocol ICMP. - account (
str
) – An optional account for the security group. Must be used with domainId. - domainid – An optional domainId for the security group. If the account parameter is used, domainId must also be used.
- projectid (
str
) – An optional project of the security group - securitygroupid (
str
) – The ID of the security group. Mutually exclusive with securitygroupname - usersecuritygrouplist (
dict
) – User to security group mapping
Return type: dict
- securitygroupname (
-
ex_create_affinity_group
(name, group_type)[source]¶ Creates a new Affinity Group
Parameters: - name (
str
) – Name of the affinity group - group_type (
CloudStackAffinityGroupType
) – Type of the affinity group from the available affinity/anti-affinity group types - description (
str
) – Optional description of the affinity group - domainid (
str
) – domain ID of the account owning the affinity group
Return type: - name (
-
ex_create_egress_firewall_rule
(network_id, cidr_list, protocol, icmp_code=None, icmp_type=None, start_port=None, end_port=None)[source]¶ Creates a Firewall Rule
Parameters: - network_id (
str
) – the id network network for the egress firewall services - cidr_list (
str
) – cidr list - protocol (
str
) – TCP/IP Protocol (TCP, UDP) - icmp_code (
int
) – Error code for this icmp message - icmp_type (
int
) – Type of the icmp message being sent - start_port (
int
) – start of port range - end_port (
int
) – end of port range
Return type: - network_id (
-
ex_create_firewall_rule
(address, cidr_list, protocol, icmp_code=None, icmp_type=None, start_port=None, end_port=None)[source]¶ Creates a Firewall Rule
Parameters: - address (
CloudStackAddress
) – External IP address - cidr_list (
str
) – cidr list - protocol (
str
) – TCP/IP Protocol (TCP, UDP) - icmp_code (
int
) – Error code for this icmp message - icmp_type (
int
) – Type of the icmp message being sent - start_port (
int
) – start of port range - end_port (
int
) – end of port range
Return type: - address (
-
ex_create_ip_forwarding_rule
(node, address, protocol, start_port, end_port=None)[source]¶ “Add a NAT/firewall forwarding rule.
Parameters: - node (
CloudStackNode
) – Node which should be used - address (
CloudStackAddress
) – CloudStackAddress which should be used - protocol (
str
) – Protocol which should be used (TCP or UDP) - start_port (
int
) – Start port which should be used - end_port (
int
) – End port which should be used
Return type: CloudStackForwardingRule
- node (
-
ex_create_keypair
(name, **kwargs)[source]¶ Creates a SSH KeyPair, returns fingerprint and private key
Parameters: - name (
str
) – Name of the keypair (required) - projectid (
str
) – An optional project for the ssh key - domainid (
str
) – An optional domainId for the ssh key. If the account parameter is used, domainId must also be used. - account (
str
) – An optional account for the ssh key. Must be used with domainId.
Returns: A keypair dictionary
Return type: dict
- name (
-
ex_create_network
(display_text, name, network_offering, location, gateway=None, netmask=None, network_domain=None, vpc_id=None, project_id=None)[source]¶ Creates a Network, only available in advanced zones.
Parameters: - display_text (
str
) – the display text of the network - name (
str
) – the name of the network - network_offering (:class:'CloudStackNetworkOffering`) – NetworkOffering object
- location (
NodeLocation
) – Zone object - gateway (
str
) – Optional, the Gateway of this network - netmask (
str
) – Optional, the netmask of this network - network_domain (
str
) – Optional, the DNS domain of the network - vpc_id (
str
) – Optional, the VPC id the network belongs to - project_id (
str
) – Optional, the project id the networks belongs to
Return type: - display_text (
-
ex_create_network_acl
(protocol, acl_id, cidr_list, start_port, end_port, action=None, traffic_type=None)[source]¶ Creates an ACL rule in the given network (the network has to belong to VPC)
Parameters: - protocol (
string
) – the protocol for the ACL rule. Valid values are TCP/UDP/ICMP/ALL or valid protocol number - acl_id (
str
) – Name of the network ACL List - cidr_list (
str
) – the cidr list to allow traffic from/to - start_port (
str
) – the starting port of ACL - end_port (
str
) – the ending port of ACL - action (
str
) – scl entry action, allow or deny - traffic_type (
str
) – the traffic type for the ACL,can be Ingress or Egress, defaulted to Ingress if not specified
Return type: - protocol (
-
ex_create_network_acllist
(name, vpc_id, description=None)[source]¶ Create an ACL List for a network within a VPC.
Parameters: - name (
string
) – Name of the network ACL List - vpc_id (
string
) – Id of the VPC associated with this network ACL List - description (
string
) – Description of the network ACL List
Return type: - name (
-
ex_create_port_forwarding_rule
(node, address, private_port, public_port, protocol, public_end_port=None, private_end_port=None, openfirewall=True, network_id=None)[source]¶ Creates a Port Forwarding Rule, used for Source NAT
Parameters: - address (
CloudStackAddress
) – IP address of the Source NAT - private_port (
int
) – Port of the virtual machine - protocol (
str
) – Protocol of the rule - public_port (
int
) – Public port on the Source NAT address - node (
CloudStackNode
) – The virtual machine - network_id (
string
) – The network of the vm the Port Forwarding rule will be created for. Required when public Ip address is not associated with any Guest network yet (VPC case)
Return type: - address (
-
ex_create_security_group
(name, **kwargs)[source]¶ Creates a new Security Group
Parameters: - name (
str
) – name of the security group (required) - account (
str
) – An optional account for the security group. Must be used with domainId. - domainid (
str
) – An optional domainId for the security group. If the account parameter is used, domainId must also be used. - description (
str
) – The description of the security group - projectid (
str
) – Deploy vm for the project
Return type: dict
- name (
-
ex_create_snapshot_template
(snapshot, name, ostypeid, displaytext=None)[source]¶ Create a template from a snapshot
Parameters: - snapshot – Instance of
VolumeSnapshot
- name (
str
) – the name of the template - name – the os type id
- name – the display name of the template
Return type: NodeImage
- snapshot – Instance of
Create tags for a resource (Node/StorageVolume/etc). A list of resource types can be found at http://goo.gl/6OKphH
Parameters: - resource_ids (
list
of resource IDs) – Resource IDs to be tagged. The resource IDs must all be associated with the resource_type. For example, for virtual machines (UserVm) you can only specify a list of virtual machine IDs. - resource_type (
str
) – Resource type (eg: UserVm) - tags (
dict
) – A dictionary or other mapping of strings to strings, associating tag names with tag values.
Return type: bool
- resource_ids (
-
ex_create_vpc
(cidr, display_text, name, vpc_offering, zone_id, network_domain=None)[source]¶ Creates a VPC, only available in advanced zones.
Parameters: - cidr – the cidr of the VPC. All VPC guest networks’ cidrs should be within this CIDR
- display_text (
str
) – the display text of the VPC - name (
str
) – the name of the VPC - vpc_offering (:class:'CloudStackVPCOffering`) – the ID of the VPC offering
- zone_id (
str
) – the ID of the availability zone - network_domain (
str
) – Optional, the DNS domain of the network
Return type:
-
ex_create_vpn_connection
(vpn_customer_gateway, vpn_gateway, for_display=None, passive=None)[source]¶ Creates a VPN Connection.
Parameters: - vpn_customer_gateway (
CloudStackVpnCustomerGateway
) – The VPN Customer Gateway (required). - vpn_gateway (
CloudStackVpnGateway
) – The VPN Gateway (required). - for_display (
str
) – Display the Connection to the end user or not. - passive (
bool
) – If True, sets the connection to be passive.
Return type: class: CloudStackVpnConnection - vpn_customer_gateway (
-
ex_create_vpn_customer_gateway
(cidr_list, esp_policy, gateway, ike_policy, ipsec_psk, account=None, domain_id=None, dpd=None, esp_lifetime=None, ike_lifetime=None, name=None)[source]¶ Creates a VPN Customer Gateway.
Parameters: - cidr_list (
str
) – Guest CIDR list of the Customer Gateway (required). - esp_policy (
str
) – ESP policy of the Customer Gateway (required). - gateway (
str
) – Public IP address of the Customer Gateway (required). - ike_policy (
str
) – IKE policy of the Customer Gateway (required). - ipsec_psk (
str
) – IPsec preshared-key of the Customer Gateway (required). - account (
str
) – The associated account with the Customer Gateway (must be used with the domain_id param). - domain_id (
str
) – The domain ID associated with the Customer Gateway. If used with the account parameter returns the gateway associated with the account for the specified domain. - dpd (
bool
) – If DPD is enabled for the VPN connection. - esp_lifetime (
int
) – Lifetime of phase 2 VPN connection to the Customer Gateway, in seconds. - ike_lifetime (
int
) – Lifetime of phase 1 VPN connection to the Customer Gateway, in seconds. - name (
str
) – Name of the Customer Gateway.
Return type: class: CloudStackVpnCustomerGateway - cidr_list (
-
ex_create_vpn_gateway
(vpc, for_display=None)[source]¶ Creates a VPN Gateway.
Parameters: - vpc – VPC to create the Gateway for (required).
- for_display (
bool
) – Display the VPC to the end user or not.
Return type: class: CloudStackVpnGateway
-
ex_delete_affinity_group
(affinity_group)[source]¶ Delete an Affinity Group
Parameters: affinity_group ( CloudStackAffinityGroup
) – Instance of affinity group:rtype
bool
-
ex_delete_egress_firewall_rule
(firewall_rule)[source]¶ Remove a Firewall rule.
Parameters: egress_firewall_rule ( CloudStackEgressFirewallRule
) – Firewall rule which should be usedReturn type: bool
-
ex_delete_firewall_rule
(firewall_rule)[source]¶ Remove a Firewall Rule.
Parameters: firewall_rule ( CloudStackFirewallRule
) – Firewall rule which should be usedReturn type: bool
-
ex_delete_ip_forwarding_rule
(node, rule)[source]¶ Remove a NAT/firewall forwarding rule.
Parameters: - node (
CloudStackNode
) – Node which should be used - rule (
CloudStackForwardingRule
) – Forwarding rule which should be used
Return type: bool
- node (
-
ex_delete_keypair
(keypair, **kwargs)[source]¶ Deletes an existing SSH KeyPair
Parameters: - keypair (
str
) – Name of the keypair (required) - projectid (
str
) – The project associated with keypair - domainid (
str
) – The domain ID associated with the keypair - account (
str
) – The account associated with the keypair. Must be used with the domainId parameter.
Returns: True of False based on success of Keypair deletion
Return type: bool
- keypair (
-
ex_delete_network
(network, force=None)[source]¶ Deletes a Network, only available in advanced zones.
Parameters: - network – The network
- force (
bool
) – Force deletion of the network?
Return type: bool
-
ex_delete_port_forwarding_rule
(node, rule)[source]¶ Remove a Port forwarding rule.
Parameters: - node (
CloudStackNode
) – Node used in the rule - rule (
CloudStackPortForwardingRule
) – Forwarding rule which should be used
Return type: bool
- node (
-
ex_delete_security_group
(name)[source]¶ Deletes a given Security Group
Parameters: - domainid (
str
) – The domain ID of account owning the security group - id (
str
) – The ID of the security group. Mutually exclusive with name parameter - name (
str
) – The ID of the security group. Mutually exclusive with id parameter - account (
str
) – The account of the security group. Must be specified with domain ID - projectid (
str
) – The project of the security group
Return type: bool
- domainid (
Delete tags from a resource.
Parameters: - resource_ids (
list
of resource IDs) – Resource IDs to be tagged. The resource IDs must all be associated with the resource_type. For example, for virtual machines (UserVm) you can only specify a list of virtual machine IDs. - resource_type (
str
) – Resource type (eg: UserVm) - tag_keys (
list
) – A list of keys to delete. CloudStack only requires the keys from the key/value pair.
Return type: bool
- resource_ids (
-
ex_delete_vpc
(vpc)[source]¶ Deletes a VPC, only available in advanced zones.
Parameters: vpc – The VPC Return type: bool
-
ex_delete_vpn_connection
(vpn_connection)[source]¶ Deletes a VPN Connection.
Parameters: vpn_connection ( CloudStackVpnConnection
) – The VPN Connection (required).Return type: bool
-
ex_delete_vpn_customer_gateway
(vpn_customer_gateway)[source]¶ Deletes a VPN Customer Gateway.
Parameters: vpn_customer_gateway ( CloudStackVpnCustomerGateway
) – The VPN Customer Gateway (required).Return type: bool
-
ex_delete_vpn_gateway
(vpn_gateway)[source]¶ Deletes a VPN Gateway.
Parameters: vpn_gateway ( CloudStackVpnGateway
) – The VPN Gateway (required).Return type: bool
-
ex_detach_nic_from_node
(nic, node)[source]¶ Remove Nic from a VM
Parameters: - nic (:class:'CloudStackNetwork`) – Nic object
- node (:class:'CloudStackNode`) – Node Object
Return type: bool
-
ex_get_node
(node_id, project=None)[source]¶ Return a Node object based on its ID.
Parameters: - node_id (
str
) – The id of the node - project (
CloudStackProject
) – Limit node returned to those configured under the defined project.
Return type: - node_id (
-
ex_get_volume
(volume_id, project=None)[source]¶ Return a StorageVolume object based on its ID.
Parameters: - volume_id (
str
) – The id of the volume - project (
CloudStackProject
) – Limit volume returned to those configured under the defined project.
Return type: - volume_id (
-
ex_import_keypair
(name, keyfile)[source]¶ Imports a new public key where the public key is passed via a filename
Parameters: - name (
str
) – The name of the public key to import. - keyfile (
str
) – The filename with path of the public key to import.
Return type: dict
- name (
-
ex_import_keypair_from_string
(name, key_material)[source]¶ Imports a new public key where the public key is passed in as a string
Parameters: - name (
str
) – The name of the public key to import. - key_material (
str
) – The contents of a public key file.
Return type: dict
- name (
-
ex_limits
()[source]¶ Extra call to get account’s resource limits, such as the amount of instances, volumes, snapshots and networks.
CloudStack uses integers as the resource type so we will convert them to a more human readable string using the resource map
A list of the resource type mappings can be found at http://goo.gl/17C6Gk
Returns: dict Return type: dict
-
ex_list_affinity_group_types
()[source]¶ List Affinity Group Types
:rtype
list
ofCloudStackAffinityGroupTypes
-
ex_list_affinity_groups
()[source]¶ List Affinity Groups
:rtype
list
ofCloudStackAffinityGroup
-
ex_list_disk_offerings
()[source]¶ Fetch a list of all available disk offerings.
Return type: list
ofCloudStackDiskOffering
-
ex_list_egress_firewall_rules
()[source]¶ Lists all egress Firewall Rules
Return type: list
ofCloudStackEgressFirewallRule
-
ex_list_firewall_rules
()[source]¶ Lists all Firewall Rules
Return type: list
ofCloudStackFirewallRule
-
ex_list_ip_forwarding_rules
(account=None, domain_id=None, id=None, ipaddress_id=None, is_recursive=None, keyword=None, list_all=None, page=None, page_size=None, project_id=None, virtualmachine_id=None)[source]¶ Lists all NAT/firewall forwarding rules
Parameters: - account (
str
) – List resources by account. Must be used with the domainId parameter - domain_id (
str
) – List only resources belonging to the domain specified - id (
str
) – Lists rule with the specified ID - ipaddress_id (
str
) – list the rule belonging to this public ip address - is_recursive (
bool
) – Defaults to false, but if true, lists all resources from the parent specified by the domainId till leaves. - keyword (
str
) – List by keyword - list_all (
bool
) – If set to false, list only resources belonging to the command’s caller; if set to true - list resources that the caller is authorized to see. Default value is false - page (
int
) – The page to list the keypairs from - page_size (
int
) – The number of results per page - project_id (
str
) – list objects by project - virtualmachine_id (
str
) – Lists all rules applied to the specified Vm
Return type: list
ofCloudStackIPForwardingRule
- account (
-
ex_list_keypairs
(**kwargs)[source]¶ List Registered SSH Key Pairs
Parameters: - projectid (
str
) – list objects by project - page (
int
) – The page to list the keypairs from - keyword (
str
) – List by keyword - listall (
bool
) – If set to false, list only resources belonging to the command’s caller; if set to true - list resources that the caller is authorized to see. Default value is false - pagesize (
int
) – The number of results per page - account (
str
) – List resources by account. Must be used with the domainId parameter - isrecursive (
bool
) – Defaults to false, but if true, lists all resources from the parent specified by the domainId till leaves. - fingerprint (
str
) – A public key fingerprint to look for - name (
str
) – A key pair name to look for - domainid (
str
) – List only resources belonging to the domain specified
Returns: A list of keypair dictionaries
Return type: list
ofdict
- projectid (
-
ex_list_network_acl
()[source]¶ Lists all network ACL items
Return type: list
ofCloudStackNetworkACL
-
ex_list_network_acllists
()[source]¶ Lists all network ACLs
Return type: list
ofCloudStackNetworkACLList
-
ex_list_network_offerings
()[source]¶ List the available network offerings
:rtype
list
ofCloudStackNetworkOffering
-
ex_list_networks
(project=None)[source]¶ List the available networks
Parameters: project ( CloudStackProject
) – Optional project the networks belongs to.:rtype
list
ofCloudStackNetwork
-
ex_list_nics
(node)[source]¶ List the available networks
Parameters: vm (:class:`CloudStackNode) – Node Object :rtype
list
ofCloudStackNic
-
ex_list_os_types
()[source]¶ List all registered os types (needed for snapshot creation)
Return type: list
-
ex_list_port_forwarding_rules
(account=None, domain_id=None, id=None, ipaddress_id=None, is_recursive=None, keyword=None, list_all=None, network_id=None, page=None, page_size=None, project_id=None)[source]¶ Lists all Port Forwarding Rules
Parameters: - account (
str
) – List resources by account. Must be used with the domainId parameter - domain_id (
str
) – List only resources belonging to the domain specified - for_display (
bool
) – List resources by display flag (only root admin is eligible to pass this parameter). - id (
str
) – Lists rule with the specified ID - ipaddress_id (
str
) – list the rule belonging to this public ip address - is_recursive (
bool
) – Defaults to false, but if true, lists all resources from the parent specified by the domainId till leaves. - keyword (
str
) – List by keyword - list_all (
bool
) – If set to false, list only resources belonging to the command’s caller; if set to true - list resources that the caller is authorized to see. Default value is false - network_id (
string
) – list port forwarding rules for certain network - page (
int
) – The page to list the keypairs from - page_size (
int
) – The number of results per page - project_id (
str
) – list objects by project
Return type: list
ofCloudStackPortForwardingRule
- account (
-
ex_list_projects
()[source]¶ List the available projects
:rtype
list
ofCloudStackProject
-
ex_list_public_ips
()[source]¶ Lists all Public IP Addresses.
Return type: list
ofCloudStackAddress
-
ex_list_routers
(vpc_id=None)[source]¶ List routers
:rtype
list
ofCloudStackRouter
-
ex_list_security_groups
(**kwargs)[source]¶ Lists Security Groups
Parameters: - domainid (
str
) – List only resources belonging to the domain specified - account (
str
) – List resources by account. Must be used with the domainId parameter. - listall (
bool
) – If set to false, list only resources belonging to the command’s caller; if set to true list resources that the caller is authorized to see. Default value is false - pagesize (
int
) – Number of entries per page - keyword (
str
) – List by keyword - tags (
dict
) – List resources by tags (key/value pairs) - id (
str
) – list the security group by the id provided - securitygroupname (
str
) – lists security groups by name - virtualmachineid (
str
) – lists security groups by virtual machine id - projectid (
str
) – list objects by project - isrecursive (
bool
) – (boolean) defaults to false, but if true, lists all resources from the parent specified by the domainId till leaves. - page (
int
) – (integer)
:rtype
list
- domainid (
-
ex_list_vpc_offerings
()[source]¶ List the available vpc offerings
:rtype
list
ofCloudStackVPCOffering
-
ex_list_vpcs
(project=None)[source]¶ List the available VPCs
Parameters: project ( CloudStackProject
) – Optional project under which VPCs are present.:rtype
list
ofCloudStackVPC
-
ex_list_vpn_connections
(account=None, domain_id=None, for_display=None, id=None, is_recursive=None, keyword=None, list_all=None, page=None, page_size=None, project_id=None, vpc_id=None)[source]¶ List VPN Connections.
Parameters: - account (
str
) – List resources by account (must be used with the domain_id parameter). - domain_id (
str
) – List only resources belonging to the domain specified. - for_display (
bool
) – List resources by display flag (only root admin is eligible to pass this parameter). - id (
str
) – ID of the VPN Connection. - is_recursive (
bool
) – Defaults to False, but if true, lists all resources from the parent specified by the domain_id till leaves. - keyword (
str
) – List by keyword. - list_all (
str
) – If set to False, list only resources belonging to the command’s caller; if set to True - list resources that the caller is authorized to see. Default value is False. - page (
int
) – Start from page. - page_size (
int
) – Items per page. - project_id (
str
) – List objects by project. - vpc_id (
str
) – List objects by VPC.
Return type: list
ofCloudStackVpnConnection
- account (
-
ex_list_vpn_customer_gateways
(account=None, domain_id=None, id=None, is_recursive=None, keyword=None, list_all=None, page=None, page_size=None, project_id=None)[source]¶ List VPN Customer Gateways.
Parameters: - account (
str
) – List resources by account (must be used with the domain_id parameter). - domain_id (
str
) – List only resources belonging to the domain specified. - id (
str
) – ID of the VPN Customer Gateway. - is_recursive (
bool
) – Defaults to False, but if true, lists all resources from the parent specified by the domain_id till leaves. - keyword (
str
) – List by keyword. - list_all (
str
) – If set to False, list only resources belonging to the command’s caller; if set to True - list resources that the caller is authorized to see. Default value is False. - page (
int
) – Start from page. - page_size (
int
) – Items per page. - project_id (
str
) – List objects by project.
Return type: list
ofCloudStackVpnCustomerGateway
- account (
-
ex_list_vpn_gateways
(account=None, domain_id=None, for_display=None, id=None, is_recursive=None, keyword=None, list_all=None, page=None, page_size=None, project_id=None, vpc_id=None)[source]¶ List VPN Gateways.
Parameters: - account (
str
) – List resources by account (must be used with the domain_id parameter). - domain_id (
str
) – List only resources belonging to the domain specified. - for_display (
bool
) – List resources by display flag (only root admin is eligible to pass this parameter). - id (
str
) – ID of the VPN Gateway. - is_recursive (
bool
) – Defaults to False, but if true, lists all resources from the parent specified by the domain ID till leaves. - keyword (
str
) – List by keyword. - list_all (
str
) – If set to False, list only resources belonging to the command’s caller; if set to True - list resources that the caller is authorized to see. Default value is False. - page (
int
) – Start from page. - page_size (
int
) – Items per page. - project_id (
str
) – List objects by project. - vpc_id (
str
) – List objects by VPC.
Return type: list
ofCloudStackVpnGateway
- account (
-
ex_register_iso
(name, url, location=None, **kwargs)[source]¶ Registers an existing ISO by URL.
Parameters: - name (
str
) – Name which should be used - url (
str
) – Url should be used - location (
NodeLocation
) – Location which should be used
Return type: str
- name (
-
ex_release_public_ip
(address)[source]¶ Release a public IP.
Parameters: address ( CloudStackAddress
) – CloudStackAddress which should be usedReturn type: bool
-
ex_replace_network_acllist
(acl_id, network_id)[source]¶ Create an ACL List for a network within a VPC.Replaces ACL associated with a Network or private gateway
Parameters: - acl_id (
string
) – the ID of the network ACL - network_id (
string
) – the ID of the network
Return type: - acl_id (
-
ex_revoke_security_group_ingress
(rule_id)[source]¶ Revoke/delete an ingress security rule
Parameters: id ( str
) – The ID of the ingress security ruleReturn type: bool
-
ex_start
(node)[source]¶ Starts/Resumes a stopped virtual machine
Parameters: - id (
str
) – The ID of the virtual machine (required) - hostid (
str
) – destination Host ID to deploy the VM to parameter available for root admin only
:rtype
str
- id (
-
ex_stop
(node)[source]¶ Stops/Suspends a running virtual machine
Parameters: node ( CloudStackNode
) – Node to stop.Return type: str
-
ex_update_node_affinity_group
(node, affinity_group_list)[source]¶ Updates the affinity/anti-affinity group associations of a virtual machine. The VM has to be stopped and restarted for the new properties to take effect.
Parameters: - node (
CloudStackNode
) – Node to update. - affinity_group_list (
list
ofCloudStackAffinityGroup
) – List of CloudStackAffinityGroup to associate
:rtype
CloudStackNode
- node (
-
features
= {'create_node': ['generates_password']}¶
-
get_key_pair
(name)[source]¶ Retrieve a single key pair.
Parameters: name ( str
) – Name of the key pair to retrieve.Return type: KeyPair
-
import_key_pair_from_string
(name, key_material)[source]¶ Import a new public key from string.
Parameters: - name (
str
) – Key pair name. - key_material (
str
) – Public key material.
Returns: Imported key pair object.
Return type: - name (
-
list_key_pairs
(**kwargs)[source]¶ List registered key pairs.
Parameters: - projectid (
str
) – list objects by project - page (
int
) – The page to list the keypairs from - keyword (
str
) – List by keyword - listall (
bool
) – If set to false, list only resources belonging to the command’s caller; if set to true - list resources that the caller is authorized to see. Default value is false - pagesize (
int
) – The number of results per page - account (
str
) – List resources by account. Must be used with the domainId parameter - isrecursive (
bool
) – Defaults to false, but if true, lists all resources from the parent specified by the domainId till leaves. - fingerprint (
str
) – A public key fingerprint to look for - name (
str
) – A key pair name to look for - domainid (
str
) – List only resources belonging to the domain specified
Returns: A list of key par objects.
Return type: list
oflibcloud.compute.base.KeyPair
- projectid (
-
list_nodes
(project=None, location=None)[source]¶ @inherits:
NodeDriver.list_nodes
Parameters: - project (
CloudStackProject
) – Limit nodes returned to those configured under the defined project. - location (
NodeLocation
) – Limit nodes returned to those in the defined location.
Return type: list
ofCloudStackNode
- project (
-
list_volumes
(node=None)[source]¶ List all volumes
Parameters: node ( CloudStackNode
) – Only return volumes for the provided node.Return type: list
ofStorageVolume
-
name
= 'CloudStack'¶
-
reboot_node
(node)[source]¶ @inherits:
NodeDriver.reboot_node
:type node:CloudStackNode
Return type: bool
-
type
= 'cloudstack'¶
-
website
= 'http://cloudstack.org/'¶
-
class
libcloud.compute.drivers.cloudstack.
CloudStackPortForwardingRule
(node, rule_id, address, protocol, public_port, private_port, public_end_port=None, private_end_port=None, network_id=None)[source]¶ Bases:
object
A Port forwarding rule for Source NAT.
A Port forwarding rule for Source NAT.
@note: This is a non-standard extension API, and only works for EC2.
Parameters: - node (
Node
) – Node for rule - rule_id (
int
) – Rule ID - address (
CloudStackAddress
) – External IP address - protocol (
str
) – TCP/IP Protocol (TCP, UDP) - public_port (
int
) – External port for rule (or start port if public_end_port is also provided) - private_port (
int
) – Internal node port for rule (or start port if public_end_port is also provided) - public_end_port (
int
) – End of external port range - private_end_port (
int
) – End of internal port range - network_id (
str
) – The network of the vm the Port Forwarding rule will be created for. Required when public Ip address is not associated with any Guest network yet (VPC case)
Return type: - node (
-
class
libcloud.compute.drivers.cloudstack.
CloudStackProject
(id, name, display_text, driver, extra=None)[source]¶ Bases:
object
Class representing a CloudStack Project.
-
class
libcloud.compute.drivers.cloudstack.
CloudStackRouter
(id, name, state, public_ip, vpc_id, driver)[source]¶ Bases:
object
Class representing a CloudStack Router.
-
class
libcloud.compute.drivers.cloudstack.
CloudStackVPC
(name, vpc_offering_id, id, cidr, driver, zone_id=None, display_text=None, extra=None)[source]¶ Bases:
object
Class representing a CloudStack VPC.
-
class
libcloud.compute.drivers.cloudstack.
CloudStackVPCOffering
(name, display_text, id, driver, extra=None)[source]¶ Bases:
object
Class representing a CloudStack VPC Offering.
-
class
libcloud.compute.drivers.cloudstack.
CloudStackVpnConnection
(id, passive, vpn_customer_gateway_id, vpn_gateway_id, state, driver, extra=None)[source]¶ Bases:
object
Class representing a CloudStack VPN Connection.
-
vpn_customer_gateway
¶
-
vpn_gateway
¶
-
-
class
libcloud.compute.drivers.cloudstack.
CloudStackVpnCustomerGateway
(id, cidr_list, esp_policy, gateway, ike_policy, ipsec_psk, driver, extra=None)[source]¶ Bases:
object
Class representing a CloudStack VPN Customer Gateway.
libcloud.compute.drivers.cloudwatt module¶
Cloudwatt driver.
-
class
libcloud.compute.drivers.cloudwatt.
CloudwattNodeDriver
(key, secret, tenant_id, secure=True, tenant_name=None, host=None, port=None, **kwargs)[source]¶ Bases:
libcloud.compute.drivers.openstack.OpenStack_1_1_NodeDriver
Implements the
NodeDriver
‘s for Cloudwatt.@inherits:
NodeDriver.__init__
Parameters: tenant_id ( str
) – ID of tenant required for Cloudwatt auth-
connectionCls
¶ alias of
CloudwattConnection
-
name
= 'Cloudwatt'¶
-
type
= 'cloudwatt'¶
-
website
= 'https://www.cloudwatt.com/'¶
-
libcloud.compute.drivers.digitalocean module¶
DigitalOcean Driver
-
class
libcloud.compute.drivers.digitalocean.
DigitalOceanNodeDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region=None, **kwargs)[source]¶ Bases:
libcloud.compute.base.NodeDriver
DigitalOcean NodeDriver defaulting to using APIv2.
Parameters: - key (
str
) – Required for authentication. Used in bothv1
andv2
implementations. - secret (
str
) – Used in driver authentication with key. Defaults to None and when set, will cause driver to usev1
for connection and response. (optional) - api_version (
str
) – Specifies the API version to use.v1
andv2
are the only valid options. Defaults to usingv2
(optional) - key – API key or username to be used (required)
- secret – Secret password to be used (required)
- secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections. - api_version – Optional API version. Only used by drivers which support multiple API versions.
- region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
Return type: None
-
name
= 'DigitalOcean'¶
-
type
= 'digitalocean'¶
-
website
= 'https://www.digitalocean.com'¶
- key (
-
class
libcloud.compute.drivers.digitalocean.
DigitalOcean_v1_NodeDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region=None, **kwargs)[source]¶ Bases:
libcloud.common.digitalocean.DigitalOcean_v1_BaseDriver
,libcloud.compute.drivers.digitalocean.DigitalOceanNodeDriver
DigitalOcean NodeDriver using v1 of the API.
Parameters: - key (
str
) – API key or username to be used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections. - api_version (
str
) – Optional API version. Only used by drivers which support multiple API versions. - region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
Return type: None
-
NODE_STATE_MAP
= {'active': 'running', 'new': 'pending', 'off': 'rebooting'}¶
-
create_key_pair
(name, ssh_key_pub)[source]¶ Create a new SSH key.
Parameters: - name (
str
) – Key name (required) - name – Valid public key string (required)
- name (
-
create_node
(name, size, image, location, ex_ssh_key_ids=None)[source]¶ Create a node.
Parameters: ex_ssh_key_ids ( list
ofstr
) – A list of ssh key ids which will be added to the server. (optional)Returns: The newly created node. Return type: Node
-
delete_key_pair
(key_pair)[source]¶ Delete an existing key pair.
Parameters: key_pair ( KeyPair
) – Key pair object.
-
ex_create_ssh_key
(name, ssh_key_pub)[source]¶ Create a new SSH key. :param name: Key name (required) :type name:
str
:param name: Valid public key string (required) :type name:str
-
ex_destroy_ssh_key
(key_id)[source]¶ Delete an existing SSH key. :param key_id: SSH key id (required) :type key_id:
str
-
ex_list_ssh_keys
()[source]¶ List all the available SSH keys. :return: Available SSH keys. :rtype:
list
ofSSHKey
-
get_key_pair
(name)[source]¶ Retrieve a single key pair.
Parameters: name ( str
) – Name of the key pair to retrieve.Return type: KeyPair
- key (
-
class
libcloud.compute.drivers.digitalocean.
DigitalOcean_v2_NodeDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region=None, ex_per_page=200, **kwargs)[source]¶ Bases:
libcloud.common.digitalocean.DigitalOcean_v2_BaseDriver
,libcloud.compute.drivers.digitalocean.DigitalOceanNodeDriver
DigitalOcean NodeDriver using v2 of the API.
-
EX_CREATE_ATTRIBUTES
= ['backups', 'ipv6', 'private_networking', 'ssh_keys']¶
-
NODE_STATE_MAP
= {'active': 'running', 'new': 'pending', 'off': 'stopped', 'archive': 'terminated'}¶
-
attach_volume
(node, volume, device=None)[source]¶ Attaches volume to node.
Parameters: - node (
Node
) – Node to attach volume to. - volume (
StorageVolume
) – Volume to attach. - device (
str
) – Where the device is exposed, e.g. ‘/dev/sdb’
Rytpe: bool
- node (
-
create_image
(node, name)[source]¶ Create an image from a Node.
@inherits:
NodeDriver.create_image
Parameters: - node (
str
) – Node to use as base for image - node – Name for image
Return type: bool
- node (
-
create_key_pair
(name, public_key='')[source]¶ Create a new SSH key.
Parameters: - name (
str
) – Key name (required) - public_key (
str
) – Valid public key string (required)
- name (
-
create_node
(name, size, image, location, ex_create_attr=None, ex_ssh_key_ids=None, ex_user_data=None)[source]¶ Create a node.
The ex_create_attr parameter can include the following dictionary key and value pairs:
- backups:
bool
defaults to False - ipv6:
bool
defaults to False - private_networking:
bool
defaults to False - user_data:
str
for cloud-config data - ssh_keys:
list
ofint
key ids orstr
fingerprints
ex_create_attr[‘ssh_keys’] will override ex_ssh_key_ids assignment.
Parameters: - ex_create_attr (
dict
) – A dictionary of optional attributes for droplet creation - ex_ssh_key_ids (
list
ofint
key ids orstr
key fingerprints) – A list of ssh key ids which will be added to the server. (optional) - ex_user_data (
str
) – User data to be added to the node on create. (optional)
Returns: The newly created node.
Return type: Node
- backups:
-
create_volume
(size, name, location=None, snapshot=None)[source]¶ Create a new volume.
Parameters: - size (
int
) – Size of volume in gigabytes (required) - name (
str
) – Name of the volume to be created - location (
NodeLocation
) – Which data center to create a volume in. If empty, undefined behavior will be selected. (optional) - snapshot (
VolumeSnapshot
) – Snapshot from which to create the new volume. (optional)
Returns: The newly created volume.
Return type: StorageVolume
- size (
-
delete_image
(image)[source]¶ Delete an image for node.
@inherits:
NodeDriver.delete_image
Parameters: image ( NodeImage
) – the image to be deletedReturn type: bool
-
delete_key_pair
(key)[source]¶ Delete an existing SSH key.
Parameters: key ( KeyPair
) – SSH key (required)
-
destroy_volume
(volume)[source]¶ Destroys a storage volume.
Parameters: volume ( StorageVolume
) – Volume to be destroyedReturn type: bool
-
detach_volume
(volume)[source]¶ Detaches a volume from a node.
Parameters: volume ( StorageVolume
) – Volume to be detachedReturn type: bool
-
get_image
(image_id)[source]¶ Get an image based on an image_id
@inherits:
NodeDriver.get_image
Parameters: image_id ( int
) – Image identifierReturns: A NodeImage object Return type: NodeImage
-
get_key_pair
(name)[source]¶ Retrieve a single key pair.
Parameters: name ( str
) – Name of the key pair to retrieve.Return type: KeyPair
-
libcloud.compute.drivers.dimensiondata module¶
Dimension Data Driver
-
class
libcloud.compute.drivers.dimensiondata.
DimensionDataNodeDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region='dd-na', **kwargs)[source]¶ Bases:
libcloud.compute.base.NodeDriver
DimensionData node driver.
-
api_version
= 1.0¶
-
connectionCls
¶ alias of
DimensionDataConnection
-
create_node
(name, image, auth, ex_description, ex_network=None, ex_network_domain=None, ex_vlan=None, ex_primary_ipv4=None, ex_memory_gb=None, ex_cpu_specification=None, ex_is_started=True, ex_additional_nics_vlan=None, ex_additional_nics_ipv4=None, ex_primary_dns=None, ex_secondary_dns=None, **kwargs)[source]¶ Create a new DimensionData node
Parameters: - name (
str
) – String with a name for this new node (required) - image (
NodeImage
orstr
) – OS Image to boot on node. (required) - auth (
NodeAuthPassword
orstr
orNone
) – Initial authentication information for the node. (If this is a customer LINUX image auth will be ignored) - ex_description (
str
) – description for this node (required) - ex_network (
DimensionDataNetwork
orstr
) – Network to create the node within (required unless using ex_network_domain or ex_primary_ipv4) - ex_network_domain (
DimensionDataNetworkDomain
orstr
) – Network Domain to create the node (required unless using network or ex_primary_ipv4) - ex_primary_ipv4 (
str
) – Primary nics IPv4 Address MCP1: (required unless ex_network) MCP2: (required unless ex_vlan) - ex_vlan (
DimensionDataVlan
orstr
) – VLAN to create the node within (required unless using network) - ex_memory_gb (
int
) – The amount of memory in GB for the server - ex_cpu_specification (
DimensionDataServerCpuSpecification
) – The spec of CPU to deploy (optional) - ex_is_started (
bool
) – Start server after creation? default true (required) - ex_additional_nics_vlan (
list
ofDimensionDataVlan
orlist
ofstr
) – (MCP2 Only) List of additional nics to add by vlan - ex_additional_nics_ipv4 (
list
ofstr
) – (MCP2 Only) List of additional nics to add by ipv4 address - ex_primary_dns (
str
) – The node’s primary DNS - ex_secondary_dns (
str
) – The node’s secondary DNS
Returns: The newly created
Node
.Return type: Node
- name (
-
destroy_node
(node)[source]¶ Deletes a node, node must be stopped before deletion
Parameters: node ( Node
) – The node to deleteReturn type: bool
-
ex_add_storage_to_node
(node, amount, speed='STANDARD', scsi_id=None)[source]¶ Add storage to the node
Parameters: - node (
Node
) – The server to add storage to - amount (
int
) – The amount of storage to add, in GB - speed (
str
) – The disk speed type - scsi_id (
int
) – The target SCSI ID (optional)
Return type: bool
- node (
-
ex_apply_tag_to_asset
(asset, tag_key, value=None)[source]¶ Apply a tag to a Dimension Data Asset
Parameters: - asset (
Node
orNodeImage
orDimensionDataNewtorkDomain
orDimensionDataVlan
orDimensionDataPublicIpBlock
) – The asset to apply a tag to. (required) - tag_key (
DimensionDataTagKey
orstr
) – The tag_key to apply to the asset. (required) - value (
str
) – The value to be assigned to the tag key This is only required if theDimensionDataTagKey
requires it
Return type: bool
- asset (
-
ex_attach_node_to_vlan
(node, vlan=None, private_ipv4=None)[source]¶ Attach a node to a VLAN by adding an additional NIC to the node on the target VLAN. The IP will be automatically assigned based on the VLAN IP network space. Alternatively, provide a private IPv4 address instead of VLAN information, and this will be assigned to the node on corresponding NIC.
Parameters: - node (
Node
) – Node which should be used - vlan (
DimensionDataVlan
) – VLAN to attach the node to (required unless private_ipv4) - private_ipv4 (
str
) – Private nic IPv4 Address (required unless vlan)
Return type: bool
- node (
-
ex_audit_log_report
(start_date, end_date)[source]¶ Get audit log report
Parameters: - start_date (
str
in format YYYY-MM-DD) – Start date for the report - end_date (
str
in format YYYY-MM-DD) – End date for the report
Return type: list
oflist
- start_date (
-
ex_backup_usage_report
(start_date, end_date, location)[source]¶ Get audit log report
Parameters: - start_date (
str
in format YYYY-MM-DD) – Start date for the report - end_date (
str
in format YYYY-MM-DD) – End date for the report - location (
NodeLocation
orstr
) – Filters the node list to nodes that are located in this location
Return type: list
oflist
- start_date (
-
ex_change_storage_size
(node, disk_id, size)[source]¶ Change the size of a disk
Parameters: - node (
Node
) – The server to change the disk of - disk_id (
str
) – The ID of the disk to resize - size (
int
) – The disk size in GB
Return type: bool
- node (
-
ex_change_storage_speed
(node, disk_id, speed)[source]¶ Change the speed (disk tier) of a disk
Parameters: - node (
Node
) – The server to change the disk speed of - disk_id (
str
) – The ID of the disk to change - speed (
str
) – The disk speed type e.g. STANDARD
Return type: bool
- node (
-
ex_clean_failed_deployment
(node)[source]¶ Removes a node that has failed to deploy
Parameters: node ( Node
orstr
) – The failed node to clean
-
ex_clone_node_to_image
(node, image_name, image_description=None)[source]¶ Clone a server into a customer image.
Parameters: - node (
Node
) – The server to clone - image_name (
str
) – The name of the clone image - description (
str
) – The description of the image
Return type: bool
- node (
-
ex_create_anti_affinity_rule
(node_list)[source]¶ Create an anti affinity rule given a list of nodes Anti affinity rules ensure that servers will not reside on the same VMware ESX host
Parameters: node_list ( list
ofNode
orlist
ofstr
) – The list of nodes to create a rule forReturn type: bool
-
ex_create_firewall_rule
(network_domain, rule, position, position_relative_to_rule=None)[source]¶ Creates a firewall rule
Parameters: - network_domain (
DimensionDataNetworkDomain
orstr
) – The network domain in which to create the firewall rule - rule (
DimensionDataFirewallRule
) – The rule in which to create - position (
str
) – The position in which to create the rule There are two types of positions with position_relative_to_rule arg and without it With: ‘BEFORE’ or ‘AFTER’ Without: ‘FIRST’ or ‘LAST’ - position_relative_to_rule (
DimensionDataFirewallRule
orstr
) – The rule or rule name in which to decide positioning by
Return type: bool
- network_domain (
-
ex_create_nat_rule
(network_domain, internal_ip, external_ip)[source]¶ Create a NAT rule
Parameters: - network_domain (
DimensionDataNetworkDomain
) – The network domain the rule belongs to - internal_ip (
str
) – The IPv4 address internally - external_ip (
str
) – The IPv4 address externally
Return type: DimensionDataNatRule
- network_domain (
-
ex_create_network
(location, name, description=None)[source]¶ Create a new network in an MCP 1.0 location
Parameters: - location (
NodeLocation
orstr
) – The target location (MCP1) - name (
str
) – The name of the network - description (
str
) – Additional description of the network
Returns: A new instance of DimensionDataNetwork
Return type: Instance of
DimensionDataNetwork
- location (
-
ex_create_network_domain
(location, name, service_plan, description=None)[source]¶ Deploy a new network domain to a data center
Parameters: - location (
NodeLocation
orstr
) – The data center to list - name (
str
) – The name of the network domain to create - service_plan (
str
) – The service plan, either “ESSENTIALS” or “ADVANCED” - description (
str
) – An additional description of the network domain
Returns: an instance of DimensionDataNetworkDomain
Return type: DimensionDataNetworkDomain
- location (
-
ex_create_tag_key
(name, description=None, value_required=True, display_on_report=True)[source]¶ Creates a tag key in the Dimension Data Cloud
Parameters: - name (
str
) – The name of the tag key (required) - description (
str
) – The description of the tag key - value_required (
bool
) – If a value is required for the tag Tags themselves can be just a tag, or be a key/value pair - display_on_report (
bool
) – Should this key show up on the usage reports
Return type: bool
- name (
-
ex_create_vlan
(network_domain, name, private_ipv4_base_address, description=None, private_ipv4_prefix_size=24)[source]¶ Deploy a new VLAN to a network domain
Parameters: - network_domain (
DimensionDataNetworkDomain
) – The network domain to add the VLAN to - name (
str
) – The name of the VLAN to create - private_ipv4_base_address (
str
) – The base IPv4 address e.g. 192.168.1.0 - description (
str
) – An additional description of the VLAN - private_ipv4_prefix_size (
int
) – The size of the IPv4 address space, e.g 24
Returns: an instance of DimensionDataVlan
Return type: DimensionDataVlan
- network_domain (
-
ex_delete_anti_affinity_rule
(anti_affinity_rule)[source]¶ Remove anti affinity rule
Parameters: anti_affinity_rule ( DimensionDataAntiAffinityRule
orstr
) – The anti affinity rule to deleteReturn type: bool
-
ex_delete_firewall_rule
(rule)[source]¶ Delete a firewall rule
Parameters: rule ( DimensionDataFirewallRule
) – The rule to deleteReturn type: bool
-
ex_delete_nat_rule
(rule)[source]¶ Delete an existing NAT rule
Parameters: rule ( DimensionDataNatRule
) – The rule to deleteReturn type: bool
-
ex_delete_network
(network)[source]¶ Delete a network from an MCP 1 data center
Parameters: network ( DimensionDataNetwork
) – The network to deleteReturn type: bool
-
ex_delete_network_domain
(network_domain)[source]¶ Delete a network domain
Parameters: network_domain ( DimensionDataNetworkDomain
) – The network domain to deleteReturn type: bool
-
ex_delete_vlan
(vlan)[source]¶ Deletes an existing VLAN
Parameters: vlan ( DimensionDataNetworkDomain
) – The VLAN to deleteReturn type: bool
-
ex_destroy_nic
(nic_id)[source]¶ Remove a NIC on a node, removing the node from a VLAN
Parameters: nic_id ( str
) – The identifier of the NIC to removeReturn type: bool
-
ex_detailed_usage_report
(start_date, end_date)[source]¶ Get detailed usage information
Parameters: - start_date (
str
in format YYYY-MM-DD) – Start date for the report - end_date (
str
in format YYYY-MM-DD) – End date for the report
Return type: list
oflist
- start_date (
-
ex_disable_monitoring
(node)[source]¶ Disables cloud monitoring for a node
Parameters: node ( Node
) – The node to stop monitoringReturn type: bool
-
ex_enable_monitoring
(node, service_plan='ESSENTIALS')[source]¶ Enables cloud monitoring on a node
Parameters: - node (
Node
) – The node to monitor - service_plan (
str
) – The service plan, one of ESSENTIALS or ADVANCED
Return type: bool
- node (
-
ex_expand_vlan
(vlan)[source]¶ Expands the VLAN to the prefix size in private_ipv4_range_size The expansion will not be permitted if the proposed IP space overlaps with an already deployed VLANs IP space.
Parameters: vlan ( DimensionDataNetworkDomain
) – The VLAN to updateReturns: an instance of DimensionDataVlan Return type: DimensionDataVlan
-
ex_get_base_image_by_id
(id)[source]¶ Gets a Base image in the Dimension Data Cloud given the id
Parameters: id ( str
) – The id of the imageReturn type: NodeImage
-
ex_get_customer_image_by_id
(id)[source]¶ Gets a Customer image in the Dimension Data Cloud given the id
Parameters: id ( str
) – The id of the imageReturn type: NodeImage
-
ex_get_image_by_id
(id)[source]¶ Gets a Base/Customer image in the Dimension Data Cloud given the id
- Note: This first checks the base image
- If it is not a base image we check if it is a customer image If it is not in either of these a DimensionDataAPIException is thrown
Parameters: id ( str
) – The id of the imageReturn type: NodeImage
-
ex_get_location_by_id
(id)[source]¶ Get location by ID.
Parameters: id ( str
) – ID of the node location which should be usedReturn type: NodeLocation
-
ex_get_nat_rule
(network_domain, rule_id)[source]¶ Get a NAT rule by ID
Parameters: - network_domain (
DimensionDataNetworkDomain
) – The network domain the rule belongs to - rule_id (
str
) – The ID of the NAT rule to fetch
Return type: DimensionDataNatRule
- network_domain (
-
ex_get_network_domain
(network_domain_id)[source]¶ Get an individual Network Domain, by identifier
Parameters: network_domain_id ( str
) – The identifier of the network domainReturn type: DimensionDataNetworkDomain
-
ex_get_tag_key_by_id
(id)[source]¶ Get a specific tag key by ID
Parameters: id ( str
) – ID of the tag key you want (required)Return type: DimensionDataTagKey
-
ex_get_tag_key_by_name
(name)[source]¶ Get a specific tag key by Name
Parameters: name ( str
) – Name of the tag key you want (required)Return type: DimensionDataTagKey
-
ex_get_vlan
(vlan_id)[source]¶ Get a single VLAN, by it’s identifier
Parameters: vlan_id ( str
) – The identifier of the VLANReturns: an instance of DimensionDataVlan Return type: DimensionDataVlan
-
ex_list_anti_affinity_rules
(network=None, network_domain=None, node=None, filter_id=None, filter_state=None)[source]¶ List anti affinity rules for a network, network domain, or node
Parameters: - network (
DimensionDataNetwork
orstr
) – The network to list anti affinity rules for One of network, network_domain, or node is required - network_domain (
DimensionDataNetworkDomain
orstr
) – The network domain to list anti affinity rules One of network, network_domain, or node is required - node (
Node
orstr
) – The node to list anti affinity rules for One of network, netwok_domain, or node is required - filter_id (
str
) – This will allow you to filter the rules by this node id
Return type: list
ofDimensionDataAntiAffinityRule
- network (
-
ex_list_customer_images
(location=None)[source]¶ Return a list of customer imported images
Parameters: location ( NodeLocation
orstr
) – The target locationReturn type: list
ofNodeImage
-
ex_list_nat_rules
(network_domain)[source]¶ Get NAT rules for the network domain
Parameters: network_domain ( DimensionDataNetworkDomain
) – The network domain the rules belongs toReturn type: list
ofDimensionDataNatRule
-
ex_list_network_domains
(location=None, name=None, service_plan=None, state=None)[source]¶ List networks domains deployed across all data center locations for your organization. The response includes the location of each network domain.
Parameters: - location (
NodeLocation
orstr
) – Only network domains in the location (optional) - name (
str
) – Only network domains of this name (optional) - service_plan (
str
) – Only network domains of this type (optional) - state (
str
) – Only network domains in this state (optional)
Returns: a list of DimensionDataNetwork objects
Return type: list
ofDimensionDataNetwork
- location (
-
ex_list_networks
(location=None)[source]¶ List networks deployed across all data center locations for your organization. The response includes the location of each network.
Parameters: location ( NodeLocation
orstr
) – The target locationReturns: a list of DimensionDataNetwork objects Return type: list
ofDimensionDataNetwork
-
ex_list_nodes_paginated
(name=None, location=None, ipv6=None, ipv4=None, vlan=None, image=None, deployed=None, started=None, state=None, network=None, network_domain=None)[source]¶ Return a generator which yields node lists in pages
Parameters: - location (
NodeLocation
orstr
) – Filters the node list to nodes that are located in this location - name – Filters the node list to nodes that have this name
:type name
str
Parameters: - ipv6 (
str
) – Filters the node list to nodes that have this ipv6 address - ipv4 (
str
) – Filters the node list to nodes that have this ipv4 address - vlan (
DimensionDataVlan
orstr
) – Filters the node list to nodes that are in this VLAN - image (
NodeImage
orstr
) – Filters the node list to nodes that have this image - deployed (
bool
) – Filters the node list to nodes that are deployed or not - started (
bool
) – Filters the node list to nodes that are started or not - state (
str
) – Filters the node list to nodes that are in this state - network (
DimensionDataNetwork
orstr
) – Filters the node list to nodes in this network - network_domain (
DimensionDataNetworkDomain
orstr
) – Filters the node list to nodes in this network domain
Returns: a list of Node objects
Return type: generator
of list ofNode
- location (
-
ex_list_tag_keys
(id=None, name=None, value_required=None, display_on_report=None)[source]¶ List tag keys in the Dimension Data Cloud
Parameters: - id (
str
) – Filter the list to the id of the tag key - name (
str
) – Filter the list to the name of the tag key - value_required (
bool
) – Filter the list to if a value is required for a tag key - display_on_report (
bool
) – Filter the list to if the tag key should show up on usage reports
Return type: list
ofDimensionDataTagKey
- id (
List tags in the Dimension Data Cloud
Parameters: - asset_id (
str
) – Filter the list by asset id - asset_type (
str
) – Filter the list by asset type - location (:class:
NodeLocation
orstr
) – Filter the list by the assets location - tag_key_name (
str
) – Filter the list by a tag key name - tag_key_id (
str
) – Filter the list by a tag key id - value (
str
) – Filter the list by a tag value - value_required (
bool
) – Filter the list to if a value is required for a tag - display_on_report (
bool
) – Filter the list to if the tag should show up on usage reports
Return type: list
ofDimensionDataTag
- asset_id (
-
ex_list_vlans
(location=None, network_domain=None, name=None, ipv4_address=None, ipv6_address=None, state=None)[source]¶ List VLANs available, can filter by location and/or network domain
Parameters: - location (
NodeLocation
orstr
) – Only VLANs in this location (optional) - network_domain (
DimensionDataNetworkDomain
) – Only VLANs in this domain (optional) - name (
str
) – Only VLANs with this name (optional) - ipv4_address (
str
) – Only VLANs with this ipv4 address (optional) - ipv6_address (
str
) – Only VLANs with this ipv6 address (optional) - state (
str
) – Only VLANs with this state (optional)
Returns: a list of DimensionDataVlan objects
Return type: list
ofDimensionDataVlan
- location (
-
ex_modify_tag_key
(tag_key, name=None, description=None, value_required=None, display_on_report=None)[source]¶ Modify a specific tag key
Parameters: - tag_key (
DimensionDataTagKey
orstr
) – The tag key you want to modify (required) - name (
str
) – Set to modifiy the name of the tag key - description (
str
) – Set to modify the description of the tag key - value_required (
bool
) – Set to modify if a value is required for the tag key - display_on_report (
bool
) – Set to modify if this tag key should display on the usage reports
Return type: bool
- tag_key (
-
ex_power_off
(node)[source]¶ This function will abruptly power-off a server. Unlike ex_shutdown_graceful, success ensures the node will stop but some OS and application configurations may be adversely affected by the equivalent of pulling the power plug out of the machine.
Parameters: node ( Node
) – Node which should be usedReturn type: bool
-
ex_reconfigure_node
(node, memory_gb, cpu_count, cores_per_socket, cpu_performance)[source]¶ Reconfigure the virtual hardware specification of a node
Parameters: - node (
Node
) – The server to change - memory_gb (
int
) – The amount of memory in GB (optional) - cpu_count (
int
) – The number of CPU (optional) - cores_per_socket (
int
) – Number of CPU cores per socket (optional) - cpu_performance (
str
) – CPU Performance type (optional)
Return type: bool
- node (
-
ex_remove_storage
(disk_id)[source]¶ Remove storage from a node
Parameters: - node (
Node
) – The server to add storage to - disk_id (
str
) – The ID of the disk to remove
Return type: bool
- node (
-
ex_remove_storage_from_node
(node, scsi_id)[source]¶ Remove storage from a node
Parameters: - node (
Node
) – The server to add storage to - scsi_id (
str
) – The ID of the disk to remove
Return type: bool
- node (
-
ex_remove_tag_from_asset
(asset, tag_key)[source]¶ Remove a tag from an asset
Parameters: - asset (
Node
orNodeImage
orDimensionDataNewtorkDomain
orDimensionDataVlan
orDimensionDataPublicIpBlock
) – The asset to remove a tag from. (required) - tag_key (
DimensionDataTagKey
orstr
) – The tag key you want to remove (required)
Return type: bool
- asset (
-
ex_remove_tag_key
(tag_key)[source]¶ Modify a specific tag key
Parameters: tag_key ( DimensionDataTagKey
orstr
) – The tag key you want to remove (required)Return type: bool
-
ex_rename_network
(network, new_name)[source]¶ Rename a network in MCP 1 data center
Parameters: - network (
DimensionDataNetwork
) – The network to rename - new_name (
str
) – The new name of the network
Return type: bool
- network (
-
ex_reset
(node)[source]¶ This function will abruptly reset a server. Unlike reboot_node, success ensures the node will restart but some OS and application configurations may be adversely affected by the equivalent of pulling the power plug out of the machine.
Parameters: node ( Node
) – Node which should be usedReturn type: bool
-
ex_set_firewall_rule_state
(rule, state)[source]¶ Change the state (enabled or disabled) of a rule
Parameters: - rule (
DimensionDataFirewallRule
) – The rule to delete - state (
bool
) – The desired state enabled (True) or disabled (False)
Return type: bool
- rule (
-
ex_shutdown_graceful
(node)[source]¶ This function will attempt to “gracefully” stop a server by initiating a shutdown sequence within the guest operating system. A successful response on this function means the system has successfully passed the request into the operating system.
Parameters: node ( Node
) – Node which should be usedReturn type: bool
-
ex_software_usage_report
(start_date, end_date)[source]¶ Get detailed software usage reports
Parameters: - start_date (
str
in format YYYY-MM-DD) – Start date for the report - end_date (
str
in format YYYY-MM-DD) – End date for the report
Return type: list
oflist
- start_date (
-
ex_start_node
(node)[source]¶ Powers on an existing deployed server
Parameters: node ( Node
) – Node which should be usedReturn type: bool
-
ex_summary_usage_report
(start_date, end_date)[source]¶ Get summary usage information
Parameters: - start_date (
str
in format YYYY-MM-DD) – Start date for the report - end_date (
str
in format YYYY-MM-DD) – End date for the report
Return type: list
oflist
- start_date (
-
ex_update_monitoring_plan
(node, service_plan='ESSENTIALS')[source]¶ Updates the service plan on a node with monitoring
Parameters: - node (
Node
) – The node to monitor - service_plan (
str
) – The service plan, one of ESSENTIALS or ADVANCED
Return type: bool
- node (
-
ex_update_network_domain
(network_domain)[source]¶ Update the properties of a network domain
Parameters: network_domain ( DimensionDataNetworkDomain
) – The network domain with updated propertiesReturns: an instance of DimensionDataNetworkDomain Return type: DimensionDataNetworkDomain
-
ex_update_node
(node, name=None, description=None, cpu_count=None, ram_mb=None)[source]¶ Update the node, the name, CPU or RAM
Parameters: - node (
Node
) – Node which should be used - name (
str
) – The new name (optional) - description (
str
) – The new description (optional) - cpu_count (
int
) – The new CPU count (optional) - ram_mb (
int
) – The new Memory in MB (optional)
Return type: bool
- node (
-
ex_update_vlan
(vlan)[source]¶ Updates the properties of the given VLAN Only name and description are updated
Parameters: vlan ( DimensionDataNetworkDomain
) – The VLAN to updateReturns: an instance of DimensionDataVlan Return type: DimensionDataVlan
-
ex_update_vm_tools
(node)[source]¶ This function triggers an update of the VMware Tools software running on the guest OS of a Server.
Parameters: node ( Node
) – Node which should be usedReturn type: bool
-
ex_wait_for_state
(state, func, poll_interval=2, timeout=60, *args, **kwargs)[source]¶ Wait for the function which returns a instance with field status to match
Keep polling func until one of the desired states is matched
Parameters: - state (
str
orlist
) – Either the desired state (str) or a list of states - func (
function
) – The function to call, e.g. ex_get_vlan - poll_interval (int) – The number of seconds to wait between checks
- timeout (int) – The total number of seconds to wait to reach a state
- args (Positional arguments) – The arguments for func
- kwargs (Keyword arguments) – The arguments for func
- state (
-
features
= {'create_node': ['password']}¶
-
list_images
(location=None)[source]¶ List images available
- Note: Currently only returns the default ‘base OS images’
- provided by DimensionData. Customer images (snapshots) are not yet supported.
Parameters: ex_location ( NodeLocation
orstr
) – Filters the node list to nodes that are located in this locationReturns: List of images available Return type: list
ofNodeImage
-
list_locations
(ex_id=None)[source]¶ List locations (datacenters) available for instantiating servers and networks.
Parameters: ex_id ( str
) – Filters the location list to this idReturns: List of locations Return type: list
ofNodeLocation
-
list_networks
(location=None)[source]¶ List networks deployed across all data center locations for your organization. The response includes the location of each network.
Parameters: location ( NodeLocation
orstr
) – The locationReturns: a list of DimensionDataNetwork objects Return type: list
ofDimensionDataNetwork
-
list_nodes
(ex_location=None, ex_name=None, ex_ipv6=None, ex_ipv4=None, ex_vlan=None, ex_image=None, ex_deployed=None, ex_started=None, ex_state=None, ex_network=None, ex_network_domain=None)[source]¶ List nodes deployed for your organization.
Parameters: - ex_location (
NodeLocation
orstr
) – Filters the node list to nodes that are located in this location - ex_name – Filters the node list to nodes that have this name
:type ex_name
str
Parameters: - ex_ipv6 (
str
) – Filters the node list to nodes that have this ipv6 address - ex_ipv4 (
str
) – Filters the node list to nodes that have this ipv4 address - ex_vlan (
DimensionDataVlan
orstr
) – Filters the node list to nodes that are in this VLAN - ex_image (
NodeImage
orstr
) – Filters the node list to nodes that have this image - ex_deployed (
bool
) – Filters the node list to nodes that are deployed or not - ex_started (
bool
) – Filters the node list to nodes that are started or not - ex_state (
str
) – Filters the node list by nodes that are in this state - ex_network (
DimensionDataNetwork
orstr
) – Filters the node list to nodes in this network - ex_network_domain (
DimensionDataNetworkDomain
orstr
) – Filters the node list to nodes in this network domain
Returns: a list of Node objects
Return type: list
ofNode
- ex_location (
-
list_sizes
(location=None)[source]¶ - return a list of available sizes
- Currently, the size of the node is dictated by the chosen OS base image, they cannot be set explicitly.
@inherits:
NodeDriver.list_sizes
-
name
= 'DimensionData'¶
-
reboot_node
(node)[source]¶ Reboots a node by requesting the OS restart via the hypervisor
Parameters: node ( Node
) – The node to rebootReturn type: bool
-
selected_region
= None¶
-
type
= 'dimensiondata'¶
-
website
= 'http://www.dimensiondata.com/'¶
-
libcloud.compute.drivers.dummy module¶
Dummy Driver
@note: This driver is out of date
-
class
libcloud.compute.drivers.dummy.
DummyConnection
(key, secure=True, host=None, port=None, url=None, timeout=None, proxy_url=None, backoff=None, retry_delay=None)[source]¶ Bases:
libcloud.common.base.ConnectionKey
Dummy connection class
Initialize user_id and key; set secure to an
int
based on passed value.
-
class
libcloud.compute.drivers.dummy.
DummyNodeDriver
(creds)[source]¶ Bases:
libcloud.compute.base.NodeDriver
Dummy node driver
This is a fake driver which appears to always create or destroy nodes successfully.
>>> from libcloud.compute.drivers.dummy import DummyNodeDriver >>> driver = DummyNodeDriver(0) >>> node=driver.create_node() >>> node.public_ips[0] '127.0.0.3' >>> node.name 'dummy-3'
If the credentials you give convert to an integer then the next node to be created will be one higher.
Each time you create a node you will get a different IP address.
>>> driver = DummyNodeDriver(22) >>> node=driver.create_node() >>> node.name 'dummy-23'
Parameters: creds ( str
) – CredentialsReturn type: None
-
create_node
(**kwargs)[source]¶ Creates a dummy node; the node id is equal to the number of nodes in the node list
>>> from libcloud.compute.drivers.dummy import DummyNodeDriver >>> driver = DummyNodeDriver(0) >>> sorted([node.name for node in driver.list_nodes()]) ['dummy-1', 'dummy-2'] >>> nodeA = driver.create_node() >>> sorted([node.name for node in driver.list_nodes()]) ['dummy-1', 'dummy-2', 'dummy-3'] >>> driver.create_node().name 'dummy-4' >>> driver.destroy_node(nodeA) True >>> sorted([node.name for node in driver.list_nodes()]) ['dummy-1', 'dummy-2', 'dummy-4']
@inherits:
NodeDriver.create_node
-
destroy_node
(node)[source]¶ Sets the node state to terminated and removes it from the node list
>>> from libcloud.compute.drivers.dummy import DummyNodeDriver >>> driver = DummyNodeDriver(0) >>> from libcloud.compute.types import NodeState >>> node = [node for node in driver.list_nodes() if ... node.name == 'dummy-1'][0] >>> node.state == NodeState.RUNNING True >>> driver.destroy_node(node) True >>> node.state == NodeState.RUNNING False >>> [n for n in driver.list_nodes() if n.name == 'dummy-1'] []
@inherits:
NodeDriver.destroy_node
-
list_images
(location=None)[source]¶ Returns a list of images as a cloud provider might have
>>> from libcloud.compute.drivers.dummy import DummyNodeDriver >>> driver = DummyNodeDriver(0) >>> sorted([image.name for image in driver.list_images()]) ['Slackware 4', 'Ubuntu 9.04', 'Ubuntu 9.10']
@inherits:
NodeDriver.list_images
-
list_locations
()[source]¶ Returns a list of locations of nodes
>>> from libcloud.compute.drivers.dummy import DummyNodeDriver >>> driver = DummyNodeDriver(0) >>> sorted([loc.name + " in " + loc.country for loc in ... driver.list_locations()]) ['Island Datacenter in FJ', 'London Loft in GB', "Paul's Room in US"]
@inherits:
NodeDriver.list_locations
-
list_nodes
()[source]¶ List the nodes known to a particular driver; There are two default nodes created at the beginning
>>> from libcloud.compute.drivers.dummy import DummyNodeDriver >>> driver = DummyNodeDriver(0) >>> node_list=driver.list_nodes() >>> sorted([node.name for node in node_list ]) ['dummy-1', 'dummy-2']
each item in the list returned is a node object from which you can carry out any node actions you wish
>>> node_list[0].reboot() True
As more nodes are added, list_nodes will return them
>>> node=driver.create_node() >>> node.size.id 's1' >>> node.image.id 'i2' >>> sorted([n.name for n in driver.list_nodes()]) ['dummy-1', 'dummy-2', 'dummy-3']
@inherits:
NodeDriver.list_nodes
-
list_sizes
(location=None)[source]¶ Returns a list of node sizes as a cloud provider might have
>>> from libcloud.compute.drivers.dummy import DummyNodeDriver >>> driver = DummyNodeDriver(0) >>> sorted([size.ram for size in driver.list_sizes()]) [128, 512, 4096, 8192]
@inherits:
NodeDriver.list_images
-
name
= 'Dummy Node Provider'¶
-
reboot_node
(node)[source]¶ Sets the node state to rebooting; in this dummy driver always returns True as if the reboot had been successful.
>>> from libcloud.compute.drivers.dummy import DummyNodeDriver >>> driver = DummyNodeDriver(0) >>> node=driver.create_node() >>> from libcloud.compute.types import NodeState >>> node.state == NodeState.RUNNING True >>> node.state == NodeState.REBOOTING False >>> driver.reboot_node(node) True >>> node.state == NodeState.REBOOTING True
Please note, dummy nodes never recover from the reboot.
@inherits:
NodeDriver.reboot_node
-
type
= 'dummy'¶
-
website
= 'http://example.com'¶
-
libcloud.compute.drivers.ec2 module¶
Amazon EC2, Eucalyptus, Nimbus and Outscale drivers.
-
libcloud.compute.drivers.ec2.
OUTSCALE_INSTANCE_TYPES
= {'os1.4xlarge': {'disk': 120, 'bandwidth': None, 'ram': 131072, 'id': 'os1.4xlarge', 'name': 'Memory Optimized, High Storage, Passthrough NIC Quadruple Extra Large Instance'}, 'nv1.large': {'disk': 840, 'bandwidth': None, 'ram': 7679, 'id': 'nv1.large', 'name': 'GPU Large Instance'}, 'oc2.8xlarge': {'disk': 3360, 'bandwidth': None, 'ram': 65535, 'id': 'oc2.8xlarge', 'name': 'Outscale Eight Extra Large Instance'}, 'os1.2xlarge': {'disk': 60, 'bandwidth': None, 'ram': 65536, 'id': 'os1.2xlarge', 'name': 'Memory Optimized, High Storage, Passthrough NIC Double Extra Large Instance'}, 'os1.8xlarge': {'disk': 500, 'bandwidth': None, 'ram': 249856, 'id': 'os1.8xlarge', 'name': 'Memory Optimized, High Storage, Passthrough NIC Eight Extra Large Instance'}, 'c1.xlarge': {'disk': 1680, 'bandwidth': None, 'ram': 7168, 'id': 'c1.xlarge', 'name': 'Compute Optimized Extra Large Instance'}, 'nv1.medium': {'disk': 420, 'bandwidth': None, 'ram': 3839, 'id': 'nv1.medium', 'name': 'GPU Medium Instance'}, 'nv1.small': {'disk': 150, 'bandwidth': None, 'ram': 1739, 'id': 'nv1.small', 'name': 'GPU Small Instance'}, 'g2.2xlarge': {'disk': 60, 'bandwidth': None, 'ram': 15360, 'id': 'g2.2xlarge', 'name': 'GPU Double Extra Large Instance'}, 'm1.small': {'disk': 150, 'bandwidth': None, 'ram': 1740, 'id': 'm1.small', 'name': 'Standard Small Instance'}, 'c1.medium': {'disk': 340, 'bandwidth': None, 'ram': 1740, 'id': 'c1.medium', 'name': 'Compute Optimized Medium Instance'}, 'm3.2xlarge': {'disk': 0, 'bandwidth': None, 'ram': 30720, 'id': 'm3.2xlarge', 'name': 'High Storage Optimized Double Extra Large Instance'}, 'm3s.2xlarge': {'disk': 0, 'bandwidth': None, 'ram': 30719, 'id': 'm3s.2xlarge', 'name': 'High Storage Optimized Double Extra Large Instance'}, 'm2.xlarge': {'disk': 420, 'bandwidth': None, 'ram': 17510, 'id': 'm2.xlarge', 'name': 'High Memory Extra Large Instance'}, 't1.micro': {'disk': 0, 'bandwidth': None, 'ram': 615, 'id': 't1.micro', 'name': 'Micro Instance'}, 'cr1.8xlarge': {'disk': 240, 'bandwidth': None, 'ram': 249855, 'id': 'cr1.8xlarge', 'name': 'Memory Optimized Eight Extra Large Instance'}, 'c3.large': {'disk': 32, 'bandwidth': None, 'ram': 3840, 'id': 'c3.large', 'name': 'Compute Optimized Large Instance'}, 'cc1.4xlarge': {'disk': 1680, 'bandwidth': None, 'ram': 24576, 'id': 'cc1.4xlarge', 'name': 'Cluster Compute Quadruple Extra Large Instance'}, 'm1.medium': {'disk': 420, 'bandwidth': None, 'ram': 3840, 'id': 'm1.medium', 'name': 'Standard Medium Instance'}, 'oc1.4xlarge': {'disk': 1680, 'bandwidth': None, 'ram': 24575, 'id': 'oc1.4xlarge', 'name': 'Outscale Quadruple Extra Large Instance'}, 'c3.xlarge': {'disk': 80, 'bandwidth': None, 'ram': 7168, 'id': 'c3.xlarge', 'name': 'Compute Optimized Extra Large Instance'}, 'c3.8xlarge': {'disk': 640, 'bandwidth': None, 'ram': 61440, 'id': 'c3.8xlarge', 'name': 'Compute Optimized Eight Extra Large Instance'}, 'm1.large': {'disk': 840, 'bandwidth': None, 'ram': 7680, 'id': 'm1.large', 'name': 'Standard Large Instance'}, 'c3.2xlarge': {'disk': 160, 'bandwidth': None, 'ram': 15359, 'id': 'c3.2xlarge', 'name': 'Compute Optimized Double Extra Large Instance'}, 'm3s.xlarge': {'disk': 0, 'bandwidth': None, 'ram': 15359, 'id': 'm3s.xlarge', 'name': 'High Storage Optimized Extra Large Instance'}, 'cc2.8xlarge': {'disk': 3360, 'bandwidth': None, 'ram': 65536, 'id': 'cc2.8xlarge', 'name': 'Cluster Compute Eight Extra Large Instance'}, 'nv1.xlarge': {'disk': 1680, 'bandwidth': None, 'ram': 15358, 'id': 'nv1.xlarge', 'name': 'GPU Extra Large Instance'}, 'c3.4xlarge': {'disk': 320, 'bandwidth': None, 'ram': 30720, 'id': 'c3.4xlarge', 'name': 'Compute Optimized Quadruple Extra Large Instance'}, 'm1.xlarge': {'disk': 1680, 'bandwidth': None, 'ram': 15360, 'id': 'm1.xlarge', 'name': 'Standard Extra Large Instance'}, 'm2.4xlarge': {'disk': 1680, 'bandwidth': None, 'ram': 70042, 'id': 'm2.4xlarge', 'name': 'High Memory Quadruple Extra Large Instance'}, 'm2.2xlarge': {'disk': 840, 'bandwidth': None, 'ram': 35020, 'id': 'm2.2xlarge', 'name': 'High Memory Double Extra Large Instance'}, 'm3.xlarge': {'disk': 0, 'bandwidth': None, 'ram': 15357, 'id': 'm3.xlarge', 'name': 'High Storage Optimized Extra Large Instance'}, 'hi1.xlarge': {'disk': 1680, 'bandwidth': None, 'ram': 15361, 'id': 'hi1.xlarge', 'name': 'High Storage Extra Large Instance'}}¶ The function manipulating Outscale cloud regions will be overridden because Outscale instances types are in a separate dict so also declare Outscale cloud regions in some other constants.
-
libcloud.compute.drivers.ec2.
OUTSCALE_INC_REGION_DETAILS
= {'us-east-1': {'country': 'USA', 'api_name': 'osc_inc_us_east_1', 'endpoint': 'api.us-east-1.outscale.com', 'instance_types': ['t1.micro', 'm1.small', 'm1.medium', 'm1.large', 'm1.xlarge', 'c1.medium', 'c1.xlarge', 'm2.xlarge', 'm2.2xlarge', 'm2.4xlarge', 'nv1.small', 'nv1.medium', 'nv1.large', 'nv1.xlarge', 'cc1.4xlarge', 'cc2.8xlarge', 'm3.xlarge', 'm3.2xlarge', 'cr1.8xlarge', 'os1.8xlarge']}, 'us-east-2': {'country': 'USA', 'api_name': 'osc_inc_us_east_2', 'endpoint': 'fcu.us-east-2.outscale.com', 'instance_types': ['t1.micro', 'm1.small', 'm1.medium', 'm1.large', 'm1.xlarge', 'c1.medium', 'c1.xlarge', 'm2.xlarge', 'm2.2xlarge', 'm2.4xlarge', 'nv1.small', 'nv1.medium', 'nv1.large', 'nv1.xlarge', 'cc1.4xlarge', 'cc2.8xlarge', 'm3.xlarge', 'm3.2xlarge', 'cr1.8xlarge', 'os1.8xlarge']}, 'eu-west-1': {'country': 'FRANCE', 'api_name': 'osc_inc_eu_west_1', 'endpoint': 'api.eu-west-1.outscale.com', 'instance_types': ['t1.micro', 'm1.small', 'm1.medium', 'm1.large', 'm1.xlarge', 'c1.medium', 'c1.xlarge', 'm2.xlarge', 'm2.2xlarge', 'm2.4xlarge', 'nv1.small', 'nv1.medium', 'nv1.large', 'nv1.xlarge', 'cc1.4xlarge', 'cc2.8xlarge', 'm3.xlarge', 'm3.2xlarge', 'cr1.8xlarge', 'os1.8xlarge']}, 'eu-west-2': {'country': 'FRANCE', 'api_name': 'osc_inc_eu_west_2', 'endpoint': 'fcu.eu-west-2.outscale.com', 'instance_types': ['t1.micro', 'm1.small', 'm1.medium', 'm1.large', 'm1.xlarge', 'c1.medium', 'c1.xlarge', 'm2.xlarge', 'm2.2xlarge', 'm2.4xlarge', 'nv1.small', 'nv1.medium', 'nv1.large', 'nv1.xlarge', 'cc1.4xlarge', 'cc2.8xlarge', 'm3.xlarge', 'm3.2xlarge', 'cr1.8xlarge', 'os1.8xlarge']}, 'eu-west-3': {'country': 'FRANCE', 'api_name': 'osc_inc_eu_west_3', 'endpoint': 'api-ppd.outscale.com', 'instance_types': ['t1.micro', 'm1.small', 'm1.medium', 'm1.large', 'm1.xlarge', 'c1.medium', 'c1.xlarge', 'm2.xlarge', 'm2.2xlarge', 'm2.4xlarge', 'nv1.small', 'nv1.medium', 'nv1.large', 'nv1.xlarge', 'cc1.4xlarge', 'cc2.8xlarge', 'm3.xlarge', 'm3.2xlarge', 'cr1.8xlarge', 'os1.8xlarge']}}¶ Define the extra dictionary for specific resources
-
libcloud.compute.drivers.ec2.
EUCA_NAMESPACE
= 'http://msgs.eucalyptus.com/3.3.0'¶ Sizes must be hardcoded, because Amazon doesn’t provide an API to fetch them. From http://aws.amazon.com/ec2/instance-types/ and <http://aws.amazon.com/ec2/previous-generation/> ram = [MiB], disk = [GB]
-
class
libcloud.compute.drivers.ec2.
EC2NodeDriver
(key, secret=None, secure=True, host=None, port=None, region='us-east-1', token=None, **kwargs)[source]¶ Bases:
libcloud.compute.drivers.ec2.BaseEC2NodeDriver
Amazon EC2 node driver.
-
NODE_STATE_MAP
= {'terminated': 'terminated', 'running': 'running', 'stopped': 'stopped', 'shutting-down': 'unknown', 'pending': 'pending'}¶
-
connectionCls
¶ alias of
EC2Connection
-
name
= 'Amazon EC2'¶
-
path
= '/'¶
-
type
= 'ec2'¶
-
website
= 'http://aws.amazon.com/ec2/'¶
-
-
class
libcloud.compute.drivers.ec2.
BaseEC2NodeDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region=None, **kwargs)[source]¶ Bases:
libcloud.compute.base.NodeDriver
Base Amazon EC2 node driver.
Used for main EC2 and other derivate driver classes to inherit from it.
Parameters: - key (
str
) – API key or username to be used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections. - api_version (
str
) – Optional API version. Only used by drivers which support multiple API versions. - region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
Return type: None
-
NODE_STATE_MAP
= {'terminated': 'terminated', 'running': 'running', 'shutting-down': 'unknown', 'pending': 'pending'}¶
-
SNAPSHOT_STATE_MAP
= {'completed': 'available', 'pending': 'creating', 'error': 'error'}¶
-
VOLUME_STATE_MAP
= {'available': 'available', 'creating': 'creating', 'deleted': 'deleted', 'in-use': 'inuse', 'error_deleting': 'error', 'error': 'error', 'deleting': 'deleting'}¶
-
connectionCls
¶ alias of
EC2Connection
-
copy_image
(image, source_region, name=None, description=None)[source]¶ Copy an Amazon Machine Image from the specified source region to the current region.
@inherits:
NodeDriver.copy_image
Parameters: - source_region (
str
) – The region where the image resides - image (
NodeImage
) – Instance of class NodeImage - name (
str
) – The name of the new image - description (
str
) – The description of the new image
Returns: Instance of class
NodeImage
Return type: NodeImage
- source_region (
-
create_image
(node, name, description=None, reboot=False, block_device_mapping=None)[source]¶ Create an Amazon Machine Image based off of an EBS-backed instance.
@inherits:
NodeDriver.create_image
Parameters: - node – Instance of
Node
- name (
str
) – The name for the new image - block_device_mapping (
list
ofdict
) – A dictionary of the disk layout An example of this dict is included below. - reboot (
bool
) – Whether or not to shutdown the instance before creation. Amazon calls this NoReboot and sets it to false by default to ensure a clean image. - description (
str
) – An optional description for the new image
An example block device mapping dictionary is included:
- mapping = [{‘VirtualName’: None,
- ‘Ebs’: {‘VolumeSize’: 10,
- ‘VolumeType’: ‘standard’, ‘DeleteOnTermination’: ‘true’}, ‘DeviceName’: ‘/dev/sda1’}]
Returns: Instance of class NodeImage
Return type: NodeImage
- node – Instance of
-
create_node
(**kwargs)[source]¶ Create a new EC2 node.
Reference: http://bit.ly/8ZyPSy [docs.amazonwebservices.com]
@inherits:
NodeDriver.create_node
Parameters: - ex_keyname (
str
) – The name of the key pair - ex_userdata (
str
) – User data - ex_security_groups (
list
) – A list of names of security groups to assign to the node. - ex_security_group_ids (
list
) – A list of ids of security groups to assign to the node.[for VPC nodes only] - ex_metadata (
dict
) – Key/Value metadata to associate with a node - ex_mincount (
int
) – Minimum number of instances to launch - ex_maxcount (
int
) – Maximum number of instances to launch - ex_clienttoken (
str
) – Unique identifier to ensure idempotency - ex_blockdevicemappings (
list
ofdict
) –list
ofdict
block device mappings. - ex_iamprofile (
str
) – Name or ARN of IAM profile - ex_ebs_optimized (
bool
) – EBS-Optimized if True - ex_subnet (
EC2Subnet
) – The subnet to launch the instance into. - ex_placement_group (
str
) – The name of the placement group to launch the instance into. - ex_assign_public_ip (
bool
) – If True, the instance will be assigned a public ip address. Note : It takes takes a short while for the instance to be assigned the public ip so the node returned will NOT have the public ip assigned yet. - ex_terminate_on_shutdown (
bool
) – Indicates if the instance should be terminated instead of just shut down when using the operating systems command for system shutdown.
- ex_keyname (
-
create_volume
(size, name, location=None, snapshot=None, ex_volume_type='standard', ex_iops=None, ex_encrypted=None, ex_kms_key_id=None)[source]¶ Create a new volume.
Parameters: - size (
int
) – Size of volume in gigabytes (required) - name (
str
) – Name of the volume to be created - location (
ExEC2AvailabilityZone
) – Which data center to create a volume in. If empty, undefined behavior will be selected. (optional) - snapshot (
VolumeSnapshot
) – Snapshot from which to create the new volume. (optional) - location – Datacenter in which to create a volume in.
- ex_volume_type (
str
) – Type of volume to create. - iops (
int
) – The number of I/O operations per second (IOPS) that the volume supports. Only used if ex_volume_type is io1. - ex_encrypted (
bool
) – Specifies whether the volume should be encrypted. - ex_kms_key_id (
str
) – The full ARN of the AWS Key Management Service (AWS KMS) customer master key (CMK) to use when creating the encrypted volume. Example: arn:aws:kms:us-east-1:012345678910:key/abcd1234-a123 -456a-a12b-a123b4cd56ef. Only used if encrypted is set to True.
Returns: The newly created volume.
Return type: StorageVolume
- size (
-
create_volume_snapshot
(volume, name=None)[source]¶ Create snapshot from volume
Parameters: - volume (
StorageVolume
) – Instance ofStorageVolume
- name (
str
) – Name of snapshot (optional)
Return type: VolumeSnapshot
- volume (
-
delete_image
(image)[source]¶ Deletes an image at Amazon given a NodeImage object
@inherits:
NodeDriver.delete_image
Parameters: image – Instance of NodeImage
Return type: bool
-
ex_allocate_address
(domain='standard')[source]¶ Allocate a new Elastic IP address for EC2 classic or VPC
Parameters: domain ( str
) – The domain to allocate the new address in (standard/vpc)Returns: Instance of ElasticIP Return type: ElasticIP
-
ex_associate_address_with_node
(node, elastic_ip, domain=None)[source]¶ Associate an Elastic IP address with a particular node.
Parameters: - node (
Node
) – Node instance - elastic_ip (
ElasticIP
) – Elastic IP instance - domain (
str
) – The domain where the IP resides (vpc only)
Returns: A string representation of the association ID which is required for VPC disassociation. EC2/standard addresses return None
Return type: None
orstr
- node (
-
ex_associate_addresses
(node, elastic_ip, domain=None)[source]¶ Note: This method has been deprecated in favor of the ex_associate_address_with_node method.
-
ex_associate_route_table
(route_table, subnet)[source]¶ Associates a route table with a subnet within a VPC.
Note: A route table can be associated with multiple subnets.
Parameters: - route_table (
EC2RouteTable
) – The route table to associate. - subnet (
EC2Subnet
) – The subnet to associate with.
Returns: Route table association ID.
Return type: str
- route_table (
-
ex_attach_internet_gateway
(gateway, network)[source]¶ Attach an Internet gateway to a VPC
Parameters: - gateway (
VPCInternetGateway
) – The gateway to attach - network (
EC2Network
) – The VPC network to attach to
Return type: bool
- gateway (
-
ex_attach_network_interface_to_node
(network_interface, node, device_index)[source]¶ Attach a network interface to an instance.
Parameters: - network_interface (
EC2NetworkInterface
) – EC2NetworkInterface instance - node (
Node
) – Node instance - device_index (
int
) – The interface device index
Returns: String representation of the attachment id. This is required to detach the interface.
Return type: str
- network_interface (
Edit a Security Group to allow specific traffic.
@note: This is a non-standard extension API, and only works for EC2.
Parameters: - name (
str
) – The name of the security group to edit - from_port (
str
) – The beginning of the port range to open - to_port (
str
) – The end of the port range to open - cidr_ip (
str
) – The ip to allow traffic for. - protocol (
str
) – tcp/udp/icmp
Return type: bool
- name (
Edit a Security Group to allow specific egress traffic using CIDR blocks or either a group ID, group name or user ID (account). This call is not supported for EC2 classic and only works for VPC groups.
Parameters: - id (
str
) – The id of the security group to edit - from_port (
int
) – The beginning of the port range to open - to_port (
int
) – The end of the port range to open - cidr_ips (
list
) – The list of ip ranges to allow traffic for. - group_pairs (
list
ofdict
) –Source user/group pairs to allow traffic for. More info can be found at http://goo.gl/stBHJF
EC2 Classic Example: To allow access from any system associated with the default group on account 1234567890
[{‘group_name’: ‘default’, ‘user_id’: ‘1234567890’}]
VPC Example: Allow access from any system associated with security group sg-47ad482e on your own account
[{‘group_id’: ‘ sg-47ad482e’}]
- protocol (
str
) – tcp/udp/icmp
Return type: bool
- id (
Edit a Security Group to allow specific ingress traffic using CIDR blocks or either a group ID, group name or user ID (account).
Parameters: - id (
str
) – The id of the security group to edit - from_port (
int
) – The beginning of the port range to open - to_port (
int
) – The end of the port range to open - cidr_ips (
list
) – The list of ip ranges to allow traffic for. - group_pairs (
list
ofdict
) –Source user/group pairs to allow traffic for. More info can be found at http://goo.gl/stBHJF
EC2 Classic Example: To allow access from any system associated with the default group on account 1234567890
[{‘group_name’: ‘default’, ‘user_id’: ‘1234567890’}]
VPC Example: Allow access from any system associated with security group sg-47ad482e on your own account
[{‘group_id’: ‘ sg-47ad482e’}]
- protocol (
str
) – tcp/udp/icmp
Return type: bool
- id (
Edit a Security Group to allow all traffic.
@note: This is a non-standard extension API, and only works for EC2.
Parameters: name ( str
) – The name of the security group to editReturn type: list
ofstr
-
ex_change_node_size
(node, new_size)[source]¶ Change the node size. Note: Node must be turned of before changing the size.
Parameters: - node (
Node
) – Node instance - new_size (
NodeSize
) – NodeSize instance
Returns: True on success, False otherwise.
Return type: bool
- node (
-
ex_create_keypair
(name)[source]¶ Creates a new keypair
@note: This is a non-standard extension API, and only works for EC2.
Parameters: name ( str
) – The name of the keypair to Create. This must be unique, otherwise an InvalidKeyPair.Duplicate exception is raised.Return type: dict
-
ex_create_network
(cidr_block, name=None, instance_tenancy='default')[source]¶ Create a network/VPC
Parameters: - cidr_block (
str
) – The CIDR block assigned to the network - name (
str
) – An optional name for the network - instance_tenancy (
str
) – The allowed tenancy of instances launched into the VPC. Valid values: default/dedicated
Returns: Dictionary of network properties
Return type: dict
- cidr_block (
-
ex_create_network_interface
(subnet, name=None, description=None, private_ip_address=None)[source]¶ Create a network interface within a VPC subnet.
Parameters: - subnet (
EC2NetworkSubnet
) – EC2NetworkSubnet instance - name (
str
) – Optional name of the interface - description (
str
) – Optional description of the network interface - private_ip_address (
str
) – Optional address to assign as the primary private IP address of the interface. If one is not provided then Amazon will automatically auto-assign an available IP. EC2 allows assignment of multiple IPs, but this will be the primary.
Returns: EC2NetworkInterface instance
Return type: :class EC2NetworkInterface
- subnet (
-
ex_create_placement_group
(name)[source]¶ Creates new Placement Group
Parameters: name ( str
) – Name for new placement GroupReturn type: bool
-
ex_create_route
(route_table, cidr, internet_gateway=None, node=None, network_interface=None, vpc_peering_connection=None)[source]¶ Creates a route entry in the route table.
Parameters: - route_table (
EC2RouteTable
) – The route table to create the route in. - cidr (
str
) – The CIDR block used for the destination match. - internet_gateway (
VPCInternetGateway
) – The internet gateway to route traffic through. - node (
Node
) – The NAT instance to route traffic through. - network_interface (
EC2NetworkInterface
) – The network interface of the node to route traffic through. - vpc_peering_connection (
VPCPeeringConnection
) – The VPC peering connection.
Return type: bool
- Note: You must specify one of the following: internet_gateway,
- node, network_interface, vpc_peering_connection.
- route_table (
-
ex_create_route_table
(network, name=None)[source]¶ Create a route table within a VPC.
Parameters: vpc_id ( EC2Network
) – The VPC that the subnet should be created in.Return type: class: .EC2RouteTable
-
ex_create_security_group
(name, description, vpc_id=None)[source]¶ Creates a new Security Group in EC2-Classic or a targeted VPC.
Parameters: - name (
str
) – The name of the security group to Create. This must be unique. - description (
str
) – Human readable description of a Security Group. - vpc_id (
str
) – Optional identifier for VPC networks
Return type: dict
- name (
-
ex_create_subnet
(vpc_id, cidr_block, availability_zone, name=None)[source]¶ Create a network subnet within a VPC
Parameters: - vpc_id (
str
) – The ID of the VPC that the subnet should be associated with - cidr_block (
str
) – The CIDR block assigned to the subnet - availability_zone (
str
) – The availability zone where the subnet should reside - name (
str
) – An optional name for the network
Return type: class: EC2NetworkSubnet - vpc_id (
Create tags for a resource (Node or StorageVolume).
Parameters: - resource (
Node
orStorageVolume
orVolumeSnapshot
) – Resource to be tagged - tags (
dict
) – A dictionary or other mapping of strings to strings, associating tag names with tag values.
Return type: bool
- resource (
-
ex_delete_internet_gateway
(gateway)[source]¶ Delete a VPC Internet gateway
Parameters: gateway ( VPCInternetGateway
) – The gateway to deleteReturn type: bool
-
ex_delete_keypair
(keypair)[source]¶ Delete a key pair by name.
@note: This is a non-standard extension API, and only works with EC2.
Parameters: keypair ( str
) – The name of the keypair to delete.Return type: bool
-
ex_delete_network
(vpc)[source]¶ Deletes a network/VPC.
Parameters: vpc ( EC2Network
) – VPC to delete.Return type: bool
-
ex_delete_network_interface
(network_interface)[source]¶ Deletes a network interface.
Parameters: network_interface ( EC2NetworkInterface
) – EC2NetworkInterface instanceReturn type: bool
-
ex_delete_placement_group
(name)[source]¶ Deletes Placement Group
Parameters: name ( str
) – Placement Group nameReturn type: bool
-
ex_delete_route
(route_table, cidr)[source]¶ Deletes a route entry from the route table.
Parameters: - route_table (
EC2RouteTable
) – The route table to delete the route from. - cidr (
str
) – The CIDR block used for the destination match.
Return type: bool
- route_table (
-
ex_delete_route_table
(route_table)[source]¶ Deletes a VPC route table.
Parameters: route_table ( EC2RouteTable
) – The route table to delete.Return type: bool
-
ex_delete_security_group
(name)[source]¶ Wrapper method which calls ex_delete_security_group_by_name.
Parameters: name ( str
) – The name of the security groupReturn type: bool
-
ex_delete_security_group_by_id
(group_id)[source]¶ Deletes a new Security Group using the group id.
Parameters: group_id ( str
) – The ID of the security groupReturn type: bool
-
ex_delete_security_group_by_name
(group_name)[source]¶ Deletes a new Security Group using the group name.
Parameters: group_name ( str
) – The name of the security groupReturn type: bool
-
ex_delete_subnet
(subnet)[source]¶ Deletes a VPC subnet.
Parameters: subnet ( EC2NetworkSubnet
) – The subnet to deleteReturn type: bool
Delete tags from a resource.
Parameters: - resource (
Node
orStorageVolume
) – Resource to be tagged - tags (
dict
) – A dictionary or other mapping of strings to strings, specifying the tag names and tag values to be deleted.
Return type: bool
- resource (
-
ex_describe_addresses
(nodes)[source]¶ Return Elastic IP addresses for all the nodes in the provided list.
Parameters: nodes ( list
ofNode
) – List ofNode
instancesReturns: Dictionary where a key is a node ID and the value is a list with the Elastic IP addresses associated with this node. Return type: dict
-
ex_describe_addresses_for_node
(node)[source]¶ Return a list of Elastic IP addresses associated with this node.
Parameters: node ( Node
) – Node instanceReturns: list Elastic IP addresses attached to this node. Return type: list
ofstr
-
ex_describe_all_addresses
(only_associated=False)[source]¶ Return all the Elastic IP addresses for this account optionally, return only addresses associated with nodes
Parameters: only_associated ( bool
) – If true, return only those addresses that are associated with an instance.Returns: List of ElasticIP instances. Return type: list
ofElasticIP
-
ex_describe_all_keypairs
()[source]¶ Return names for all the available key pairs.
@note: This is a non-standard extension API, and only works for EC2.
Return type: list
ofstr
-
ex_describe_keypair
(name)[source]¶ Describes a keypair by name.
@note: This is a non-standard extension API, and only works for EC2.
Parameters: name ( str
) – The name of the keypair to describe.Return type: dict
Return a dictionary of tags for a resource (e.g. Node or StorageVolume).
Parameters: resource (any resource class, such as Node,
StorageVolume,
or :class:NodeImage`) – resource which should be usedReturns: dict Node tags Return type: dict
-
ex_detach_internet_gateway
(gateway, network)[source]¶ Detach an Internet gateway from a VPC
Parameters: - gateway (
VPCInternetGateway
) – The gateway to detach - network (
EC2Network
) – The VPC network to detach from
Return type: bool
- gateway (
-
ex_detach_network_interface
(attachment_id, force=False)[source]¶ Detach a network interface from an instance.
Parameters: - attachment_id (
str
) – The attachment ID associated with the interface - force (
bool
) – Forces the detachment.
Returns: True
on successful detachment,False
otherwise.Return type: bool
- attachment_id (
-
ex_disassociate_address
(elastic_ip, domain=None)[source]¶ Disassociate an Elastic IP address using the IP (EC2-Classic) or the association ID (VPC)
Parameters: - elastic_ip (
ElasticIP
) – ElasticIP instance - domain (
str
) – The domain where the IP resides (vpc only)
Returns: True on success, False otherwise.
Return type: bool
- elastic_ip (
-
ex_dissociate_route_table
(subnet_association)[source]¶ Dissociates a subnet from a route table.
Parameters: subnet_association ( EC2SubnetAssociation
orstr
) – The subnet association object or subnet association ID.Return type: bool
-
ex_find_or_import_keypair_by_key_material
(pubkey)[source]¶ Given a public key, look it up in the EC2 KeyPair database. If it exists, return any information we have about it. Otherwise, create it.
Keys that are created are named based on their comment and fingerprint.
Return type: dict
-
ex_get_console_output
(node)[source]¶ Get console output for the node.
Parameters: node ( Node
) – Node which should be usedReturns: Dictionary with the following keys: - instance_id ( str
) - timestamp (datetime.datetime
) - ts of the last output - output (str
) - console outputReturn type: dict
-
ex_get_metadata_for_node
(node)[source]¶ Return the metadata associated with the node.
Parameters: node ( Node
) – Node instanceReturns: A dictionary or other mapping of strings to strings, associating tag names with tag values. Rtype tags: dict
-
ex_get_security_groups
(group_ids=None, group_names=None, filters=None)[source]¶ Return a list of
EC2SecurityGroup
objects for the current region.Parameters: - group_ids (
list
) – Return only groups matching the provided group IDs. - group_names – Return only groups matching the provided group names.
- filters (
dict
) – The filters so that the response includes information for only specific security groups.
Return type: list
ofEC2SecurityGroup
- group_ids (
-
ex_import_keypair
(name, keyfile)[source]¶ imports a new public key where the public key is passed via a filename
@note: This is a non-standard extension API, and only works for EC2.
Parameters: - name (
str
) – The name of the public key to import. This must be unique, otherwise an InvalidKeyPair.Duplicate exception is raised. - keyfile (
str
) – The filename with path of the public key to import.
Return type: dict
- name (
-
ex_import_keypair_from_string
(name, key_material)[source]¶ imports a new public key where the public key is passed in as a string
@note: This is a non-standard extension API, and only works for EC2.
Parameters: - name (
str
) – The name of the public key to import. This must be unique, otherwise an InvalidKeyPair.Duplicate exception is raised. - key_material (
str
) – The contents of a public key file.
Return type: dict
- name (
-
ex_list_availability_zones
(only_available=True)[source]¶ Return a list of
ExEC2AvailabilityZone
objects for the current region.Note: This is an extension method and is only available for EC2 driver.
Parameters: only_available ( str
) – If true, return only availability zones with state ‘available’Return type: list
ofExEC2AvailabilityZone
-
ex_list_internet_gateways
(gateway_ids=None, filters=None)[source]¶ Describes available Internet gateways and whether or not they are attached to a VPC. These are required for VPC nodes to communicate over the Internet.
Parameters: - gateway_ids (
list
) – Return only internet gateways matching the provided internet gateway IDs. If not specified, a list of all the internet gateways in the corresponding region is returned. - filters (
dict
) – The filters so that the response includes information for only certain gateways.
Return type: list
ofVPCInternetGateway
- gateway_ids (
-
ex_list_network_interfaces
()[source]¶ Return all network interfaces
Returns: List of EC2NetworkInterface instances Return type: list
of :class EC2NetworkInterface
-
ex_list_networks
(network_ids=None, filters=None)[source]¶ Return a list of
EC2Network
objects for the current region.Parameters: - network_ids (
list
) – Return only networks matching the provided network IDs. If not specified, a list of all the networks in the corresponding region is returned. - filters (
dict
) – The filters so that the response includes information for only certain networks.
Return type: list
ofEC2Network
- network_ids (
-
ex_list_placement_groups
(names=None)[source]¶ List Placement Groups
Parameters: names ( list
ofstr
) – Placement Group namesReturn type: list
ofEC2PlacementGroup
-
ex_list_reserved_nodes
()[source]¶ List all reserved instances/nodes which can be purchased from Amazon for one or three year terms. Reservations are made at a region level and reduce the hourly charge for instances.
More information can be found at http://goo.gl/ulXCC7.
Return type: list
ofEC2ReservedNode
-
ex_list_route_tables
(route_table_ids=None, filters=None)[source]¶ Describes one or more of a VPC’s route tables. These are used to determine where network traffic is directed.
Parameters: - route_table_ids (
list
) – Return only route tables matching the provided route table IDs. If not specified, a list of all the route tables in the corresponding region is returned. - filters (
dict
) – The filters so that the response includes information for only certain route tables.
Return type: list
ofEC2RouteTable
- route_table_ids (
-
ex_list_security_groups
()[source]¶ List existing Security Groups.
@note: This is a non-standard extension API, and only works for EC2.
Return type: list
ofstr
-
ex_list_subnets
(subnet_ids=None, filters=None)[source]¶ Return a list of
EC2NetworkSubnet
objects for the current region.Parameters: - subnet_ids (
list
) – Return only subnets matching the provided subnet IDs. If not specified, a list of all the subnets in the corresponding region is returned. - filters (
dict
) – The filters so that the response includes information for only certain subnets.
Return type: list
ofEC2NetworkSubnet
- subnet_ids (
-
ex_modify_image_attribute
(image, attributes)[source]¶ Modify image attributes.
Parameters: - image (
NodeImage
) – NodeImage instance - attributes (
dict
) – Dictionary with node attributes
Returns: True on success, False otherwise.
Return type: bool
- image (
-
ex_modify_instance_attribute
(node, attributes)[source]¶ Modify node attributes. A list of valid attributes can be found at http://goo.gl/gxcj8
Parameters: - node (
Node
) – Node instance - attributes (
dict
) – Dictionary with node attributes
Returns: True on success, False otherwise.
Return type: bool
- node (
-
ex_register_image
(name, description=None, architecture=None, image_location=None, root_device_name=None, block_device_mapping=None, kernel_id=None, ramdisk_id=None, virtualization_type=None)[source]¶ Registers an Amazon Machine Image based off of an EBS-backed instance. Can also be used to create images from snapshots. More information can be found at http://goo.gl/hqZq0a.
Parameters: - name (
str
) – The name for the AMI being registered - description (
str
) – The description of the AMI (optional) - architecture (
str
) – The architecture of the AMI (i386/x86_64) (optional) - image_location (
str
) – The location of the AMI within Amazon S3 Required if registering an instance store-backed AMI - root_device_name (
str
) – The device name for the root device Required if registering an EBS-backed AMI - block_device_mapping (
dict
) – A dictionary of the disk layout (optional) - kernel_id (
str
) – Kernel id for AMI (optional) - ramdisk_id (
str
) – RAM disk for AMI (optional) - virtualization_type (
str
) – The type of virtualization for the AMI you are registering, paravirt or hvm (optional)
Return type: NodeImage
- name (
-
ex_release_address
(elastic_ip, domain=None)[source]¶ Release an Elastic IP address using the IP (EC2-Classic) or using the allocation ID (VPC)
Parameters: - elastic_ip (
ElasticIP
) – Elastic IP instance - domain (
str
) – The domain where the IP resides (vpc only)
Returns: True on success, False otherwise.
Return type: bool
- elastic_ip (
-
ex_replace_route
(route_table, cidr, internet_gateway=None, node=None, network_interface=None, vpc_peering_connection=None)[source]¶ Replaces an existing route entry within a route table in a VPC.
Parameters: - route_table (
EC2RouteTable
) – The route table to replace the route in. - cidr (
str
) – The CIDR block used for the destination match. - internet_gateway (
VPCInternetGateway
) – The new internet gateway to route traffic through. - node (
Node
) – The new NAT instance to route traffic through. - network_interface (
EC2NetworkInterface
) – The new network interface of the node to route traffic through. - vpc_peering_connection (
VPCPeeringConnection
) – The new VPC peering connection.
Return type: bool
- Note: You must specify one of the following: internet_gateway,
- node, network_interface, vpc_peering_connection.
- route_table (
-
ex_replace_route_table_association
(subnet_association, route_table)[source]¶ Changes the route table associated with a given subnet in a VPC.
- Note: This method can be used to change which table is the main route
- table in the VPC (Specify the main route table’s association ID and the route table to be the new main route table).
Parameters: - subnet_association (
EC2SubnetAssociation
orstr
) – The subnet association object or subnet association ID. - route_table (
EC2RouteTable
) – The new route table to associate.
Returns: New route table association ID.
Return type: str
-
ex_revoke_security_group_egress
(id, from_port, to_port, cidr_ips=None, group_pairs=None, protocol='tcp')[source]¶ Edit a Security Group to revoke specific egress traffic using CIDR blocks or either a group ID, group name or user ID (account). This call is not supported for EC2 classic and only works for VPC groups.
Parameters: - id (
str
) – The id of the security group to edit - from_port (
int
) – The beginning of the port range to open - to_port (
int
) – The end of the port range to open - cidr_ips (
list
) – The list of ip ranges to allow traffic for. - group_pairs (
list
ofdict
) –Source user/group pairs to allow traffic for. More info can be found at http://goo.gl/stBHJF
EC2 Classic Example: To allow access from any system associated with the default group on account 1234567890
[{‘group_name’: ‘default’, ‘user_id’: ‘1234567890’}]
VPC Example: Allow access from any system associated with security group sg-47ad482e on your own account
[{‘group_id’: ‘ sg-47ad482e’}]
- protocol (
str
) – tcp/udp/icmp
Return type: bool
- id (
-
ex_revoke_security_group_ingress
(id, from_port, to_port, cidr_ips=None, group_pairs=None, protocol='tcp')[source]¶ Edit a Security Group to revoke specific ingress traffic using CIDR blocks or either a group ID, group name or user ID (account).
Parameters: - id (
str
) – The id of the security group to edit - from_port (
int
) – The beginning of the port range to open - to_port (
int
) – The end of the port range to open - cidr_ips (
list
) – The list of ip ranges to allow traffic for. - group_pairs (
list
ofdict
) –Source user/group pairs to allow traffic for. More info can be found at http://goo.gl/stBHJF
EC2 Classic Example: To allow access from any system associated with the default group on account 1234567890
[{‘group_name’: ‘default’, ‘user_id’: ‘1234567890’}]
VPC Example: Allow access from any system associated with security group sg-47ad482e on your own account
[{‘group_id’: ‘ sg-47ad482e’}]
- protocol (
str
) – tcp/udp/icmp
Return type: bool
- id (
-
ex_start_node
(node)[source]¶ Start the node by passing in the node object, does not work with instance store backed instances
Parameters: node ( Node
) – Node which should be usedReturn type: bool
-
ex_stop_node
(node)[source]¶ Stop the node by passing in the node object, does not work with instance store backed instances
Parameters: node ( Node
) – Node which should be usedReturn type: bool
-
features
= {'create_node': ['ssh_key']}¶
-
get_image
(image_id)[source]¶ Get an image based on an image_id
Parameters: image_id ( str
) – Image identifierReturns: A NodeImage object Return type: NodeImage
-
list_images
(location=None, ex_image_ids=None, ex_owner=None, ex_executableby=None, ex_filters=None)[source]¶ List all images @inherits:
NodeDriver.list_images
Ex_image_ids parameter is used to filter the list of images that should be returned. Only the images with the corresponding image ids will be returned.
Ex_owner parameter is used to filter the list of images that should be returned. Only the images with the corresponding owner will be returned. Valid values: amazon|aws-marketplace|self|all|aws id
Ex_executableby parameter describes images for which the specified user has explicit launch permissions. The user can be an AWS account ID, self to return images for which the sender of the request has explicit launch permissions, or all to return images with public launch permissions. Valid values: all|self|aws id
Ex_filters parameter is used to filter the list of images that should be returned. Only images matching the filter will be returned.
Parameters: - ex_image_ids (
list
ofstr
) – List ofNodeImage.id
- ex_owner (
str
) – Owner name - ex_executableby (
str
) – Executable by - ex_filters (
dict
) – Filter by
Return type: list
ofNodeImage
- ex_image_ids (
-
list_nodes
(ex_node_ids=None, ex_filters=None)[source]¶ List all nodes
Ex_node_ids parameter is used to filter the list of nodes that should be returned. Only the nodes with the corresponding node ids will be returned.
Parameters: - ex_node_ids (
list
ofstr
) – List ofnode.id
- ex_filters (
dict
) – The filters so that the response includes information for only certain nodes.
Return type: list
ofNode
- ex_node_ids (
-
list_snapshots
(snapshot=None, owner=None)[source]¶ Describe all snapshots.
Parameters: - snapshot – If provided, only return snapshot information for the provided snapshot.
- owner (
str
) – Owner for snapshot: self|amazon|ID
Return type: list
ofVolumeSnapshot
-
path
= '/'¶
-
signature_version
= '2'¶
- key (
-
class
libcloud.compute.drivers.ec2.
NimbusNodeDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region=None, **kwargs)[source]¶ Bases:
libcloud.compute.drivers.ec2.BaseEC2NodeDriver
Driver class for Nimbus
Parameters: - key (
str
) – API key or username to be used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections. - api_version (
str
) – Optional API version. Only used by drivers which support multiple API versions. - region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
Return type: None
-
api_name
= 'nimbus'¶
-
connectionCls
¶ alias of
NimbusConnection
-
country
= 'Private'¶
Nimbus doesn’t support creating tags, so this is a pass-through.
@inherits:
EC2NodeDriver.ex_create_tags
-
ex_describe_addresses
(nodes)[source]¶ Nimbus doesn’t support elastic IPs, so this is a pass-through.
@inherits:
EC2NodeDriver.ex_describe_addresses
-
friendly_name
= 'Nimbus Private Cloud'¶
-
name
= 'Nimbus'¶
-
region_name
= 'nimbus'¶
-
signature_version
= '2'¶
-
type
= 'nimbus'¶
-
website
= 'http://www.nimbusproject.org/'¶
- key (
-
class
libcloud.compute.drivers.ec2.
EucNodeDriver
(key, secret=None, secure=True, host=None, path=None, port=None, api_version='3.3.0')[source]¶ Bases:
libcloud.compute.drivers.ec2.BaseEC2NodeDriver
Driver class for Eucalyptus
@inherits:
EC2NodeDriver.__init__
Parameters: - path (
str
) – The host where the API can be reached. - api_version (
str
) – The API version to extend support for Eucalyptus proprietary API calls
-
api_name
= 'ec2_us_east'¶
-
connectionCls
¶ alias of
EucConnection
-
name
= 'Eucalyptus'¶
-
region_name
= 'us-east-1'¶
-
signature_version
= '2'¶
-
website
= 'http://www.eucalyptus.com/'¶
- path (
-
class
libcloud.compute.drivers.ec2.
OutscaleSASNodeDriver
(key, secret=None, secure=True, host=None, port=None, region='us-east-1', region_details=None, **kwargs)[source]¶ Bases:
libcloud.compute.drivers.ec2.OutscaleNodeDriver
Outscale SAS node driver
-
name
= 'Outscale SAS'¶
-
type
= 'outscale_sas'¶
-
-
class
libcloud.compute.drivers.ec2.
OutscaleINCNodeDriver
(key, secret=None, secure=True, host=None, port=None, region='us-east-1', region_details=None, **kwargs)[source]¶ Bases:
libcloud.compute.drivers.ec2.OutscaleNodeDriver
Outscale INC node driver
-
name
= 'Outscale INC'¶
-
type
= 'outscale_inc'¶
-
-
class
libcloud.compute.drivers.ec2.
EC2NodeLocation
(id, name, country, driver, availability_zone)[source]¶
-
class
libcloud.compute.drivers.ec2.
EC2ReservedNode
(id, state, driver, size=None, image=None, extra=None)[source]¶ Bases:
libcloud.compute.base.Node
Class which stores information about EC2 reserved instances/nodes Inherits from Node and passes in None for name and private/public IPs
Note: This class is EC2 specific.
-
class
libcloud.compute.drivers.ec2.
EC2SecurityGroup
(id, name, ingress_rules, egress_rules, extra=None)[source]¶ Bases:
object
Represents information about a Security group
Note: This class is EC2 specific.
-
class
libcloud.compute.drivers.ec2.
EC2PlacementGroup
(name, state, strategy='cluster', extra=None)[source]¶ Bases:
object
Represents information about a Placement Grous
Note: This class is EC2 specific.
-
class
libcloud.compute.drivers.ec2.
EC2Network
(id, name, cidr_block, extra=None)[source]¶ Bases:
object
Represents information about a VPC (Virtual Private Cloud) network
Note: This class is EC2 specific.
-
class
libcloud.compute.drivers.ec2.
EC2NetworkSubnet
(id, name, state, extra=None)[source]¶ Bases:
object
Represents information about a VPC (Virtual Private Cloud) subnet
Note: This class is EC2 specific.
-
class
libcloud.compute.drivers.ec2.
EC2NetworkInterface
(id, name, state, extra=None)[source]¶ Bases:
object
Represents information about a VPC network interface
Note: This class is EC2 specific. The state parameter denotes the current status of the interface. Valid values for state are attaching, attached, detaching and detached.
-
class
libcloud.compute.drivers.ec2.
EC2RouteTable
(id, name, routes, subnet_associations, propagating_gateway_ids, extra=None)[source]¶ Bases:
object
Class which stores information about VPC Route Tables.
Note: This class is VPC specific.
Parameters: - id (
str
) – The ID of the route table. - name (
str
) – The name of the route table. - routes (
list
ofEC2Route
) – A list of routes in the route table. - subnet_associations (
list
ofEC2SubnetAssociation
) – A list of associations between the route table and one or more subnets. - propagating_gateway_ids (
list
) – The list of IDs of any virtual private gateways propagating the routes.
- id (
-
class
libcloud.compute.drivers.ec2.
EC2Route
(cidr, gateway_id, instance_id, owner_id, interface_id, state, origin, vpc_peering_connection_id)[source]¶ Bases:
object
Class which stores information about a Route.
Note: This class is VPC specific.
Parameters: - cidr (
str
) – The CIDR block used for the destination match. - gateway_id (
str
) – The ID of a gateway attached to the VPC. - instance_id (
str
) – The ID of a NAT instance in the VPC. - owner_id (
str
) – The AWS account ID of the owner of the instance. - interface_id (
str
) – The ID of the network interface. - state (
str
) – The state of the route (active | blackhole). - origin (
str
) – Describes how the route was created. - vpc_peering_connection_id (
str
) – The ID of the VPC peering connection.
- cidr (
-
class
libcloud.compute.drivers.ec2.
EC2SubnetAssociation
(id, route_table_id, subnet_id, main=False)[source]¶ Bases:
object
Class which stores information about Route Table associated with a given Subnet in a VPC
Note: This class is VPC specific.
Parameters: - id (
str
) – The ID of the subnet association in the VPC. - route_table_id (
str
) – The ID of a route table in the VPC. - subnet_id (
str
) – The ID of a subnet in the VPC. - main (
bool
) – If true, means this is a main VPC route table.
- id (
-
class
libcloud.compute.drivers.ec2.
ExEC2AvailabilityZone
(name, zone_state, region_name)[source]¶ Bases:
object
Extension class which stores information about an EC2 availability zone.
Note: This class is EC2 specific.
-
exception
libcloud.compute.drivers.ec2.
IdempotentParamError
(value, driver=None)[source]¶ Bases:
libcloud.common.types.LibcloudError
Request used the same client token as a previous, but non-identical request.
libcloud.compute.drivers.ecp module¶
Enomaly ECP driver
-
class
libcloud.compute.drivers.ecp.
ECPConnection
(user_id, key, secure=True, host=None, port=None, url=None, timeout=None, proxy_url=None, backoff=None, retry_delay=None)[source]¶ Bases:
libcloud.common.base.ConnectionUserAndKey
Connection class for the Enomaly ECP driver
-
host
= ''¶
-
port
= (80, 443)¶
-
responseCls
¶ alias of
ECPResponse
-
-
class
libcloud.compute.drivers.ecp.
ECPNodeDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region=None, **kwargs)[source]¶ Bases:
libcloud.compute.base.NodeDriver
Enomaly ECP node driver
Parameters: - key (
str
) – API key or username to be used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections. - api_version (
str
) – Optional API version. Only used by drivers which support multiple API versions. - region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
Return type: None
-
connectionCls
¶ alias of
ECPConnection
-
create_node
(**kwargs)[source]¶ Creates a virtual machine.
Parameters: - name (
str
) – String with a name for this new node (required) - size (
NodeSize
) – The size of resources allocated to this node . (required) - image (
NodeImage
) – OS Image to boot on node. (required)
Return type: Node
- name (
-
list_images
(location=None)[source]¶ Returns a list of all package templates aka appliances aka images.
@inherits:
NodeDriver.list_images
-
list_locations
()[source]¶ This feature does not exist in ECP. Returns hard coded dummy location.
Return type: list
ofNodeLocation
-
list_sizes
(location=None)[source]¶ Returns a list of all hardware templates
@inherits:
NodeDriver.list_sizes
-
name
= 'Enomaly Elastic Computing Platform'¶
-
reboot_node
(node)[source]¶ Shuts down a VM and then starts it again.
@inherits:
NodeDriver.reboot_node
-
type
= 'ecp'¶
-
website
= 'http://www.enomaly.com/'¶
- key (
-
class
libcloud.compute.drivers.ecp.
ECPResponse
(response, connection)[source]¶ Bases:
libcloud.common.base.Response
Parameters: - response (
httplib.HTTPResponse
) – HTTP response object. (optional) - connection (
Connection
) – Parent connection object.
- response (
libcloud.compute.drivers.ecs module¶
Node driver for Aliyun.
-
class
libcloud.compute.drivers.ecs.
DiskCategory
[source]¶ Bases:
object
Enum defined disk types supported by Aliyun system and data disks.
-
CLOUD
= 'cloud'¶
-
CLOUD_EFFICIENCY
= 'cloud_efficiency'¶
-
CLOUD_SSD
= 'cloud_ssd'¶
-
EPHEMERAL_SSD
= 'ephemeral_ssd'¶
-
-
class
libcloud.compute.drivers.ecs.
InternetChargeType
[source]¶ Bases:
object
Internet connection billing types for Aliyun Nodes.
-
BY_BANDWIDTH
= 'PayByBandwidth'¶
-
BY_TRAFFIC
= 'PayByTraffic'¶
-
-
class
libcloud.compute.drivers.ecs.
ECSDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region=None, **kwargs)[source]¶ Bases:
libcloud.compute.base.NodeDriver
Aliyun ECS node driver.
Used for Aliyun ECS service.
TODO: Create public IP address Get guest OS root password Adjust internet bandwidth settings Manage security groups and rules
Parameters: - key (
str
) – API key or username to be used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections. - api_version (
str
) – Optional API version. Only used by drivers which support multiple API versions. - region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
Return type: None
-
NODE_STATE_MAPPING
= {'Stopping': 'pending', 'Stopped': 'stopped', 'Running': 'running', 'Starting': 'pending'}¶
-
SNAPSHOT_STATE_MAPPING
= {'failed': 'error', 'accomplished': 'available', 'progressing': 'creating'}¶
-
VOLUME_STATE_MAPPING
= {'Available': 'available', 'ReIniting': 'creating', 'Creating': 'creating', 'In_use': 'inuse', 'Attaching': 'attaching', 'Detaching': 'inuse'}¶
-
attach_volume
(node, volume, device=None, ex_delete_with_instance=None)[source]¶ Attaches volume to node.
@inherits
NodeDriver.attach_volume
Parameters: - device (
str
between /dev/xvdb to xvdz, if empty, allocated by the system) – device path allocated for this attached volume - ex_delete_with_instance (
bool
) – if to delete this volume when the instance is deleted.
- device (
-
connectionCls
¶ alias of
ECSConnection
-
copy_image
(source_region, node_image, name, description=None, ex_destination_region_id=None, ex_client_token=None)[source]¶ Copies an image from a source region to the destination region. If not provide a destination region, default to the current region.
@inherits
NodeDriver.copy_image
Parameters: - ex_destination_region_id (
str
) – id of the destination region - ex_client_token (
str
) – a token generated by client to identify each request.
- ex_destination_region_id (
-
create_image
(node, name, description=None, ex_snapshot_id=None, ex_image_version=None, ex_client_token=None)[source]¶ Creates an image from a system disk snapshot.
@inherits
NodeDriver.create_image
Parameters: - ex_snapshot_id (
str
) – the id of the snapshot to create the image. (required) - ex_image_version (
str
) – the version number of the image - ex_client_token (
str
) – a token generated by client to identify each request.
- ex_snapshot_id (
-
create_node
(name, size, image, auth=None, ex_security_group_id=None, ex_description=None, ex_internet_charge_type=None, ex_internet_max_bandwidth_out=None, ex_internet_max_bandwidth_in=None, ex_hostname=None, ex_io_optimized=None, ex_system_disk=None, ex_data_disks=None, ex_vswitch_id=None, ex_private_ip_address=None, ex_client_token=None, **kwargs)[source]¶ @inherits:
NodeDriver.create_node
Parameters: - name (
str
) – The name for this new node (required) - image (NodeImage) – The image to use when creating this node (required)
- size (NodeSize) – The size of the node to create (required)
- auth (
NodeAuthSSHKey
orNodeAuthPassword
) – Initial authentication information for the node (optional) - ex_security_group_id (
str
) – The id of the security group the new created node is attached to. (required) - ex_description (
str
) – A description string for this node (optional) - ex_internet_charge_type (a
str
of ‘PayByTraffic’ or ‘PayByBandwidth’) – The internet charge type (optional) - ex_internet_max_bandwidth_out (a
int
in range [0, 100] aint
in range [1, 100] for ‘PayByTraffic’ internet charge type) – The max output bandwidth, in Mbps (optional) Required for ‘PayByTraffic’ internet charge type - ex_internet_max_bandwidth_in (a
int
in range [1, 200] default to 200 in server side) – The max input bandwidth, in Mbps (optional) - ex_hostname (
str
) – The hostname for the node (optional) - ex_io_optimized (
boll
) – Whether the node is IO optimized (optional) - ex_system_disk (
dict
) – The system disk for the node (optional) - ex_data_disks (a list of dict) – The data disks for the node (optional)
- ex_vswitch_id (
str
) – The id of vswitch for a VPC type node (optional) - ex_private_ip_address (
str
) – The IP address in private network (optional) - ex_client_token – A token generated by client to keep requests idempotency (optional)
- name (
-
create_volume
(size, name, location=None, snapshot=None, ex_zone_id=None, ex_description=None, ex_disk_category=None, ex_client_token=None)[source]¶ Create a new volume.
@inherites
NodeDriver.create_volume
Parameters: - ex_zone_id (
str
) – the availability zone id (required) - ex_description (
unicode
) – volume description - ex_disk_category (
str
) – disk category for data disk - ex_client_token (
str
) – a token generated by client to identify each request.
- ex_zone_id (
-
create_volume_snapshot
(volume, name=None, ex_description=None, ex_client_token=None)[source]¶ Creates a snapshot of the storage volume.
@inherits
NodeDriver.create_volume_snapshot
Parameters: - ex_description (
unicode
) – description of the snapshot. - ex_client_token (
str
) – a token generated by client to identify each request.
- ex_description (
-
detach_volume
(volume, ex_instance_id=None)[source]¶ Detaches a volume from a node.
@inherits
NodeDriver.detach_volume
Parameters: ex_instance_id ( str
) – the id of the instance from which the volume is detached.
-
disk_categories
¶ alias of
DiskCategory
-
ex_create_security_group
(description=None, client_token=None)[source]¶ Create a new security group.
Parameters: - description (
unicode
) – security group description - client_token (
str
) – a token generated by client to identify each request.
- description (
-
ex_delete_security_group_by_id
(group_id=None)[source]¶ Delete a new security group.
Parameters: group_id ( str
) – security group id
-
ex_list_security_group_attributes
(group_id=None, nic_type='internet')[source]¶ List security group attributes in the current region.
Parameters: - group_id – security group id.
- nic_type (
str
) – internet|intranet.
Returns: a list of defined security group Attributes
Return type: list
ofECSSecurityGroupAttribute
-
ex_list_security_groups
(ex_filters=None)[source]¶ List security groups in the current region.
Parameters: ex_filters ( dict
) – security group attributes to filter results.Returns: a list of defined security groups Return type: list
ofECSSecurityGroup
-
ex_list_zones
(region_id=None)[source]¶ List availability zones in the given region or the current region.
Parameters: region_id ( str
) – the id of the region to query zones fromReturns: list of zones Return type: list
ofECSZone
-
ex_start_node
(node)[source]¶ Start node to running state.
Parameters: node ( Node
) – theNode
object to startReturns: starting operation result. Return type: bool
-
ex_stop_node
(node, ex_force_stop=False)[source]¶ Stop a running node.
Parameters: - node (
Node
) – The node to stop - ex_force_stop (
bool
) – ifTrue
, stop node force (maybe lose data) otherwise, stop node normally, default toFalse
Returns: stopping operation result.
Return type: bool
- node (
-
features
= {'create_node': ['password']}¶
-
internet_charge_types
¶ alias of
InternetChargeType
-
list_images
(location=None, ex_image_ids=None, ex_filters=None)[source]¶ List images on a provider.
@inherits
NodeDriver.list_images
Parameters: - ex_image_ids (
list
ofstr
) – a list of image ids to filter the images to be returned. - ex_filters (
dict
) – image attribute and value pairs to filter images. Only the image which matchs all the pairs will be returned. If the filter attribute need a json array value, uselist
object, the driver will convert it.
- ex_image_ids (
-
list_nodes
(ex_node_ids=None, ex_filters=None)[source]¶ List all nodes.
@inherits:
NodeDriver.create_node
Parameters: - ex_node_ids (
list
ofstr
) – a list of node’s ids used to filter nodes. Only the nodes which’s id in this list will be returned. - ex_filters (
dict
) – node attribute and value pairs to filter nodes. Only the nodes which matchs all the pairs will be returned. If the filter attribute need a json array value, uselist
object, the driver will convert it.
- ex_node_ids (
-
list_volume_snapshots
(volume, ex_snapshot_ids=[], ex_filters=None)[source]¶ List snapshots for a storage volume.
@inherites
NodeDriver.list_volume_snapshots
Parameters: - ex_snapshot_ids (
list
ofstr
) – a list of snapshot ids to filter the snapshots returned. - ex_filters (
dict
) – snapshot attribute and value pairs to filter snapshots. Only the snapshot which matchs all the pairs will be returned. If the filter attribute need a json array value, uselist
object, the driver will convert it.
- ex_snapshot_ids (
-
list_volumes
(ex_volume_ids=None, ex_filters=None)[source]¶ List all volumes.
@inherits:
NodeDriver.list_volumes
Parameters: - ex_volume_ids (
list
ofstr
) – a list of volume’s ids used to filter volumes. Only the volumes which’s id in this list will be returned. - ex_filters (
dict
) – volume attribute and value pairs to filter volumes. Only the volumes which matchs all will be returned. If the filter attribute need a json array value, uselist
object, the driver will convert it.
- ex_volume_ids (
-
name
= 'Aliyun ECS'¶
-
namespace
= None¶
-
path
= '/'¶
-
reboot_node
(node, ex_force_stop=False)[source]¶ Reboot the given node
@inherits
NodeDriver.reboot_node
Parameters: ex_force_stop ( bool
) – ifTrue
, stop node force (maybe lose data) otherwise, stop node normally, default toFalse
-
website
= 'https://www.aliyun.com/product/ecs'¶
- key (
libcloud.compute.drivers.elastichosts module¶
ElasticHosts Driver
-
class
libcloud.compute.drivers.elastichosts.
ElasticHostsAU1NodeDriver
(key, secret=None, secure=True, host=None, port=None, region='sat-p', **kwargs)[source]¶ Bases:
libcloud.compute.drivers.elastichosts.ElasticHostsNodeDriver
ElasticHosts node driver for the Sydney end-point
-
name
= 'ElasticHosts (syd-y)'¶
-
-
class
libcloud.compute.drivers.elastichosts.
ElasticHostsCA1NodeDriver
(key, secret=None, secure=True, host=None, port=None, region='sat-p', **kwargs)[source]¶ Bases:
libcloud.compute.drivers.elastichosts.ElasticHostsNodeDriver
ElasticHosts node driver for the Toronto Peer 1 end-point
-
name
= 'ElasticHosts (tor-p)'¶
-
-
class
libcloud.compute.drivers.elastichosts.
ElasticHostsCN1NodeDriver
(key, secret=None, secure=True, host=None, port=None, region='sat-p', **kwargs)[source]¶ Bases:
libcloud.compute.drivers.elastichosts.ElasticHostsNodeDriver
ElasticHosts node driver for the Hong Kong end-point
-
name
= 'ElasticHosts (cn-1)'¶
-
-
exception
libcloud.compute.drivers.elastichosts.
ElasticHostsException
[source]¶ Bases:
exceptions.Exception
-
class
libcloud.compute.drivers.elastichosts.
ElasticHostsNodeDriver
(key, secret=None, secure=True, host=None, port=None, region='sat-p', **kwargs)[source]¶ Bases:
libcloud.compute.drivers.elasticstack.ElasticStackBaseNodeDriver
Node Driver class for ElasticHosts
-
api_name
= 'elastichosts'¶
-
features
= {'create_node': ['generates_password']}¶
-
name
= 'ElasticHosts'¶
-
type
= 'elastichosts'¶
-
website
= 'http://www.elastichosts.com/'¶
-
-
class
libcloud.compute.drivers.elastichosts.
ElasticHostsUK1NodeDriver
(key, secret=None, secure=True, host=None, port=None, region='sat-p', **kwargs)[source]¶ Bases:
libcloud.compute.drivers.elastichosts.ElasticHostsNodeDriver
ElasticHosts node driver for the London Peer 1 end-point
-
name
= 'ElasticHosts (lon-p)'¶
-
-
class
libcloud.compute.drivers.elastichosts.
ElasticHostsUK2NodeDriver
(key, secret=None, secure=True, host=None, port=None, region='sat-p', **kwargs)[source]¶ Bases:
libcloud.compute.drivers.elastichosts.ElasticHostsNodeDriver
ElasticHosts node driver for the London Bluesquare end-point
-
name
= 'ElasticHosts (lon-b)'¶
-
-
class
libcloud.compute.drivers.elastichosts.
ElasticHostsUS1NodeDriver
(key, secret=None, secure=True, host=None, port=None, region='sat-p', **kwargs)[source]¶ Bases:
libcloud.compute.drivers.elastichosts.ElasticHostsNodeDriver
ElasticHosts node driver for the San Antonio Peer 1 end-point
-
name
= 'ElasticHosts (sat-p)'¶
-
-
class
libcloud.compute.drivers.elastichosts.
ElasticHostsUS2NodeDriver
(key, secret=None, secure=True, host=None, port=None, region='sat-p', **kwargs)[source]¶ Bases:
libcloud.compute.drivers.elastichosts.ElasticHostsNodeDriver
ElasticHosts node driver for the Los Angeles Peer 1 end-point
-
name
= 'ElasticHosts (lax-p)'¶
-
-
class
libcloud.compute.drivers.elastichosts.
ElasticHostsUS3NodeDriver
(key, secret=None, secure=True, host=None, port=None, region='sat-p', **kwargs)[source]¶ Bases:
libcloud.compute.drivers.elastichosts.ElasticHostsNodeDriver
ElasticHosts node driver for the San Jose (Silicon Valley) end-point
-
name
= 'ElasticHosts (sjc-c)'¶
-
libcloud.compute.drivers.elasticstack module¶
Base driver for the providers based on the ElasticStack platform - http://www.elasticstack.com.
-
class
libcloud.compute.drivers.elasticstack.
ElasticStackBaseConnection
(user_id, key, secure=True, host=None, port=None, url=None, timeout=None, proxy_url=None, backoff=None, retry_delay=None)[source]¶ Bases:
libcloud.common.base.ConnectionUserAndKey
Base connection class for the ElasticStack driver
-
host
= None¶
-
responseCls
¶ alias of
ElasticStackResponse
-
-
class
libcloud.compute.drivers.elasticstack.
ElasticStackBaseNodeDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region=None, **kwargs)[source]¶ Bases:
libcloud.compute.base.NodeDriver
Parameters: - key (
str
) – API key or username to be used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections. - api_version (
str
) – Optional API version. Only used by drivers which support multiple API versions. - region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
Return type: None
-
connectionCls
¶ alias of
ElasticStackBaseConnection
-
create_node
(**kwargs)[source]¶ Creates an ElasticStack instance
@inherits:
NodeDriver.create_node
Parameters: - name (
str
) – String with a name for this new node (required) - smp (
int
) – Number of virtual processors or None to calculate based on the cpu speed - nic_model (
str
) – e1000, rtl8139 or virtio (if not specified, e1000 is used) - vnc_password (
str
) – If set, the same password is also used for SSH access with user toor, otherwise VNC access is disabled and no SSH login is possible.
- name (
-
deploy_node
(**kwargs)[source]¶ Create a new node, and start deployment.
@inherits:
NodeDriver.deploy_node
Parameters: enable_root ( bool
) – If true, root password will be set to vnc_password (this will enable SSH access) and default ‘toor’ account will be deleted.
-
ex_destroy_drive
(drive_uuid)[source]¶ Deletes a drive
Parameters: drive_uuid ( str
) – Drive uuid which should be usedReturn type: bool
-
ex_set_node_configuration
(node, **kwargs)[source]¶ Changes the configuration of the running server
Parameters: - node (
Node
) – Node which should be used - kwargs (
dict
) – keyword arguments
Return type: bool
- node (
-
ex_shutdown_node
(node)[source]¶ Sends the ACPI power-down event
Parameters: node ( Node
) – Node which should be usedReturn type: bool
-
features
= {'create_node': ['generates_password']}¶
-
website
= 'http://www.elasticstack.com'¶
- key (
-
exception
libcloud.compute.drivers.elasticstack.
ElasticStackException
[source]¶ Bases:
exceptions.Exception
-
class
libcloud.compute.drivers.elasticstack.
ElasticStackNodeSize
(id, name, cpu, ram, disk, bandwidth, price, driver)[source]¶
-
class
libcloud.compute.drivers.elasticstack.
ElasticStackResponse
(response, connection)[source]¶ Bases:
libcloud.common.base.JsonResponse
Parameters: - response (
httplib.HTTPResponse
) – HTTP response object. (optional) - connection (
Connection
) – Parent connection object.
- response (
libcloud.compute.drivers.exoscale module¶
-
class
libcloud.compute.drivers.exoscale.
ExoscaleNodeDriver
(key, secret=None, secure=True, host=None, path=None, port=None, url=None, *args, **kwargs)[source]¶ Bases:
libcloud.compute.drivers.cloudstack.CloudStackNodeDriver
Inherits: NodeDriver.__init__
Parameters: - host (
str
) – The host where the API can be reached. (required) - path (
str
) – The path where the API can be reached. (required) - url (
str
) – Full URL to the API endpoint. Mutually exclusive with host and path argument.
-
host
= 'api.exoscale.ch'¶
-
name
= 'Exoscale'¶
-
path
= '/compute'¶
-
type
= 'exoscale'¶
-
website
= 'https://www.exoscale.ch/'¶
- host (
libcloud.compute.drivers.gandi module¶
Gandi driver for compute
-
class
libcloud.compute.drivers.gandi.
GandiNodeDriver
(*args, **kwargs)[source]¶ Bases:
libcloud.common.gandi.BaseGandiDriver
,libcloud.compute.base.NodeDriver
Gandi node driver
@inherits:
NodeDriver.__init__
-
api_name
= 'gandi'¶
-
attach_volume
(node, volume, device=None)[source]¶ Attach a volume to a node.
Parameters: - node (
Node
) – The node to attach the volume to - volume (
StorageVolume
) – The volume to attach. - device (
None
) – Not used in this cloud.
Returns: True if successful
Return type: bool
- node (
-
country
= 'FR'¶
-
create_node
(**kwargs)[source]¶ Create a new Gandi node
Parameters: - name (
str
) – String with a name for this new node (required) - image (
NodeImage
) – OS Image to boot on node. (required) - location (
NodeLocation
) – Which data center to create a node in. If empty, undefined behavior will be selected. (optional) - size (
NodeSize
) – The size of resources allocated to this node. (required) - login (
str
) – user name to create for login on machine (required) - password (
str
) – password for user that’ll be created (required) - inet_family (
int
) – version of ip to use, default 4 (optional) - keypairs (list of
int
orKeyPair
) – IDs of keypairs or Keypairs object
Return type: Node
- name (
-
create_volume
(size, name, location=None, snapshot=None)[source]¶ Create a volume (disk).
Parameters: - size (
int
) – Size of volume to create (in GB). - name (
str
) – Name of volume to create - location (
NodeLocation
orNone
) – Location (zone) to create the volume in - snapshot (
Snapshot
) – Snapshot to create image from
Returns: Storage Volume object
Return type: StorageVolume
- size (
-
delete_key_pair
(key_pair)[source]¶ Delete an existing key pair.
Parameters: key_pair (:class.KeyPair` or int
) – Key pair object or ID.Returns: True of False based on success of Keypair deletion Return type: bool
-
destroy_node
(node)[source]¶ Destroy a node.
Parameters: node ( Node
) – Node object to destroyReturns: True if successful Return type: bool
-
destroy_volume
(volume)[source]¶ Destroy a volume.
Parameters: volume ( StorageVolume
) – Volume object to destroyReturns: True if successful Return type: bool
-
detach_volume
(node, volume)[source]¶ Detaches a volume from a node.
Parameters: - node (
Node
) – Node which should be used - volume (
StorageVolume
) – Volume to be detached
Return type: bool
- node (
-
ex_get_node
(node_id)[source]¶ Return a Node object based on a node id.
Parameters: name ( int
) – The ID of the nodeReturns: A Node object for the node Return type: Node
-
ex_get_volume
(volume_id)[source]¶ Return a Volume object based on a volume ID.
Parameters: volume_id ( int
) – The ID of the volumeReturns: A StorageVolume object for the volume Return type: StorageVolume
-
ex_list_interfaces
()[source]¶ Specific method to list network interfaces
Return type: list
ofGandiNetworkInterface
-
ex_node_attach_disk
(node, disk)[source]¶ Specific method to attach a disk to a node
Parameters: - node (
Node
) – Node which should be used - disk (
GandiDisk
) – Disk which should be used
Return type: bool
- node (
-
ex_node_attach_interface
(node, iface)[source]¶ Specific method to attach an interface to a node
Parameters: - node (
Node
) – Node which should be used - iface (
GandiNetworkInterface
) – Network interface which should be used
Return type: bool
- node (
-
ex_node_detach_disk
(node, disk)[source]¶ Specific method to detach a disk from a node
Parameters: - node (
Node
) – Node which should be used - disk (
GandiDisk
) – Disk which should be used
Return type: bool
- node (
-
ex_node_detach_interface
(node, iface)[source]¶ Specific method to detach an interface from a node
Parameters: - node (
Node
) – Node which should be used - iface (
GandiNetworkInterface
) – Network interface which should be used
Return type: bool
- node (
-
ex_snapshot_disk
(disk, name=None)[source]¶ Specific method to make a snapshot of a disk
Parameters: - disk (
GandiDisk
) – Disk which should be used - name (
str
) – Name which should be used
Return type: bool
- disk (
-
ex_update_disk
(disk, new_size=None, new_name=None)[source]¶ Specific method to update size or name of a disk WARNING: if a server is attached it’ll be rebooted
Parameters: - disk (
GandiDisk
) – Disk which should be used - new_size (
int
) – New size - new_name (
str
) – New name
Return type: bool
- disk (
-
features
= {}¶
-
friendly_name
= 'Gandi.net'¶
-
get_key_pair
(name)[source]¶ Retrieve a single key pair.
Parameters: name ( str
) – Name of the key pair to retrieve.Return type: KeyPair
-
import_key_pair_from_string
(name, key_material)[source]¶ Create a new key pair object.
Parameters: - name (
str
) – Key pair name. - key_material (
str
) – Public key material.
Returns: Imported key pair object.
Return type: - name (
-
list_images
(location=None)[source]¶ Return a list of image objects.
Parameters: location ( NodeLocation
) – Which data center to filter a images in.Returns: List of GCENodeImage objects Return type: list
ofGCENodeImage
-
list_key_pairs
()[source]¶ List registered key pairs.
Returns: A list of key par objects. Return type: list
oflibcloud.compute.base.KeyPair
-
list_locations
()[source]¶ Return a list of locations (datacenters).
Returns: List of NodeLocation objects Return type: list
ofNodeLocation
-
list_nodes
()[source]¶ Return a list of nodes in the current zone or all zones.
Returns: List of Node objects Return type: list
ofNode
-
list_sizes
(location=None)[source]¶ Return a list of sizes (machineTypes) in a zone.
Parameters: location ( NodeLocation
orNone
) – Which data center to filter a sizes in.Returns: List of NodeSize objects Return type: list
ofNodeSize
-
list_volumes
()[source]¶ Return a list of volumes.
Returns: A list of volume objects. Return type: list
ofStorageVolume
-
reboot_node
(node)[source]¶ Reboot a node.
Parameters: node ( Node
) – Node to be rebootedReturns: True if successful, False if not Return type: bool
-
type
= 'gandi'¶
-
website
= 'http://www.gandi.net/'¶
-
libcloud.compute.drivers.gce module¶
Module for Google Compute Engine Driver.
-
class
libcloud.compute.drivers.gce.
GCEAddress
(id, name, address, region, driver, extra=None)[source]¶ Bases:
libcloud.compute.base.UuidMixin
A GCE Static address.
-
class
libcloud.compute.drivers.gce.
GCEAutoscaler
(id, name, zone, target, policy, driver, extra=None)[source]¶ Bases:
libcloud.compute.base.UuidMixin
Represents a autoscaling policy object used to scale Instance Groups.
-
class
libcloud.compute.drivers.gce.
GCEBackendService
(id, name, backends, healthchecks, port, port_name, protocol, timeout, driver, extra=None)[source]¶ Bases:
libcloud.compute.base.UuidMixin
A GCE Backend Service.
-
class
libcloud.compute.drivers.gce.
GCEConnection
(user_id, key, secure, auth_type=None, credential_file=None, project=None, **kwargs)[source]¶ Bases:
libcloud.common.google.GoogleBaseConnection
Connection class for the GCE driver.
- GCEConnection extends
google.GoogleBaseConnection
for 2 reasons: - modify request_path for GCE URI.
- Implement gce_params functionality described below.
If the parameter gce_params is set to a dict prior to calling request(), the URL parameters will be updated to include those key/values FOR A SINGLE REQUEST. If the response contains a nextPageToken, gce_params[‘pageToken’] will be set to its value. This can be used to implement paging in list:
>>> params, more_results = {'maxResults': 2}, True >>> while more_results: ... driver.connection.gce_params=params ... driver.ex_list_urlmaps() ... more_results = 'pageToken' in params ... [<GCEUrlMap id="..." name="cli-map">, <GCEUrlMap id="..." name="lc-map">] [<GCEUrlMap id="..." name="web-map">]
-
host
= 'www.googleapis.com'¶
-
pre_connect_hook
(params, headers)[source]¶ Update URL parameters with values from self.gce_params.
@inherits:
GoogleBaseConnection.pre_connect_hook
-
request
(*args, **kwargs)[source]¶ Perform request then do GCE-specific processing of URL params.
@inherits:
GoogleBaseConnection.request
-
responseCls
¶ alias of
GCEResponse
- GCEConnection extends
-
class
libcloud.compute.drivers.gce.
GCEDiskType
(id, name, zone, driver, extra=None)[source]¶ Bases:
libcloud.compute.base.UuidMixin
A GCE DiskType resource.
-
class
libcloud.compute.drivers.gce.
GCEFailedDisk
(name, error, code)[source]¶ Bases:
object
Dummy Node object for disks that are not created.
-
class
libcloud.compute.drivers.gce.
GCEFailedNode
(name, error, code)[source]¶ Bases:
object
Dummy Node object for nodes that are not created.
-
class
libcloud.compute.drivers.gce.
GCEFirewall
(id, name, allowed, network, source_ranges, source_tags, target_tags, driver, extra=None)[source]¶ Bases:
libcloud.compute.base.UuidMixin
A GCE Firewall rule class.
-
update
()[source]¶ Commit updated firewall values.
Returns: Updated Firewall object Return type: GCEFirewall
-
-
class
libcloud.compute.drivers.gce.
GCEForwardingRule
(id, name, region, address, protocol, targetpool, driver, extra=None)[source]¶ Bases:
libcloud.compute.base.UuidMixin
-
class
libcloud.compute.drivers.gce.
GCEHealthCheck
(id, name, path, port, interval, timeout, unhealthy_threshold, healthy_threshold, driver, extra=None)[source]¶ Bases:
libcloud.compute.base.UuidMixin
A GCE Http Health Check class.
-
class
libcloud.compute.drivers.gce.
GCEInstanceGroup
(id, name, zone, driver, extra=None, description=None, network=None, subnetwork=None, named_ports=None)[source]¶ Bases:
libcloud.compute.base.UuidMixin
GCEInstanceGroup represents the InstanceGroup resource.
Parameters: - name (
str
) – Required. The name of the instance group. The name must be 1-63 characters long, and comply with RFC1035. - zone (
GCEZone
) – The URL of the zone where the instance group is located. - description (
str
) – An optional description of this resource. Provide this property when you create the resource. - network (
GCENetwork
) – The URL of the network to which all instances in the instance group belong. - subnetwork (
GCESubnetwork
) – The URL of the subnetwork to which all instances in the instance group belong. - named_ports (
"<type 'list'>"
) – Assigns a name to a port number. For example: {name: “http”, port: 80} This allows the system to reference ports by the assigned name instead of a port number. Named ports can also contain multiple ports. For example: [{name: “http”, port: 80},{name: “http”, port: 8080}] Named ports apply to all instances in this instance group.
- name (
-
class
libcloud.compute.drivers.gce.
GCEInstanceGroupManager
(id, name, zone, size, template, instance_group, driver, extra=None)[source]¶ Bases:
libcloud.compute.base.UuidMixin
GCE Instance Groups Manager class.
Handles ‘managed’ Instance Groups. For more information on Instance Groups, see: https://cloud.google.com/compute/docs/instance-groups
Parameters: - id (
str
) – Internal identifier of Instance Group. Display only. - name – The name of this Instance Group.
- zone – Zone in witch the Instance Group belongs
- size (
int
) – Number of instances in this Instance Group. - template – An initialized :class:
GCEInstanceTemplate
- instance_group – An initialized :class:
GCEInstanceGroup
- driver (:class:
GCENodeDriver
) – An initialized :class:GCENodeDriver
- extra (
dict
) – A dictionary of extra information.
-
destroy
()[source]¶ Destroy this Instance Group. Destroys all instances managed by the Instance Group.
Returns: True if successful Return type: bool
-
list_managed_instances
()[source]¶ Lists all of the instances in this managed instance group.
Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute * https://www.googleapis.com/auth/compute.readonly
Returns: list
ofdict
containing instance URI and currentAction. See ex_instancegroupmanager_list_managed_instances for more details.Return type: list
-
recreate_instances
()[source]¶ Recreate instances in a Managed Instance Group.
Returns: list
ofdict
containing instance URI and currentAction. See ex_instancegroupmanager_list_managed_instances for more details.Return type: list
-
resize
(size)[source]¶ Set the number of instances for this Instance Group. An increase in num_instances will result in VMs being created. A decrease will result in VMs being destroyed.
Parameters: size ( int
) – Number to instances to resize to.Returns: True if successful Return type: bool
-
set_instancetemplate
(instancetemplate)[source]¶ Set the Instance Template for this Instance Group.
Parameters: instancetemplate ( GCEInstanceTemplate
) – Instance Template to set.Returns: True if successful Return type: bool
- id (
-
class
libcloud.compute.drivers.gce.
GCEInstanceTemplate
(id, name, driver, extra=None)[source]¶ Bases:
libcloud.compute.base.UuidMixin
Represents a machine configuration used in creating Instance Groups.
-
class
libcloud.compute.drivers.gce.
GCELicense
(name, project, driver)[source]¶ Bases:
libcloud.compute.base.UuidMixin
,libcloud.common.base.LazyObject
A GCE License used to track software usage in GCE nodes.
-
class
libcloud.compute.drivers.gce.
GCEList
(driver, list_fn, **kwargs)[source]¶ Bases:
object
An Iterator that wraps list functions to provide additional features.
GCE enforces a limit on the number of objects returned by a list operation, so users with more than 500 objects of a particular type will need to use filter(), page() or both.
>>> l=GCEList(driver, driver.ex_list_urlmaps) >>> for sublist in l.filter('name eq ...-map').page(1): ... sublist ... [<GCEUrlMap id="..." name="cli-map">] [<GCEUrlMap id="..." name="web-map">]
One can create a GCEList manually, but it’s slightly easier to use the ex_list() method of
GCENodeDriver
.Parameters: - driver (:class:
GCENodeDriver
) – An initialized :class:GCENodeDriver
- list_fn (
instancemethod
) – A bound list method fromGCENodeDriver
.
-
filter
(expression)[source]¶ Filter results of a list operation.
GCE supports server-side filtering of resources returned by a list operation. Syntax of the filter expression is fully described in the GCE API reference doc, but in brief it is:
FIELD_NAME COMPARISON_STRING LITERAL_STRING
where FIELD_NAME is the resource’s property name, COMPARISON_STRING is ‘eq’ or ‘ne’, and LITERAL_STRING is a regular expression in RE2 syntax.
>>> for sublist in l.filter('name eq ...-map'): ... sublist ... [<GCEUrlMap id="..." name="cli-map">, <GCEUrlMap id="..." name="web-map">]
API reference: https://cloud.google.com/compute/docs/reference/latest/ RE2 syntax: https://github.com/google/re2/blob/master/doc/syntax.txt
Parameters: expression ( str
) – Filter expression described above.Returns: This GCEList
instanceReturn type: GCEList
-
page
(max_results=500)[source]¶ Limit the number of results by each iteration.
This implements the paging functionality of the GCE list methods and returns this GCEList instance so that results can be chained:
>>> for sublist in GCEList(driver, driver.ex_list_urlmaps).page(2): ... sublist ... [<GCEUrlMap id="..." name="cli-map">, <GCEUrlMap id="..." name="lc-map">] [<GCEUrlMap id="..." name="web-map">]
Parameters: max_results ( int
) – Maximum number of results to return per iteration. Defaults to the GCE default of 500.Returns: This GCEList
instanceReturn type: GCEList
- driver (:class:
-
class
libcloud.compute.drivers.gce.
GCENetwork
(id, name, cidr, driver, extra=None)[source]¶ Bases:
libcloud.compute.base.UuidMixin
A GCE Network object class.
-
class
libcloud.compute.drivers.gce.
GCENodeDriver
(user_id, key=None, datacenter=None, project=None, auth_type=None, scopes=None, credential_file=None, **kwargs)[source]¶ Bases:
libcloud.compute.base.NodeDriver
GCE Node Driver class.
This is the primary driver for interacting with Google Compute Engine. It contains all of the standard libcloud methods, plus additional ex_* methods for more features.
Note that many methods allow either objects or strings (or lists of objects/strings). In most cases, passing strings instead of objects will result in additional GCE API calls.
Parameters: - user_id (
str
) – The email address (for service accounts) or Client ID (for installed apps) to be used for authentication. - key (
str
) – The RSA Key (for service accounts) or file path containing key or Client Secret (for installed apps) to be used for authentication. - datacenter (
str
) – The name of the datacenter (zone) used for operations. - project (
str
) – Your GCE project name. (required) - auth_type (
str
) – Accepted values are “SA” or “IA” or “GCE” (“Service Account” or “Installed Application” or “GCE” if libcloud is being used on a GCE instance with service account enabled). If not supplied, auth_type will be guessed based on value of user_id or if the code is being executed in a GCE instance. - scopes (
list
) – List of authorization URLs. Default is empty and grants read/write to Compute, Storage, DNS. - credential_file (
str
) – Path to file for caching authentication information used by GCEConnection.
-
AUTH_URL
= 'https://www.googleapis.com/auth/'¶
-
GUEST_OS_FEATURES
= ['VIRTIO_SCSI_MULTIQUEUE']¶
-
IMAGE_PROJECTS
= {'centos-cloud': ['centos'], 'ubuntu-os-cloud': ['ubuntu'], 'debian-cloud': ['debian', 'backports'], 'windows-cloud': ['windows'], 'suse-cloud': ['sles', 'suse'], 'google-containers': ['container-vm'], 'opensuse-cloud': ['opensuse'], 'coreos-cloud': ['coreos'], 'gce-nvme': ['nvme-backports'], 'rhel-cloud': ['rhel']}¶
-
KIND_METHOD_MAP
= {'compute#region': <function _to_region at 0x7f61eb783230>, 'compute#targetInstance': <function _to_targetinstance at 0x7f61eb783410>, 'compute#instance': <function _to_node at 0x7f61eb7830c8>, 'compute#targetHttpProxy': <function _to_targethttpproxy at 0x7f61eb783398>, 'compute#backendService': <function _to_backendservice at 0x7f61eb782c08>, 'compute#machineType': <function _to_node_size at 0x7f61eb783140>, 'compute#image': <function _to_node_image at 0x7f61eb782f50>, 'compute#address': <function _to_address at 0x7f61eb782b90>, 'compute#snapshot': <function _to_snapshot at 0x7f61eb7832a8>, 'compute#httpHealthCheck': <function _to_healthcheck at 0x7f61eb782c80>, 'compute#disk': <function _to_storage_volume at 0x7f61eb783320>, 'compute#forwardingRule': <function _to_forwarding_rule at 0x7f61eb782d70>, 'compute#urlMap': <function _to_urlmap at 0x7f61eb783758>, 'compute#project': <function _to_project at 0x7f61eb7831b8>, 'compute#network': <function _to_network at 0x7f61eb782e60>, 'compute#zone': <function _to_zone at 0x7f61eb7837d0>, 'compute#firewall': <function _to_firewall at 0x7f61eb782cf8>, 'compute#targetPool': <function _to_targetpool at 0x7f61eb783488>}¶
-
NODE_STATE_MAP
= {'TERMINATED': 'stopped', 'STAGING': 'pending', 'UNKNOWN': 'unknown', 'PROVISIONING': 'pending', 'RUNNING': 'running', 'STOPPING': 'pending'}¶
-
SA_SCOPES_MAP
= {'cloud-platform': 'cloud-platform', 'monitoring': 'monitoring', 'storage-ro': 'devstorage.read_only', 'compute-rw': 'compute', 'sql': 'sqlservice', 'bigquery': 'bigquery', 'sql-admin': 'sqlservice.admin', 'userinfo-email': 'userinfo.email', 'taskqueue': 'taskqueue', 'logging-write': 'logging.write', 'storage-rw': 'devstorage.read_write', 'service-management': 'service.management', 'monitoring-write': 'monitoring.write', 'datastore': 'datastore', 'storage-full': 'devstorage.full_control', 'useraccounts-ro': 'cloud.useraccounts.readonly', 'service-control': 'servicecontrol', 'useraccounts-rw': 'cloud.useraccounts', 'compute-ro': 'compute.readonly'}¶
-
api_name
= 'google'¶
-
attach_volume
(node, volume, device=None, ex_mode=None, ex_boot=False, ex_type=None, ex_source=None, ex_auto_delete=None, ex_initialize_params=None, ex_licenses=None, ex_interface=None)[source]¶ Attach a volume to a node.
If volume is None, an ex_source URL must be provided.
Parameters: - node (
Node
orNone
) – The node to attach the volume to - volume (
StorageVolume
orNone
) – The volume to attach. - device (
str
) – The device name to attach the volume as. Defaults to volume name. - ex_mode (
str
) – Either ‘READ_WRITE’ or ‘READ_ONLY’ - ex_boot (
bool
) – If true, disk will be attached as a boot disk - ex_type (
str
) – Specify either ‘PERSISTENT’ (default) or ‘SCRATCH’. - ex_source (
str
orNone
) – URL (full or partial) of disk source. Must be present if not using an existing StorageVolume. - ex_auto_delete (
bool
orNone
) – If set, the disk will be auto-deleted if the parent node/instance is deleted. - ex_initialize_params (
dict
orNone
) – Allow user to pass in full JSON struct of initializeParams as documented in GCE’s API. - ex_licenses (
list
ofstr
) – List of strings representing licenses associated with the volume/disk. - ex_interface (
str
orNone
) – User can specify either ‘SCSI’ (default) or ‘NVME’.
Returns: True if successful
Return type: bool
- node (
-
connectionCls
¶ alias of
GCEConnection
-
create_node
(name, size, image, location=None, ex_network='default', ex_subnetwork=None, ex_tags=None, ex_metadata=None, ex_boot_disk=None, use_existing_disk=True, external_ip='ephemeral', ex_disk_type='pd-standard', ex_disk_auto_delete=True, ex_service_accounts=None, description=None, ex_can_ip_forward=None, ex_disks_gce_struct=None, ex_nic_gce_struct=None, ex_on_host_maintenance=None, ex_automatic_restart=None, ex_preemptible=None, ex_image_family=None)[source]¶ Create a new node and return a node object for the node.
Parameters: - name (
str
) – The name of the node to create. - size (
str
orGCENodeSize
) – The machine type to use. - image (
str
orGCENodeImage
orNone
) – The image to use to create the node (or, if attaching a persistent disk, the image used to create the disk) - location (
str
orNodeLocation
orGCEZone
orNone
) – The location (zone) to create the node in. - ex_network (
str
orGCENetwork
) – The network to associate with the node. - ex_subnetwork (
str
orGCESubnetwork
) – The subnetwork to associate with the node. - ex_tags (
list
ofstr
orNone
) – A list of tags to associate with the node. - ex_metadata (
dict
orNone
) – Metadata dictionary for instance. - ex_boot_disk (
StorageVolume
orstr
orNone
) – The boot disk to attach to the instance. - use_existing_disk (
bool
) – If True and if an existing disk with the same name/location is found, use that disk instead of creating a new one. - external_ip (
GCEAddress
orstr
orNone
) – The external IP address to use. If ‘ephemeral’ (default), a new non-static address will be used. If ‘None’, then no external address will be used. To use an existing static IP address, a GCEAddress object should be passed in. - ex_disk_type (
str
orGCEDiskType
) – Specify a pd-standard (default) disk or pd-ssd for an SSD disk. - ex_disk_auto_delete (
bool
) – Indicate that the boot disk should be deleted when the Node is deleted. Set to True by default. - ex_service_accounts (
list
) – Specify a list of serviceAccounts when creating the instance. The format is a list of dictionaries containing email and list of scopes, e.g. [{‘email’:’default’, ‘scopes’:[‘compute’, ...]}, ...] Scopes can either be full URLs or short names. If not provided, use the ‘default’ service account email and a scope of ‘devstorage.read_only’. Also accepts the aliases defined in ‘gcloud compute’. - description (
str
orNone
) – The description of the node (instance). - ex_can_ip_forward (
bool
orNone
) – Set toTrue
to allow this node to send/receive non-matching src/dst packets. - ex_disks_gce_struct (
list
orNone
) – Support for passing in the GCE-specific formatted disks[] structure. No attempt is made to ensure proper formatting of the disks[] structure. Using this structure obviates the need of using other disk params like ‘ex_boot_disk’, etc. See the GCE docs for specific details. - ex_nic_gce_struct (
list
orNone
) – Support passing in the GCE-specific formatted networkInterfaces[] structure. No attempt is made to ensure proper formatting of the networkInterfaces[] data. Using this structure obviates the need of using ‘external_ip’ and ‘ex_network’. See the GCE docs for details. - ex_on_host_maintenance (
str
orNone
) – Defines whether node should be terminated or migrated when host machine goes down. Acceptable values are: ‘MIGRATE’ or ‘TERMINATE’ (If not supplied, value will be reset to GCE default value for the instance type.) - ex_automatic_restart (
bool
orNone
) – Defines whether the instance should be automatically restarted when it is terminated by Compute Engine. (If not supplied, value will be set to the GCE default value for the instance type.) - ex_preemptible (
bool
orNone
) – Defines whether the instance is preemptible. (If not supplied, the instance will not be preemptible) - ex_image_family (
str
orNone
) – Determine image from an ‘Image Family’ instead of by name. ‘image’ should be None to use this keyword.
Returns: A Node object for the new node.
Return type: Node
- name (
-
create_volume
(size, name, location=None, snapshot=None, image=None, use_existing=True, ex_disk_type='pd-standard', ex_image_family=None)[source]¶ Create a volume (disk).
Parameters: - size (
int
orstr
orNone
) – Size of volume to create (in GB). Can be None if image or snapshot is supplied. - name (
str
) – Name of volume to create - location (
str
orGCEZone
orNodeLocation
orNone
) – Location (zone) to create the volume in - snapshot (
GCESnapshot
orstr
orNone
) – Snapshot to create image from - image (
GCENodeImage
orstr
orNone
) – Image to create disk from. - use_existing (
bool
) – If True and a disk with the given name already exists, return an object for that disk instead of attempting to create a new disk. - ex_disk_type (
str
orGCEDiskType
) – Specify a pd-standard (default) disk or pd-ssd for an SSD disk. - ex_image_family (
str
orNone
) – Determine image from an ‘Image Family’ instead of by name. ‘image’ should be None to use this keyword.
Returns: Storage Volume object
Return type: StorageVolume
- size (
-
create_volume_snapshot
(volume, name)[source]¶ Create a snapshot of the provided Volume.
Parameters: volume ( StorageVolume
) – A StorageVolume objectReturns: A GCE Snapshot object Return type: GCESnapshot
-
deploy_node
(name, size, image, script, location=None, ex_network='default', ex_tags=None, ex_service_accounts=None)[source]¶ Create a new node and run a script on start-up.
Parameters: - name (
str
) – The name of the node to create. - size (
str
orGCENodeSize
) – The machine type to use. - image (
str
orGCENodeImage
) – The image to use to create the node. - script (
str
) – File path to start-up script - location (
str
orNodeLocation
orGCEZone
orNone
) – The location (zone) to create the node in. - ex_network (
str
orGCENetwork
) – The network to associate with the node. - ex_tags (
list
ofstr
orNone
) – A list of tags to associate with the node. - ex_service_accounts (
list
) – Specify a list of serviceAccounts when creating the instance. The format is a list of dictionaries containing email and list of scopes, e.g. [{‘email’:’default’, ‘scopes’:[‘compute’, ...]}, ...] Scopes can either be full URLs or short names. If not provided, use the ‘default’ service account email and a scope of ‘devstorage.read_only’. Also accepts the aliases defined in ‘gcloud compute’.
Returns: A Node object for the new node.
Return type: Node
- name (
-
destroy_node
(node, destroy_boot_disk=False)[source]¶ Destroy a node.
Parameters: - node (
Node
) – Node object to destroy - destroy_boot_disk (
bool
) – If true, also destroy the node’s boot disk. (Note that this keyword is not accessible from the node’s .destroy() method.)
Returns: True if successful
Return type: bool
- node (
-
destroy_volume
(volume)[source]¶ Destroy a volume.
Parameters: volume ( StorageVolume
) – Volume object to destroyReturns: True if successful Return type: bool
-
destroy_volume_snapshot
(snapshot)[source]¶ Destroy a snapshot.
Parameters: snapshot ( GCESnapshot
) – Snapshot object to destroyReturns: True if successful Return type: bool
-
detach_volume
(volume, ex_node=None)[source]¶ Detach a volume from a node.
Parameters: - volume (
StorageVolume
) – Volume object to detach - ex_node (
Node
) – Node object to detach volume from (required)
Returns: True if successful
Return type: bool
- volume (
-
ex_add_access_config
(node, name, nic, nat_ip=None, config_type=None)[source]¶ Add a network interface access configuration to a node.
Parameters: - node (
str
) – The existing target Node (instance) that will receive the new access config. - name – Name of the new access config.
- nat_ip (
str
orNone
) – The external existing static IP Address to use for the access config. If not provided, an ephemeral IP address will be allocated. - config_type (
str
orNone
) – The type of access config to create. Currently the only supported type is ‘ONE_TO_ONE_NAT’.
Returns: True if successful
Return type: bool
- node (
-
ex_copy_image
(name, url, description=None, family=None, guest_os_features=None)[source]¶ Copy an image to your image collection.
Parameters: - name (
str
) – The name of the image - url – The URL to the image. The URL can start with gs://
- url –
str
- description (
str
) – The description of the image - family (
str
) – The family of the image - guest_os_features (
list
ofstr
orNone
) – The features of the guest operating system.
Returns: NodeImage object based on provided information or None if an image with that name is not found.
Return type: NodeImage
orNone
- name (
-
ex_create_address
(name, region=None, address=None, description=None)[source]¶ Create a static address in a region, or a global address.
Parameters: - name (
str
) – Name of static address - region (
str
orGCERegion
) – Name of region for the address (e.g. ‘us-central1’) Use ‘global’ to create a global address. - address (
str
orNone
) – Ephemeral IP address to promote to a static one (e.g. ‘xxx.xxx.xxx.xxx’) - description (
str
orNone
) – Optional descriptive comment.
Returns: Static Address object
Return type: - name (
-
ex_create_autoscaler
(name, zone, instance_group, policy, description=None)[source]¶ Create an Autoscaler for an Instance Group.
Parameters: - name (
str
) – The name of the Autoscaler - zone (
str
orGCEZone
) – The zone to which the Instance Group belongs - instance_group – An Instance Group Manager object.
- policy – A dict containing policy configuration. See the API documentation for Autoscalers for more details.
Type: Type: dict
Returns: An Autoscaler object.
Return type: - name (
-
ex_create_backendservice
(name, healthchecks)[source]¶ Create a global Backend Service.
Parameters: - name (
str
) – Name of the Backend Service - healthchecks (
list
of (str
orGCEHealthCheck
)) – A list of HTTP Health Checks to use for this service. There must be at least one.
Returns: A Backend Service object.
Return type: - name (
-
ex_create_firewall
(name, allowed, network='default', source_ranges=None, source_tags=None, target_tags=None)[source]¶ Create a firewall on a network.
Firewall rules should be supplied in the “allowed” field. This is a list of dictionaries formated like so (“ports” is optional):
[{"IPProtocol": "<protocol string or number>", "ports": "<port_numbers or ranges>"}]
For example, to allow tcp on port 8080 and udp on all ports, ‘allowed’ would be:
[{"IPProtocol": "tcp", "ports": ["8080"]}, {"IPProtocol": "udp"}]
See Firewall Reference for more information.
Parameters: - name (
str
) – Name of the firewall to be created - allowed (
list
ofdict
) – List of dictionaries with rules - network (
str
orGCENetwork
) – The network that the firewall applies to. - source_ranges (
list
ofstr
) – A list of IP ranges in CIDR format that the firewall should apply to. Defaults to [‘0.0.0.0/0’] - source_tags (
list
ofstr
) – A list of source instance tags the rules apply to. - target_tags (
list
ofstr
) – A list of target instance tags the rules apply to.
Returns: Firewall object
Return type: - name (
-
ex_create_forwarding_rule
(name, target=None, region=None, protocol='tcp', port_range=None, address=None, description=None, global_rule=False, targetpool=None)[source]¶ Create a forwarding rule.
Parameters: - name (
str
) – Name of forwarding rule to be created - target (
str
orGCETargetHttpProxy
orGCETargetInstance
orGCETargetPool
) – The target of this forwarding rule. For global forwarding rules this must be a global TargetHttpProxy. For regional rules this may be either a TargetPool or TargetInstance. If passed a string instead of the object, it will be the name of a TargetHttpProxy for global rules or a TargetPool for regional rules. A TargetInstance must be passed by object. (required) - region (
str
orGCERegion
) – Region to create the forwarding rule in. Defaults to self.region. Ignored if global_rule is True. - protocol (
str
) – Should be ‘tcp’ or ‘udp’ - port_range (
str
) – Single port number or range separated by a dash. Examples: ‘80’, ‘5000-5999’. Required for global forwarding rules, optional for regional rules. - address (
str
orGCEAddress
) – Optional static address for forwarding rule. Must be in same region. - description (
str
orNone
) – The description of the forwarding rule. Defaults to None. - targetpool (
str
orGCETargetPool
) – Deprecated parameter for backwards compatibility. Use target instead.
Returns: Forwarding Rule object
Return type: - name (
-
ex_create_healthcheck
(name, host=None, path=None, port=None, interval=None, timeout=None, unhealthy_threshold=None, healthy_threshold=None, description=None)[source]¶ Create an Http Health Check.
Parameters: - name (
str
) – Name of health check - host (
str
) – Hostname of health check request. Defaults to empty and public IP is used instead. - path (
str
) – The request path for the check. Defaults to /. - port (
int
) – The TCP port number for the check. Defaults to 80. - interval (
int
) – How often (in seconds) to check. Defaults to 5. - timeout (
int
) – How long to wait before failing. Defaults to 5. - unhealthy_threshold (
int
) – How many failures before marking unhealthy. Defaults to 2. - healthy_threshold (
int
) – How many successes before marking as healthy. Defaults to 2. - description (
str
orNone
) – The description of the check. Defaults to None.
Returns: Health Check object
Return type: - name (
-
ex_create_image
(name, volume, description=None, family=None, guest_os_features=None, use_existing=True, wait_for_completion=True)[source]¶ Create an image from the provided volume.
Parameters: - name (
str
) – The name of the image to create. - volume (
str
orStorageVolume
) – The volume to use to create the image, or the Google Cloud Storage URI - description (
str
) – Description of the new Image - family (
str
) – The name of the image family to which this image belongs. If you create resources by specifying an image family instead of a specific image name, the resource uses the latest non-deprecated image that is set with that family name. - use_existing (
bool
) – If True and an image with the given name already exists, return an object for that image instead of attempting to create a new image. - wait_for_completion (
bool
) – If True, wait until the new image is created before returning a new NodeImage Otherwise, return a new NodeImage instance, and let the user track the creation progress
Keywork guest_os_features: Features of the guest operating system, valid for bootable images only. Possible values include ‘VIRTIO_SCSI_MULTIQUEUE’ if specified.
Returns: A GCENodeImage object for the new image
Return type: - name (
-
ex_create_instancegroupmanager
(name, zone, template, size, base_instance_name=None, description=None)[source]¶ Create a Managed Instance Group.
Parameters: - name (
str
) – Name of the Instance Group. - zone (
str
orGCEZone
orNone
) – The zone to which the Instance Group belongs - template (
str
orGCEInstanceTemplate
) – The Instance Template. Should be an instance of GCEInstanceTemplate or a string. - base_instance_name (
str
) – The prefix for each instance created. If None, Instance Group name will be used. - description (
str
) – User-supplied text about the Instance Group.
Returns: An Instance Group Manager object.
Return type: - name (
-
ex_create_multiple_nodes
(base_name, size, image, number, location=None, ex_network='default', ex_tags=None, ex_metadata=None, ignore_errors=True, use_existing_disk=True, poll_interval=2, external_ip='ephemeral', ex_disk_type='pd-standard', ex_disk_auto_delete=True, ex_service_accounts=None, timeout=180, description=None, ex_can_ip_forward=None, ex_disks_gce_struct=None, ex_nic_gce_struct=None, ex_on_host_maintenance=None, ex_automatic_restart=None, ex_image_family=None)[source]¶ Create multiple nodes and return a list of Node objects.
Nodes will be named with the base name and a number. For example, if the base name is ‘libcloud’ and you create 3 nodes, they will be named:
libcloud-000 libcloud-001 libcloud-002
Parameters: - base_name (
str
) – The base name of the nodes to create. - size (
str
orGCENodeSize
) – The machine type to use. - image (
str
orGCENodeImage
) – The image to use to create the nodes. - number (
int
) – The number of nodes to create. - location (
str
orNodeLocation
orGCEZone
orNone
) – The location (zone) to create the nodes in. - ex_network (
str
orGCENetwork
) – The network to associate with the nodes. - ex_tags (
list
ofstr
orNone
) – A list of tags to associate with the nodes. - ex_metadata (
dict
orNone
) – Metadata dictionary for instances. - ignore_errors (
bool
) – If True, don’t raise Exceptions if one or more nodes fails. - use_existing_disk (
bool
) – If True and if an existing disk with the same name/location is found, use that disk instead of creating a new one. - poll_interval (
int
) – Number of seconds between status checks. - external_ip (
str
or None) – The external IP address to use. If ‘ephemeral’ (default), a new non-static address will be used. If ‘None’, then no external address will be used. (Static addresses are not supported for multiple node creation.) - ex_disk_type (
str
orGCEDiskType
) – Specify a pd-standard (default) disk or pd-ssd for an SSD disk. - ex_disk_auto_delete (
bool
) – Indicate that the boot disk should be deleted when the Node is deleted. Set to True by default. - ex_service_accounts (
list
) – Specify a list of serviceAccounts when creating the instance. The format is a list of dictionaries containing email and list of scopes, e.g. [{‘email’:’default’, ‘scopes’:[‘compute’, ...]}, ...] Scopes can either be full URLs or short names. If not provided, use the ‘default’ service account email and a scope of ‘devstorage.read_only’. Also accepts the aliases defined in ‘gcloud compute’. - timeout (
int
) – The number of seconds to wait for all nodes to be created before timing out. - description (
str
orNone
) – The description of the node (instance). - ex_can_ip_forward (
bool
orNone
) – Set toTrue
to allow this node to send/receive non-matching src/dst packets. - ex_disks_gce_struct (
list
orNone
) – Support for passing in the GCE-specific formatted disks[] structure. No attempt is made to ensure proper formatting of the disks[] structure. Using this structure obviates the need of using other disk params like ‘ex_boot_disk’, etc. See the GCE docs for specific details. - ex_nic_gce_struct (
list
orNone
) – Support passing in the GCE-specific formatted networkInterfaces[] structure. No attempt is made to ensure proper formatting of the networkInterfaces[] data. Using this structure obviates the need of using ‘external_ip’ and ‘ex_network’. See the GCE docs for details. - ex_on_host_maintenance (
str
orNone
) – Defines whether node should be terminated or migrated when host machine goes down. Acceptable values are: ‘MIGRATE’ or ‘TERMINATE’ (If not supplied, value will be reset to GCE default value for the instance type.) - ex_automatic_restart (
bool
orNone
) – Defines whether the instance should be automatically restarted when it is terminated by Compute Engine. (If not supplied, value will be set to the GCE default value for the instance type.) - ex_image_family (
str
orNone
) – Determine image from an ‘Image Family’ instead of by name. ‘image’ should be None to use this keyword.
Returns: A list of Node objects for the new nodes.
Return type: list
ofNode
- base_name (
-
ex_create_network
(name, cidr, description=None, mode='legacy')[source]¶ Create a network. In November 2015, Google introduced Subnetworks and suggests using networks with ‘auto’ generated subnetworks. See, the subnet docs for more details. Note that libcloud follows the usability pattern from the Cloud SDK (e.g. ‘gcloud compute’ command-line utility) and uses ‘mode’ to specify ‘auto’, ‘custom’, or ‘legacy’.
Parameters: - name (
str
) – Name of network to be created - cidr (
str
orNone
) – Address range of network in CIDR format. - description (
str
orNone
) – Custom description for the network. - mode (
str
) – Create a ‘auto’, ‘custom’, or ‘legacy’ network.
Returns: Network object
Return type: - name (
-
ex_create_route
(name, dest_range, priority=500, network='default', tags=None, next_hop=None, description=None)[source]¶ Create a route.
Parameters: - name (
str
) – Name of route to be created - dest_range (
str
) – Address range of route in CIDR format. - priority (
int
) – Priority value, lower values take precedence - network (
str
orGCENetwork
) – The network the route belongs to. Can be either the full URL of the network or a libcloud object. - tags (
list
ofstr
orNone
) – List of instance-tags for routing, empty for all nodes - next_hop (
str
,Node
, orNone
) – Next traffic hop. UseNone
for the default Internet gateway, or specify an instance or IP address. - description (
str
orNone
) – Custom description for the route.
Returns: Route object
Return type: - name (
-
ex_create_subnetwork
(name, cidr=None, network=None, region=None, description=None)[source]¶ Create a subnetwork.
Parameters: - name (
str
) – Name of subnetwork to be created - cidr (
str
) – Address range of network in CIDR format. - network (
str
orGCENetwork
) – The network name or object this subnet belongs to. - region (
str
orGCERegion
) – The region the subnetwork belongs to. - description (
str
orNone
) – Custom description for the network.
Returns: Subnetwork object
Return type: - name (
-
ex_create_targethttpproxy
(name, urlmap)[source]¶ Create a target HTTP proxy.
Parameters: - name (
str
) – Name of target HTTP proxy - urlmap – URL map defining the mapping from URl to the backendservice.
Returns: Target Pool object
Return type: - name (
-
ex_create_targetinstance
(name, zone=None, node=None, description=None, nat_policy='NO_NAT')[source]¶ Create a target instance.
Parameters: - name (
str
) – Name of target instance - region (
str
orGCEZone
orNone
) – Zone to create the target pool in. Defaults to self.zone - node (
str
orNode
) – The actual instance to be used as the traffic target. - description (
str
orNone
) – A text description for the target instance - nat_policy (
str
) – The NAT option for how IPs are NAT’d to the node.
Returns: Target Instance object
Return type: - name (
-
ex_create_targetpool
(name, region=None, healthchecks=None, nodes=None, session_affinity=None, backup_pool=None, failover_ratio=None)[source]¶ Create a target pool.
Parameters: - name (
str
) – Name of target pool - region (
str
orGCERegion
orNone
) – Region to create the target pool in. Defaults to self.region - healthchecks (
list
ofstr
orGCEHealthCheck
) – Optional list of health checks to attach - nodes (
list
ofstr
orNode
) – Optional list of nodes to attach to the pool - session_affinity (
str
) – Optional algorithm to use for session affinity. - backup_pool (
GCETargetPool
orNone
) – Optional backup targetpool to take over traffic if the failover_ratio is exceeded. - failover_ratio (
GCETargetPool
orNone
) – The percentage of healthy VMs must fall at or below this value before traffic will be sent to the backup_pool.
Returns: Target Pool object
Return type: - name (
-
ex_create_urlmap
(name, default_service)[source]¶ Create a URL Map.
Parameters: - name (
str
) – Name of the URL Map. - default_service (
str
orGCEBackendService
) – Default backend service for the map.
Returns: URL Map object
Return type: - name (
-
ex_delete_access_config
(node, name, nic)[source]¶ Delete a network interface access configuration from a node.
Parameters: - node (
str
) – The existing target Node (instance) for the request. - name – Name of the access config.
- nic (
str
) – Name of the network interface.
Returns: True if successful
Return type: bool
- node (
-
ex_delete_image
(image)[source]¶ Delete a specific image resource.
Parameters: image ( str
orGCENodeImage
) – Image object to deleteReturns: True if successful Return type: bool
-
ex_deprecate_image
(image, replacement, state=None, deprecated=None, obsolete=None, deleted=None)[source]¶ Deprecate a specific image resource.
Parameters: - image (
str
or :class: GCENodeImage) – Image object to deprecate - replacement (
str
or :class: GCENodeImage) – Image object to use as a replacement - state (
str
) – State of the image - deprecated (
str
orNone
) – RFC3339 timestamp to mark DEPRECATED - obsolete (
str
orNone
) – RFC3339 timestamp to mark OBSOLETE - deleted (
str
orNone
) – RFC3339 timestamp to mark DELETED
Returns: True if successful
Return type: bool
- image (
-
ex_destroy_address
(address)[source]¶ Destroy a static address.
Parameters: address ( str
orGCEAddress
) – Address object to destroyReturns: True if successful Return type: bool
-
ex_destroy_autoscaler
(autoscaler)[source]¶ Destroy an Autoscaler.
Parameters: autoscaler ( GCEAutoscaler
) – Autoscaler object to destroy.Returns: True if successful Return type: bool
-
ex_destroy_backendservice
(backendservice)[source]¶ Destroy a Backend Service.
Parameters: backendservice ( GCEBackendService
) – BackendService object to destroyReturns: True if successful Return type: bool
-
ex_destroy_firewall
(firewall)[source]¶ Destroy a firewall.
Parameters: firewall ( GCEFirewall
) – Firewall object to destroyReturns: True if successful Return type: bool
-
ex_destroy_forwarding_rule
(forwarding_rule)[source]¶ Destroy a forwarding rule.
Parameters: forwarding_rule ( GCEForwardingRule
) – Forwarding Rule object to destroyReturns: True if successful Return type: bool
-
ex_destroy_healthcheck
(healthcheck)[source]¶ Destroy a healthcheck.
Parameters: healthcheck ( GCEHealthCheck
) – Health check object to destroyReturns: True if successful Return type: bool
-
ex_destroy_instancegroupmanager
(manager)[source]¶ Destroy a managed instance group. This will destroy all instances that belong to the instance group.
Parameters: manager ( GCEInstanceGroup
) – InstanceGroup object to destroy.Returns: True if successful Return type: bool
-
ex_destroy_multiple_nodes
(node_list, ignore_errors=True, destroy_boot_disk=False, poll_interval=2, timeout=180)[source]¶ Destroy multiple nodes at once.
Parameters: - node_list (
list
ofNode
) – List of nodes to destroy - ignore_errors (
bool
) – If true, don’t raise an exception if one or more nodes fails to be destroyed. - destroy_boot_disk (
bool
) – If true, also destroy the nodes’ boot disks. - poll_interval (
int
) – Number of seconds between status checks. - timeout (
int
) – Number of seconds to wait for all nodes to be destroyed.
Returns: A list of boolean values. One for each node. True means that the node was successfully destroyed.
Return type: list
ofbool
- node_list (
-
ex_destroy_network
(network)[source]¶ Destroy a network.
Parameters: network ( GCENetwork
) – Network object to destroyReturns: True if successful Return type: bool
-
ex_destroy_route
(route)[source]¶ Destroy a route.
Parameters: route ( GCERoute
) – Route object to destroyReturns: True if successful Return type: bool
-
ex_destroy_subnetwork
(name, region=None)[source]¶ Delete a Subnetwork object based on name and region.
Parameters: - name (
str
orGCERegion
orNone
) – The name, URL or object of the subnetwork - name – The region object, name, or URL of the subnetwork
Returns: True if successful
Return type: bool
- name (
-
ex_destroy_targethttpproxy
(targethttpproxy)[source]¶ Destroy a target HTTP proxy.
Parameters: targethttpproxy ( GCETargetHttpProxy
) – TargetHttpProxy object to destroyReturns: True if successful Return type: bool
-
ex_destroy_targetinstance
(targetinstance)[source]¶ Destroy a target instance.
Parameters: targetinstance ( GCETargetInstance
) – TargetInstance object to destroyReturns: True if successful Return type: bool
-
ex_destroy_targetpool
(targetpool)[source]¶ Destroy a target pool.
Parameters: targetpool ( GCETargetPool
) – TargetPool object to destroyReturns: True if successful Return type: bool
-
ex_destroy_urlmap
(urlmap)[source]¶ Destroy a URL map.
Parameters: urlmap ( GCEUrlMap
) – UrlMap object to destroyReturns: True if successful Return type: bool
-
ex_get_address
(name, region=None)[source]¶ Return an Address object based on an address name and optional region.
Parameters: - name (
str
) – The name of the address - region (
str
GCERegion
orNone
) – The region to search for the address in (set to ‘all’ to search all regions)
Returns: An Address object for the address
Return type: - name (
-
ex_get_autoscaler
(name, zone=None)[source]¶ Return an Autoscaler object based on a name and optional zone.
Parameters: - name (
str
) – The name of the Autoscaler. - zone (
str
orGCEZone
orNone
) – The zone to search for the Autoscaler. Set to ‘all’ to search all zones.
Returns: An Autoscaler object.
Return type: - name (
-
ex_get_backendservice
(name)[source]¶ Return a Backend Service object based on name
Parameters: name ( str
) – The name of the backend serviceReturns: A BackendService object for the backend service Return type: GCEBackendService
-
ex_get_disktype
(name, zone=None)[source]¶ Return a DiskType object based on a name and optional zone.
Parameters: - name (
str
) – The name of the DiskType - zone (
str
GCEZone
orNone
) – The zone to search for the DiskType in (set to ‘all’ to search all zones)
Returns: A DiskType object for the name
Return type: - name (
-
ex_get_firewall
(name)[source]¶ Return a Firewall object based on the firewall name.
Parameters: name ( str
) – The name of the firewallReturns: A GCEFirewall object Return type: GCEFirewall
-
ex_get_forwarding_rule
(name, region=None, global_rule=False)[source]¶ Return a Forwarding Rule object based on the forwarding rule name.
Parameters: - name (
str
) – The name of the forwarding rule - region (
str
orNone
) – The region to search for the rule in (set to ‘all’ to search all regions). - global_rule (
bool
) – Set to True to get a global forwarding rule. Region will be ignored if True.
Returns: A GCEForwardingRule object
Return type: - name (
-
ex_get_healthcheck
(name)[source]¶ Return a HealthCheck object based on the healthcheck name.
Parameters: name ( str
) – The name of the healthcheckReturns: A GCEHealthCheck object Return type: GCEHealthCheck
-
ex_get_image
(partial_name, ex_project_list=None, ex_standard_projects=True)[source]¶ Return an GCENodeImage object based on the name or link provided.
Parameters: - partial_name (
str
) – The name, partial name, or full path of a GCE image. - ex_project_list – The name of the project to list for images. Examples include: ‘debian-cloud’.
- ex_standard_projects (
bool
) – If true, check in standard projects if the image is not found.
Returns: GCENodeImage object based on provided information or None if an image with that name is not found.
Return type: GCENodeImage
or raiseResourceNotFoundError
- partial_name (
-
ex_get_image_from_family
(image_family, ex_project_list=None, ex_standard_projects=True)[source]¶ Return an GCENodeImage object based on an image family name.
Parameters: - image_family (
str
) – The name of the ‘Image Family’ to return the latest image from. - ex_project_list (
list
ofstr
, orNone
) – The name of the project to list for images. Examples include: ‘debian-cloud’. - ex_standard_projects (
bool
) – If true, check in standard projects if the image is not found.
Returns: GCENodeImage object based on provided information or ResourceNotFoundError if the image family is not found.
Return type: GCENodeImage
or raiseResourceNotFoundError
- image_family (
-
ex_get_instancegroup
(name, zone=None)[source]¶ Returns the specified Instance Group. Get a list of available instance groups by making a list() request.
Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute * https://www.googleapis.com/auth/compute.readonly
Parameters: - name (
str
) – The name of the instance group. - zone (
str
) – The name of the zone where the instance group is located.
Returns: GCEInstanceGroup object.
Return type: - name (
-
ex_get_instancegroupmanager
(name, zone=None)[source]¶ Return a InstanceGroupManager object based on a name and optional zone.
Parameters: - name (
str
) – The name of the Instance Group Manager. - zone (
str
orGCEZone
orNone
) – The zone to search for the Instance Group Manager. Set to ‘all’ to search all zones.
Returns: An Instance Group Manager object.
Return type: - name (
-
ex_get_instancetemplate
(name)[source]¶ Return an InstanceTemplate object based on a name and optional zone.
Parameters: name ( str
) – The name of the Instance Template.Returns: An Instance Template object. Return type: GCEInstanceTemplate
-
ex_get_license
(project, name)[source]¶ Return a License object for specified project and name.
Parameters: - name (
str
) – The project to reference when looking up the license. - name – The name of the License
Returns: A License object for the name
Return type: - name (
-
ex_get_network
(name)[source]¶ Return a Network object based on a network name.
Parameters: name ( str
) – The name of the networkReturns: A Network object for the network Return type: GCENetwork
-
ex_get_node
(name, zone=None)[source]¶ Return a Node object based on a node name and optional zone.
Parameters: - name (
str
) – The name of the node - zone (
str
orGCEZone
orNodeLocation
orNone
) – The zone to search for the node in. If set to ‘all’, search all zones for the instance.
Returns: A Node object for the node
Return type: Node
- name (
-
ex_get_project
()[source]¶ Return a Project object with project-wide information.
Returns: A GCEProject object Return type: GCEProject
-
ex_get_region
(name)[source]¶ Return a Region object based on the region name.
Parameters: name ( str
) – The name of the region.Returns: A GCERegion object for the region Return type: GCERegion
-
ex_get_route
(name)[source]¶ Return a Route object based on a route name.
Parameters: name ( str
) – The name of the routeReturns: A Route object for the named route Return type: GCERoute
-
ex_get_serial_output
(node)[source]¶ Fetch the console/serial port output from the node.
Parameters: node ( Node
) – The existing target Node (instance) for the request.Returns: A string containing serial port output of the node. Return type: str
-
ex_get_size
(name, zone=None)[source]¶ Return a size object based on a machine type name and zone.
Parameters: - name (
str
) – The name of the node - zone (
str
orGCEZone
orNodeLocation
orNone
) – The zone to search for the machine type in
Returns: A GCENodeSize object for the machine type
Return type: - name (
-
ex_get_snapshot
(name)[source]¶ Return a Snapshot object based on snapshot name.
Parameters: name ( str
) – The name of the snapshotReturns: A GCESnapshot object for the snapshot Return type: GCESnapshot
-
ex_get_subnetwork
(name, region=None)[source]¶ Return a Subnetwork object based on name and region.
Parameters: - name (
str
orGCERegion
orNone
) – The name or URL of the subnetwork - name – The region of the subnetwork
Returns: A Subnetwork object
Return type: - name (
-
ex_get_targethttpproxy
(name)[source]¶ Return a Target HTTP Proxy object based on its name.
Parameters: name ( str
) – The name of the target HTTP proxy.Returns: A Target HTTP Proxy object for the pool Return type: GCETargetHttpProxy
-
ex_get_targetinstance
(name, zone=None)[source]¶ Return a TargetInstance object based on a name and optional zone.
Parameters: - name (
str
) – The name of the target instance - zone (
str
orGCEZone
orNone
) – The zone to search for the target instance in (set to ‘all’ to search all zones).
Returns: A TargetInstance object for the instance
Return type: - name (
-
ex_get_targetpool
(name, region=None)[source]¶ Return a TargetPool object based on a name and optional region.
Parameters: - name (
str
) – The name of the target pool - region (
str
orGCERegion
orNone
) – The region to search for the target pool in (set to ‘all’ to search all regions).
Returns: A TargetPool object for the pool
Return type: - name (
-
ex_get_urlmap
(name)[source]¶ Return a URL Map object based on name
Parameters: name ( str
) – The name of the url mapReturns: A URL Map object for the backend service Return type: GCEUrlMap
-
ex_get_volume
(name, zone=None)[source]¶ Return a Volume object based on a volume name and optional zone.
Parameters: - name (
str
) – The name of the volume - zone (
str
orGCEZone
orNodeLocation
orNone
) – The zone to search for the volume in (set to ‘all’ to search all zones)
Returns: A StorageVolume object for the volume
Return type: StorageVolume
- name (
-
ex_get_zone
(name)[source]¶ Return a Zone object based on the zone name.
Parameters: name ( str
) – The name of the zone.Returns: A GCEZone object for the zone or None if not found Return type: GCEZone
orNone
-
ex_instancegroupmanager_list_managed_instances
(manager)[source]¶ Lists all of the instances in the Managed Instance Group.
Each instance in the list has a currentAction, which indicates the action that the managed instance group is performing on the instance. For example, if the group is still creating an instance, the currentAction is ‘CREATING’. Note that ‘instanceStatus’ might not be available, for example, if currentAction is ‘CREATING’ or ‘RECREATING’. If a previous action failed, the list displays the errors for that failed action.
Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute * https://www.googleapis.com/auth/compute.readonly
- ‘currentAction’ values are one of:
- ‘ABANDONING’, ‘CREATING’, ‘DELETING’, ‘NONE’, ‘RECREATING’, ‘REFRESHING’, ‘RESTARTING’
Parameters: manager ( GCEInstanceGroupManager
) – Instance Group Manager to operate on.Returns: list
ofdict
containing ‘name’, ‘zone’, ‘lastAttempt’, ‘currentAction’, ‘instance’ and ‘instanceStatus’.Return type: list
-
ex_instancegroupmanager_recreate_instances
(manager, instances=None)[source]¶ Schedules a group action to recreate the specified instances in the managed instance group. The instances are deleted and recreated using the current instance template for the managed instance group. This operation is marked as DONE when the action is scheduled even if the instances have not yet been recreated. You must separately verify the status of the recreating action with the listmanagedinstances method or querying the managed instance group directly.
Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute
Parameters: - manager (
str
or :class: GCEInstanceGroupManager) – Required. The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035. - instances (
list
of :class: Node,list
of instance names (only),list
of instance URIs, or None.) – list of Node objects to be recreated. If equal to None, all instances in the managed instance group are recreated.
Returns: Dictionary containing instance URI and currentAction. See ex_instancegroupmanager_list_managed_instances for more details.
Return type: dict
- manager (
-
ex_instancegroupmanager_resize
(manager, size)[source]¶ Set the Instance Template for this Instance Group.
Parameters: - manager (
GCEInstanceGroupManager
) – Instance Group Manager to operate on. - size (
int
) – New size of Managed Instance Group.
Returns: True if successful
Return type: bool
- manager (
-
ex_instancegroupmanager_set_instancetemplate
(manager, instancetemplate)[source]¶ Set the Instance Template for this Instance Group. Existing VMs are not recreated by setting a new InstanceTemplate.
Parameters: - manager (
GCEInstanceGroupManager
) – Instance Group Manager to operate on. - instancetemplate (
GCEInstanceTemplate
) – Instance Template to set.
Returns: True if successful
Return type: bool
- manager (
-
ex_list
(list_fn, **kwargs)[source]¶ Wrap a list method in a
GCEList
iterator.>>> for sublist in driver.ex_list(driver.ex_list_urlmaps).page(1): ... sublist ... [<GCEUrlMap id="..." name="cli-map">] [<GCEUrlMap id="..." name="lc-map">] [<GCEUrlMap id="..." name="web-map">]
Parameters: list_fn ( instancemethod
) – A bound list method fromGCENodeDriver
.Returns: An iterator that returns sublists from list_fn. Return type: GCEList
-
ex_list_addresses
(region=None)[source]¶ Return a list of static addresses for a region, ‘global’, or all.
Parameters: region ( str
orNone
) – The region to return addresses from. For example: ‘us-central1’. If None, will return addresses from region of self.zone. If ‘all’, will return all addresses. If ‘global’, it will return addresses in the global namespace.Returns: A list of static address objects. Return type: list
ofGCEAddress
-
ex_list_autoscalers
(zone=None)[source]¶ Return the list of AutoScalers.
Parameters: zone ( str
orNone
) – The zone to return InstanceGroupManagers from. For example: ‘us-central1-a’. If None, will return InstanceGroupManagers from self.zone. If ‘all’, will return all InstanceGroupManagers.Returns: A list of AutoScaler Objects Return type: list
ofGCEAutoScaler
-
ex_list_backendservices
()[source]¶ Return a list of backend services.
Returns: A list of backend service objects. Return type: list
ofGCEBackendService
-
ex_list_disktypes
(zone=None)[source]¶ Return a list of DiskTypes for a zone or all.
Parameters: zone ( str
orNone
) – The zone to return DiskTypes from. For example: ‘us-central1-a’. If None, will return DiskTypes from self.zone. If ‘all’, will return all DiskTypes.Returns: A list of static DiskType objects. Return type: list
ofGCEDiskType
-
ex_list_firewalls
()[source]¶ Return the list of firewalls.
Returns: A list of firewall objects. Return type: list
ofGCEFirewall
-
ex_list_forwarding_rules
(region=None, global_rules=False)[source]¶ Return the list of forwarding rules for a region or all.
Parameters: - region (
str
orGCERegion
orNone
) – The region to return forwarding rules from. For example: ‘us-central1’. If None, will return forwarding rules from the region of self.region (which is based on self.zone). If ‘all’, will return forwarding rules for all regions, which does not include the global forwarding rules. - global_rules (
bool
) – List global forwarding rules instead of per-region rules. Setting True will cause ‘region’ parameter to be ignored.
Returns: A list of forwarding rule objects.
Return type: list
ofGCEForwardingRule
- region (
-
ex_list_healthchecks
()[source]¶ Return the list of health checks.
Returns: A list of health check objects. Return type: list
ofGCEHealthCheck
-
ex_list_instancegroupmanagers
(zone=None)[source]¶ Return a list of Instance Group Managers.
Parameters: zone ( str
orNone
) – The zone to return InstanceGroupManagers from. For example: ‘us-central1-a’. If None, will return InstanceGroupManagers from self.zone. If ‘all’, will return all InstanceGroupManagers.Returns: A list of instance group mgr objects. Return type: list
ofGCEInstanceGroupManagers
-
ex_list_instancegroups
(zone)[source]¶ Retrieves the list of instance groups that are located in the specified project and zone.
Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute * https://www.googleapis.com/auth/compute.readonly
Parameters: zone ( str
) – The name of the zone where the instance group is located.Returns: A list of instance group mgr objects. Return type: list
ofGCEInstanceGroupManagers
-
ex_list_instancetemplates
()[source]¶ Return the list of Instance Templates.
Returns: A list of Instance Template Objects Return type: list
ofGCEInstanceTemplate
-
ex_list_networks
()[source]¶ Return the list of networks.
Returns: A list of network objects. Return type: list
ofGCENetwork
-
ex_list_project_images
(ex_project=None, ex_include_deprecated=False)[source]¶ Return a list of image objects for a project. If no project is specified, only a list of ‘global’ images is returned.
Parameters: - ex_project (
str
,list
ofstr
, orNone
) – Optional alternate project name. - ex_include_deprecated (
bool
) – If True, even DEPRECATED images will be returned.
Returns: List of GCENodeImage objects
Return type: list
ofGCENodeImage
- ex_project (
-
ex_list_regions
()[source]¶ Return the list of regions.
Returns: A list of region objects. Return type: list
ofGCERegion
-
ex_list_routes
()[source]¶ Return the list of routes.
Returns: A list of route objects. Return type: list
ofGCERoute
-
ex_list_snapshots
()[source]¶ Return the list of disk snapshots in the project.
Returns: A list of snapshot objects Return type: list
ofGCESnapshot
-
ex_list_subnetworks
(region=None)[source]¶ Return the list of subnetworks.
Parameters: region ( str
orGCERegion
) – Region for the subnetwork. Specify ‘all’ to return the aggregated list of subnetworks.Returns: A list of subnetwork objects. Return type: list
ofGCESubnetwork
-
ex_list_targethttpproxies
()[source]¶ Return the list of target HTTP proxies.
Returns: A list of target http proxy objects Return type: list
ofGCETargetHttpProxy
-
ex_list_targetinstances
(zone=None)[source]¶ Return the list of target instances.
Returns: A list of target instance objects Return type: list
ofGCETargetInstance
-
ex_list_targetpools
(region=None)[source]¶ Return the list of target pools.
Returns: A list of target pool objects Return type: list
ofGCETargetPool
-
ex_list_urlmaps
()[source]¶ Return the list of URL Maps in the project.
Returns: A list of url map objects Return type: list
ofGCEUrlMap
-
ex_list_zones
()[source]¶ Return the list of zones.
Returns: A list of zone objects. Return type: list
ofGCEZone
-
ex_set_common_instance_metadata
(metadata=None, force=False)[source]¶ Set common instance metadata for the project. Common uses are for setting ‘sshKeys’, or setting a project-wide ‘startup-script’ for all nodes (instances). Passing in
None
for the ‘metadata’ parameter will clear out all common instance metadata except for ‘sshKeys’. If you also want to update ‘sshKeys’, set the ‘force’ parameter toTrue
.Parameters: - metadata (
dict
orNone
) – Dictionary of metadata. Can be either a standard python dictionary, or the format expected by GCE (e.g. {‘items’: [{‘key’: k1, ‘value’: v1}, ...}] - force (
bool
) – Force update of ‘sshKeys’. If force isFalse
(the default), existing sshKeys will be retained. Setting force toTrue
will either replace sshKeys if a new a new value is supplied, or deleted if no new value is supplied.
Returns: True if successful
Return type: bool
- metadata (
-
ex_set_machine_type
(node, machine_type='n1-standard-1')[source]¶ Set the machine type of the stopped instance. Can be the short-name, a full, or partial URL.
Parameters: - node (
Node
) – Target node object to change - machine_type (
str
) – Desired machine type
Returns: True if successful
Return type: bool
- node (
-
ex_set_node_metadata
(node, metadata)[source]¶ Set metadata for the specified node.
Parameters: - node (
Node
) – The existing target Node (instance) for the request. - metadata (
dict
orNone
) – Set (or clear with None) metadata for this particular node.
Returns: True if successful
Return type: bool
- node (
-
ex_set_node_scheduling
(node, on_host_maintenance=None, automatic_restart=None)[source]¶ Set the maintenance behavior for the node.
See Scheduling documentation for more info.
Parameters: - node (
Node
) – Node object - on_host_maintenance (
str
) – Defines whether node should be terminated or migrated when host machine goes down. Acceptable values are: ‘MIGRATE’ or ‘TERMINATE’ (If not supplied, value will be reset to GCE default value for the instance type.) - automatic_restart (
bool
) – Defines whether the instance should be automatically restarted when it is terminated by Compute Engine. (If not supplied, value will be set to the GCE default value for the instance type.)
Returns: True if successful.
Return type: bool
- node (
Set the tags on a Node instance.
Note that this updates the node object directly.
Parameters: - node (
Node
) – Node object - tags (
list
ofstr
) – List of tags to apply to the object
Returns: True if successful
Return type: bool
- node (
-
ex_set_usage_export_bucket
(bucket, prefix=None)[source]¶ Used to retain Compute Engine resource usage, storing the CSV data in a Google Cloud Storage bucket. See the docs for more information. Please ensure you have followed the necessary setup steps prior to enabling this feature (e.g. bucket exists, ACLs are in place, etc.)
Parameters: - bucket (
str
) – Name of the Google Cloud Storage bucket. Specify the name in either ‘gs://<bucket_name>’ or the full URL ‘https://storage.googleapis.com/<bucket_name>’. - prefix (
str
orNone
) – Optional prefix string for all reports.
Returns: True if successful
Return type: bool
- bucket (
-
ex_set_volume_auto_delete
(volume, node, auto_delete=True)[source]¶ Sets the auto-delete flag for a volume attached to a node.
Parameters: - volume (
StorageVolume
) – Volume object to auto-delete - ex_node (
Node
) – Node object to auto-delete volume from - auto_delete (
bool
(default True)) – Flag to set for the auto-delete value
Returns: True if successful
Return type: bool
- volume (
-
ex_start_node
(node)[source]¶ Start a node that is stopped and in TERMINATED state.
Parameters: node ( Node
) – Node object to startReturns: True if successful Return type: bool
-
ex_stop_node
(node)[source]¶ Stop a running node.
Parameters: node ( Node
) – Node object to stopReturns: True if successful Return type: bool
-
ex_targetpool_add_healthcheck
(targetpool, healthcheck)[source]¶ Add a health check to a target pool.
Parameters: - targetpool (
str
orGCETargetPool
) – The targetpool to add health check to - healthcheck (
str
orGCEHealthCheck
) – The healthcheck to add
Returns: True if successful
Return type: bool
- targetpool (
-
ex_targetpool_add_node
(targetpool, node)[source]¶ Add a node to a target pool.
Parameters: - targetpool (
str
orGCETargetPool
) – The targetpool to add node to - node (
str
orNode
) – The node to add
Returns: True if successful
Return type: bool
- targetpool (
-
ex_targetpool_get_health
(targetpool, node=None)[source]¶ Return a hash of target pool instances and their health.
Parameters: - targetpool (
GCETargetPool
) – Targetpool containing healthchecked instances. - node (
str
,Node
, orNone
) – Optional node to specify if only a specific node’s health status should be returned
Returns: List of hashes of instances and their respective health, e.g. [{‘node’:
Node
, ‘health’: ‘UNHEALTHY’}, ...]Return type: list
ofdict
- targetpool (
-
ex_targetpool_remove_healthcheck
(targetpool, healthcheck)[source]¶ Remove a health check from a target pool.
Parameters: - targetpool (
str
orGCETargetPool
) – The targetpool to remove health check from - healthcheck (
str
orGCEHealthCheck
) – The healthcheck to remove
Returns: True if successful
Return type: bool
- targetpool (
-
ex_targetpool_remove_node
(targetpool, node)[source]¶ Remove a node from a target pool.
Parameters: - targetpool (
str
orGCETargetPool
) – The targetpool to remove node from - node (
str
orNode
) – The node to remove
Returns: True if successful
Return type: bool
- targetpool (
-
ex_targetpool_set_backup_targetpool
(targetpool, backup_targetpool, failover_ratio=0.1)[source]¶ Set a backup targetpool.
Parameters: - targetpool (
GCETargetPool
) – The existing primary targetpool - backup_targetpool (
GCETargetPool
) – The existing targetpool to use for failover traffic. - failover_ratio (
float
) – The percentage of healthy VMs must fall at or below this value before traffic will be sent to the backup targetpool (default 0.10)
Returns: True if successful
Return type: bool
- targetpool (
-
ex_update_autoscaler
(autoscaler)[source]¶ Update an autoscaler with new values.
To update, change the attributes of the autoscaler object and pass the updated object to the method.
Parameters: autoscaler ( GCEAutoscaler
) – An Autoscaler object with updated values.Returns: An Autoscaler object representing the new state. Return type: GCEAutoscaler`
-
ex_update_firewall
(firewall)[source]¶ Update a firewall with new values.
To update, change the attributes of the firewall object and pass the updated object to the method.
Parameters: firewall ( GCEFirewall
) – A firewall object with updated values.Returns: An object representing the new state of the firewall. Return type: GCEFirewall
-
ex_update_healthcheck
(healthcheck)[source]¶ Update a health check with new values.
To update, change the attributes of the health check object and pass the updated object to the method.
Parameters: healthcheck ( GCEHealthCheck
) – A healthcheck object with updated values.Returns: An object representing the new state of the health check. Return type: GCEHealthCheck
-
list_images
(ex_project=None, ex_include_deprecated=False)[source]¶ Return a list of image objects. If no project is specified, a list of all non-deprecated global and vendor images images is returned. By default, only non-deprecated images are returned.
Parameters: - ex_project (
str
,list
ofstr
, orNone
) – Optional alternate project name. - ex_include_deprecated (
bool
) – If True, even DEPRECATED images will be returned.
Returns: List of GCENodeImage objects
Return type: list
ofGCENodeImage
- ex_project (
-
list_locations
()[source]¶ Return a list of locations (zones).
The
ex_list_zones
method returns more comprehensive results, but this is here for compatibility.Returns: List of NodeLocation objects Return type: list
ofNodeLocation
-
list_nodes
(ex_zone=None)[source]¶ Return a list of nodes in the current zone or all zones.
Parameters: ex_zone ( str
orGCEZone
orNodeLocation
orNone
) – Optional zone name or ‘all’Returns: List of Node objects Return type: list
ofNode
-
list_sizes
(location=None)[source]¶ Return a list of sizes (machineTypes) in a zone.
Parameters: location ( str
orGCEZone
orNodeLocation
orNone
) – Location or Zone for sizesReturns: List of GCENodeSize objects Return type: list
ofGCENodeSize
-
list_volume_snapshots
(volume)[source]¶ List snapshots created from the provided volume.
For GCE, snapshots are global, but while the volume they were created from still exists, the source disk for the snapshot is tracked.
Parameters: volume ( StorageVolume
) – A StorageVolume objectReturns: A list of Snapshot objects Return type: list
ofGCESnapshot
-
list_volumes
(ex_zone=None)[source]¶ Return a list of volumes for a zone or all.
Will return list from provided zone, or from the default zone unless given the value of ‘all’.
Parameters: ex_zone ( str
orGCEZone
orNodeLocation
orNone
) – The zone to return volumes from.Returns: A list of volume objects. Return type: list
ofStorageVolume
-
name
= 'Google Compute Engine'¶
-
reboot_node
(node)[source]¶ Reboot a node.
Parameters: node ( Node
) – Node to be rebootedReturns: True if successful, False if not Return type: bool
-
type
= 'gce'¶
-
website
= 'https://cloud.google.com/'¶
- user_id (
-
class
libcloud.compute.drivers.gce.
GCENodeImage
(id, name, driver, extra=None)[source]¶ Bases:
libcloud.compute.base.NodeImage
A GCE Node Image class.
-
deprecate
(replacement, state, deprecated=None, obsolete=None, deleted=None)[source]¶ Deprecate this image
Parameters: - replacement (
str
or :class: GCENodeImage) – Image to use as a replacement - state (
str
) – Deprecation state of this image. Possible values include ‘ACTIVE’, ‘DELETED’, ‘DEPRECATED’ or ‘OBSOLETE’. - deprecated (
str
orNone
) – RFC3339 timestamp to mark DEPRECATED - obsolete (
str
orNone
) – RFC3339 timestamp to mark OBSOLETE - deleted (
str
orNone
) – RFC3339 timestamp to mark DELETED
Returns: True if successful
Return type: bool
- replacement (
-
-
class
libcloud.compute.drivers.gce.
GCENodeSize
(id, name, ram, disk, bandwidth, price, driver, extra=None)[source]¶ Bases:
libcloud.compute.base.NodeSize
A GCE Node Size (MachineType) class.
-
class
libcloud.compute.drivers.gce.
GCEProject
(id, name, metadata, quotas, driver, extra=None)[source]¶ Bases:
libcloud.compute.base.UuidMixin
GCE Project information.
-
set_common_instance_metadata
(metadata=None, force=False)[source]¶ Set common instance metadata for the project. Common uses are for setting ‘sshKeys’, or setting a project-wide ‘startup-script’ for all nodes (instances). Passing in
None
for the ‘metadata’ parameter will clear out all common instance metadata except for ‘sshKeys’. If you also want to update ‘sshKeys’, set the ‘force’ parameter toTrue
.Parameters: - metadata (
dict
orNone
) – Dictionary of metadata. Can be either a standard python dictionary, or the format expected by GCE (e.g. {‘items’: [{‘key’: k1, ‘value’: v1}, ...}] - force (
bool
) – Force update of ‘sshKeys’. If force isFalse
(the default), existing sshKeys will be retained. Setting force toTrue
will either replace sshKeys if a new a new value is supplied, or deleted if no new value is supplied.
Returns: True if successful
Return type: bool
- metadata (
-
set_usage_export_bucket
(bucket, prefix=None)[source]¶ Used to retain Compute Engine resource usage, storing the CSV data in a Google Cloud Storage bucket. See the docs for more information. Please ensure you have followed the necessary setup steps prior to enabling this feature (e.g. bucket exists, ACLs are in place, etc.)
Parameters: - bucket (
str
) – Name of the Google Cloud Storage bucket. Specify the name in either ‘gs://<bucket_name>’ or the full URL ‘https://storage.googleapis.com/<bucket_name>’. - prefix (
str
orNone
) – Optional prefix string for all reports.
Returns: True if successful
Return type: bool
- bucket (
-
-
class
libcloud.compute.drivers.gce.
GCERegion
(id, name, status, zones, quotas, deprecated, driver, extra=None)[source]¶ Bases:
libcloud.compute.base.UuidMixin
-
class
libcloud.compute.drivers.gce.
GCEResponse
(response, connection)[source]¶ Bases:
libcloud.common.google.GoogleResponse
Parameters: - response (
httplib.HTTPResponse
) – HTTP response object. (optional) - connection (
Connection
) – Parent connection object.
- response (
-
class
libcloud.compute.drivers.gce.
GCERoute
(id, name, dest_range, priority, network='default', tags=None, driver=None, extra=None)[source]¶ Bases:
libcloud.compute.base.UuidMixin
A GCE Route object class.
-
class
libcloud.compute.drivers.gce.
GCESnapshot
(id, name, size, status, driver, extra=None, created=None)[source]¶
-
class
libcloud.compute.drivers.gce.
GCESubnetwork
(id, name, cidr, network, region, driver, extra=None)[source]¶ Bases:
libcloud.compute.base.UuidMixin
A GCE Subnetwork object class.
-
class
libcloud.compute.drivers.gce.
GCETargetHttpProxy
(id, name, urlmap, driver, extra=None)[source]¶ Bases:
libcloud.compute.base.UuidMixin
-
class
libcloud.compute.drivers.gce.
GCETargetInstance
(id, name, zone, node, driver, extra=None)[source]¶ Bases:
libcloud.compute.base.UuidMixin
-
class
libcloud.compute.drivers.gce.
GCETargetPool
(id, name, region, healthchecks, nodes, driver, extra=None)[source]¶ Bases:
libcloud.compute.base.UuidMixin
-
add_healthcheck
(healthcheck)[source]¶ Add a healthcheck to this target pool.
Parameters: healthcheck ( str
orGCEHealthCheck
) – Healthcheck to addReturns: True if successful Return type: bool
-
add_node
(node)[source]¶ Add a node to this target pool.
Parameters: node ( str
orNode
) – Node to addReturns: True if successful Return type: bool
-
get_health
(node=None)[source]¶ Return a hash of target pool instances and their health.
Parameters: node ( str
,Node
, orNone
) – Optional node to specify if only a specific node’s health status should be returnedReturns: List of hashes of nodes and their respective health Return type: list
ofdict
-
remove_healthcheck
(healthcheck)[source]¶ Remove a healthcheck from this target pool.
Parameters: healthcheck ( str
orGCEHealthCheck
) – Healthcheck to removeReturns: True if successful Return type: bool
-
remove_node
(node)[source]¶ Remove a node from this target pool.
Parameters: node ( str
orNode
) – Node to removeReturns: True if successful Return type: bool
-
set_backup_targetpool
(backup_targetpool, failover_ratio=0.1)[source]¶ Set a backup targetpool.
Parameters: - backup_targetpool (
GCETargetPool
) – The existing targetpool to use for failover traffic. - failover_ratio (
float
) – The percentage of healthy VMs must fall at or below this value before traffic will be sent to the backup targetpool (default 0.10)
Returns: True if successful
Return type: bool
- backup_targetpool (
-
-
class
libcloud.compute.drivers.gce.
GCEUrlMap
(id, name, default_service, host_rules, path_matchers, tests, driver, extra=None)[source]¶ Bases:
libcloud.compute.base.UuidMixin
A GCE URL Map.
-
class
libcloud.compute.drivers.gce.
GCEZone
(id, name, status, maintenance_windows, deprecated, driver, extra=None)[source]¶ Bases:
libcloud.compute.base.NodeLocation
Subclass of NodeLocation to provide additional information.
-
next_mw_duration
¶ Returns the duration of the next Maintenance Window as a datetime.timedelta object.
-
time_until_mw
¶ Returns the time until the next Maintenance Window as a datetime.timedelta object.
-
-
libcloud.compute.drivers.gce.
timestamp_to_datetime
(timestamp)[source]¶ Return a datetime object that corresponds to the time in an RFC3339 timestamp.
Parameters: timestamp ( str
) – RFC3339 timestamp stringReturns: Datetime object corresponding to timestamp Return type: datetime.datetime
libcloud.compute.drivers.gogrid module¶
GoGrid driver
-
class
libcloud.compute.drivers.gogrid.
GoGridNode
(id, name, state, public_ips, private_ips, driver, size=None, image=None, extra=None, created_at=None)[source]¶ Bases:
libcloud.compute.base.Node
Parameters: - id (
str
) – Node ID. - name (
str
) – Node name. - state (
libcloud.compute.types.NodeState
) – Node state. - public_ips (
list
) – Public IP addresses associated with this node. - private_ips (
list
) – Private IP addresses associated with this node. - driver (
NodeDriver
) – Driver this node belongs to. - size (
NodeSize
) – Size of this node. (optional) - image (
NodeImage
) – Image of this node. (optional) - created_at – The datetime this node was created (optional)
- extra (
dict
) – Optional provider specific attributes associated with this node.
- id (
-
class
libcloud.compute.drivers.gogrid.
GoGridNodeDriver
(*args, **kwargs)[source]¶ Bases:
libcloud.common.gogrid.BaseGoGridDriver
,libcloud.compute.base.NodeDriver
GoGrid node driver
@inherits:
NodeDriver.__init__
-
api_name
= 'gogrid'¶
-
connectionCls
¶ alias of
GoGridConnection
-
create_node
(**kwargs)[source]¶ Create a new GoGird node
@inherits:
NodeDriver.create_node
Parameters: - ex_description (
str
) – Description of a Node - ex_ip (
str
) – Public IP address to use for a Node. If not specified, first available IP address will be picked
Return type: - ex_description (
-
destroy_node
(node)[source]¶ @inherits:
NodeDriver.reboot_node
:type node:GoGridNode
-
ex_create_node_nowait
(**kwargs)[source]¶ Don’t block until GoGrid allocates id for a node but return right away with id == None.
The existence of this method is explained by the fact that GoGrid assigns id to a node only few minutes after creation.
Parameters: - name (
str
) – String with a name for this new node (required) - size (
NodeSize
) – The size of resources allocated to this node . (required) - image (
NodeImage
) – OS Image to boot on node. (required) - ex_description (
str
) – Description of a Node - ex_ip (
str
) – Public IP address to use for a Node. If not specified, first available IP address will be picked
Return type: - name (
-
ex_edit_image
(**kwargs)[source]¶ Edit metadata of a server image.
Parameters: - image (
NodeImage
) – image to be edited (required) - public (
bool
) – should be the image public (required) - ex_description (
str
) – description of the image (optional) - name (
str
) – name of the image
Return type: NodeImage
- image (
-
ex_edit_node
(**kwargs)[source]¶ Change attributes of a node.
Parameters: - node (
GoGridNode
) – node to be edited (required) - size (
NodeSize
) – new size of a node (required) - ex_description (
str
) – new description of a node
Return type: Node
- node (
-
ex_list_ips
(**kwargs)[source]¶ Return list of IP addresses assigned to the account.
Parameters: - public (
bool
) – set to True to list only public IPs or False to list only private IPs. Set to None or not specify at all not to filter by type - assigned (
bool
) – set to True to list only addresses assigned to servers, False to list unassigned addresses and set to None or don’t set at all not no filter by state - location (
NodeLocation
) – filter IP addresses by location
Return type: list
ofGoGridIpAddress
- public (
-
ex_save_image
(node, name)[source]¶ Create an image for node.
Please refer to GoGrid documentation to get info how prepare a node for image creation:
http://wiki.gogrid.com/wiki/index.php/MyGSI
Parameters: - node (
GoGridNode
) – node to use as a base for image - name (
str
) – name for new image
Return type: NodeImage
- node (
-
features
= {'create_node': ['generates_password']}¶
-
list_nodes
()[source]¶ @inherits:
NodeDriver.list_nodes
:rtype:list
ofGoGridNode
-
name
= 'GoGrid'¶
-
reboot_node
(node)[source]¶ @inherits:
NodeDriver.reboot_node
:type node:GoGridNode
-
type
= 'gogrid'¶
-
website
= 'http://www.gogrid.com/'¶
-
libcloud.compute.drivers.gridspot module¶
-
exception
libcloud.compute.drivers.gridspot.
GridspotAPIException
[source]¶ Bases:
exceptions.Exception
-
class
libcloud.compute.drivers.gridspot.
GridspotConnection
(key, secure=True, host=None, port=None, url=None, timeout=None, proxy_url=None, backoff=None, retry_delay=None)[source]¶ Bases:
libcloud.common.base.ConnectionKey
Connection class to connect to Gridspot’s API servers
Initialize user_id and key; set secure to an
int
based on passed value.-
host
= 'gridspot.com'¶
-
responseCls
¶ alias of
GridspotResponse
-
-
class
libcloud.compute.drivers.gridspot.
GridspotNodeDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region=None, **kwargs)[source]¶ Bases:
libcloud.compute.base.NodeDriver
Gridspot (http://www.gridspot.com/) node driver.
Parameters: - key (
str
) – API key or username to be used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections. - api_version (
str
) – Optional API version. Only used by drivers which support multiple API versions. - region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
Return type: None
-
NODE_STATE_MAP
= {'Running': 'running', 'Starting': 'pending'}¶
-
connectionCls
¶ alias of
GridspotConnection
-
name
= 'Gridspot'¶
-
type
= 'gridspot'¶
-
website
= 'http://www.gridspot.com/'¶
- key (
-
class
libcloud.compute.drivers.gridspot.
GridspotResponse
(response, connection)[source]¶ Bases:
libcloud.common.base.JsonResponse
Response class for Gridspot
Parameters: - response (
httplib.HTTPResponse
) – HTTP response object. (optional) - connection (
Connection
) – Parent connection object.
- response (
libcloud.compute.drivers.hostvirtual module¶
libcloud driver for the Host Virtual Inc. (VR) API Home page https://www.hostvirtual.com/
-
class
libcloud.compute.drivers.hostvirtual.
HostVirtualComputeConnection
(key, secure=True, host=None, port=None, url=None, timeout=None, proxy_url=None, backoff=None, retry_delay=None)[source]¶ Bases:
libcloud.common.hostvirtual.HostVirtualConnection
Initialize user_id and key; set secure to an
int
based on passed value.-
responseCls
¶ alias of
HostVirtualComputeResponse
-
-
class
libcloud.compute.drivers.hostvirtual.
HostVirtualComputeResponse
(response, connection)[source]¶ Bases:
libcloud.common.hostvirtual.HostVirtualResponse
Parameters: - response (
httplib.HTTPResponse
) – HTTP response object. (optional) - connection (
Connection
) – Parent connection object.
- response (
-
class
libcloud.compute.drivers.hostvirtual.
HostVirtualNodeDriver
(key, secure=True, host=None, port=None)[source]¶ Bases:
libcloud.compute.base.NodeDriver
-
connectionCls
¶ alias of
HostVirtualComputeConnection
-
create_node
(name, image, size, **kwargs)[source]¶ Creates a node
Example of node creation with ssh key deployed:
>>> from libcloud.compute.base import NodeAuthSSHKey >>> key = open('/home/user/.ssh/id_rsa.pub').read() >>> auth = NodeAuthSSHKey(pubkey=key) >>> from libcloud.compute.providers import get_driver; >>> driver = get_driver('hostvirtual') >>> conn = driver('API_KEY') >>> image = conn.list_images()[1] >>> size = conn.list_sizes()[0] >>> location = conn.list_locations()[1] >>> name = 'markos-dev' >>> node = conn.create_node(name, image, size, auth=auth, >>> location=location)
-
ex_cancel_package
(node)[source]¶ Cancel a server package.
Parameters: node ( Node
) – Node which should be usedReturn type: str
-
ex_delete_node
(node)[source]¶ Delete a node.
Parameters: node ( Node
) – Node which should be usedReturn type: bool
-
ex_get_node
(node_id)[source]¶ Get a single node.
Parameters: node_id ( str
) – id of the node that we need the node object forReturn type: Node
-
ex_provision_node
(**kwargs)[source]¶ Provision a server on a VR package and get it booted
Parameters: - node (
Node
) – node which should be used - image (
NodeImage
) – The distribution to deploy on your server (mandatory) - auth (
NodeAuthSSHKey
orNodeAuthPassword
) – an SSH key or root password (mandatory) - location (
NodeLocation
) – which datacenter to create the server in
Returns: Node representing the newly built server
Return type: Node
- node (
-
ex_start_node
(node)[source]¶ Start a node.
Parameters: node ( Node
) – Node which should be usedReturn type: bool
-
ex_stop_node
(node)[source]¶ Stop a node.
Parameters: node ( Node
) – Node which should be usedReturn type: bool
-
ex_unlink_package
(node)[source]¶ Unlink a server package from location.
Parameters: node ( Node
) – Node which should be usedReturn type: str
-
features
= {'create_node': ['ssh_key', 'password']}¶
-
name
= 'HostVirtual'¶
-
type
= 'hostvirtual'¶
-
website
= 'http://www.hostvirtual.com'¶
-
libcloud.compute.drivers.ikoula module¶
-
class
libcloud.compute.drivers.ikoula.
IkoulaNodeDriver
(key, secret=None, secure=True, host=None, path=None, port=None, url=None, *args, **kwargs)[source]¶ Bases:
libcloud.compute.drivers.cloudstack.CloudStackNodeDriver
Inherits: NodeDriver.__init__
Parameters: - host (
str
) – The host where the API can be reached. (required) - path (
str
) – The path where the API can be reached. (required) - url (
str
) – Full URL to the API endpoint. Mutually exclusive with host and path argument.
-
host
= 'cloudstack.ikoula.com'¶
-
name
= 'Ikoula'¶
-
path
= '/client/api'¶
-
type
= 'ikoula'¶
-
website
= 'http://express.ikoula.co.uk/cloudstack'¶
- host (
libcloud.compute.drivers.indosat module¶
Indosat Driver
-
class
libcloud.compute.drivers.indosat.
IndosatNodeDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region='indosat-id', **kwargs)[source]¶ Bases:
libcloud.compute.drivers.dimensiondata.DimensionDataNodeDriver
Indosat node driver, based on Dimension Data driver
-
api_version
= 1.0¶
-
connectionCls
¶ alias of
DimensionDataConnection
-
features
= {'create_node': ['password']}¶
-
name
= 'Indosat'¶
-
selected_region
= None¶
-
type
= 'indosat'¶
-
website
= 'http://www.indosat.com/'¶
-
libcloud.compute.drivers.internetsolutions module¶
Internet Solutions Driver
-
class
libcloud.compute.drivers.internetsolutions.
InternetSolutionsNodeDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region='is-af', **kwargs)[source]¶ Bases:
libcloud.compute.drivers.dimensiondata.DimensionDataNodeDriver
InternetSolutions node driver, based on Dimension Data driver
-
api_version
= 1.0¶
-
connectionCls
¶ alias of
DimensionDataConnection
-
features
= {'create_node': ['password']}¶
-
name
= 'InternetSolutions'¶
-
selected_region
= None¶
-
type
= 'internetsolutions'¶
-
website
= 'http://www.is.co.za/'¶
-
libcloud.compute.drivers.joyent module¶
Joyent Cloud (http://www.joyentcloud.com) driver.
-
class
libcloud.compute.drivers.joyent.
JoyentConnection
(user_id, key, secure=True, host=None, port=None, url=None, timeout=None, proxy_url=None, backoff=None, retry_delay=None)[source]¶ Bases:
libcloud.common.base.ConnectionUserAndKey
Joyent connection class.
-
allow_insecure
= False¶
-
responseCls
¶ alias of
JoyentResponse
-
-
class
libcloud.compute.drivers.joyent.
JoyentNodeDriver
(key, secret=None, secure=True, host=None, port=None, region='us-east-1', **kwargs)[source]¶ Bases:
libcloud.compute.base.NodeDriver
Joyent node driver class.
-
connectionCls
¶ alias of
JoyentConnection
-
ex_get_node
(node_id)[source]¶ Return a Node object based on a node ID.
Parameters: node_id ( str
) – ID of the nodeReturns: A Node object for the node Return type: Node
-
ex_start_node
(node)[source]¶ Start node
Parameters: node ( Node
) – The node to be stoppedReturn type: bool
-
ex_stop_node
(node)[source]¶ Stop node
Parameters: node ( Node
) – The node to be stoppedReturn type: bool
-
features
= {'create_node': ['generates_password']}¶
-
name
= 'Joyent'¶
-
type
= 'joyent'¶
-
website
= 'http://www.joyentcloud.com'¶
-
-
class
libcloud.compute.drivers.joyent.
JoyentResponse
(response, connection)[source]¶ Bases:
libcloud.common.base.JsonResponse
Joyent response class.
Parameters: - response (
httplib.HTTPResponse
) – HTTP response object. (optional) - connection (
Connection
) – Parent connection object.
-
valid_response_codes
= [200, 202, 201, 204]¶
- response (
libcloud.compute.drivers.kili module¶
HP Public cloud driver which is essentially just a small wrapper around OpenStack driver.
-
class
libcloud.compute.drivers.kili.
KiliCloudNodeDriver
(key, secret, tenant_name, secure=True, host=None, port=None, **kwargs)[source]¶ Bases:
libcloud.compute.drivers.openstack.OpenStack_1_1_NodeDriver
Note: tenant_name argument is required for Kili cloud.
-
connectionCls
¶ alias of
KiliCloudConnection
-
name
= 'Kili Public Cloud'¶
-
type
= 'hpcloud'¶
-
website
= 'http://kili.io/'¶
-
libcloud.compute.drivers.ktucloud module¶
-
class
libcloud.compute.drivers.ktucloud.
KTUCloudNodeDriver
(key, secret=None, secure=True, host=None, path=None, port=None, url=None, *args, **kwargs)[source]¶ Bases:
libcloud.compute.drivers.cloudstack.CloudStackNodeDriver
Driver for KTUCloud Compute platform.
Inherits: NodeDriver.__init__
Parameters: - host (
str
) – The host where the API can be reached. (required) - path (
str
) – The path where the API can be reached. (required) - url (
str
) – Full URL to the API endpoint. Mutually exclusive with host and path argument.
-
EMPTY_DISKOFFERINGID
= '0'¶
-
name
= 'KTUCloud'¶
-
type
= 'ktucloud'¶
-
website
= 'https://ucloudbiz.olleh.com/'¶
- host (
libcloud.compute.drivers.libvirt_driver module¶
-
class
libcloud.compute.drivers.libvirt_driver.
LibvirtNodeDriver
(uri, key=None, secret=None)[source]¶ Bases:
libcloud.compute.base.NodeDriver
Libvirt (http://libvirt.org/) node driver.
To enable debug mode, set LIBVIR_DEBUG environment variable.
Parameters: - uri (
str
) – Hypervisor URI (e.g. vbox:///session, qemu:///system, etc.). - key (
str
) – the username for a remote libvirtd server - secret – the password for a remote libvirtd server
-
NODE_STATE_MAP
= {0: 'terminated', 1: 'running', 2: 'pending', 3: 'terminated', 4: 'terminated', 5: 'terminated', 6: 'unknown', 7: 'unknown'}¶
-
ex_get_node_by_name
(name)[source]¶ Retrieve Node object for a domain with a provided name.
Parameters: name ( str
) – Name of the domain.
-
ex_get_node_by_uuid
(uuid)[source]¶ Retrieve Node object for a domain with a provided uuid.
Parameters: uuid ( str
) – Uuid of the domain.
-
ex_resume_node
(node)[source]¶ Resume a suspended node.
Parameters: node ( Node
) – Node which should be usedReturn type: bool
-
ex_shutdown_node
(node)[source]¶ Shutdown a running node.
Note: Usually this will result in sending an ACPI event to the node.
Parameters: node ( Node
) – Node which should be usedReturn type: bool
-
ex_start_node
(node)[source]¶ Start a stopped node.
Parameters: node ( Node
) – Node which should be usedReturn type: bool
-
ex_suspend_node
(node)[source]¶ Suspend a running node.
Parameters: node ( Node
) – Node which should be usedReturn type: bool
-
ex_take_node_screenshot
(node, directory, screen=0)[source]¶ Take a screenshot of a monitoring of a running instance.
Parameters: - node (
libcloud.compute.base.Node
) – Node to take the screenshot of. - directory (
str
) – Path where the screenshot will be saved. - screen (
int
) – ID of the monitor to take the screenshot of.
Returns: Full path where the screenshot has been saved.
Return type: str
- node (
-
name
= 'Libvirt'¶
-
type
= 'libvirt'¶
-
website
= 'http://libvirt.org/'¶
- uri (
libcloud.compute.drivers.linode module¶
libcloud driver for the Linode(R) API
This driver implements all libcloud functionality for the Linode API. Since the API is a bit more fine-grained, create_node abstracts a significant amount of work (and may take a while to run).
Linode home page http://www.linode.com/ Linode API documentation http://www.linode.com/api/ Alternate bindings for reference http://github.com/tjfontaine/linode-python
Linode(R) is a registered trademark of Linode, LLC.
-
class
libcloud.compute.drivers.linode.
LinodeNodeDriver
(key)[source]¶ Bases:
libcloud.compute.base.NodeDriver
libcloud driver for the Linode API
Rough mapping of which is which:
list_nodes linode.list
reboot_node linode.reboot
destroy_node linode.delete
- create_node linode.create, linode.update,
linode.disk.createfromdistribution, linode.disk.create, linode.config.create, linode.ip.addprivate, linode.boot
list_sizes avail.linodeplans
list_images avail.distributions
list_locations avail.datacenters
list_volumes linode.disk.list
destroy_volume linode.disk.delete
For more information on the Linode API, be sure to read the reference:
Instantiate the driver with the given API key
Parameters: key ( str
) – the API key to use (required)Return type: None
-
LINODE_STATES
= {0: 'pending', 1: 'running', 2: 'terminated', 3: 'rebooting', 4: 'unknown', -2: 'unknown', -1: 'pending'}¶
-
connectionCls
¶ alias of
LinodeConnection
-
create_node
(**kwargs)[source]¶ Create a new Linode, deploy a Linux distribution, and boot
This call abstracts much of the functionality of provisioning a Linode and getting it booted. A global grant to add Linodes to the account is required, as this call will result in a billing charge.
Note that there is a safety valve of 5 Linodes per hour, in order to prevent a runaway script from ruining your day.
Parameters: - name (
str
) – the name to assign the Linode (mandatory) - image (
NodeImage
) – which distribution to deploy on the Linode (mandatory) - size (
NodeSize
) – the plan size to create (mandatory) - auth (
NodeAuthSSHKey
orNodeAuthPassword
) – an SSH key or root password (mandatory) - location (
NodeLocation
) – which datacenter to create the Linode in - ex_swap (
int
) – size of the swap partition in MB (128) - ex_rsize (
int
) – size of the root partition in MB (plan size - swap). - ex_kernel (
str
) – a kernel ID from avail.kernels (Latest 2.6 Stable). - ex_payment (
int
) – one of 1, 12, or 24; subscription length (1) - ex_comment (
str
) – a small comment for the configuration (libcloud) - ex_private (
bool
) – whether or not to request a private IP (False) - lconfig (
str
) – what to call the configuration (generated) - lroot (
str
) – what to call the root image (generated) - lswap (
str
) – what to call the swap space (generated)
Returns: Node representing the newly-created Linode
Return type: Node
- name (
-
destroy_node
(node)[source]¶ Destroy the given Linode
Will remove the Linode from the account and issue a prorated credit. A grant for removing Linodes from the account is required, otherwise this method will fail.
In most cases, all disk images must be removed from a Linode before the Linode can be removed; however, this call explicitly skips those safeguards. There is no going back from this method.
Parameters: node ( Node
) – the Linode to destroyReturn type: bool
-
destroy_volume
(volume)[source]¶ Destroys disk volume for the Linode. Linode id is to be provided as extra[“LinodeId”] whithin
StorageVolume
. It can be retrieved bylibcloud.compute.drivers.linode.LinodeNodeDriver .ex_list_volumes()
.Parameters: volume ( StorageVolume
) – Volume to be destroyedReturn type: bool
-
ex_create_volume
(size, name, node, fs_type)[source]¶ Create disk for the Linode.
Parameters: - size (
int
) – Size of volume in megabytes (required) - name (
str
) – Name of the volume to be created - node (
Node
) – Node to attach volume to. - fs_type (
str
) – The formatted type of this disk. Valid types are: ext3, ext4, swap, raw
Returns: StorageVolume representing the newly-created volume
Return type: StorageVolume
- size (
-
ex_list_volumes
(node, disk_id=None)[source]¶ List existing disk volumes for for given Linode.
Parameters: - node (
Node
) – Node to list disk volumes for. (required) - disk_id (
int
) – Id for specific disk volume. (optional)
Return type: list
ofStorageVolume
- node (
-
features
= {'create_node': ['ssh_key', 'password']}¶
-
linode_set_datacenter
(dc)[source]¶ Set the default datacenter for Linode creation
Since Linodes must be created in a facility, this function sets the default that
create_node
will use. If a location keyword is not passed tocreate_node
, this method must have already been used.Parameters: dc ( NodeLocation
) – the datacenter to create Linodes in unless specifiedReturn type: bool
-
list_images
()[source]¶ List available Linux distributions
Retrieve all Linux distributions that can be deployed to a Linode.
Return type: list
ofNodeImage
-
list_locations
()[source]¶ List available facilities for deployment
Retrieve all facilities that a Linode can be deployed in.
Return type: list
ofNodeLocation
-
list_nodes
()[source]¶ List all Linodes that the API key can access
- This call will return all Linodes that the API key in use has access
- to.
If a node is in this list, rebooting will work; however, creation and destruction are a separate grant.
Returns: List of node objects that the API key can access Return type: list
ofNode
-
list_sizes
(location=None)[source]¶ List available Linode plans
Gets the sizes that can be used for creating a Linode. Since available Linode plans vary per-location, this method can also be passed a location to filter the availability.
Parameters: location ( NodeLocation
) – the facility to retrieve plans inReturn type: list
ofNodeSize
-
name
= 'Linode'¶
-
reboot_node
(node)[source]¶ Reboot the given Linode
Will issue a shutdown job followed by a boot job, using the last booted configuration. In most cases, this will be the only configuration.
Parameters: node ( Node
) – the Linode to rebootReturn type: bool
-
type
= 'linode'¶
-
website
= 'http://www.linode.com/'¶
libcloud.compute.drivers.medone module¶
Med-1 Driver
-
class
libcloud.compute.drivers.medone.
MedOneNodeDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region='med1-il', **kwargs)[source]¶ Bases:
libcloud.compute.drivers.dimensiondata.DimensionDataNodeDriver
Med-1 node driver, based on Dimension Data driver
-
api_version
= 1.0¶
-
connectionCls
¶ alias of
DimensionDataConnection
-
features
= {'create_node': ['password']}¶
-
name
= 'MedOne'¶
-
selected_region
= None¶
-
type
= 'medone'¶
-
website
= 'http://www.med-1.com/'¶
-
libcloud.compute.drivers.nephoscale module¶
NephoScale Cloud driver (http://www.nephoscale.com) API documentation: http://docs.nephoscale.com Created by Markos Gogoulos (https://mist.io)
-
class
libcloud.compute.drivers.nephoscale.
NephoscaleConnection
(user_id, key, secure=True, host=None, port=None, url=None, timeout=None, proxy_url=None, backoff=None, retry_delay=None)[source]¶ Bases:
libcloud.common.base.ConnectionUserAndKey
Nephoscale connection class. Authenticates to the API through Basic Authentication with username/password
-
allow_insecure
= False¶
-
host
= 'api.nephoscale.com'¶
-
responseCls
¶ alias of
NephoscaleResponse
-
-
class
libcloud.compute.drivers.nephoscale.
NephoscaleNodeDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region=None, **kwargs)[source]¶ Bases:
libcloud.compute.base.NodeDriver
Nephoscale node driver class.
>>> from libcloud.compute.providers import get_driver >>> driver = get_driver('nephoscale') >>> conn = driver('nepho_user','nepho_password') >>> conn.list_nodes()
Parameters: - key (
str
) – API key or username to be used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections. - api_version (
str
) – Optional API version. Only used by drivers which support multiple API versions. - region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
Return type: None
-
api_name
= 'nephoscale'¶
-
connectionCls
¶ alias of
NephoscaleConnection
-
create_node
(name, size, image, server_key=None, console_key=None, zone=None, **kwargs)[source]¶ Creates the node, and sets the ssh key, console key NephoScale will respond with a 200-200 response after sending a valid request. If nowait=True is specified in the args, we then ask a few times until the server is created and assigned a public IP address, so that deploy_node can be run
>>> from libcloud.compute.providers import get_driver >>> driver = get_driver('nephoscale') >>> conn = driver('nepho_user','nepho_password') >>> conn.list_nodes() >>> name = 'staging-server' >>> size = conn.list_sizes()[0] <NodeSize: id=27, ...name=CS025 - 0.25GB, 10GB, ...> >>> image = conn.list_images()[9] <NodeImage: id=49, name=Linux Ubuntu Server 10.04 LTS 64-bit, ...> >>> server_keys = conn.ex_list_keypairs(key_group=1)[0] <NodeKey: id=71211, name=markos> >>> server_key = conn.ex_list_keypairs(key_group=1)[0].id 70867 >>> console_keys = conn.ex_list_keypairs(key_group=4)[0] <NodeKey: id=71213, name=mistio28434> >>> console_key = conn.ex_list_keypairs(key_group=4)[0].id 70907 >>> node = conn.create_node(name=name, size=size, image=image, console_key=console_key, server_key=server_key)
We can also create an ssh key, plus a console key and deploy node with them >>> server_key = conn.ex_create_keypair(name, public_key=‘123’) 71211 >>> console_key = conn.ex_create_keypair(name, key_group=4) 71213
We can increase the number of connect attempts to wait until the node is created, so that deploy_node has ip address to deploy the script We can also specify the location >>> location = conn.list_locations()[0] >>> node = conn.create_node(name=name, >>> ... size=size, >>> ... image=image, >>> ... console_key=console_key, >>> ... server_key=server_key, >>> ... connect_attempts=10, >>> ... nowait=True, >>> ... zone=location.id)
-
ex_create_keypair
(name, public_key=None, password=None, key_group=None)[source]¶ Creates a key, ssh or password, for server or console The group for the key (key_group) is 1 for Server and 4 for Console Returns the id of the created key
-
ex_list_keypairs
(ssh=False, password=False, key_group=None)[source]¶ List available console and server keys There are two types of keys for NephoScale, ssh and password keys. If run without arguments, lists all keys. Otherwise list only ssh keys, or only password keys. Password keys with key_group 4 are console keys. When a server is created, it has two keys, one password or ssh key, and one password console key.
Parameters: - ssh (
bool
) – if specified, show ssh keys only (optional) - password (
bool
) – if specified, show password keys only (optional) - key_group (
int
) – if specified, show keys with this key_group only eg key_group=4 for console password keys (optional)
Return type: list
ofNodeKey
- ssh (
-
features
= {'create_node': ['ssh_key']}¶
-
name
= 'NephoScale'¶
-
rename_node
(node, name, hostname=None)[source]¶ rename a cloud server, optionally specify hostname too
-
type
= 'nephoscale'¶
-
website
= 'http://www.nephoscale.com'¶
- key (
-
class
libcloud.compute.drivers.nephoscale.
NephoscaleResponse
(response, connection)[source]¶ Bases:
libcloud.common.base.JsonResponse
Nephoscale API Response
Parameters: - response (
httplib.HTTPResponse
) – HTTP response object. (optional) - connection (
Connection
) – Parent connection object.
- response (
libcloud.compute.drivers.ntta module¶
NTT America Driver
-
class
libcloud.compute.drivers.ntta.
NTTAmericaNodeDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region='ntta-na', **kwargs)[source]¶ Bases:
libcloud.compute.drivers.dimensiondata.DimensionDataNodeDriver
NTT America node driver, based on Dimension Data driver
-
api_version
= 1.0¶
-
connectionCls
¶ alias of
DimensionDataConnection
-
features
= {'create_node': ['password']}¶
-
name
= 'NTTAmerica'¶
-
selected_region
= None¶
-
type
= 'ntta'¶
-
website
= 'http://www.nttamerica.com/'¶
-
libcloud.compute.drivers.onapp module¶
-
class
libcloud.compute.drivers.onapp.
OnAppNodeDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region=None, **kwargs)[source]¶ Bases:
libcloud.compute.base.NodeDriver
Base OnApp node driver.
Parameters: - key (
str
) – API key or username to be used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections. - api_version (
str
) – Optional API version. Only used by drivers which support multiple API versions. - region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
Return type: None
-
connectionCls
¶ alias of
OnAppConnection
-
create_node
(name, ex_memory, ex_cpus, ex_cpu_shares, ex_hostname, ex_template_id, ex_primary_disk_size, ex_swap_disk_size, ex_required_virtual_machine_build=1, ex_required_ip_address_assignment=1, **kwargs)[source]¶ Add a VS
Parameters: kwargs ( dict
) – All keyword arguments to create a VSReturn type: OnAppNode
-
destroy_node
(node, ex_convert_last_backup=0, ex_destroy_all_backups=0)[source]¶ Delete a VS
Parameters: - node – OnApp node
- convert_last_backup (
int
) – set 1 to convert the last VS’s backup to template, otherwise set 0 - destroy_all_backups (
int
) – set 1 to destroy all existing backups of this VS, otherwise set 0
-
name
= 'OnApp'¶
-
type
= 'onapp'¶
-
website
= 'http://onapp.com/'¶
- key (
libcloud.compute.drivers.opennebula module¶
OpenNebula.org driver.
-
class
libcloud.compute.drivers.opennebula.
ACTION
[source]¶ Bases:
object
All actions, except RESUME, only apply when the VM is in the “Running” state.
-
CANCEL
= 'CANCEL'¶ The VM is forcibly shutdown, its memory state is deleted. If a persistent disk image was used, that disk image is transferred back to the front-end. Any non-persistent disk images are deleted.
-
DONE
= 'DONE'¶ The VM is forcibly shutdown, its memory state is deleted. If a persistent disk image was used, that disk image is transferred back to the front-end. Any non-persistent disk images are deleted.
-
REBOOT
= 'REBOOT'¶ Introduced in OpenNebula v3.2.
The VM is gracefully restarted by sending the ACPI signal.
-
RESUME
= 'RESUME'¶ The VM is resumed using the saved memory state from the checkpoint file, and the VM’s disk image. The VM is either started immediately, or re-scheduled depending on how it was suspended.
-
SHUTDOWN
= 'SHUTDOWN'¶ The VM is gracefully shutdown by sending the ACPI signal. If the VM does not shutdown, then it is considered to still be running. If successfully, shutdown, its memory state is deleted. If a persistent disk image was used, that disk image is transferred back to the front-end. Any non-persistent disk images are deleted.
-
STOP
= 'STOPPED'¶ The VM is stopped, and its memory state stored to a checkpoint file. VM state, and disk image, are transferred back to the front-end. Resuming the VM requires the VM instance to be re-scheduled.
-
SUSPEND
= 'SUSPENDED'¶ The VM is stopped, and its memory state stored to a checkpoint file. The VM state, and disk image, are left on the host to be resumed later. Resuming the VM does not require the VM to be re-scheduled. Rather, after suspending, the VM resources are reserved for later resuming.
-
-
class
libcloud.compute.drivers.opennebula.
OpenNebulaResponse
(response, connection)[source]¶ Bases:
libcloud.common.base.XmlResponse
XmlResponse class for the OpenNebula.org driver.
Parameters: - response (
httplib.HTTPResponse
) – HTTP response object. (optional) - connection (
Connection
) – Parent connection object.
- response (
-
class
libcloud.compute.drivers.opennebula.
OpenNebulaConnection
(*args, **kwargs)[source]¶ Bases:
libcloud.common.base.ConnectionUserAndKey
Connection class for the OpenNebula.org driver. with plain_auth support
-
add_default_headers
(headers)[source]¶ Add headers required by the OpenNebula.org OCCI interface.
Includes adding Basic HTTP Authorization headers for authenticating against the OpenNebula.org OCCI interface.
Parameters: headers ( dict
) – Dictionary containing HTTP headers.Return type: dict
Returns: Dictionary containing updated headers.
-
host
= ''¶
-
plain_auth
= False¶
-
port
= (4567, 443)¶
-
responseCls
¶ alias of
OpenNebulaResponse
-
secure
= True¶
-
-
class
libcloud.compute.drivers.opennebula.
OpenNebulaNodeSize
(id, name, ram, disk, bandwidth, price, driver, cpu=None, vcpu=None)[source]¶ Bases:
libcloud.compute.base.NodeSize
NodeSize class for the OpenNebula.org driver.
-
class
libcloud.compute.drivers.opennebula.
OpenNebulaNetwork
(id, name, address, size, driver, extra=None)[source]¶ Bases:
object
Provide a common interface for handling networks of all types.
Network objects are analogous to physical switches connecting two or more physical nodes together. The Network object provides the interface in libcloud through which we can manipulate networks in different cloud providers in the same way. Network objects don’t actually do much directly themselves, instead the network driver handles the connection to the network.
You don’t normally create a network object yourself; instead you use a driver and then have that create the network for you.
>>> from libcloud.compute.drivers.dummy import DummyNodeDriver >>> driver = DummyNodeDriver() >>> network = driver.create_network() >>> network = driver.list_networks()[0] >>> network.name 'dummy-1'
-
get_uuid
()[source]¶ Unique hash for this network.
The hash is a function of an SHA1 hash of the network’s ID and its driver which means that it should be unique between all networks. In some subclasses (e.g. GoGrid) there is no ID available so the public IP address is used. This means that, unlike a properly done system UUID, the same UUID may mean a different system install at a different time
>>> from libcloud.network.drivers.dummy import DummyNetworkDriver >>> driver = DummyNetworkDriver() >>> network = driver.create_network() >>> network.get_uuid() 'd3748461511d8b9b0e0bfa0d4d3383a619a2bb9f'
Note, for example, that this example will always produce the same UUID!
Return type: str
Returns: Unique identifier for this instance.
-
-
class
libcloud.compute.drivers.opennebula.
OpenNebulaNodeDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region=None, **kwargs)[source]¶ Bases:
libcloud.compute.base.NodeDriver
OpenNebula.org node driver.
Parameters: - key (
str
) – API key or username to be used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections. - api_version (
str
) – Optional API version. Only used by drivers which support multiple API versions. - region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
Return type: None
-
NODE_STATE_MAP
= {'FAILED': 'terminated', 'INIT': 'pending', 'STOPPED': 'terminated', 'SUSPENDED': 'pending', 'ACTIVE': 'running', 'DONE': 'terminated', 'HOLD': 'pending', 'PENDING': 'pending'}¶
-
connectionCls
¶ alias of
OpenNebulaConnection
-
create_node
(**kwargs)[source]¶ Create a new OpenNebula node.
@inherits:
NodeDriver.create_node
Parameters: networks ( OpenNebulaNetwork
orlist
ofOpenNebulaNetwork
) – List of virtual networks to which this node should connect. (optional)
-
ex_list_networks
(location=None)[source]¶ List virtual networks on a provider.
Parameters: location ( NodeLocation
) – Location from which to request a list of virtual networks. (optional)Returns: List of virtual networks available to be connected to a compute node. Return type: list
ofOpenNebulaNetwork
-
ex_node_action
(node, action)[source]¶ Build action representation and instruct node to commit action.
Build action representation from the compute node ID, and the action which should be carried out on that compute node. Then instruct the node to carry out that action.
Parameters: - node (
Node
) – Compute node instance. - action (
str
) – Action to be carried out on the compute node.
Returns: False if an HTTP Bad Request is received, else, True is returned.
Return type: bool
- node (
-
list_sizes
(location=None)[source]¶ Return list of sizes on a provider.
@inherits:
NodeDriver.list_sizes
Returns: List of compute node sizes supported by the cloud provider. Return type: list
ofOpenNebulaNodeSize
-
name
= 'OpenNebula'¶
-
type
= 'opennebula'¶
-
website
= 'http://opennebula.org/'¶
- key (
-
class
libcloud.compute.drivers.opennebula.
OpenNebula_1_4_NodeDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region=None, **kwargs)[source]¶ Bases:
libcloud.compute.drivers.opennebula.OpenNebulaNodeDriver
OpenNebula.org node driver for OpenNebula.org v1.4.
Parameters: - key (
str
) – API key or username to be used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections. - api_version (
str
) – Optional API version. Only used by drivers which support multiple API versions. - region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
Return type: None
-
name
= 'OpenNebula (v1.4)'¶
- key (
-
class
libcloud.compute.drivers.opennebula.
OpenNebula_2_0_NodeDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region=None, **kwargs)[source]¶ Bases:
libcloud.compute.drivers.opennebula.OpenNebulaNodeDriver
OpenNebula.org node driver for OpenNebula.org v2.0 through OpenNebula.org v2.2.
Parameters: - key (
str
) – API key or username to be used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections. - api_version (
str
) – Optional API version. Only used by drivers which support multiple API versions. - region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
Return type: None
-
create_node
(**kwargs)[source]¶ Create a new OpenNebula node.
@inherits:
NodeDriver.create_node
Parameters: - networks (
OpenNebulaNetwork
orlist
ofOpenNebulaNetwork
) – List of virtual networks to which this node should connect. (optional) - context (
dict
) – Custom (key, value) pairs to be injected into compute node XML description. (optional)
Returns: Instance of a newly created node.
Return type: Node
- networks (
-
list_sizes
(location=None)[source]¶ Return list of sizes on a provider.
@inherits:
NodeDriver.list_sizes
Returns: List of compute node sizes supported by the cloud provider. Return type: list
ofOpenNebulaNodeSize
-
name
= 'OpenNebula (v2.0 - v2.2)'¶
- key (
-
class
libcloud.compute.drivers.opennebula.
OpenNebula_3_0_NodeDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region=None, **kwargs)[source]¶ Bases:
libcloud.compute.drivers.opennebula.OpenNebula_2_0_NodeDriver
OpenNebula.org node driver for OpenNebula.org v3.0.
Parameters: - key (
str
) – API key or username to be used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections. - api_version (
str
) – Optional API version. Only used by drivers which support multiple API versions. - region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
Return type: None
-
ex_node_set_save_name
(node, name)[source]¶ Build action representation and instruct node to commit action.
Build action representation from the compute node ID, the disk image which will be saved, and the name under which the image will be saved upon shutting down the compute node.
Parameters: - node (
Node
) – Compute node instance. - name (
str
) – Name under which the image should be saved after shutting down the compute node.
Returns: False if an HTTP Bad Request is received, else, True is returned.
Return type: bool
- node (
-
name
= 'OpenNebula (v3.0)'¶
- key (
-
class
libcloud.compute.drivers.opennebula.
OpenNebula_3_2_NodeDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region=None, **kwargs)[source]¶ Bases:
libcloud.compute.drivers.opennebula.OpenNebula_3_0_NodeDriver
OpenNebula.org node driver for OpenNebula.org v3.2.
Parameters: - key (
str
) – API key or username to be used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections. - api_version (
str
) – Optional API version. Only used by drivers which support multiple API versions. - region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
Return type: None
-
list_sizes
(location=None)[source]¶ Return list of sizes on a provider.
@inherits:
NodeDriver.list_sizes
Returns: List of compute node sizes supported by the cloud provider. Return type: list
ofOpenNebulaNodeSize
-
name
= 'OpenNebula (v3.2)'¶
- key (
-
class
libcloud.compute.drivers.opennebula.
OpenNebula_3_8_NodeDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region=None, **kwargs)[source]¶ Bases:
libcloud.compute.drivers.opennebula.OpenNebula_3_6_NodeDriver
OpenNebula.org node driver for OpenNebula.org v3.8.
Parameters: - key (
str
) – API key or username to be used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections. - api_version (
str
) – Optional API version. Only used by drivers which support multiple API versions. - region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
Return type: None
-
name
= 'OpenNebula (v3.8)'¶
-
plain_auth
= False¶
- key (
libcloud.compute.drivers.openstack module¶
OpenStack driver
-
class
libcloud.compute.drivers.openstack.
OpenStack_1_0_Connection
(user_id, key, secure=True, host=None, port=None, timeout=None, proxy_url=None, ex_force_base_url=None, ex_force_auth_url=None, ex_force_auth_version=None, ex_force_auth_token=None, ex_token_scope='project', ex_domain_name='Default', ex_tenant_name=None, ex_force_service_type=None, ex_force_service_name=None, ex_force_service_region=None, retry_delay=None, backoff=None)[source]¶ Bases:
libcloud.compute.drivers.openstack.OpenStackComputeConnection
-
XML_NAMESPACE
= 'http://docs.rackspacecloud.com/servers/api/v1.0'¶
-
accept_format
= 'application/xml'¶
-
default_content_type
= 'application/xml; charset=UTF-8'¶
-
responseCls
¶ alias of
OpenStack_1_0_Response
-
-
class
libcloud.compute.drivers.openstack.
OpenStack_1_0_NodeDriver
(*args, **kwargs)[source]¶ Bases:
libcloud.compute.drivers.openstack.OpenStackNodeDriver
OpenStack node driver.
- Extra node attributes:
- password: root password, available after create.
- hostId: represents the host your cloud server runs on
- imageId: id of image
- flavorId: id of flavor
-
connectionCls
¶ alias of
OpenStack_1_0_Connection
-
create_image
(node, name, description=None, reboot=True)[source]¶ Create an image for node.
@inherits:
NodeDriver.create_image
Parameters: - node (
Node
) – node to use as a base for image - name (
str
) – name for new image
Return type: NodeImage
- node (
-
create_node
(**kwargs)[source]¶ Create a new node
@inherits:
NodeDriver.create_node
Parameters: - ex_metadata (
dict
) – Key/Value metadata to associate with a node - ex_files (
dict
) – File Path => File contents to create on the node - ex_shared_ip_group_id (
str
) – The server is launched into that shared IP group
- ex_metadata (
-
delete_image
(image)[source]¶ Delete an image for node.
@inherits:
NodeDriver.delete_image
Parameters: image ( NodeImage
) – the image to be deletedReturn type: bool
-
ex_confirm_resize
(node)[source]¶ Confirm a resize request which is currently in progress. If a resize request is not explicitly confirmed or reverted it’s automatically confirmed after 24 hours.
For more info refer to the API documentation: http://goo.gl/zjFI1
Parameters: node ( Node
) – node for which the resize request will be confirmed.Return type: bool
-
ex_create_ip_group
(group_name, node_id=None)[source]¶ Creates a shared IP group.
Parameters: - group_name (
str
) – group name which should be used - node_id (
str
) – ID of the node which should be used
Return type: bool
- group_name (
-
ex_delete_ip_group
(group_id)[source]¶ Deletes the specified shared IP group.
Parameters: group_id ( str
) – group id which should be usedReturn type: bool
-
ex_limits
()[source]¶ Extra call to get account’s limits, such as rates (for example amount of POST requests per day) and absolute limits like total amount of available RAM to be used by servers.
Returns: dict with keys ‘rate’ and ‘absolute’ Return type: dict
-
ex_list_ip_addresses
(node_id)[source]¶ List all server addresses.
Parameters: node_id ( str
) – ID of the node which should be usedReturn type: OpenStack_1_0_NodeIpAddresses
-
ex_list_ip_groups
(details=False)[source]¶ Lists IDs and names for shared IP groups. If details lists all details for shared IP groups.
Parameters: details ( bool
) – True if details is requiredReturn type: list
ofOpenStack_1_0_SharedIpGroup
-
ex_rebuild
(node_id, image_id)[source]¶ Rebuilds the specified server.
Parameters: - node_id (
str
) – ID of the node which should be used - image_id (
str
) – ID of the image which should be used
Return type: bool
- node_id (
-
ex_resize
(node, size)[source]¶ Change an existing server flavor / scale the server up or down.
Parameters: - node (
Node
) – node to resize. - size (
NodeSize
) – new size.
Return type: bool
- node (
-
ex_revert_resize
(node)[source]¶ Revert a resize request which is currently in progress. All resizes are automatically confirmed after 24 hours if they have not already been confirmed explicitly or reverted.
For more info refer to the API documentation: http://goo.gl/AizBu
Parameters: node ( Node
) – node for which the resize request will be reverted.Return type: bool
-
ex_set_password
(node, password)[source]¶ Sets the Node’s root password.
This will reboot the instance to complete the operation.
Node.extra['password']
will be set to the new value if the operation was successful.Parameters: - node (
Node
) – node to set password - password (
str
) – new password.
Return type: bool
- node (
-
ex_set_server_name
(node, name)[source]¶ Sets the Node’s name.
This will reboot the instance to complete the operation.
Parameters: - node (
Node
) – node to set name - name (
str
) – new name
Return type: bool
- node (
Shares an IP address to the specified server.
Parameters: - group_id (
str
) – group id which should be used - node_id (
str
) – ID of the node which should be used - ip (
str
) – ip which should be used - configure_node (
bool
) – configure node
Return type: bool
- group_id (
Removes a shared IP address from the specified server.
Parameters: - node_id (
str
) – ID of the node which should be used - ip (
str
) – ip which should be used
Return type: bool
- node_id (
-
features
= {'create_node': ['generates_password']}¶
-
type
= 'openstack'¶
Bases:
object
Shared IP group info.
-
class
libcloud.compute.drivers.openstack.
OpenStack_1_0_NodeIpAddresses
(public_addresses, private_addresses)[source]¶ Bases:
object
List of public and private IP addresses of a Node.
-
class
libcloud.compute.drivers.openstack.
OpenStack_1_1_Connection
(user_id, key, secure=True, host=None, port=None, timeout=None, proxy_url=None, ex_force_base_url=None, ex_force_auth_url=None, ex_force_auth_version=None, ex_force_auth_token=None, ex_token_scope='project', ex_domain_name='Default', ex_tenant_name=None, ex_force_service_type=None, ex_force_service_name=None, ex_force_service_region=None, retry_delay=None, backoff=None)[source]¶ Bases:
libcloud.compute.drivers.openstack.OpenStackComputeConnection
-
accept_format
= 'application/json'¶
-
default_content_type
= 'application/json; charset=UTF-8'¶
-
responseCls
¶ alias of
OpenStack_1_1_Response
-
-
class
libcloud.compute.drivers.openstack.
OpenStack_1_1_NodeDriver
(*args, **kwargs)[source]¶ Bases:
libcloud.compute.drivers.openstack.OpenStackNodeDriver
OpenStack node driver.
-
connectionCls
¶ alias of
OpenStack_1_1_Connection
-
create_image
(node, name, metadata=None)[source]¶ Creates a new image.
Parameters: - node (
Node
) – Node - name (
str
) – The name for the new image. - metadata (
dict
) – Key and value pairs for metadata.
Return type: NodeImage
- node (
-
create_node
(**kwargs)[source]¶ Create a new node
@inherits:
NodeDriver.create_node
Parameters: - ex_keyname (
str
) – The name of the key pair - ex_userdata (
str
) – String containing user data see https://help.ubuntu.com/community/CloudInit - ex_config_drive (
bool
) – Enable config drive see http://docs.openstack.org/grizzly/openstack-compute/admin/content/config-drive.html - ex_security_groups (
list
ofOpenStackSecurityGroup
) – List of security groups to assign to the node - ex_metadata (
dict
) – Key/Value metadata to associate with a node - ex_files (
dict
) – File Path => File contents to create on the no de - networks (
list
ofOpenStackNetwork
) – The server is launched into a set of Networks. - ex_disk_config (
str
) – Name of the disk configuration. Can be eitherAUTO
orMANUAL
. - ex_config_drive – If True enables metadata injection in a server through a configuration drive.
- ex_admin_pass (
str
) – The root password for the node - ex_availability_zone (
str
) – Nova availability zone for the node
- ex_keyname (
-
create_volume_snapshot
(volume, name=None, ex_description=None, ex_force=True)[source]¶ Create snapshot from volume
Parameters: - volume (StorageVolume) – Instance of StorageVolume
- name (str) – Name of snapshot (optional)
- ex_description (str) – Description of the snapshot (optional)
- ex_force (bool) – Specifies if we create a snapshot that is not in state available. For example in-use. Defaults to True. (optional)
Return type: VolumeSnapshot
-
delete_image
(image)[source]¶ Delete a NodeImage
@inherits:
NodeDriver.delete_image
Parameters: image ( NodeImage
) – image witch should be usedReturn type: bool
-
delete_key_pair
(key_pair)[source]¶ Delete a KeyPair.
Parameters: keypair ( OpenStackKeyPair
) – KeyPair to deleteReturn type: bool
-
ex_attach_floating_ip_to_node
(node, ip)[source]¶ Attach the floating IP to the node
Parameters: - node (
Node
) – node - ip (
str
orOpenStack_1_1_FloatingIpAddress
) – floating IP to attach
Return type: bool
- node (
-
ex_confirm_resize
(node)[source]¶ Confirms a pending resize action.
Parameters: node ( Node
) – Node to resize.Return type: bool
-
ex_create_floating_ip
(ip_pool=None)[source]¶ Create new floating IP. The ip_pool attribute is optional only if your infrastructure has only one IP pool available.
Parameters: ip_pool ( str
) – name of the floating IP poolReturn type: OpenStack_1_1_FloatingIpAddress
-
ex_create_keypair
(name)[source]¶ Create a new KeyPair
Parameters: name ( str
) – Name of the new KeyPairReturn type: OpenStackKeyPair
-
ex_create_network
(name, cidr)[source]¶ Create a new Network
Parameters: - name (
str
) – Name of network which should be used - cidr (
str
) – cidr of network which should be used
Return type: OpenStackNetwork
- name (
-
ex_create_security_group
(name, description)[source]¶ Create a new Security Group
Parameters: - name (
str
) – Name of the new Security Group - description (
str
) – Description of the new Security Group
Return type: OpenStackSecurityGroup
- name (
-
ex_create_security_group_rule
(security_group, ip_protocol, from_port, to_port, cidr=None, source_security_group=None)[source]¶ Create a new Rule in a Security Group
Parameters: - security_group (
OpenStackSecurityGroup
) – Security Group in which to add the rule - ip_protocol (
str
) – Protocol to which this rule applies Examples: tcp, udp, ... - from_port (
int
) – First port of the port range - to_port (
int
) – Last port of the port range - cidr (
str
) – CIDR notation of the source IP range for this rule - source_security_group (L{OpenStackSecurityGroup) – Existing Security Group to use as the source (instead of CIDR)
Return type: OpenStackSecurityGroupRule
- security_group (
-
ex_create_snapshot
(volume, name, description=None, force=False)[source]¶ Create a snapshot based off of a volume.
Parameters: - volume (
StorageVolume
) – volume - name (
str
) – New name for the volume snapshot - description (
str
) – Description of the snapshot (optional) - force (
bool
) – Whether to force creation (optional)
Return type: VolumeSnapshot
- volume (
-
ex_delete_floating_ip
(ip)[source]¶ Delete specified floating IP
Parameters: ip ( OpenStack_1_1_FloatingIpAddress
) – floating IP to removeReturn type: bool
-
ex_delete_keypair
(keypair)[source]¶ Delete a KeyPair.
Parameters: keypair ( OpenStackKeyPair
) – KeyPair to deleteReturn type: bool
-
ex_delete_network
(network)[source]¶ Get a list of NodeNetorks that are available.
Parameters: network ( OpenStackNetwork
) – Network which should be usedReturn type: bool
-
ex_delete_security_group
(security_group)[source]¶ Delete a Security Group.
Parameters: security_group ( OpenStackSecurityGroup
) – Security Group should be deletedReturn type: bool
-
ex_delete_security_group_rule
(rule)[source]¶ Delete a Rule from a Security Group.
Parameters: rule ( OpenStackSecurityGroupRule
) – Rule should be deletedReturn type: bool
-
ex_delete_snapshot
(snapshot)[source]¶ Delete a VolumeSnapshot
Parameters: snapshot ( VolumeSnapshot
) – snapshotReturn type: bool
-
ex_detach_floating_ip_from_node
(node, ip)[source]¶ Detach the floating IP from the node
Parameters: - node (
Node
) – node - ip (
str
orOpenStack_1_1_FloatingIpAddress
) – floating IP to remove
Return type: bool
- node (
-
ex_get_console_output
(node, length=None)[source]¶ Get console output
Parameters: - node (
Node
) – node - length (
int
) – Optional number of lines to fetch from the console log
Returns: Dictionary with the output
Return type: dict
- node (
-
ex_get_floating_ip
(ip)[source]¶ Get specified floating IP
Parameters: ip ( str
) – floating IP to getReturn type: OpenStack_1_1_FloatingIpAddress
-
ex_get_metadata
(node)[source]¶ Get a Node’s metadata.
Parameters: node ( Node
) – NodeReturns: Key/Value metadata associated with node. Return type: dict
-
ex_get_metadata_for_node
(node)[source]¶ Return the metadata associated with the node.
Parameters: node ( Node
) – Node instanceReturns: A dictionary or other mapping of strings to strings, associating tag names with tag values.
-
ex_get_node_security_groups
(node)[source]¶ Get Security Groups of the specified server.
Return type: list
ofOpenStackSecurityGroup
-
ex_get_size
(size_id)[source]¶ Get a NodeSize
Parameters: size_id ( str
) – ID of the size which should be usedReturn type: NodeSize
-
ex_import_keypair
(name, keyfile)[source]¶ Import a KeyPair from a file
Parameters: - name (
str
) – Name of the new KeyPair - keyfile (
str
) – Path to the public key file (in OpenSSH format)
Return type: OpenStackKeyPair
- name (
-
ex_import_keypair_from_string
(name, key_material)[source]¶ Import a KeyPair from a string
Parameters: - name (
str
) – Name of the new KeyPair - key_material (
str
) – Public key (in OpenSSH format)
Return type: OpenStackKeyPair
- name (
-
ex_list_floating_ip_pools
()[source]¶ List available floating IP pools
Return type: list
ofOpenStack_1_1_FloatingIpPool
-
ex_list_floating_ips
()[source]¶ List floating IPs
Return type: list
ofOpenStack_1_1_FloatingIpAddress
-
ex_list_keypairs
()[source]¶ Get a list of KeyPairs that are available.
Return type: list
ofOpenStackKeyPair
-
ex_list_networks
()[source]¶ Get a list of Networks that are available.
Return type: list
ofOpenStackNetwork
-
ex_list_security_groups
()[source]¶ Get a list of Security Groups that are available.
Return type: list
ofOpenStackSecurityGroup
-
ex_rebuild
(node, image, **kwargs)[source]¶ Rebuild a Node.
Parameters: - node (
Node
) – Node to rebuild. - image (
NodeImage
) – New image to use. - ex_metadata (
dict
) – Key/Value metadata to associate with a node - ex_files (
dict
) – File Path => File contents to create on the no de - ex_keyname (
str
) – Name of existing public key to inject into instance - ex_userdata (
str
) – String containing user data see https://help.ubuntu.com/community/CloudInit - ex_security_groups (
list
ofOpenStackSecurityGroup
) – List of security groups to assign to the node - ex_disk_config (
str
) – Name of the disk configuration. Can be eitherAUTO
orMANUAL
. - ex_config_drive (
bool
) – If True enables metadata injection in a server through a configuration drive.
Return type: bool
- node (
-
ex_rescue
(node, password=None)[source]¶ Rescue a node
Parameters: - node (
Node
) – node - password (
str
) – password
Return type: Node
- node (
-
ex_resize
(node, size)[source]¶ Change a node size.
Parameters: - node (
Node
) – Node to resize. - size (
NodeSize
) – New size to use.
Return type: bool
- node (
-
ex_revert_resize
(node)[source]¶ Cancels and reverts a pending resize action.
Parameters: node ( Node
) – Node to resize.Return type: bool
-
ex_set_metadata
(node, metadata)[source]¶ Sets the Node’s metadata.
Parameters: - node (
Node
) – Node - metadata (
dict
) – Key/Value metadata to associate with a node
Return type: dict
- node (
-
ex_set_password
(node, password)[source]¶ Changes the administrator password for a specified server.
Parameters: - node (
Node
) – Node to rebuild. - password (
str
) – The administrator password.
Return type: bool
- node (
-
ex_set_server_name
(node, name)[source]¶ Sets the Node’s name.
Parameters: - node (
Node
) – Node - name (
str
) – The name of the server.
Return type: Node
- node (
-
ex_update_node
(node, **node_updates)[source]¶ Update the Node’s editable attributes. The OpenStack API currently supports editing name and IPv4/IPv6 access addresses.
The driver currently only supports updating the node name.
Parameters: - node (
Node
) – Node - name (
str
) – New name for the server
Return type: Node
- node (
-
features
= {'create_node': ['generates_password']}¶
-
get_image
(image_id)[source]¶ Get a NodeImage
@inherits:
NodeDriver.get_image
Parameters: image_id ( str
) – ID of the image which should be usedReturn type: NodeImage
-
type
= 'openstack'¶
-
-
class
libcloud.compute.drivers.openstack.
OpenStack_1_1_FloatingIpPool
(name, connection)[source]¶ Bases:
object
Floating IP Pool info.
-
create_floating_ip
()[source]¶ Create new floating IP in the pool
Return type: OpenStack_1_1_FloatingIpAddress
-
delete_floating_ip
(ip)[source]¶ Delete specified floating IP from the pool
Parameters: ip – floating IP to remove :type ip:
OpenStack_1_1_FloatingIpAddress
Return type: bool
-
get_floating_ip
(ip)[source]¶ Get specified floating IP from the pool
Parameters: ip ( str
) – floating IP to getReturn type: OpenStack_1_1_FloatingIpAddress
-
list_floating_ips
()[source]¶ List floating IPs in the pool
Return type: list
ofOpenStack_1_1_FloatingIpAddress
-
-
class
libcloud.compute.drivers.openstack.
OpenStack_1_1_FloatingIpAddress
(id, ip_address, pool, node_id=None, driver=None)[source]¶ Bases:
object
Floating IP info.
-
class
libcloud.compute.drivers.openstack.
OpenStackNodeDriver
(*args, **kwargs)[source]¶ Bases:
libcloud.compute.base.NodeDriver
,libcloud.common.openstack.OpenStackDriverMixin
Base OpenStack node driver. Should not be used directly.
-
NODE_STATE_MAP
= {'RESCUE': 'pending', 'DELETE_IP': 'pending', 'PREP_RESIZE': 'pending', 'DELETED': 'terminated', 'UNKNOWN': 'unknown', 'REBUILD': 'pending', 'ERROR': 'error', 'REBOOT': 'rebooting', 'SHUTOFF': 'stopped', 'VERIFY_RESIZE': 'running', 'QUEUE_RESIZE': 'pending', 'BUILD': 'pending', 'SUSPENDED': 'stopped', 'SHARE_IP': 'pending', 'ACTIVE': 'running', 'SHARE_IP_NO_CONFIG': 'pending', 'PASSWORD': 'pending', 'HARD_REBOOT': 'rebooting'}¶
-
SNAPSHOT_STATE_MAP
= {'available': 'available', 'creating': 'creating', 'error': 'error', 'error_restoring': 'error', 'deleting': 'deleting', 'restoring': 'restoring'}¶
-
VOLUME_STATE_MAP
= {'available': 'available', 'restoring-backup': 'backup', 'creating': 'creating', 'in-use': 'inuse', 'error_extending': 'error', 'backing-up': 'backup', 'error_deleting': 'error', 'attaching': 'attaching', 'error': 'error', 'error_restoring': 'error', 'deleting': 'deleting'}¶
-
api_name
= 'openstack'¶
-
create_volume
(size, name, location=None, snapshot=None, ex_volume_type=None)[source]¶ Create a new volume.
Parameters: - size (
int
) – Size of volume in gigabytes (required) - name (
str
) – Name of the volume to be created - location (
NodeLocation
) – Which data center to create a volume in. If empty, undefined behavior will be selected. (optional) - snapshot (
VolumeSnapshot
) – Snapshot from which to create the new volume. (optional) - ex_volume_type (
str
) – What kind of volume to create. (optional)
Returns: The newly created volume.
Return type: StorageVolume
- size (
-
ex_get_node_details
(node_id)[source]¶ Lists details of the specified server.
Parameters: node_id ( str
) – ID of the node which should be usedReturn type: Node
-
ex_hard_reboot_node
(node)[source]¶ Hard reboots the specified server
Parameters: node ( Node
) – nodeReturn type: bool
-
ex_soft_reboot_node
(node)[source]¶ Soft reboots the specified server
Parameters: node ( Node
) – nodeReturn type: bool
-
get_image
(image_id)[source]¶ Get an image based on an image_id
@inherits:
NodeDriver.get_image
Parameters: image_id ( str
) – Image identifierReturns: A NodeImage object Return type: NodeImage
-
list_images
(location=None, ex_only_active=True)[source]¶ Lists all active images
@inherits:
NodeDriver.list_images
Parameters: ex_only_active ( bool
) – True if list only active
-
list_nodes
(ex_all_tenants=False)[source]¶ List the nodes in a tenant
Parameters: ex_all_tenants ( bool
) – List nodes for all the tenants. Note: Your user must have admin privileges for this functionality to work.
-
name
= 'OpenStack'¶
-
website
= 'http://openstack.org/'¶
-
libcloud.compute.drivers.packet module¶
Packet Driver
-
class
libcloud.compute.drivers.packet.
PacketConnection
(key, secure=True, host=None, port=None, url=None, timeout=None, proxy_url=None, backoff=None, retry_delay=None)[source]¶ Bases:
libcloud.common.base.ConnectionKey
Connection class for the Packet driver.
Initialize user_id and key; set secure to an
int
based on passed value.-
host
= 'api.packet.net'¶
-
responseCls
¶ alias of
PacketResponse
-
-
class
libcloud.compute.drivers.packet.
PacketNodeDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region=None, **kwargs)[source]¶ Bases:
libcloud.compute.base.NodeDriver
Packet NodeDriver
Parameters: - key (
str
) – API key or username to be used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections. - api_version (
str
) – Optional API version. Only used by drivers which support multiple API versions. - region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
Return type: None
-
NODE_STATE_MAP
= {'rebuilding': 'pending', 'deprovisioning': 'terminated', 'deleted': 'terminated', 'inactive': 'stopped', 'active': 'running', 'rebooting': 'rebooting', 'provisioning': 'pending', 'powering_on': 'rebooting', 'failed': 'error', 'powering_off': 'rebooting', 'queued': 'pending'}¶
-
connectionCls
¶ alias of
PacketConnection
-
create_key_pair
(name, public_key)[source]¶ Create a new SSH key.
Parameters: - name (
str
) – Key name (required) - public_key (
str
) – Valid public key string (required)
- name (
-
create_node
(name, size, image, location, ex_project_id)[source]¶ Create a node.
Returns: The newly created node. Return type: Node
-
delete_key_pair
(key)[source]¶ Delete an existing SSH key.
Parameters: key ( KeyPair
) – SSH key (required)
-
list_key_pairs
()[source]¶ List all the available SSH keys.
Returns: Available SSH keys. Return type: list
ofKeyPair
objects
-
name
= 'Packet'¶
-
type
= 'packet'¶
-
website
= 'http://www.packet.net/'¶
- key (
-
class
libcloud.compute.drivers.packet.
PacketResponse
(response, connection)[source]¶ Bases:
libcloud.common.base.JsonResponse
Parameters: - response (
httplib.HTTPResponse
) – HTTP response object. (optional) - connection (
Connection
) – Parent connection object.
-
valid_response_codes
= [200, 202, 201, 204]¶
- response (
libcloud.compute.drivers.profitbricks module¶
ProfitBricks Compute driver
-
class
libcloud.compute.drivers.profitbricks.
ProfitBricksNodeDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region=None, **kwargs)[source]¶ Bases:
libcloud.compute.base.NodeDriver
Base ProfitBricks node driver.
Parameters: - key (
str
) – API key or username to be used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections. - api_version (
str
) – Optional API version. Only used by drivers which support multiple API versions. - region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
Return type: None
-
AVAILABILITY_ZONE
= {'1': {'name': 'AUTO'}, '3': {'name': 'ZONE_2'}, '2': {'name': 'ZONE_1'}}¶ ProfitBricks is unique in that they allow the user to define all aspects of the instance size, i.e. disk size, core size, and memory size.
These are instance types that match up with what other providers support.
You can configure disk size, core size, and memory size using the
ex_
parameters on the create_node method.
-
NODE_STATE_MAP
= {'PAUSE': 'stopped', 'NOSTATE': 'unknown', 'RUNNING': 'running', 'CRASHED': 'stopped', 'SHUTOFF': 'stopped', 'SHUTDOWN': 'pending', 'BLOCKED': 'stopped'}¶
-
PROFIT_BRICKS_GENERIC_SIZES
= {'1': {'disk': 50, 'cores': 1, 'ram': 1024, 'id': '1', 'name': 'Micro'}, '3': {'disk': 50, 'cores': 2, 'ram': 4096, 'id': '3', 'name': 'Medium Instance'}, '2': {'disk': 50, 'cores': 1, 'ram': 2048, 'id': '2', 'name': 'Small Instance'}, '5': {'disk': 50, 'cores': 8, 'ram': 14336, 'id': '5', 'name': 'ExtraLarge Instance'}, '4': {'disk': 50, 'cores': 4, 'ram': 7168, 'id': '4', 'name': 'Large Instance'}, '7': {'disk': 50, 'cores': 8, 'ram': 57344, 'id': '7', 'name': 'Memory Intensive Instance Large'}, '6': {'disk': 50, 'cores': 4, 'ram': 28672, 'id': '6', 'name': 'Memory Intensive Instance Medium'}}¶ Core Functions
-
PROVISIONING_STATE
= {'AVAILABLE': 'running', 'DELETED': 'terminated', 'INACTIVE': 'pending', 'INPROCESS': 'pending'}¶
-
REGIONS
= {'1': {'country': 'USA', 'region': 'us/las'}, '3': {'country': 'DEU', 'region': 'de/fkb'}, '2': {'country': 'DEU', 'region': 'de/fra'}}¶
-
attach_volume
(node, volume, device=None, ex_bus_type=None)[source]¶ Attaches a volume.
Parameters: - volume (
StorageVolume
) – The volume you’re attaching. - node (
Node
) – The node to which you’re attaching the volume. - device (:
int
) – The device number order. - ex_bus_type (
str
) – Bus type. Either IDE or VIRTIO (default).
Returns: Instance of class
StorageVolume
Return type: StorageVolume
- volume (
-
connectionCls
¶ alias of
ProfitBricksConnection
-
create_node
(name, image, size=None, location=None, volume=None, ex_datacenter=None, ex_internet_access=True, ex_availability_zone=None, ex_ram=None, ex_cores=None, ex_disk=None, **kwargs)[source]¶ Creates a node.
image is optional as long as you pass ram, cores, and disk to the method. ProfitBricks allows you to adjust compute resources at a much more granular level.
Parameters: - volume (
StorageVolume
) – If the volume already exists then pass this in. - location (:
NodeLocation
) – The location of the new data center if one is not supplied. - ex_datacenter (
Datacenter
) – If you’ve already created the DC then pass it in. - ex_internet_access (:
bool
) – Configure public Internet access. - ex_availability_zone (class: ProfitBricksAvailabilityZone) – The availability zone.
- ex_ram (:
int
) – The amount of ram required. - ex_cores (:
int
) – The number of cores required. - ex_disk (:
int
) – The amount of disk required.
Returns: Instance of class
Node
Return type: Node
- volume (
-
create_volume
(size, name=None, ex_datacenter=None, ex_image=None, ex_password=None)[source]¶ Creates a volume.
Parameters: - ex_datacenter (
Datacenter
) – The datacenter you’re placing the storage in. (req) - ex_image (
NodeImage
) – The OS image for the volume. - ex_password (:
str
) – Optional password for root.
Returns: Instance of class
StorageVolume
Return type: StorageVolume
- ex_datacenter (
-
destroy_node
(node, ex_remove_attached_disks=False)[source]¶ Destroys a node.
Parameters: - node – The node you wish to destroy.
- ex_remove_attached_disks (:
bool
) – True to destroy all attached volumes.
Return type: :
bool
-
destroy_volume
(volume)[source]¶ Destroys a volume.
Parameters: volume ( StorageVolume
) – The volume you’re attaching.Return type: : bool
-
detach_volume
(volume)[source]¶ Detaches a volume.
Parameters: volume ( StorageVolume
) – The volume you’re detaching.Return type: : bool
-
ex_clear_datacenter
(datacenter)[source]¶ Clear a datacenter.
This removes all objects in a DC.
Parameters: datacenter ( Datacenter
) – The DC you’re clearing.Return type: : bool
-
ex_create_datacenter
(name, location)[source]¶ Creates a datacenter.
ProfitBricks has a concept of datacenters. These represent buckets into which you can place various compute resources.
Parameters: - name (:
str
) – The DC name. - location (:
str
) – The DC region.
Returns: Instance of class
Datacenter
Return type: - name (:
-
ex_create_network_interface
(node, lan_id=None, ip=None, nic_name=None, dhcp_active=True)[source]¶ Creates a network interface.
Parameters: - lan_id (:
int
) – The ID for the LAN. - ip (
str
) – The IP address for the NIC. - nic_name (
str
) – The name of the NIC, e.g. PUBLIC. - dhcp_active (
bool
) – Set to false to disable.
Returns: Instance of class
ProfitBricksNetworkInterface
Return type: - lan_id (:
-
ex_describe_datacenter
(datacenter_id)[source]¶ Describes a datacenter.
Parameters: datacenter_id ( str
) – The DC you are describing.Returns: Instance of class Datacenter
Return type: Datacenter
-
ex_describe_network_interface
(network_interface)[source]¶ Describes a network interface.
Parameters: network_interface ( ProfitBricksNetworkInterface
) – The NIC you wish to describe.Returns: Instance of class ProfitBricksNetworkInterface
Return type: ProfitBricksNetworkInterface
-
ex_describe_node
(node)[source]¶ Describes a node.
Parameters: node ( Node
) – The node you wish to describe.Returns: Instance of class Node
Return type: Node
-
ex_describe_volume
(volume_id)[source]¶ Describes a volume.
Parameters: volume_id ( StorageVolume
) – The ID of the volume you’re describing.Returns: Instance of class StorageVolume
Return type: StorageVolume
-
ex_destroy_datacenter
(datacenter)[source]¶ Destroys a datacenter.
Parameters: datacenter ( Datacenter
) – The DC you’re destroying.Return type: : bool
-
ex_destroy_network_interface
(network_interface)[source]¶ Destroy a network interface.
Parameters: network_interface ( ProfitBricksNetworkInterface
) – The NIC you wish to describe.Return type: : bool
-
ex_list_datacenters
()[source]¶ Lists all datacenters.
Returns: list
of classDatacenter
Return type: Datacenter
-
ex_list_network_interfaces
()[source]¶ Lists all network interfaces.
Returns: list
of classProfitBricksNetworkInterface
Return type: ProfitBricksNetworkInterface
-
ex_rename_datacenter
(datacenter, name)[source]¶ Update a datacenter.
Parameters: - datacenter (
Datacenter
) – The DC you are renaming. - name (:
str
) – The DC name.
Return type: :
bool
- datacenter (
-
ex_start_node
(node)[source]¶ Starts a volume.
Parameters: node ( Node
) – The node you wish to start.Return type: : bool
-
ex_stop_node
(node)[source]¶ Stops a node.
This also deallocates the public IP space.
Parameters: node ( Node
) – The node you wish to halt.Return type: : bool
-
ex_update_network_interface
(network_interface, name=None, lan_id=None, ip=None, dhcp_active=None)[source]¶ Updates a network interface.
Parameters: - lan_id (:
int
) – The ID for the LAN. - ip (
str
) – The IP address for the NIC. - name (
str
) – The name of the NIC, e.g. PUBLIC. - dhcp_active (
bool
) – Set to false to disable.
Return type: :
bool
- lan_id (:
-
ex_update_node
(node, name=None, cores=None, ram=None, availability_zone=None)[source]¶ Updates a node.
Parameters: - cores – The number of CPUs the node should have.
- ram (:
int
) – The amount of ram the machine should have. - ex_availability_zone (
ProfitBricksAvailabilityZone
) – Update the availability zone.
Return type: :
bool
-
ex_update_volume
(volume, storage_name=None, size=None)[source]¶ Updates a volume.
Parameters: - volume (
StorageVolume
) – The volume you’re attaching.. - storage_name (:
str
) – The name of the volume. - size (
int
) – The desired size.
Return type: :
bool
- volume (
-
name
= 'ProfitBricks'¶
-
type
= 'profitbricks'¶
-
website
= 'http://www.profitbricks.com'¶
- key (
-
class
libcloud.compute.drivers.profitbricks.
Datacenter
(id, name, version, driver, extra=None)[source]¶ Bases:
libcloud.compute.base.UuidMixin
Class which stores information about ProfitBricks datacenter instances.
Parameters: - id (
str
) – The datacenter ID. - name (
str
) – The datacenter name. - version (
str
) – Datacenter version.
Note: This class is ProfitBricks specific.
- id (
-
class
libcloud.compute.drivers.profitbricks.
ProfitBricksNetworkInterface
(id, name, state, extra=None)[source]¶ Bases:
object
Class which stores information about ProfitBricks network interfaces.
Parameters: - id (
str
) – The network interface ID. - name (
str
) – The network interface name. - state (
int
) – The network interface name.
Note: This class is ProfitBricks specific.
- id (
libcloud.compute.drivers.rackspace module¶
Rackspace driver
-
class
libcloud.compute.drivers.rackspace.
RackspaceConnection
(*args, **kwargs)[source]¶ Bases:
libcloud.compute.drivers.openstack.OpenStack_1_1_Connection
Connection class for the Rackspace next-gen OpenStack base driver.
-
auth_url
= 'https://identity.api.rackspacecloud.com'¶
-
-
class
libcloud.compute.drivers.rackspace.
RackspaceFirstGenConnection
(*args, **kwargs)[source]¶ Bases:
libcloud.compute.drivers.openstack.OpenStack_1_0_Connection
Connection class for the Rackspace first-gen driver.
-
XML_NAMESPACE
= 'http://docs.rackspacecloud.com/servers/api/v1.0'¶
-
auth_url
= 'https://identity.api.rackspacecloud.com'¶
-
cache_busting
= True¶
-
responseCls
¶ alias of
OpenStack_1_0_Response
-
-
class
libcloud.compute.drivers.rackspace.
RackspaceFirstGenNodeDriver
(key, secret=None, secure=True, host=None, port=None, region='us', **kwargs)[source]¶ Bases:
libcloud.compute.drivers.openstack.OpenStack_1_0_NodeDriver
@inherits:
NodeDriver.__init__
Parameters: region ( str
) – Region ID which should be used-
api_name
= 'rackspace'¶
-
connectionCls
¶ alias of
RackspaceFirstGenConnection
-
list_locations
()[source]¶ Lists available locations
Locations cannot be set or retrieved via the API, but currently there are two locations, DFW and ORD.
@inherits:
OpenStack_1_0_NodeDriver.list_locations
-
name
= 'Rackspace Cloud (First Gen)'¶
-
type
= 'rackspace_first_gen'¶
-
website
= 'http://www.rackspace.com'¶
-
-
class
libcloud.compute.drivers.rackspace.
RackspaceNodeDriver
(key, secret=None, secure=True, host=None, port=None, region='dfw', **kwargs)[source]¶ Bases:
libcloud.compute.drivers.openstack.OpenStack_1_1_NodeDriver
@inherits:
NodeDriver.__init__
Parameters: region ( str
) – ID of the region which should be used.-
connectionCls
¶ alias of
RackspaceConnection
-
name
= 'Rackspace Cloud (Next Gen)'¶
-
type
= 'rackspace'¶
-
website
= 'http://www.rackspace.com'¶
-
libcloud.compute.drivers.rimuhosting module¶
RimuHosting Driver
-
class
libcloud.compute.drivers.rimuhosting.
RimuHostingConnection
(key, secure=True, retry_delay=None, backoff=None, timeout=None)[source]¶ Bases:
libcloud.common.base.ConnectionKey
Connection class for the RimuHosting driver
-
api_context
= '/r'¶
-
host
= 'rimuhosting.com'¶
-
port
= 443¶
-
responseCls
¶ alias of
RimuHostingResponse
-
-
exception
libcloud.compute.drivers.rimuhosting.
RimuHostingException
[source]¶ Bases:
exceptions.Exception
Exception class for RimuHosting driver
-
class
libcloud.compute.drivers.rimuhosting.
RimuHostingNodeDriver
(key, host='rimuhosting.com', port=443, api_context='/r', secure=True)[source]¶ Bases:
libcloud.compute.base.NodeDriver
RimuHosting node driver
Parameters: - key (
str
) – API key (required) - host (
str
) – hostname for connection - port (
int
) – Override port used for connections. - api_context (
str
) – Optional API context. - secure (
bool
) – Whether to use HTTPS or HTTP.
Return type: None
-
connectionCls
¶ alias of
RimuHostingConnection
-
create_node
(**kwargs)[source]¶ Creates a RimuHosting instance
@inherits:
NodeDriver.create_node
Parameters: - name (
str
) – Must be a FQDN. e.g example.com. - ex_billing_oid (
str
) – If not set, a billing method is automatically picked. - ex_host_server_oid (
str
) – The host server to set the VPS up on. - ex_vps_order_oid_to_clone (
str
) – Clone another VPS to use as the image for the new VPS. - ex_num_ips (
int
) – Number of IPs to allocate. Defaults to 1. - ex_extra_ip_reason (
str
) – Reason for needing the extra IPs. - ex_memory_mb (
int
) – Memory to allocate to the VPS. - ex_disk_space_mb (
int
) – Diskspace to allocate to the VPS. Defaults to 4096 (4GB). - ex_disk_space_2_mb (
int
) – Secondary disk size allocation. Disabled by default. - ex_control_panel (
str
) – Control panel to install on the VPS.
- name (
-
features
= {'create_node': ['password']}¶
-
name
= 'RimuHosting'¶
-
type
= 'rimuhosting'¶
-
website
= 'http://rimuhosting.com/'¶
- key (
-
class
libcloud.compute.drivers.rimuhosting.
RimuHostingResponse
(response, connection)[source]¶ Bases:
libcloud.common.base.JsonResponse
Response Class for RimuHosting driver
Parameters: - response (
httplib.HTTPResponse
) – HTTP response object. (optional) - connection (
Connection
) – Parent connection object.
- response (
libcloud.compute.drivers.runabove module¶
RunAbove driver
-
class
libcloud.compute.drivers.runabove.
RunAboveNodeDriver
(key, secret, ex_consumer_key=None)[source]¶ Bases:
libcloud.compute.base.NodeDriver
Libcloud driver for the RunAbove API
For more information on the RunAbove API, read the official reference:
Instantiate the driver with the given API credentials.
Parameters: - key (
str
) – Your application key (required) - secret (
str
) – Your application secret (required) - ex_consumer_key (
str
) – Your consumer key (required)
Return type: None
-
NODE_STATE_MAP
= {'RESCUE': 'pending', 'DELETE_IP': 'pending', 'PREP_RESIZE': 'pending', 'DELETED': 'terminated', 'UNKNOWN': 'unknown', 'REBUILD': 'pending', 'ERROR': 'error', 'REBOOT': 'rebooting', 'SHUTOFF': 'stopped', 'VERIFY_RESIZE': 'running', 'QUEUE_RESIZE': 'pending', 'BUILD': 'pending', 'SUSPENDED': 'stopped', 'SHARE_IP': 'pending', 'ACTIVE': 'running', 'SHARE_IP_NO_CONFIG': 'pending', 'PASSWORD': 'pending', 'HARD_REBOOT': 'rebooting'}¶
-
VOLUME_STATE_MAP
= {'available': 'available', 'restoring-backup': 'backup', 'creating': 'creating', 'in-use': 'inuse', 'error_extending': 'error', 'backing-up': 'backup', 'error_deleting': 'error', 'attaching': 'attaching', 'error': 'error', 'error_restoring': 'error', 'deleting': 'deleting'}¶
-
api_name
= 'runabove'¶
-
attach_volume
(node, volume, device=None)[source]¶ Attach a volume to a node.
Parameters: - node (
Node
) – Node where to attach volume - volume (
StorageVolume
) – The ID of the volume - device – Unsed parameter
Returns: True or False representing operation successful
Return type: bool
- node (
-
connectionCls
¶ alias of
RunAboveConnection
-
create_node
(name, image, size, location, ex_keyname=None)[source]¶ Create a new node
Parameters: - name (
str
) – Name of created node - image (
NodeImage
) – Image used for node - size (
NodeSize
) – Size (flavor) used for node - location (
NodeLocation
) – Location (region) where to create node - ex_keyname (
str
) – Name of SSH key used
Returns: Created node
:rtype :
Node
- name (
-
create_volume
(size, location, name=None, ex_volume_type='classic', ex_description=None)[source]¶ Create a volume.
Parameters: - size (
int
) – Size of volume to create (in GB). - name (
str
) – Name of volume to create - location (
NodeLocation
orNone
) – Location to create the volume in - ex_volume_type (
str
) –'classic'
or'high-speed'
- ex_description (str) – Optionnal description of volume
Returns: Storage Volume object
Return type: StorageVolume
- size (
-
delete_key_pair
(name, location)[source]¶ Delete an existing key pair.
Parameters: - name (
str
) – Key pair name. - location (
NodeLocation
) – Key’s region
Returns: True of False based on success of Keypair deletion
Return type: bool
- name (
-
detach_volume
(volume, ex_node=None)[source]¶ Detach a volume to a node.
Parameters: - volume (
StorageVolume
) – The ID of the volume - ex_node (
Node
) – Node to detach from (optionnal if volume is attached to only one node)
Returns: True or False representing operation successful
Return type: bool
Raises: Exception: If
ex_node
is not provided and more than one node is attached to the volume- volume (
-
ex_get_node
(node_id)[source]¶ Get a individual node.
Parameters: node_id ( str
) – Node’s IDReturns: Created node :rtype :
Node
-
ex_get_size
(size_id)[source]¶ Get an individual size (flavor).
Parameters: size_id ( str
) – Size’s IDReturns: Size Return type: NodeSize
-
ex_get_volume
(volume_id)[source]¶ Return a Volume object based on a volume ID.
Parameters: volume_id ( int
) – The ID of the volumeReturns: A StorageVolume object for the volume Return type: StorageVolume
-
features
= {'create_node': ['ssh_key']}¶
-
get_key_pair
(name, location)[source]¶ Get an individual SSH public key by its name and location.
Parameters: - name (str) – SSH key name
- location (
NodeLocation
) – Key’s region
Returns: Public key
Return type: KeyPair
-
import_key_pair_from_string
(name, key_material, location)[source]¶ Import a new public key from string.
Parameters: - name (
str
) – Key pair name. - key_material (
str
) – Public key material.
Returns: Imported key pair object.
Return type: KeyPair
- name (
-
list_images
(location=None, ex_size=None)[source]¶ List available images
Parameters: - location (
NodeLocation
) – Location (region) used as filter - ex_size (
NodeImage
) – Exclude images which are uncompatible with given size
Returns: List of images
:rtype :
list
ofNodeImage
- location (
-
list_key_pairs
(location=None)[source]¶ List available SSH public keys.
Parameters: location ( NodeLocation
) – Location (region) used as filterReturns: Public keys Return type: ``list``of KeyPair
-
list_nodes
(location=None)[source]¶ List all nodes.
Parameters: location ( NodeLocation
) – Location (region) used as filterReturns: List of node objects Return type: list
ofNode
-
list_volumes
(location=None)[source]¶ Return a list of volumes.
Parameters: location ( NodeLocation
orNone
) – Location use for filterReturns: A list of volume objects. Return type: list
ofStorageVolume
-
name
= 'RunAbove'¶
-
type
= 'runabove'¶
-
website
= 'https://www.runabove.com/'¶
- key (
libcloud.compute.drivers.serverlove module¶
ServerLove Driver
-
class
libcloud.compute.drivers.serverlove.
ServerLoveConnection
(user_id, key, secure=True, host=None, port=None, url=None, timeout=None, proxy_url=None, backoff=None, retry_delay=None)[source]¶ Bases:
libcloud.compute.drivers.elasticstack.ElasticStackBaseConnection
-
host
= 'api.z1-man.serverlove.com'¶
-
-
class
libcloud.compute.drivers.serverlove.
ServerLoveNodeDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region=None, **kwargs)[source]¶ Bases:
libcloud.compute.drivers.elasticstack.ElasticStackBaseNodeDriver
Parameters: - key (
str
) – API key or username to be used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections. - api_version (
str
) – Optional API version. Only used by drivers which support multiple API versions. - region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
Return type: None
-
api_name
= 'serverlove'¶
-
connectionCls
¶ alias of
ServerLoveConnection
-
features
= {'create_node': ['generates_password']}¶
-
name
= 'ServerLove'¶
-
type
= 'serverlove'¶
-
website
= 'http://www.serverlove.com/'¶
- key (
libcloud.compute.drivers.skalicloud module¶
skalicloud Driver
-
class
libcloud.compute.drivers.skalicloud.
SkaliCloudConnection
(user_id, key, secure=True, host=None, port=None, url=None, timeout=None, proxy_url=None, backoff=None, retry_delay=None)[source]¶ Bases:
libcloud.compute.drivers.elasticstack.ElasticStackBaseConnection
-
host
= 'api.sdg-my.skalicloud.com'¶
-
-
class
libcloud.compute.drivers.skalicloud.
SkaliCloudNodeDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region=None, **kwargs)[source]¶ Bases:
libcloud.compute.drivers.elasticstack.ElasticStackBaseNodeDriver
Parameters: - key (
str
) – API key or username to be used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections. - api_version (
str
) – Optional API version. Only used by drivers which support multiple API versions. - region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
Return type: None
-
api_name
= 'skalicloud'¶
-
connectionCls
¶ alias of
SkaliCloudConnection
-
features
= {'create_node': ['generates_password']}¶
-
name
= 'skalicloud'¶
-
type
= 'skalicloud'¶
-
website
= 'http://www.skalicloud.com/'¶
- key (
libcloud.compute.drivers.softlayer module¶
Softlayer driver
-
class
libcloud.compute.drivers.softlayer.
SoftLayerNodeDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region=None, **kwargs)[source]¶ Bases:
libcloud.compute.base.NodeDriver
SoftLayer node driver
- Extra node attributes:
- password: root password
- hourlyRecurringFee: hourly price (if applicable)
- recurringFee : flat rate (if applicable)
- recurringMonths : The number of months in which the recurringFee
will be incurred.
Parameters: - key (
str
) – API key or username to be used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections. - api_version (
str
) – Optional API version. Only used by drivers which support multiple API versions. - region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
Return type: None
-
api_name
= 'softlayer'¶
-
connectionCls
¶ alias of
SoftLayerConnection
-
create_node
(**kwargs)[source]¶ Create a new SoftLayer node
@inherits:
NodeDriver.create_node
Parameters: - ex_domain (
str
) – e.g. libcloud.org - ex_cpus (
int
) – e.g. 2 - ex_disk (
int
) – e.g. 100 - ex_ram (
int
) – e.g. 2048 - ex_bandwidth (
int
) – e.g. 100 - ex_local_disk (
bool
) – e.g. True - ex_datacenter (
str
) – e.g. Dal05 - ex_os (
str
) – e.g. UBUNTU_LATEST - ex_keyname (
str
) – The name of the key pair
- ex_domain (
-
features
= {'create_node': ['generates_password', 'ssh_key']}¶
-
name
= 'SoftLayer'¶
-
type
= 'softlayer'¶
-
website
= 'http://www.softlayer.com/'¶
libcloud.compute.drivers.vcl module¶
VCL driver
-
class
libcloud.compute.drivers.vcl.
VCLConnection
(user_id, key, secure=True, host=None, port=None, url=None, timeout=None, proxy_url=None, backoff=None, retry_delay=None)[source]¶ Bases:
libcloud.common.xmlrpc.XMLRPCConnection
,libcloud.common.base.ConnectionUserAndKey
-
endpoint
= '/index.php?mode=xmlrpccall'¶
-
-
class
libcloud.compute.drivers.vcl.
VCLNodeDriver
(key, secret, secure=True, host=None, port=None, *args, **kwargs)[source]¶ Bases:
libcloud.compute.base.NodeDriver
VCL node driver
Parameters: - host (
str
) – The VCL host to which you make requests(required) - key (
str
) – API key or username to used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. - host – Override hostname used for connections. (required)
- port (
int
) – Override port used for connections.
Return type: None
-
NODE_STATE_MAP
= {'notready': 'pending', 'failed': 'terminated', 'loading': 'pending', 'error': 'unknown', 'success': 'pending', 'time': 'pending', 'ready': 'running', 'future': 'pending', 'timedout': 'terminated', 'notavailable': 'terminated'}¶
-
connectionCls
¶ alias of
VCLConnection
-
create_node
(**kwargs)[source]¶ Create a new VCL reservation size and name ignored, image is the id from list_image
@inherits:
NodeDriver.create_node
Parameters: - image (
str
) – image is the id from list_image - start (
str
) – start time as unix timestamp - length (
str
) – length of time in minutes
- image (
-
destroy_node
(node)[source]¶ End VCL reservation for the node passed in. Throws error if request fails.
Parameters: node ( Node
) – The node to be destroyedReturn type: bool
-
ex_extend_request_time
(node, minutes)[source]¶ Time in minutes to extend the requested node’s reservation time
Parameters: - node (
Node
) – the reservation node to update - minutes (
str
) – the number of mintes to update
Returns: true on success, throws error on failure
Return type: bool
- node (
-
ex_get_request_end_time
(node)[source]¶ Get the ending time of the node reservation.
Parameters: node ( Node
) – the reservation node to updateReturns: unix timestamp Return type: int
-
ex_update_node_access
(node, ipaddr)[source]¶ Update the remote ip accessing the node.
Parameters: - node (
Node
) – the reservation node to update - ipaddr (
str
) – the ipaddr used to access the node
Returns: node with updated information
Return type: Node
- node (
-
list_images
(location=None)[source]¶ List images available to the user provided credentials
@inherits:
NodeDriver.list_images
-
list_nodes
(ipaddr)[source]¶ List nodes
Parameters: ipaddr ( str
) – IP address which should be usedReturn type: list
ofNode
-
list_sizes
(location=None)[source]¶ VCL does not choosing sizes for node creation. Size of images are statically set by administrators.
@inherits:
NodeDriver.list_sizes
-
name
= 'VCL'¶
-
type
= 'vcl'¶
-
website
= 'http://incubator.apache.org/vcl/'¶
- host (
-
class
libcloud.compute.drivers.vcl.
VCLResponse
(response, connection)[source]¶ Bases:
libcloud.common.xmlrpc.XMLRPCResponse
Parameters: - response (
httplib.HTTPResponse
) – HTTP response object. (optional) - connection (
Connection
) – Parent connection object.
-
exceptions
= {'VCL_Account': <class 'libcloud.common.types.InvalidCredsError'>}¶
- response (
libcloud.compute.drivers.vcloud module¶
VMware vCloud driver.
-
class
libcloud.compute.drivers.vcloud.
Capacity
(limit, used, units)[source]¶ Bases:
object
Represents CPU, Memory or Storage capacity of vDC.
-
class
libcloud.compute.drivers.vcloud.
ControlAccess
(node, everyone_access_level, subjects=None)[source]¶ Bases:
object
Represents control access settings of a node
-
libcloud.compute.drivers.vcloud.
DEFAULT_API_VERSION
= '0.8'¶ Valid vCloud API v1.5 input values.
-
class
libcloud.compute.drivers.vcloud.
HostingComConnection
(user_id, key, secure=True, host=None, port=None, url=None, timeout=None, proxy_url=None, backoff=None, retry_delay=None)[source]¶ Bases:
libcloud.compute.drivers.vcloud.VCloudConnection
vCloud connection subclass for Hosting.com
-
host
= 'vcloud.safesecureweb.com'¶
-
-
class
libcloud.compute.drivers.vcloud.
HostingComDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region=None, **kwargs)[source]¶ Bases:
libcloud.compute.drivers.vcloud.VCloudNodeDriver
vCloud node driver for Hosting.com
Parameters: - key (
str
) – API key or username to be used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections. - api_version (
str
) – Optional API version. Only used by drivers which support multiple API versions. - region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
Return type: None
-
connectionCls
¶ alias of
HostingComConnection
- key (
-
class
libcloud.compute.drivers.vcloud.
InstantiateVAppXML
(name, template, net_href, cpus, memory, password=None, row=None, group=None)[source]¶ Bases:
object
-
class
libcloud.compute.drivers.vcloud.
Instantiate_1_5_VAppXML
(name, template, network, vm_network=None, vm_fence=None)[source]¶ Bases:
object
-
class
libcloud.compute.drivers.vcloud.
Subject
(type, name, access_level, id=None)[source]¶ Bases:
object
User or group subject
-
class
libcloud.compute.drivers.vcloud.
TerremarkConnection
(user_id, key, secure=True, host=None, port=None, url=None, timeout=None, proxy_url=None, backoff=None, retry_delay=None)[source]¶ Bases:
libcloud.compute.drivers.vcloud.VCloudConnection
vCloud connection subclass for Terremark
-
host
= 'services.vcloudexpress.terremark.com'¶
-
-
class
libcloud.compute.drivers.vcloud.
TerremarkDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region=None, **kwargs)[source]¶ Bases:
libcloud.compute.drivers.vcloud.VCloudNodeDriver
vCloud node driver for Terremark
Parameters: - key (
str
) – API key or username to be used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections. - api_version (
str
) – Optional API version. Only used by drivers which support multiple API versions. - region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
Return type: None
-
connectionCls
¶ alias of
TerremarkConnection
- key (
-
class
libcloud.compute.drivers.vcloud.
VCloudConnection
(user_id, key, secure=True, host=None, port=None, url=None, timeout=None, proxy_url=None, backoff=None, retry_delay=None)[source]¶ Bases:
libcloud.common.base.ConnectionUserAndKey
Connection class for the vCloud driver
-
host
= None¶
-
responseCls
¶ alias of
VCloudResponse
-
token
= None¶
-
-
class
libcloud.compute.drivers.vcloud.
VCloudNodeDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region=None, **kwargs)[source]¶ Bases:
libcloud.compute.base.NodeDriver
vCloud node driver
Parameters: - key (
str
) – API key or username to be used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections. - api_version (
str
) – Optional API version. Only used by drivers which support multiple API versions. - region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
Return type: None
-
NODE_STATE_MAP
= {'1': 'pending', '0': 'pending', '3': 'pending', '2': 'pending', '4': 'running'}¶
-
connectionCls
¶ alias of
VCloudConnection
-
create_node
(**kwargs)[source]¶ Creates and returns node.
Parameters: - ex_network (
str
) – link to a “Network” e.g.,https://services.vcloudexpress...
- ex_vdc (
str
) – Name of organisation’s virtual data center where vApp VMs will be deployed. - ex_cpus (
int
) – number of virtual cpus (limit depends on provider)
- ex_network (
-
ex_list_nodes
(vdcs=None)[source]¶ List all nodes across all vDCs. Using ‘vdcs’ you can specify which vDCs should be queried.
Parameters: vdcs ( Vdc
) – None, vDC or a list of vDCs to query. If None all vDCs will be queried.Return type: list
ofNode
-
features
= {'create_node': ['password']}¶
-
name
= 'vCloud'¶
-
networks
¶
-
org
= None¶
-
type
= 'vcloud'¶
-
website
= 'http://www.vmware.com/products/vcloud/'¶
- key (
-
class
libcloud.compute.drivers.vcloud.
VCloudResponse
(response, connection)[source]¶ Bases:
libcloud.common.base.XmlResponse
Parameters: - response (
httplib.HTTPResponse
) – HTTP response object. (optional) - connection (
Connection
) – Parent connection object.
- response (
-
class
libcloud.compute.drivers.vcloud.
VCloud_1_5_Connection
(user_id, key, secure=True, host=None, port=None, url=None, timeout=None, proxy_url=None, backoff=None, retry_delay=None)[source]¶
-
class
libcloud.compute.drivers.vcloud.
VCloud_1_5_NodeDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region=None, **kwargs)[source]¶ Bases:
libcloud.compute.drivers.vcloud.VCloudNodeDriver
Parameters: - key (
str
) – API key or username to be used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections. - api_version (
str
) – Optional API version. Only used by drivers which support multiple API versions. - region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
Return type: None
-
NODE_STATE_MAP
= {'8': 'stopped', '10': 'unknown', '1': 'pending', '0': 'pending', '3': 'pending', '2': 'pending', '-1': 'unknown', '4': 'running', '7': 'unknown', '6': 'unknown', '9': 'unknown', '5': 'running'}¶
-
connectionCls
¶ alias of
VCloud_1_5_Connection
-
create_node
(**kwargs)[source]¶ - Creates and returns node. If the source image is:
vApp template - a new vApp is instantiated from template
- existing vApp - a new vApp is cloned from the source vApp. Can
not clone more vApps is parallel otherwise resource busy error is raised.
@inherits:
NodeDriver.create_node
Parameters: - image (
NodeImage
orNode
) – OS Image to boot on node. (required). Can be a NodeImage or existing Node that will be cloned. - ex_network (
str
) – Organisation’s network name for attaching vApp VMs to. - ex_vdc (
str
) – Name of organisation’s virtual data center where vApp VMs will be deployed. - ex_vm_names (
list
ofstr
) – list of names to be used as a VM and computer name. The name must be max. 15 characters long and follow the host name requirements. - ex_vm_cpu (
int
) – number of virtual CPUs/cores to allocate for each vApp VM. - ex_vm_memory (
int
) – amount of memory in MB to allocate for each vApp VM. - ex_vm_script (
str
) – full path to file containing guest customisation script for each vApp VM. Useful for creating users & pushing out public SSH keys etc. - ex_vm_network (
str
) – Override default vApp VM network name. Useful for when you’ve imported an OVF originating from outside of the vCloud. - ex_vm_fence (
str
) – Fence mode for connecting the vApp VM network (ex_vm_network) to the parent organisation network (ex_network). - ex_vm_ipmode (
str
) – IP address allocation mode for all vApp VM network connections. - ex_deploy (
bool
) – set to False if the node shouldn’t be deployed (started) after creation - ex_force_customization (
bool
) – Used to specify whether to force customization on deployment, if not set default value is False. - ex_clone_timeout (
int
) – timeout in seconds for clone/instantiate VM operation. Cloning might be a time consuming operation especially when linked clones are disabled or VMs are created on different datastores. Overrides the default task completion value. - ex_admin_password (
str
) – set the node admin password explicitly.
-
ex_add_vm_disk
(vapp_or_vm_id, vm_disk_size)[source]¶ Adds a virtual disk to the specified VM or VMs under the vApp. If the vapp_or_vm_id param represents a link to an vApp all VMs that are attached to this vApp will be modified.
Parameters: - vapp_or_vm_id (
str
) – vApp or VM ID that will be modified. If a vApp ID is used here all attached VMs will be modified - vm_disk_size (
int
) – the disk capacity in GB that will be added to the specified VM or VMs
Return type: None
- vapp_or_vm_id (
-
ex_change_vm_admin_password
(vapp_or_vm_id, ex_admin_password)[source]¶ Changes the admin (or root) password of VM or VMs under the vApp. If the vapp_or_vm_id param represents a link to an vApp all VMs that are attached to this vApp will be modified.
Parameters: - vapp_or_vm_id (
str
) – vApp or VM ID that will be modified. If a vApp ID is used here all attached VMs will be modified - ex_admin_password (
str
) – admin password to be used.
Return type: None
- vapp_or_vm_id (
-
ex_deploy_node
(node, ex_force_customization=False)[source]¶ Deploys existing node. Equal to vApp “start” operation.
Parameters: - node (
Node
) – The node to be deployed - ex_force_customization (
bool
) – Used to specify whether to force customization on deployment, if not set default value is False.
Return type: Node
- node (
-
ex_find_node
(node_name, vdcs=None)[source]¶ Searches for node across specified vDCs. This is more effective than querying all nodes to get a single instance.
Parameters: - node_name (
str
) – The name of the node to search for - vdcs (
Vdc
) – None, vDC or a list of vDCs to search in. If None all vDCs will be searched.
Returns: node instance or None if not found
Return type: Node
orNone
- node_name (
-
ex_get_control_access
(node)[source]¶ Returns the control access settings for specified node.
Parameters: node ( Node
) – node to get the control access forReturn type: ControlAccess
-
ex_get_metadata
(node)[source]¶ Parameters: node ( Node
) – nodeReturns: dictionary mapping metadata keys to metadata values Return type: dictionary mapping str
tostr
-
ex_power_off_node
(node)[source]¶ Powers on all VMs under specified node. VMs need to be This operation is allowed only when the vApp/VM is powered on.
Parameters: node ( Node
) – The node to be powered offReturn type: Node
-
ex_power_on_node
(node)[source]¶ Powers on all VMs under specified node. This operation is allowed only when the vApp/VM is powered off or suspended.
Parameters: node ( Node
) – The node to be powered onReturn type: Node
-
ex_query
(type, filter=None, page=1, page_size=100, sort_asc=None, sort_desc=None)[source]¶ Queries vCloud for specified type. See http://www.vmware.com/pdf/vcd_15_api_guide.pdf for details. Each element of the returned list is a dictionary with all attributes from the record.
Parameters: - type (
str
) – type to query (r.g. user, group, vApp etc.) - filter (
str
) – filter expression (see documentation for syntax) - page (
int
) – page number - page_size (
int
) – page size - sort_asc (
str
) – sort in ascending order by specified field - sort_desc (
str
) – sort in descending order by specified field
Return type: list
of dict- type (
-
ex_set_control_access
(node, control_access)[source]¶ Sets control access for the specified node.
Parameters: - node (
Node
) – node - control_access (
ControlAccess
) – control access settings
Return type: None
- node (
-
ex_set_metadata_entry
(node, key, value)[source]¶ Parameters: - node (
Node
) – node - key (
str
) – metadata key to be set - value (
str
) – metadata value to be set
Return type: None
- node (
-
ex_set_vm_cpu
(vapp_or_vm_id, vm_cpu)[source]¶ Sets the number of virtual CPUs for the specified VM or VMs under the vApp. If the vapp_or_vm_id param represents a link to an vApp all VMs that are attached to this vApp will be modified.
Please ensure that hot-adding a virtual CPU is enabled for the powered on virtual machines. Otherwise use this method on undeployed vApp.
Parameters: - vapp_or_vm_id (
str
) – vApp or VM ID that will be modified. If a vApp ID is used here all attached VMs will be modified - vm_cpu (
int
) – number of virtual CPUs/cores to allocate for specified VMs
Return type: None
- vapp_or_vm_id (
-
ex_set_vm_memory
(vapp_or_vm_id, vm_memory)[source]¶ Sets the virtual memory in MB to allocate for the specified VM or VMs under the vApp. If the vapp_or_vm_id param represents a link to an vApp all VMs that are attached to this vApp will be modified.
Please ensure that hot-change of virtual memory is enabled for the powered on virtual machines. Otherwise use this method on undeployed vApp.
Parameters: - vapp_or_vm_id (
str
) – vApp or VM ID that will be modified. If a vApp ID is used here all attached VMs will be modified - vm_memory (
int
) – virtual memory in MB to allocate for the specified VM or VMs
Return type: None
- vapp_or_vm_id (
-
ex_shutdown_node
(node)[source]¶ Shutdowns all VMs under specified node. This operation is allowed only when the vApp/VM is powered on.
Parameters: node ( Node
) – The node to be shut downReturn type: Node
-
ex_suspend_node
(node)[source]¶ Suspends all VMs under specified node. This operation is allowed only when the vApp/VM is powered on.
Parameters: node ( Node
) – The node to be suspendedReturn type: Node
- key (
-
class
libcloud.compute.drivers.vcloud.
VCloud_5_1_NodeDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region=None, **kwargs)[source]¶ Bases:
libcloud.compute.drivers.vcloud.VCloud_1_5_NodeDriver
Parameters: - key (
str
) – API key or username to be used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections. - api_version (
str
) – Optional API version. Only used by drivers which support multiple API versions. - region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
Return type: None
- key (
-
class
libcloud.compute.drivers.vcloud.
VCloud_5_5_Connection
(user_id, key, secure=True, host=None, port=None, url=None, timeout=None, proxy_url=None, backoff=None, retry_delay=None)[source]¶ Bases:
libcloud.compute.drivers.vcloud.VCloud_1_5_Connection
-
class
libcloud.compute.drivers.vcloud.
VCloud_5_5_NodeDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region=None, **kwargs)[source]¶ Bases:
libcloud.compute.drivers.vcloud.VCloud_5_1_NodeDriver
Use 5.5 Connection class to explicitly set 5.5 for the version in Accept headers
Parameters: - key (
str
) – API key or username to be used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections. - api_version (
str
) – Optional API version. Only used by drivers which support multiple API versions. - region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
Return type: None
-
connectionCls
¶ alias of
VCloud_5_5_Connection
-
ex_acquire_mks_ticket
(vapp_or_vm_id, vm_num=0)[source]¶ Retrieve a mks ticket that you can use to gain access to the console of a running VM. If successful, returns a dict with the following keys:
- host: host (or proxy) through which the console connection
is made
- vmx: a reference to the VMX file of the VM for which this
ticket was issued
ticket: screen ticket to use to authenticate the client
port: host port to be used for console access
Parameters: - vapp_or_vm_id (
str
) – vApp or VM ID you want to connect to. - vm_num (
int
) – If a vApp ID is provided, vm_num is position in the vApp VM list of the VM you want to get a screen ticket. Default is 0.
Return type: dict
-
ex_create_snapshot
(node)[source]¶ Creates new snapshot of a virtual machine or of all the virtual machines in a vApp. Prior to creation of the new snapshots, any existing user created snapshots associated with the virtual machines are removed.
Parameters: node ( Node
) – nodeReturn type: Node
- key (
-
class
libcloud.compute.drivers.vcloud.
Vdc
(id, name, driver, allocation_model=None, cpu=None, memory=None, storage=None)[source]¶ Bases:
object
Virtual datacenter (vDC) representation
libcloud.compute.drivers.voxel module¶
Voxel VoxCloud driver
-
class
libcloud.compute.drivers.voxel.
VoxelConnection
(user_id, key, secure=True, host=None, port=None, url=None, timeout=None, proxy_url=None, backoff=None, retry_delay=None)[source]¶ Bases:
libcloud.common.base.ConnectionUserAndKey
Connection class for the Voxel driver
-
host
= 'api.voxel.net'¶
-
responseCls
¶ alias of
VoxelResponse
-
-
class
libcloud.compute.drivers.voxel.
VoxelNodeDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region=None, **kwargs)[source]¶ Bases:
libcloud.compute.base.NodeDriver
Voxel VoxCLOUD node driver
Parameters: - key (
str
) – API key or username to be used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections. - api_version (
str
) – Optional API version. Only used by drivers which support multiple API versions. - region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
Return type: None
-
connectionCls
¶ alias of
VoxelConnection
-
create_node
(**kwargs)[source]¶ Create Voxel Node
Parameters: - name (
str
) – the name to assign the node (mandatory) - image (
NodeImage
) – distribution to deploy - size (
NodeSize
) – the plan size to create (mandatory) Requires size.disk (GB) to be set manually - location (
NodeLocation
) – which datacenter to create the node in - ex_privateip (
str
) – Backend IP address to assign to node; must be chosen from the customer’s private VLAN assignment. - ex_publicip (
str
) – Public-facing IP address to assign to node; must be chosen from the customer’s public VLAN assignment. - ex_rootpass (
str
) – Password for root access; generated if unset. - ex_consolepass (
str
) – Password for remote console; generated if unset. - ex_sshuser (
str
) – Username for SSH access - ex_sshpass (
str
) – Password for SSH access; generated if unset. - ex_voxel_access (
bool
) – Allow access Voxel administrative access. Defaults to False.
Return type: Node
orNone
- name (
-
features
= {'create_node': [], 'list_sizes': ['variable_disk']}¶
-
name
= 'Voxel VoxCLOUD'¶
-
type
= 'voxel'¶
-
website
= 'http://www.voxel.net/'¶
- key (
libcloud.compute.drivers.vpsnet module¶
VPS.net driver
-
class
libcloud.compute.drivers.vpsnet.
VPSNetConnection
(user_id, key, secure=True, host=None, port=None, url=None, timeout=None, proxy_url=None, backoff=None, retry_delay=None)[source]¶ Bases:
libcloud.common.base.ConnectionUserAndKey
Connection class for the VPS.net driver
-
allow_insecure
= False¶
-
host
= 'api.vps.net'¶
-
responseCls
¶ alias of
VPSNetResponse
-
-
class
libcloud.compute.drivers.vpsnet.
VPSNetNodeDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region=None, **kwargs)[source]¶ Bases:
libcloud.compute.base.NodeDriver
VPS.net node driver
Parameters: - key (
str
) – API key or username to be used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections. - api_version (
str
) – Optional API version. Only used by drivers which support multiple API versions. - region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
Return type: None
-
api_name
= 'vps_net'¶
-
connectionCls
¶ alias of
VPSNetConnection
-
create_node
(name, image, size, **kwargs)[source]¶ Create a new VPS.net node
@inherits:
NodeDriver.create_node
Parameters: - ex_backups_enabled (
bool
) – Enable automatic backups - ex_fqdn (
str
) – Fully Qualified domain of the node
- ex_backups_enabled (
-
name
= 'vps.net'¶
-
type
= 'vpsnet'¶
-
website
= 'http://vps.net/'¶
- key (
-
class
libcloud.compute.drivers.vpsnet.
VPSNetResponse
(response, connection)[source]¶ Bases:
libcloud.common.base.JsonResponse
Parameters: - response (
httplib.HTTPResponse
) – HTTP response object. (optional) - connection (
Connection
) – Parent connection object.
- response (
libcloud.compute.drivers.vsphere module¶
libcloud.compute.drivers.vultr module¶
Vultr Driver
-
class
libcloud.compute.drivers.vultr.
VultrConnection
(key, secure=True, host=None, port=None, url=None, timeout=None, proxy_url=None, backoff=None, retry_delay=None)[source]¶ Bases:
libcloud.common.base.ConnectionKey
Connection class for the Vultr driver.
Initialize user_id and key; set secure to an
int
based on passed value.-
add_default_params
(params)[source]¶ Add parameters that are necessary for every request
This method add
api_key
to the request.
-
host
= 'api.vultr.com'¶
-
responseCls
¶ alias of
VultrResponse
-
-
class
libcloud.compute.drivers.vultr.
VultrNodeDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region=None, **kwargs)[source]¶ Bases:
libcloud.compute.base.NodeDriver
VultrNode node driver.
Parameters: - key (
str
) – API key or username to be used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections. - api_version (
str
) – Optional API version. Only used by drivers which support multiple API versions. - region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
Return type: None
-
NODE_STATE_MAP
= {'active': 'running', 'pending': 'pending'}¶
-
connectionCls
¶ alias of
VultrConnection
-
list_key_pairs
()[source]¶ List all the available SSH keys. :return: Available SSH keys. :rtype:
list
ofSSHKey
-
name
= 'Vultr'¶
-
type
= 'vultr'¶
-
website
= 'https://www.vultr.com'¶
- key (
-
class
libcloud.compute.drivers.vultr.
VultrResponse
(response, connection)[source]¶ Bases:
libcloud.common.base.JsonResponse
Parameters: - response (
httplib.HTTPResponse
) – HTTP response object. (optional) - connection (
Connection
) – Parent connection object.
- response (
Module contents¶
Drivers for working with different providers