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¶
- create_node(image, name=None, size=None, location=None, ex_group_name=None)[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)ex_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 destroyed- Returns
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
- 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 run- Returns
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 user- Return 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 rebooted- Returns
True if the reboot was successful, otherwise False
- Return type
bool
- timeout = 2000¶
- type = 'abiquo'¶
- website = 'http://www.abiquo.com/'¶
- 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.AuroraComputeNodeDriver(key, secret, path=None, host=None, url=None, region=None)[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.
- 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 = {'BusyRole': NodeState.PENDING, 'CreatingRole': NodeState.PENDING, 'CreatingVM': NodeState.PENDING, 'CyclingRole': NodeState.TERMINATED, 'DeletingVM': NodeState.PENDING, 'FailedStartingRole': NodeState.TERMINATED, 'FailedStartingVM': NodeState.TERMINATED, 'Provisioning': NodeState.PENDING, 'ReadyRole': NodeState.RUNNING, 'RestartingRole': NodeState.REBOOTING, 'RoleStateUnknown': NodeState.UNKNOWN, 'StartingRole': NodeState.PENDING, 'StartingVM': NodeState.PENDING, 'StoppedDeallocated': NodeState.TERMINATED, 'StoppedVM': NodeState.STOPPED, 'StoppingRole': NodeState.PENDING, 'StoppingVM': NodeState.PENDING, 'UnresponsiveRole': NodeState.TERMINATED}¶
- attach_volume()[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
- connectionCls¶
alias of
libcloud.common.azure.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
- create_volume()[source]¶
Create a new volume.
- Parameters
size (
int
) – Size of volume in gigabytes (required)name (
str
) – Name of the volume to be createdlocation (
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
- create_volume_snapshot()[source]¶
Creates a snapshot of the storage volume.
- Parameters
volume (
StorageVolume
) – The StorageVolume to create a VolumeSnapshot fromname (str) – Name of created snapshot (optional)
- Return type
VolumeSnapshot
- 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.
- destroy_volume()[source]¶
Destroys a storage volume.
- Parameters
volume (
StorageVolume
) – Volume to be destroyed- Return type
bool
- detach_volume()[source]¶
Detaches a volume from a node.
- Parameters
volume (
StorageVolume
) – Volume to be detached- Return type
bool
- 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 createlocation (
str
) – Standard azure location stringdescription (
str
) – Optional descriptionextended_properties (
dict
) – Optional extended_properties
- Return type
bool
- 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 createlocation (
str
) – Standard azure location stringdescription (
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
- 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 of available features for a driver.
libcloud.compute.base.NodeDriver.create_node()
ssh_key: Supports
NodeAuthSSHKey
as an authentication method for nodes.password: Supports
NodeAuthPassword
as an authentication method for nodes.generates_password: Returns a password attribute on the Node object returned from creation.
- 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 name- Return 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 nameex_deployment_slot (
str
) – Options are “production” (default) or “Staging”. (Optional)
- Return type
bool
- class service_location(is_affinity_group, service_location)¶
Bases:
tuple
Create new instance of service_location(is_affinity_group, service_location)
- property is_affinity_group¶
Alias for field number 0
- property service_location¶
Alias for field number 1
- type = 'azure'¶
- 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]¶
Bases:
libcloud.compute.base.NodeLocation
- Parameters
id (
str
) – Location ID.name (
str
) – Location name.country (
str
) – Location country.driver (
NodeDriver
) – Driver this location belongs to.extra (
dict
) – Optional provided specific attributes associated with this location.
- 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]¶
- 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
libcloud.compute.drivers.azure.ConfigurationSetInputEndpoint
- xml_element_name = 'InputEndpoint'¶
- class libcloud.compute.drivers.azure.ConfigurationSets[source]¶
Bases:
libcloud.compute.drivers.azure.WindowsAzureDataTypedList
- list_type¶
- class libcloud.compute.drivers.azure.Deployments[source]¶
Bases:
libcloud.compute.drivers.azure.WindowsAzureDataTypedList
- list_type¶
- class libcloud.compute.drivers.azure.Disks[source]¶
Bases:
libcloud.compute.drivers.azure.WindowsAzureDataTypedList
- list_type¶
alias of
libcloud.compute.drivers.azure.Disk
- 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¶
- class libcloud.compute.drivers.azure.Images[source]¶
Bases:
libcloud.compute.drivers.azure.WindowsAzureDataTypedList
- list_type¶
- class libcloud.compute.drivers.azure.InputEndpoints[source]¶
Bases:
libcloud.compute.drivers.azure.WindowsAzureDataTypedList
- list_type¶
- class libcloud.compute.drivers.azure.InstanceEndpoints[source]¶
Bases:
libcloud.compute.drivers.azure.WindowsAzureDataTypedList
- list_type¶
- class libcloud.compute.drivers.azure.KeyPairs[source]¶
Bases:
libcloud.compute.drivers.azure.WindowsAzureDataTypedList
- list_type¶
- 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
- list_type¶
- 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
libcloud.compute.drivers.azure.OperatingSystemFamily
- class libcloud.compute.drivers.azure.OperatingSystems[source]¶
Bases:
libcloud.compute.drivers.azure.WindowsAzureDataTypedList
- list_type¶
- class libcloud.compute.drivers.azure.PublicKeys[source]¶
Bases:
libcloud.compute.drivers.azure.WindowsAzureDataTypedList
- list_type¶
- class libcloud.compute.drivers.azure.RoleInstanceList[source]¶
Bases:
libcloud.compute.drivers.azure.WindowsAzureDataTypedList
- list_type¶
- class libcloud.compute.drivers.azure.RoleList[source]¶
Bases:
libcloud.compute.drivers.azure.WindowsAzureDataTypedList
- list_type¶
alias of
libcloud.compute.drivers.azure.Role
- 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¶
- class libcloud.compute.drivers.azure.SubscriptionCertificates[source]¶
Bases:
libcloud.compute.drivers.azure.WindowsAzureDataTypedList
- list_type¶
alias of
libcloud.compute.drivers.azure.SubscriptionCertificate
- class libcloud.compute.drivers.azure.VMImages[source]¶
Bases:
libcloud.compute.drivers.azure.WindowsAzureDataTypedList
- list_type¶
- class libcloud.compute.drivers.azure.VirtualIPs[source]¶
Bases:
libcloud.compute.drivers.azure.WindowsAzureDataTypedList
- list_type¶
- libcloud.compute.drivers.azure.WINDOWS_SERVER_REGEX = re.compile('Win|SQL|SharePoint|Visual|Dynamics|DynGP|BizTalk')¶
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.azure_arm module¶
Driver for Microsoft Azure Resource Manager (ARM) Virtual Machines provider.
http://azure.microsoft.com/en-us/services/virtual-machines/
- class libcloud.compute.drivers.azure_arm.AzureComputeGalleryImage(subscription_id, resource_group, gallery, name, driver)[source]¶
Bases:
libcloud.compute.base.NodeImage
Represents a Compute Gallery image that an Azure VM can boot from.
- Parameters
id (
str
) – Image ID.name (
str
) – Image name.driver (
NodeDriver
) – Driver this image belongs to.extra (
dict
) – Optional provided specific attributes associated with this image.
- class libcloud.compute.drivers.azure_arm.AzureIPAddress(id, name, extra)[source]¶
Bases:
object
Represents an Azure public IP address resource.
- class libcloud.compute.drivers.azure_arm.AzureImage(version, sku, offer, publisher, location, driver)[source]¶
Bases:
libcloud.compute.base.NodeImage
Represents a Marketplace node image that an Azure VM can boot from.
- Parameters
id (
str
) – Image ID.name (
str
) – Image name.driver (
NodeDriver
) – Driver this image belongs to.extra (
dict
) – Optional provided specific attributes associated with this image.
- class libcloud.compute.drivers.azure_arm.AzureNetwork(id, name, location, extra)[source]¶
Bases:
object
Represent an Azure virtual network.
- class libcloud.compute.drivers.azure_arm.AzureNetworkSecurityGroup(id, name, location, extra)[source]¶
Bases:
object
Represent an Azure network security group.
- class libcloud.compute.drivers.azure_arm.AzureNic(id, name, location, extra)[source]¶
Bases:
object
Represents an Azure virtual network interface controller (NIC).
- class libcloud.compute.drivers.azure_arm.AzureNodeDriver(tenant_id, subscription_id, key, secret, secure=True, host=None, port=None, api_version=None, region=None, **kwargs)[source]¶
Bases:
libcloud.compute.base.NodeDriver
Compute node driver for Azure Resource Manager.
- 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
- SNAPSHOT_STATE_MAP = {'creating': VolumeSnapshotState.CREATING, 'failed': VolumeSnapshotState.ERROR, 'succeeded': VolumeSnapshotState.AVAILABLE, 'updating': VolumeSnapshotState.UPDATING}¶
- attach_volume(node, volume, ex_lun=None, ex_vhd_uri=None, ex_vhd_create=False, **ex_kwargs)[source]¶
Attach a volume to node.
- Parameters
node (
Node
) – A node to attach volume.volume (
StorageVolume
) – A volume to attach.ex_lun (
int
) – Specifies the logical unit number (LUN) location for the data drive in the virtual machine. Each data disk must have a unique LUN.ex_vhd_uri (
str
) – Attach old-style unmanaged disk from VHD blob. (optional)ex_vhd_create (
bool
) – Create a new VHD blob for unmanaged disk. (optional)
- Return type
bool
- connectionCls¶
alias of
libcloud.common.azure_arm.AzureResourceManagementConnection
- create_node(name, size, image, auth, ex_resource_group, ex_storage_account=None, ex_blob_container='vhds', location=None, ex_user_name='azureuser', ex_network=None, ex_subnet=None, ex_nic=None, ex_tags={}, ex_customdata='', ex_use_managed_disks=False, ex_disk_size=None, ex_storage_account_type='Standard_LRS', ex_os_disk_delete=False)[source]¶
Create a new node instance. This instance will be started automatically.
This driver supports the
ssh_key
feature flag forcreated_node
so you can upload a public key into the new instance:>>> from libcloud.compute.drivers.azure_arm import AzureNodeDriver >>> driver = AzureNodeDriver(...) >>> auth = NodeAuthSSHKey('pubkey data here') >>> node = driver.create_node("test_node", auth=auth)
This driver also supports the
password
feature flag forcreate_node
so you can set a password:>>> driver = AzureNodeDriver(...) >>> auth = NodeAuthPassword('mysecretpassword') >>> node = driver.create_node("test_node", auth=auth, ...)
If you don’t provide the
auth
argument libcloud will assign a password:>>> driver = AzureNodeDriver(...) >>> node = driver.create_node("test_node", ...) >>> password = node.extra["properties"] ["osProfile"]["adminPassword"]
- Parameters
name (
str
) – String with a name for this new node (required)size (
NodeSize
) – The size of resources allocated to this node. (required)image (
AzureImage
orAzureVhdImage
orAzureComputeGalleryImage
) – OS Image to boot on node (required)location – Which data center to create a node in.
(if None, use default location specified as ‘region’ in __init__) :type location:
NodeLocation
- Parameters
auth (
NodeAuthSSHKey
orNodeAuthPassword
) – Initial authentication information for the node (optional)ex_resource_group – The resource group in which to create the
node :type ex_resource_group:
str
- Parameters
ex_storage_account – The storage account id in which to store
the node’s disk image. Note: when booting from a user image (AzureVhdImage) the source image and the node image must use the same storage account. :type ex_storage_account:
str
- Parameters
ex_blob_container – The name of the blob container on the
storage account in which to store the node’s disk image (optional, default “vhds”) :type ex_blob_container:
str
- Parameters
ex_user_name – User name for the initial admin user
(optional, default “azureuser”) :type ex_user_name:
str
- Parameters
ex_network – The virtual network the node will be attached to.
Must provide either ex_network (to create a default NIC for the node on the given network) or ex_nic (to supply the NIC explicitly). :type ex_network:
str
- Parameters
ex_subnet – If ex_network is provided, the subnet of the
virtual network the node will be attached to. Optional, default is the “default” subnet. :type ex_subnet:
str
- Parameters
ex_nic – A virtual NIC to attach to this Node, from
ex_create_network_interface or ex_get_nic. Must provide either ex_nic (to supply the NIC explicitly) or ex_network (to create a default NIC for the node on the given network). :type ex_nic:
AzureNic
- Parameters
ex_tags (
dict
) – Optional tags to associate with this node.ex_customdata (
str
) – Custom data that will be placed in the file /var/lib/waagent/CustomData https://azure.microsoft.com/en-us/documentation/ articles/virtual-machines-how-to-inject-custom-data/ex_use_managed_disks (
bool
) – Enable this feature to have Azure automatically manage the availability of disks to provide data redundancy and fault tolerance, without creating and managing storage accounts on your own. Managed disks may not be available in all regions (default False).ex_disk_size (
int
) – Custom OS disk size in GBex_storage_account_type (str) – The Storage Account type, ``Standard_LRS``(HDD disks) or ``Premium_LRS``(SSD disks).
ex_os_disk_delete (
bool
) – Enable this feature to have Azure automatically delete the OS disk when you delete the VM.
- Returns
The newly created node.
- Return type
- create_volume(size, name, location=None, snapshot=None, ex_resource_group=None, ex_account_type=None, ex_tags=None)[source]¶
Create a new managed volume.
- Parameters
size (
int
) – Size of volume in gigabytes.name (
str
) – Name of the volume to be created.location (
NodeLocation
) – Which data center to create a volume in. (required)snapshot (
VolumeSnapshot
) – Snapshot from which to create the new volume.ex_resource_group (
str
) – The name of resource group in which to create the volume. (required)ex_account_type (
str
) – The Storage Account type, ``Standard_LRS``(HDD disks) or ``Premium_LRS``(SSD disks).ex_tags (
dict
) – Optional tags to associate with this resource.
- Returns
The newly created volume.
- Return type
StorageVolume
- create_volume_snapshot(volume, name=None, location=None, ex_resource_group=None, ex_tags=None)[source]¶
Create snapshot from volume.
- Parameters
volume (:class`StorageVolume`) – Instance of
StorageVolume
.name (
str
) – Name of snapshot. (required)location (
NodeLocation
) – Which data center to create a volume in. (required)ex_resource_group (
str
) – The name of resource group in which to create the snapshot. (required)ex_tags (
dict
) – Optional tags to associate with this resource.
- Return type
VolumeSnapshot
- destroy_node(node, ex_destroy_nic=True, ex_destroy_vhd=True, ex_poll_qty=10, ex_poll_wait=10)[source]¶
Destroy a node.
- Parameters
node (
Node
) – The node to be destroyedex_destroy_nic – Destroy the NICs associated with
this node (default True). :type node:
bool
- Parameters
ex_destroy_vhd – Destroy the OS disk blob associated with
this node (default True). :type node:
bool
- Parameters
ex_poll_qty – Number of retries checking if the node
is gone, destroying the NIC or destroying the VHD (default 10). :type node:
int
- Parameters
ex_poll_wait – Delay in seconds between retries (default 10).
- Returns
True if the destroy was successful, raises exception
otherwise. :rtype:
bool
- ex_check_ip_address_availability(resource_group, network, ip_address)[source]¶
Checks whether a private IP address is available for use. Also returns an object that contains the available IPs in the subnet.
- Parameters
resource_group (
str
) – The resource group to check the ip address in.network (
AzureNetwork
) – The virtual network.ip_address (
str
) – The private IP address to be verified.
- ex_create_network_interface(name, subnet, resource_group, location=None, public_ip=None)[source]¶
Create a virtual network interface (NIC).
- Parameters
name (
str
) – Name of the NIC resourcesubnet (
AzureSubnet
) – The subnet to attach the NICresource_group (
str
) – The resource group to create the NIClocation – The location at which to create the NIC
(if None, use default location specified as ‘region’ in __init__) :type location:
NodeLocation
- Parameters
public_ip – Associate a public IP resource with this NIC
(optional). :type public_ip:
AzureIPAddress
- Returns
The newly created NIC
- Return type
- ex_create_network_security_group(name, resource_group, location=None)[source]¶
Update tags on any resource supporting tags.
- Parameters
name (
str
) – Name of the network security group to createresource_group – The resource group to create the network
security group in :type resource_group:
str
- Parameters
location – The location at which to create the network security
group (if None, use default location specified as ‘region’ in __init__) :type location:
NodeLocation
- ex_create_public_ip(name, resource_group, location=None, public_ip_allocation_method=None)[source]¶
Create a public IP resources.
- Parameters
name (
str
) – Name of the public IP resourceresource_group (
str
) – The resource group to create the public IPlocation – The location at which to create the public IP
(if None, use default location specified as ‘region’ in __init__) :type location:
NodeLocation
- Parameters
public_ip_allocation_method – Call ex_create_public_ip with
public_ip_allocation_method=”Static” to create a static public IP address :type public_ip_allocation_method:
str
- Returns
The newly created public ip object
- Return type
- ex_create_tags(resource, tags, replace=False)[source]¶
Update tags on any resource supporting tags.
- Parameters
resource (
str
or Azure object with anid
attribute.) – The resource to update.tags (
dict
) – The tags to set.replace – If true, replace all tags with the new tags.
If false (default) add or update tags. :type replace:
bool
- ex_delete_network_security_group(name, resource_group, location=None)[source]¶
Update tags on any resource supporting tags.
- Parameters
name (
str
) – Name of the network security group to deleteresource_group – The resource group to create the network
security group in :type resource_group:
str
- Parameters
location – The location at which to create the network security
group (if None, use default location specified as ‘region’ in __init__) :type location:
NodeLocation
- ex_delete_public_ip(public_ip)[source]¶
Delete a public ip address resource.
- Parameters
public_ip (.AzureIPAddress) – Public ip address resource to delete
- ex_destroy_nic(nic)[source]¶
Destroy a NIC.
- Parameters
nic (
.AzureNic
) – The NIC to destroy.- Returns
True on success
- Return type
bool
- ex_get_nic(id)[source]¶
Fetch information about a NIC.
- Parameters
id (
str
) – The complete resource path to the NIC resource.- Returns
The NIC object
- Return type
- ex_get_node(id)[source]¶
Fetch information about a node.
- Parameters
id (
str
) – The complete resource path to the node resource.- Returns
The Node object
- Return type
- ex_get_public_ip(id)[source]¶
Fetch information about a public IP resource.
- Parameters
id (``str`) – The complete resource path to the public IP resource.
- Returns
The public ip object
- Return type
- ex_get_ratecard(offer_durable_id, currency='USD', locale='en-US', region='US')[source]¶
Get rate card
- Parameters
offer_durable_id – ID of the offer applicable for this
user account. (e.g. “0026P”) See http://azure.microsoft.com/en-us/support/legal/offer-details/ :type offer_durable_id: str
- Parameters
currency (
str
) – Desired currency for the response (default: “USD”)locale (
str
) – Locale (default: “en-US”)region (
str
) – Region (two-letter code) (default: “US”)
- Returns
A dictionary of rates whose ID’s correspond to nothing at all
- Return type
dict
- ex_get_snapshot(id)[source]¶
Fetch information about a snapshot.
- Parameters
id (
str
) – The complete resource path to the snapshot resource.- Returns
The VolumeSnapshot object
- Return type
- ex_get_storage_account_keys(resource_group, storage_account)[source]¶
Get account keys required to access to a storage account (using AzureBlobsStorageDriver).
- Parameters
resource_group (
str
) – The resource group containing the storage accountstorage_account (
str
) – Storage account to access
- Returns
The account keys, in the form {“key1”: “XXX”, “key2”: “YYY”}
- Return type
.dict
- ex_get_volume(id)[source]¶
Fetch information about a volume.
- Parameters
id (
str
) – The complete resource path to the volume resource.- Returns
The StorageVolume object
- Return type
- ex_list_image_versions(sku)[source]¶
List node image versions in a sku.
- Parameters
sku – The complete resource path to a sku (as returned by
ex_list_skus) :type publisher:
str
- Returns
A list of tuples in the form
(“version id”, “version name”) :rtype:
list
- ex_list_network_security_groups(resource_group)[source]¶
List network security groups.
- Parameters
resource_group – List security groups in a specific resource
group. :type resource_group:
str
- Returns
A list of network security groups.
- Return type
list
ofAzureNetworkSecurityGroup
- ex_list_networks()[source]¶
List virtual networks.
- Returns
A list of virtual networks.
- Return type
list
ofAzureNetwork
- ex_list_nics(resource_group=None)[source]¶
List available virtual network interface controllers in a resource group
- Parameters
resource_group (
str
) – List NICS in a specific resource group containing the NICs(optional).- Returns
A list of NICs.
- Return type
list
ofAzureNic
- ex_list_offers(publisher)[source]¶
List node image offers from a publisher.
- Parameters
publisher – The complete resource path to a publisher
(as returned by ex_list_publishers) :type publisher:
str
- Returns
A list of tuples in the form
(“offer id”, “offer name”) :rtype:
list
- ex_list_public_ips(resource_group)[source]¶
List public IP resources.
- Parameters
resource_group (
str
) – List public IPs in a specific resource group.- Returns
List of public ip objects
- Return type
list
ofAzureIPAddress
- ex_list_publishers(location=None)[source]¶
List node image publishers.
- Parameters
location – The location at which to list publishers
(if None, use default location specified as ‘region’ in __init__) :type location:
NodeLocation
- Returns
A list of tuples in the form
(“publisher id”, “publisher name”) :rtype:
list
- ex_list_resource_groups()[source]¶
List resource groups.
- Returns
A list of resource groups.
- Return type
list
ofAzureResourceGroup
- ex_list_skus(offer)[source]¶
List node image skus in an offer.
- Parameters
offer – The complete resource path to an offer (as returned by
ex_list_offers) :type offer:
str
- Returns
A list of tuples in the form
(“sku id”, “sku name”) :rtype:
list
- ex_list_subnets(network)[source]¶
List subnets of a virtual network.
- Parameters
network (
AzureNetwork
) – The virtual network containing the subnets.- Returns
A list of subnets.
- Return type
list
ofAzureSubnet
- ex_resize_volume(volume, new_size, resource_group)[source]¶
Resize a volume.
- Parameters
volume (
StorageVolume
) – A volume to resize.new_size (
int
) – The new size to resize the volume to in Gib.resource_group (
str
) – The name of the resource group in which to create the volume.
- ex_run_command(node, command, filerefs=[], timestamp=0, storage_account_name=None, storage_account_key=None, location=None)[source]¶
Run a command on the node as root.
Does not require ssh to log in, uses Windows Azure Agent (waagent) running on the node.
- Parameters
node (:class:
.Node
) – The node on which to run the command.command – The actual command to run. Note this is parsed
into separate arguments according to shell quoting rules but is executed directly as a subprocess, not a shell command. :type command:
str
- Parameters
filerefs – Optional files to fetch by URI from Azure blob store
(must provide storage_account_name and storage_account_key), or regular HTTP. :type command:
list
ofstr
- Parameters
location – The location of the virtual machine
(if None, use default location specified as ‘region’ in __init__) :type location:
NodeLocation
- Parameters
storage_account_name (
str
) – The storage account from which to fetch files in filerefsstorage_account_key (
str
) – The storage key to authorize to the blob store.
- Type
list
ofNodeLocation
- ex_update_network_profile_of_node(node, network_profile)[source]¶
Update the network profile of a node. This method can be used to attach or detach a NIC to a node.
- Parameters
node (
Node
) – A node to attach the network interface to.network_profile (
dict
) – The new network profile to update.
- ex_update_nic_properties(network_interface, resource_group, properties)[source]¶
Update the properties of an already existing virtual network interface (NIC).
- features = {'create_node': ['ssh_key', 'password']}¶
- List of available features for a driver.
libcloud.compute.base.NodeDriver.create_node()
ssh_key: Supports
NodeAuthSSHKey
as an authentication method for nodes.password: Supports
NodeAuthPassword
as an authentication method for nodes.generates_password: Returns a password attribute on the Node object returned from creation.
- get_image(image_id, location=None)[source]¶
Returns a single node image from a provider.
- Parameters
image_id – Either an image urn in the form
Publisher:Offer:Sku:Version or a Azure blob store URI in the form http://storageaccount.blob.core.windows.net/container/image.vhd pointing to a VHD file. :type image_id:
str
- Parameters
location – The location at which to search for the image
(if None, use default location specified as ‘region’ in __init__) :type location:
NodeLocation
:rtype
AzureImage
: orAzureVhdImage
: :return: AzureImage or AzureVhdImage instance on success.
- list_images(location=None, ex_publisher=None, ex_offer=None, ex_sku=None, ex_version=None)[source]¶
List available VM images to boot from.
- Parameters
location – The location at which to list images
(if None, use default location specified as ‘region’ in __init__) :type location:
NodeLocation
- Parameters
ex_publisher – Filter by publisher, or None to list
all publishers. :type ex_publisher:
str
- Parameters
ex_offer (
str
) – Filter by offer, or None to list all offers.ex_sku (
str
) – Filter by sku, or None to list all skus.ex_version (
str
) – Filter by version, or None to list all versions.
- Returns
list of node image objects.
- Return type
list
ofAzureImage
- list_locations()[source]¶
List data centers available with the current subscription.
- Returns
list of node location objects
- Return type
list
ofNodeLocation
- list_nodes(ex_resource_group=None, ex_fetch_nic=True, ex_fetch_power_state=True)[source]¶
List all nodes.
- Parameters
ex_resource_group (
str
) – The resource group to list all nodes from.ex_fetch_nic – Fetch NIC resources in order to get
IP address information for nodes. If True, requires an extra API call for each NIC of each node. If False, IP addresses will not be returned. :type ex_fetch_nic:
bool
- Parameters
ex_fetch_power_state – Fetch node power state. If True, requires
an extra API call for each node. If False, node state will be returned based on provisioning state only. :type ex_fetch_power_state:
bool
- Returns
list of node objects
- Return type
list
ofNode
- list_sizes(location=None)[source]¶
List available VM sizes.
- Parameters
location – The location at which to list sizes
(if None, use default location specified as ‘region’ in __init__) :type location:
NodeLocation
- Returns
list of node size objects
- Return type
list
ofNodeSize
- list_snapshots(ex_resource_group=None)[source]¶
Lists all the snapshots under a resource group or subscription.
- Parameters
ex_resource_group (
str
) – The identifier of your subscription where the managed snapshots are located (optional).- Return type
list of
VolumeSnapshot
- list_volume_snapshots(volume)[source]¶
List snapshots for a storage volume.
- Return type
list
ofVolumeSnapshot
- list_volumes(ex_resource_group=None)[source]¶
Lists all the disks under a resource group or subscription.
- Parameters
ex_resource_group (
str
) – The identifier of your subscription where the managed disks are located.- Return type
list of
StorageVolume
- name = 'Azure Virtual machines'¶
- reboot_node(node)[source]¶
Reboot a node.
- Parameters
node (
Node
) – The node to be rebooted- Returns
True if the reboot was successful, otherwise False
- Return type
bool
- stop_node(node, ex_deallocate=True)[source]¶
Stop a running node.
- Parameters
node (
Node
) – The node to be stoppeddeallocate – If True (default) stop and then deallocate the node
(release the hardware allocated to run the node). If False, stop the node but maintain the hardware allocation. If the node is not deallocated, the subscription will continue to be billed as if it were running. :type deallocate:
bool
- type = 'azure_arm'¶
- website = 'http://azure.microsoft.com/en-us/services/virtual-machines/'¶
- class libcloud.compute.drivers.azure_arm.AzureResourceGroup(id, name, location, extra)[source]¶
Bases:
object
Represent an Azure resource group.
- class libcloud.compute.drivers.azure_arm.AzureSubnet(id, name, extra)[source]¶
Bases:
object
Represents a subnet of an Azure virtual network.
- class libcloud.compute.drivers.azure_arm.AzureVhdImage(storage_account, blob_container, name, driver)[source]¶
Bases:
libcloud.compute.base.NodeImage
Represents a VHD node image that an Azure VM can boot from.
- Parameters
id (
str
) – Image ID.name (
str
) – Image name.driver (
NodeDriver
) – Driver this image belongs to.extra (
dict
) – Optional provided specific attributes associated with this image.
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
Initialize user_id and key; set secure to an
int
based on passed value.- add_default_headers(headers)[source]¶
Adds default headers (such as Authorization, X-Foo-Bar) to the passed headers
Should return a dictionary.
- allow_insecure = False¶
- host = 'boxpanel.bluebox.net'¶
- responseCls¶
- 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¶
- create_node(name, size, image, auth=None, ex_username=None)[source]¶
Create a new node instance. This instance will be started automatically.
Not all hosting API’s are created equal and to allow libcloud to support as many as possible there are some standard supported variations of
create_node
. These are declared using afeatures
API. You can inspectdriver.features['create_node']
to see what variation of the API you are dealing with:ssh_key
You can inject a public key into a new node allows key based SSH authentication.
password
You can inject a password into a new node for SSH authentication. If no password is provided libcloud will generated a password. The password will be available as
return_value.extra['password']
.generates_password
The hosting provider will generate a password. It will be returned to you via
return_value.extra['password']
.
Some drivers allow you to set how you will authenticate with the instance that is created. You can inject this initial authentication information via the
auth
parameter.If a driver supports the
ssh_key
feature flag forcreated_node
you can upload a public key into the new instance:>>> from libcloud.compute.drivers.dummy import DummyNodeDriver >>> driver = DummyNodeDriver(0) >>> auth = NodeAuthSSHKey('pubkey data here') >>> node = driver.create_node("test_node", auth=auth)
If a driver supports the
password
feature flag forcreate_node
you can set a password:>>> driver = DummyNodeDriver(0) >>> auth = NodeAuthPassword('mysecretpassword') >>> node = driver.create_node("test_node", auth=auth)
If a driver supports the
password
feature and you don’t provide theauth
argument libcloud will assign a password:>>> driver = DummyNodeDriver(0) >>> node = driver.create_node("test_node") >>> password = node.extra['password']
A password will also be returned in this way for drivers that declare the
generates_password
feature, though in that case the password is actually provided to the driver API by the hosting provider rather than generated by libcloud.You can only pass a
NodeAuthPassword
orNodeAuthSSHKey
tocreate_node
via the auth parameter if has the corresponding feature flag.- 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)location (
NodeLocation
) – Which data center to create a node in. If empty, undefined behavior will be selected. (optional)auth (
NodeAuthSSHKey
orNodeAuthPassword
) – Initial authentication information for the node (optional)
- Returns
The newly created node.
- Return type
- destroy_node(node)[source]¶
Destroy a node.
Depending upon the provider, this may destroy all data associated with the node, including backups.
- Parameters
node (
Node
) – The node to be destroyed- Returns
True if the destroy was successful, False otherwise.
- Return type
bool
- features = {'create_node': ['ssh_key', 'password']}¶
- List of available features for a driver.
libcloud.compute.base.NodeDriver.create_node()
ssh_key: Supports
NodeAuthSSHKey
as an authentication method for nodes.password: Supports
NodeAuthPassword
as an authentication method for nodes.generates_password: Returns a password attribute on the Node object returned from creation.
- list_images(location=None)[source]¶
List images on a provider.
- Parameters
location (
NodeLocation
) – The location at which to list images.- Returns
list of node image objects.
- Return type
list
ofNodeImage
- list_locations()[source]¶
List data centers for a provider
- Returns
list of node location objects
- Return type
list
ofNodeLocation
- list_sizes(location=None)[source]¶
List sizes on a provider
- Parameters
location (
NodeLocation
) – The location at which to list sizes- Returns
list of node size objects
- Return type
list
ofNodeSize
- name = 'Bluebox Blocks'¶
- reboot_node(node)[source]¶
Reboot a node.
- Parameters
node (
Node
) – The node to be rebooted- Returns
True if the reboot was successful, otherwise False
- Return type
bool
- type = 'bluebox'¶
- website = 'http://bluebox.net'¶
- class libcloud.compute.drivers.bluebox.BlueboxNodeSize(id, name, cpu, ram, disk, price, driver)[source]¶
Bases:
libcloud.compute.base.NodeSize
- Parameters
id (
str
) – Size ID.name (
str
) – Size name.ram (
int
) – Amount of memory (in MB) provided by this size.disk (
int
) – Amount of disk storage (in GB) provided by this image.bandwidth (
int
) – Amount of bandiwdth included with this size.price (
float
) – Price (in US dollars) of running this node for an hour.driver (
NodeDriver
) – Driver this size belongs to.extra (
dict
) – Optional provider specific attributes associated with this size.
- 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.
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
- 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': NodeState.RUNNING, 'creating': NodeState.PENDING, 'deleted': NodeState.TERMINATED, 'deleting': NodeState.UNKNOWN, 'failed': NodeState.UNKNOWN, 'inactive': NodeState.UNKNOWN, 'unavailable': NodeState.UNKNOWN}¶
- connectionCls¶
- create_node(name, size, image, location=None, ex_userdata=None, ex_servergroup=None)[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 dataex_servergroup (
str
orlist
ofstr
) – Name or list of server group ids to add server to
- destroy_node(node)[source]¶
Destroy a node.
Depending upon the provider, this may destroy all data associated with the node, including backups.
- Parameters
node (
Node
) – The node to be destroyed- Returns
True if the destroy was successful, False otherwise.
- Return type
bool
- 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 hostname- Return 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
- 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
- list_images(location=None)[source]¶
List images on a provider.
- Parameters
location (
NodeLocation
) – The location at which to list images.- Returns
list of node image objects.
- Return type
list
ofNodeImage
- list_locations()[source]¶
List data centers for a provider
- Returns
list of node location objects
- Return type
list
ofNodeLocation
- list_sizes()[source]¶
List sizes on a provider
- Parameters
location (
NodeLocation
) – The location at which to list sizes- Returns
list of node size objects
- Return type
list
ofNodeSize
- 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
- Parameters
key (
str
) – API key or username to be used (required)secret (
str
) – Secret password to be used (required)secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default.host (
str
) – Override hostname used for connections.port (
int
) – Override port used for connections.api_version (
str
) – Optional API version. Only used by drivers which support multiple API versions.region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
- Return type
None
- api_version = 1.0¶
- connectionCls¶
alias of
libcloud.common.dimensiondata.DimensionDataConnection
- features = {'create_node': ['password']}¶
- List of available features for a driver.
libcloud.compute.base.NodeDriver.create_node()
ssh_key: Supports
NodeAuthSSHKey
as an authentication method for nodes.password: Supports
NodeAuthPassword
as an authentication method for nodes.generates_password: Returns a password attribute on the Node object returned from creation.
- name = 'BSNL'¶
- selected_region = None¶
- type = 'bsnl'¶
- website = 'http://www.bsnlcloud.com/'¶
libcloud.compute.drivers.cloudscale module¶
A driver for cloudscale.ch.
- class libcloud.compute.drivers.cloudscale.CloudscaleConnection(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 cloudscale.ch driver.
Initialize user_id and key; set secure to an
int
based on passed value.- add_default_headers(headers)[source]¶
Add headers that are necessary for every request
This method adds
token
to the request.
- host = 'api.cloudscale.ch'¶
- responseCls¶
alias of
libcloud.compute.drivers.cloudscale.CloudscaleResponse
- class libcloud.compute.drivers.cloudscale.CloudscaleNodeDriver(key, **kwargs)[source]¶
Bases:
libcloud.compute.base.NodeDriver
Cloudscale’s 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 = {'changing': NodeState.PENDING, 'paused': NodeState.PAUSED, 'running': NodeState.RUNNING, 'stopped': NodeState.STOPPED}¶
- connectionCls¶
alias of
libcloud.compute.drivers.cloudscale.CloudscaleConnection
- create_node(name, size, image, location=None, ex_create_attr=None)[source]¶
Create a node.
The ex_create_attr parameter can include the following dictionary key and value pairs:
ssh_keys:
list
ofstr
ssh public keysvolume_size_gb:
int
defaults to 10.bulk_volume_size_gb: defaults to None.
use_public_network:
bool
defaults to Trueuse_private_network:
bool
defaults to Falseuse_ipv6:
bool
defaults to Trueanti_affinity_with:
uuid
of a server to create an anti-affinity group with that server or add it to the same group as that server.user_data:
str
for optional cloud-config data
- Parameters
ex_create_attr (
dict
) – A dictionary of optional attributes for droplet creation- Returns
The newly created node.
- Return type
Node
- destroy_node(node)[source]¶
Delete a node. It’s also possible to use
node.destroy()
. This will irreversibly delete the cloudscale.ch server and all its volumes. So please be cautious.
- ex_node_by_uuid(uuid)[source]¶
- Parameters
ex_user_data (
str
) – A valid uuid that references your exisiting cloudscale.ch server.- Returns
The server node you asked for.
- Return type
Node
- list_images()[source]¶
List all images.
Images are identified by slugs on cloudscale.ch. This means that minor version upgrades (e.g. Ubuntu 16.04.1 to Ubuntu 16.04.2) will be possible within the same id
ubuntu-16.04
.
- name = 'Cloudscale'¶
- stop_node(node)[source]¶
Stop a specific node. Similar to
shutdown -h now
. This is only possible if the node is running.
- type = 'cloudscale'¶
- website = 'https://www.cloudscale.ch'¶
- class libcloud.compute.drivers.cloudscale.CloudscaleResponse(response, connection)[source]¶
Bases:
libcloud.common.base.JsonResponse
- Parameters
response (
httplib.HTTPResponse
) – HTTP response object. (optional)connection (
Connection
) – Parent connection object.
- parse_error()[source]¶
Parse the error messages.
Override in a provider’s subclass.
- Returns
Parsed error.
- Return type
str
- success()[source]¶
Determine if our request was successful.
The meaning of this can be arbitrary; did we receive OK status? Did the node get created? Were we authenticated?
- Return type
bool
- Returns
True
orFalse
- valid_response_codes = [<HTTPStatus.OK: 200>, <HTTPStatus.ACCEPTED: 202>, <HTTPStatus.CREATED: 201>, <HTTPStatus.NO_CONTENT: 204>]¶
libcloud.compute.drivers.cloudsigma module¶
Drivers for CloudSigma API v1.0 and v2.0.
- 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 (
float
) – Drive size (in GBs).media (
str
) – Drive media (cdrom / disk).status (
str
) – Drive status (unmounted / mounted).
- 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.
- 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.
- 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.
- class libcloud.compute.drivers.cloudsigma.CloudSigmaNodeDriver(key, secret=None, secure=True, host=None, port=None, api_version='2.0', **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/'¶
- class libcloud.compute.drivers.cloudsigma.CloudSigmaNodeSize(id, name, cpu, ram, disk, bandwidth, price, driver, extra=None)[source]¶
Bases:
libcloud.compute.base.NodeSize
- Parameters
id (
str
) – Size ID.name (
str
) – Size name.ram (
int
) – Amount of memory (in MB) provided by this size.disk (
int
) – Amount of disk storage (in GB) provided by this image.bandwidth (
int
) – Amount of bandiwdth included with this size.price (
float
) – Price (in US dollars) of running this node for an hour.driver (
NodeDriver
) – Driver this size belongs to.extra (
dict
) – Optional provider specific attributes associated with this size.
- 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.
- 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.
- class libcloud.compute.drivers.cloudsigma.CloudSigma_1_0_NodeDriver(key, secret=None, secure=True, host=None, port=None, api_version='2.0', **kwargs)[source]¶
Bases:
libcloud.compute.drivers.cloudsigma.CloudSigmaNodeDriver
- 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
- IMAGING_TIMEOUT = 1200¶
- NODE_STATE_MAP = {'active': NodeState.RUNNING, 'dead': NodeState.TERMINATED, 'dumped': NodeState.TERMINATED, 'stopped': NodeState.TERMINATED}¶
- connectionCls¶
alias of
libcloud.compute.drivers.cloudsigma.CloudSigma_1_0_Connection
- create_node(name, size, image, smp='auto', nic_model='e1000', vnc_password=None, drive_type='hdd')[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.
- 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 used- Return 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 used- Return 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 used- Return 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 usedkwargs (
dict
) – keyword arguments
- Return type
bool
- 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 used- Return type
bool
- ex_static_ip_destroy(ip_address)[source]¶
Destroy a static IP address.
- Parameters
ip_address (
str
) – IP address which should be used- Return type
bool
- ex_static_ip_list()[source]¶
Return a list of available static IP addresses.
- Return type
list
ofstr
- 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
- list_sizes(location=None)[source]¶
List sizes on a provider
- Parameters
location (
NodeLocation
) – The location at which to list sizes- Returns
list of node size objects
- Return type
list
ofNodeSize
- 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
- stop_node(node)[source]¶
Stop (shutdown) a node.
- Parameters
node (
libcloud.compute.base.Node
) – Node which should be used- Return type
bool
- type = 'cloudsigma'¶
- website = 'http://www.cloudsigma.com/'¶
- class libcloud.compute.drivers.cloudsigma.CloudSigma_2_0_NodeDriver(key, secret=None, secure=True, host=None, port=None, api_version='2.0', **kwargs)[source]¶
Bases:
libcloud.compute.drivers.cloudsigma.CloudSigmaNodeDriver
Driver for CloudSigma API v2.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
- DRIVE_TRANSITION_SLEEP_INTERVAL = 5¶
- DRIVE_TRANSITION_TIMEOUT = 500¶
- NODE_STATE_MAP = {'paused': NodeState.PAUSED, 'running': NodeState.RUNNING, 'starting': NodeState.PENDING, 'stopped': NodeState.STOPPED, 'stopping': NodeState.PENDING, 'unavailable': NodeState.ERROR}¶
- api_name = 'cloudsigma_zrh'¶
- attach_volume(node, volume)[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
- connectionCls¶
alias of
libcloud.compute.drivers.cloudsigma.CloudSigma_2_0_Connection
- create_node(name, size, image, ex_metadata=None, ex_vnc_password=None, ex_avoid=None, ex_vlan=None, public_keys=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.public_keys (
list
ofstr
) – Optional list of SSH key UUIDs
- create_volume(name, size, media='disk', ex_avoid=None)[source]¶
Create a new volume.
- Parameters
size (
int
) – Size of volume in gigabytes (required)name (
str
) – Name of the volume to be createdlocation (
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
- delete_key_pair(key_pair)[source]¶
Delete an existing key pair.
- Parameters
key_pair (
KeyPair
) – Key pair object- Return type
bool
- destroy_node(node, ex_delete_drives=False)[source]¶
Destroy the node and all the associated drives.
- Returns
True
on success,False
otherwise.- Return type
bool
- destroy_volume(drive)[source]¶
Destroys a storage volume.
- Parameters
volume (
StorageVolume
) – Volume to be destroyed- Return type
bool
- detach_volume(node, volume)[source]¶
Detaches a volume from a node.
- Parameters
volume (
StorageVolume
) – Volume to be detached- Return type
bool
- ex_attach_drive(node, drive)[source]¶
Attach drive to node
- Parameters
node (
libcloud.compute.base.Node
) – Node to attach the drive to.drive (
CloudSigmaDrive
) – Drive to attach.
- 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
- 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
- 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
- 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 GBs.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
- 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
- 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.
- 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
- 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
- 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
- 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
- ex_list_tags()[source]¶
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 GBs.
- Returns
Drive object which is being resized.
- Return type
- 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
- 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
- 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
- get_key_pair(key_uuid)[source]¶
Retrieve a single key pair.
- Parameters
name (
str
) – The uuid of the key pair to retrieve.- Return type
- 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.
- Return type
KeyPair
object
- 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_key_pairs()[source]¶
List all the available key pair objects.
- Return type
list
ofKeyPair
objects
- list_nodes(ex_tag=None)[source]¶
List available nodes.
- Parameters
ex_tag (
CloudSigmaTag
) – If specified, only return servers tagged with the provided tag.
- list_volumes()[source]¶
List storage volumes.
- Return type
list
ofStorageVolume
- name = 'CloudSigma (API v2.0)'¶
- reboot_node(node)[source]¶
Reboot a node.
Because Cloudsigma API does not provide native reboot call, it’s emulated using stop and start.
- Parameters
node (
libcloud.compute.base.Node
) – Node to reboot.
- 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)
- stop_node(node)[source]¶
Stop a node
- Parameters
node (
Node
) – The node to be stopped.- Returns
True if the stop was successful, otherwise False
- Return type
bool
- website = 'http://www.cloudsigma.com/'¶
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 IPaddress (
str
) – The public IP addressassociated_network_id (
str
) – The ID of the network where this address has been associated withvpc_id (
str
) – VPC the ip belongs tovirtualmachine_id (
str
) – The ID of virutal machine this address is assigned to
- 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 IDaccount (
str
) – An account for the affinity group. Must be used with domainId.description (
str
) – optional description of the affinity groupdomain (
str
) – the domain name of the affinity groupdomainid (
str
) – domain ID of the account owning the affinity groupname (
str
) – name of the affinity groupgroup_type (
CloudStackAffinityGroupType
) – the type of the affinity groupvirtualmachine_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 group- Return type
- 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 IDnetwork_id (
str
) – the id network network for the egress firwall servicesprotocol (
str
) – TCP/IP Protocol (TCP, UDP)cidr_list (
str
) – cidr listicmp_code (
int
) – Error code for this icmp messageicmp_type (
int
) – Type of the icmp message being sentstart_port (
int
) – start of port rangeend_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 IDaddress (
CloudStackAddress
) – External IP addresscidr_list (
str
) – cidr listprotocol (
str
) – TCP/IP Protocol (TCP, UDP)icmp_code (
int
) – Error code for this icmp messageicmp_type (
int
) – Type of the icmp message being sentstart_port (
int
) – start of port rangeend_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 ruleid (
int
) – Rule IDaddress (
CloudStackAddress
) – External IP addressprotocol (
str
) – TCP/IP Protocol (TCP, UDP)start_port (
int
) – Start port for the ruleend_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 numberacl_id (
str
) – Name of the network ACL Listaction (
string
) – scl entry action, allow or denycidr_list (
str
) – the cidr list to allow traffic from/tostart_port (
str
) – the starting port of ACLend_port (
str
) – the ending port of ACLtraffic_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 IDname (
str
) – Name of the network ACL Listvpc_id (
string
) – Id of the VPC associated with this network ACL Listdescription (
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.
- 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': NodeState.TERMINATED, 'Error': NodeState.TERMINATED, 'Expunging': NodeState.PENDING, 'Migrating': NodeState.MIGRATING, 'Running': NodeState.RUNNING, 'Starting': NodeState.REBOOTING, 'Stopped': NodeState.STOPPED, 'Stopping': NodeState.PENDING}¶
- VOLUME_STATE_MAP = {'Allocated': StorageVolumeState.AVAILABLE, 'Creating': StorageVolumeState.CREATING, 'Destroy': StorageVolumeState.DELETED, 'Destroying': StorageVolumeState.DELETING, 'Expunged': StorageVolumeState.DELETED, 'Expunging': StorageVolumeState.DELETING, 'Migrating': StorageVolumeState.MIGRATING, 'Ready': StorageVolumeState.AVAILABLE, 'Snapshotting': StorageVolumeState.BACKUP, 'UploadError': StorageVolumeState.ERROR}¶
- 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 keydomainid (
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
- create_node(name, size, image, location=None, networks=None, project=None, diskoffering=None, ex_keyname=None, ex_userdata=None, ex_security_groups=None, ex_displayname=None, ex_ip_address=None, ex_start_vm=False, ex_rootdisksize=None, ex_affinity_groups=None)[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 keypairex_userdata (
str
) – String containing user dataex_security_groups (
list
ofstr
) – List of security groups to assign to the nodeex_displayname (
str
) – String containing instance display nameex_ip_address (
str
) – String with ipaddress for the default nicex_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 templateex_affinity_groups (
list
ofCloudStackAffinityGroup
) – List of affinity groups to assign to the node
- Return type
- 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
- 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 keypairdomainid (
str
) – The domain ID associated with the keypairaccount (
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
- 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
- destroy_volume_snapshot(snapshot)[source]¶
Destroys a snapshot.
- Parameters
snapshot (
VolumeSnapshot
) – The snapshot to delete- Return type
- 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 tonetwork_id (''str'') – Network where this IP is connected to.
location (
NodeLocation
) – Zone
- Return type
- 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
- ex_authorize_security_group_ingress(securitygroupname, protocol, cidrlist, startport=None, endport=None, icmptype=None, icmpcode=None, **kwargs)[source]¶
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 groupsecuritygroupid (
str
) – The ID of the security group. Mutually exclusive with securitygroupnameusersecuritygrouplist (
dict
) – User to security group mapping
- Return type
dict
- ex_change_node_size(node, offering)[source]¶
Change offering/size of a virtual machine
- Parameters
node (
CloudStackNode
) – Node to change sizeoffering (
NodeSize
) – The new offering
:rtype
str
- ex_create_affinity_group(name, group_type)[source]¶
Creates a new Affinity Group
- Parameters
name (
str
) – Name of the affinity groupgroup_type (
CloudStackAffinityGroupType
) – Type of the affinity group from the available affinity/anti-affinity group typesdescription (
str
) – Optional description of the affinity groupdomainid (
str
) – domain ID of the account owning the affinity group
- Return type
- 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 servicescidr_list (
str
) – cidr listprotocol (
str
) – TCP/IP Protocol (TCP, UDP)icmp_code (
int
) – Error code for this icmp messageicmp_type (
int
) – Type of the icmp message being sentstart_port (
int
) – start of port rangeend_port (
int
) – end of port range
- Return type
- 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 addresscidr_list (
str
) – cidr listprotocol (
str
) – TCP/IP Protocol (TCP, UDP)icmp_code (
int
) – Error code for this icmp messageicmp_type (
int
) – Type of the icmp message being sentstart_port (
int
) – start of port rangeend_port (
int
) – end of port range
- Return type
- 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 usedaddress (
CloudStackAddress
) – CloudStackAddress which should be usedprotocol (
str
) – Protocol which should be used (TCP or UDP)start_port (
int
) – Start port which should be usedend_port (
int
) – End port which should be used
- Return type
CloudStackForwardingRule
- 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 keydomainid (
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
- 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 networkname (
str
) – the name of the networknetwork_offering (:class:'CloudStackNetworkOffering`) – NetworkOffering object
location (
NodeLocation
) – Zone objectgateway (
str
) – Optional, the Gateway of this networknetmask (
str
) – Optional, the netmask of this networknetwork_domain (
str
) – Optional, the DNS domain of the networkvpc_id (
str
) – Optional, the VPC id the network belongs toproject_id (
str
) – Optional, the project id the networks belongs to
- Return type
- 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 numberacl_id (
str
) – Name of the network ACL Listcidr_list (
str
) – the cidr list to allow traffic from/tostart_port (
str
) – the starting port of ACLend_port (
str
) – the ending port of ACLaction (
str
) – scl entry action, allow or denytraffic_type (
str
) – the traffic type for the ACL,can be Ingress or Egress, defaulted to Ingress if not specified
- Return type
- 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 Listvpc_id (
string
) – Id of the VPC associated with this network ACL Listdescription (
string
) – Description of the network ACL List
- Return type
- 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 NATprivate_port (
int
) – Port of the virtual machineprotocol (
str
) – Protocol of the rulepublic_port (
int
) – Public port on the Source NAT addressnode (
CloudStackNode
) – The virtual machinenetwork_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
- 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 groupprojectid (
str
) – Deploy vm for the project
- Return type
dict
- 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 templatename – the os type id
name – the display name of the template
- Return type
NodeImage
- ex_create_tags(resource_ids, resource_type, tags)[source]¶
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
- 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 VPCname (
str
) – the name of the VPCvpc_offering (:class:'CloudStackVPCOffering`) – the ID of the VPC offering
zone_id (
str
) – the ID of the availability zonenetwork_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
- 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
- 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 used- Return type
bool
- ex_delete_firewall_rule(firewall_rule)[source]¶
Remove a Firewall Rule.
- Parameters
firewall_rule (
CloudStackFirewallRule
) – Firewall rule which should be used- Return type
bool
- ex_delete_ip_forwarding_rule(node, rule)[source]¶
Remove a NAT/firewall forwarding rule.
- Parameters
node (
CloudStackNode
) – Node which should be usedrule (
CloudStackForwardingRule
) – Forwarding rule which should be used
- Return type
bool
- 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 keypairdomainid (
str
) – The domain ID associated with the keypairaccount (
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
- 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 rulerule (
CloudStackPortForwardingRule
) – Forwarding rule which should be used
- Return type
bool
- ex_delete_security_group(name)[source]¶
Deletes a given Security Group
- Parameters
domainid (
str
) – The domain ID of account owning the security groupid (
str
) – The ID of the security group. Mutually exclusive with name parametername (
str
) – The ID of the security group. Mutually exclusive with id parameteraccount (
str
) – The account of the security group. Must be specified with domain IDprojectid (
str
) – The project of the security group
- Return type
bool
- ex_delete_tags(resource_ids, resource_type, tag_keys)[source]¶
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
- 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 nodeproject (
CloudStackProject
) – Limit node returned to those configured under the defined project.
- Return type
- ex_get_volume(volume_id, project=None)[source]¶
Return a StorageVolume object based on its ID.
- Parameters
volume_id (
str
) – The id of the volumeproject (
CloudStackProject
) – Limit volume returned to those configured under the defined project.
- Return type
- 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
- 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
- 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 parameterdomain_id (
str
) – List only resources belonging to the domain specifiedid (
str
) – Lists rule with the specified IDipaddress_id (
str
) – list the rule belonging to this public ip addressis_recursive (
bool
) – Defaults to false, but if true, lists all resources from the parent specified by the domainId till leaves.keyword (
str
) – List by keywordlist_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 falsepage (
int
) – The page to list the keypairs frompage_size (
int
) – The number of results per pageproject_id (
str
) – list objects by projectvirtualmachine_id (
str
) – Lists all rules applied to the specified Vm
- Return type
list
ofCloudStackIPForwardingRule
- ex_list_keypairs(**kwargs)[source]¶
List Registered SSH Key Pairs
- Parameters
projectid (
str
) – list objects by projectpage (
int
) – The page to list the keypairs fromkeyword (
str
) – List by keywordlistall (
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 falsepagesize (
int
) – The number of results per pageaccount (
str
) – List resources by account. Must be used with the domainId parameterisrecursive (
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 forname (
str
) – A key pair name to look fordomainid (
str
) – List only resources belonging to the domain specified
- Returns
A list of keypair dictionaries
- Return type
list
ofdict
- 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 parameterdomain_id (
str
) – List only resources belonging to the domain specifiedfor_display (
bool
) – List resources by display flag (only root admin is eligible to pass this parameter).id (
str
) – Lists rule with the specified IDipaddress_id (
str
) – list the rule belonging to this public ip addressis_recursive (
bool
) – Defaults to false, but if true, lists all resources from the parent specified by the domainId till leaves.keyword (
str
) – List by keywordlist_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 falsenetwork_id (
string
) – list port forwarding rules for certain networkpage (
int
) – The page to list the keypairs frompage_size (
int
) – The number of results per pageproject_id (
str
) – list objects by project
- Return type
list
ofCloudStackPortForwardingRule
- 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 specifiedaccount (
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 falsepagesize (
int
) – Number of entries per pagekeyword (
str
) – List by keywordtags (
dict
) – List resources by tags (key/value pairs)id (
str
) – list the security group by the id providedsecuritygroupname (
str
) – lists security groups by namevirtualmachineid (
str
) – lists security groups by virtual machine idprojectid (
str
) – list objects by projectisrecursive (
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
- 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
- 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
- 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
- ex_register_iso(name, url, location=None, **kwargs)[source]¶
Registers an existing ISO by URL.
- Parameters
name (
str
) – Name which should be usedurl (
str
) – Url should be usedlocation (
NodeLocation
) – Location which should be used
- Return type
str
- ex_release_public_ip(address)[source]¶
Release a public IP.
- Parameters
address (
CloudStackAddress
) – CloudStackAddress which should be used- Return 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 ACLnetwork_id (
string
) – the ID of the network
- Return type
- ex_restore(node, template=None)[source]¶
Restore virtual machine
- Parameters
node (
CloudStackNode
) – Node to restoretemplate (
NodeImage
) – Optional new template
:rtype
str
- ex_revoke_security_group_ingress(rule_id)[source]¶
Revoke/delete an ingress security rule
- Parameters
id (
str
) – The ID of the ingress security rule- Return 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
- 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
- features = {'create_node': ['generates_password']}¶
- List of available features for a driver.
libcloud.compute.base.NodeDriver.create_node()
ssh_key: Supports
NodeAuthSSHKey
as an authentication method for nodes.password: Supports
NodeAuthPassword
as an authentication method for nodes.generates_password: Returns a password attribute on the Node object returned from creation.
- get_key_pair(name)[source]¶
Retrieve a single key pair.
- Parameters
name (
str
) – Name of the key pair to retrieve.- Return type
- 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
- list_images(location=None)[source]¶
List images on a provider.
- Parameters
location (
NodeLocation
) – The location at which to list images.- Returns
list of node image objects.
- Return type
list
ofNodeImage
- list_key_pairs(**kwargs)[source]¶
List registered key pairs.
- Parameters
projectid (
str
) – list objects by projectpage (
int
) – The page to list the keypairs fromkeyword (
str
) – List by keywordlistall (
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 falsepagesize (
int
) – The number of results per pageaccount (
str
) – List resources by account. Must be used with the domainId parameterisrecursive (
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 forname (
str
) – A key pair name to look fordomainid (
str
) – List only resources belonging to the domain specified
- Returns
A list of key par objects.
- Return type
list
oflibcloud.compute.base.KeyPair
- 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
- 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 rulerule_id (
int
) – Rule IDaddress (
CloudStackAddress
) – External IP addressprotocol (
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 rangeprivate_end_port (
int
) – End of internal port rangenetwork_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
- 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.
- property vpn_customer_gateway¶
- property 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=None, secure=True, host=None, port=None, api_version='1.1', **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
- 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
- connectionCls¶
alias of
libcloud.compute.drivers.cloudwatt.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, api_version='v2', **kwargs)[source]¶
Bases:
libcloud.compute.base.NodeDriver
DigitalOcean NodeDriver defaulting to using APIv2.
- Parameters
key (
str
) – Personal Access Token required for authentication.secret (
str
) – Previously used with API versionv1
. (deprecated)api_version (
str
) – Specifies the API version to use. Defaults to usingv2
, currently the only valid option. (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'¶
- class libcloud.compute.drivers.digitalocean.DigitalOcean_v2_NodeDriver(key, secret=None, api_version='v2', **kwargs)[source]¶
Bases:
libcloud.common.digitalocean.DigitalOcean_v2_BaseDriver
,libcloud.compute.drivers.digitalocean.DigitalOceanNodeDriver
DigitalOcean NodeDriver using v2 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
- EX_CREATE_ATTRIBUTES = ['backups', 'ipv6', 'private_networking', 'tags', 'ssh_keys']¶
- NODE_STATE_MAP = {'active': NodeState.RUNNING, 'archive': NodeState.TERMINATED, 'new': NodeState.PENDING, 'off': NodeState.STOPPED}¶
- 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
- create_image(node, name)[source]¶
Create an image from a Node.
@inherits:
NodeDriver.create_image
- Parameters
node (
str
) – Node to use as base for imagenode – Name for image
- Return type
bool
- 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)
- 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 Falseipv6:
bool
defaults to Falseprivate_networking:
bool
defaults to Falsetags:
list
ofstr
tagsuser_data:
str
for cloud-config datassh_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 creationex_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
- 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 createdlocation (
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
- create_volume_snapshot(volume, name)[source]¶
Create a new volume snapshot.
- Parameters
volume (class:StorageVolume) – Volume to create a snapshot for
- Returns
The newly created volume snapshot.
- Return type
VolumeSnapshot
- delete_image(image)[source]¶
Delete an image for node.
@inherits:
NodeDriver.delete_image
- Parameters
image (
NodeImage
) – the image to be deleted- Return type
bool
- delete_key_pair(key)[source]¶
Delete an existing SSH key.
- Parameters
key (
KeyPair
) – SSH key (required)
- delete_volume_snapshot(snapshot)[source]¶
Delete a volume snapshot
- Parameters
snapshot (class:VolumeSnapshot) – volume snapshot to delete
- Return type
bool
- destroy_node(node)[source]¶
Destroy a node.
Depending upon the provider, this may destroy all data associated with the node, including backups.
- Parameters
node (
Node
) – The node to be destroyed- Returns
True if the destroy was successful, False otherwise.
- Return type
bool
- destroy_volume(volume)[source]¶
Destroys a storage volume.
- Parameters
volume (
StorageVolume
) – Volume to be destroyed- Return type
bool
- detach_volume(volume)[source]¶
Detaches a volume from a node.
- Parameters
volume (
StorageVolume
) – Volume to be detached- Return type
bool
- ex_attach_floating_ip_to_node(node, ip)[source]¶
Attach the floating IP to the node
- Parameters
node (
Node
) – nodeip (
str
orDigitalOcean_v2_FloatingIpAddress
) – floating IP to attach
- Return type
bool
- ex_create_floating_ip(location)[source]¶
Create new floating IP reserved to a region.
The newly created floating IP will not be associated to a Droplet.
See https://developers.digitalocean.com/documentation/v2/#floating-ips
- Parameters
location (
NodeLocation
) – Which data center to create the floating IP in.- Return type
DigitalOcean_v2_FloatingIpAddress
- ex_delete_floating_ip(ip)[source]¶
Delete specified floating IP
- Parameters
ip (
DigitalOcean_v2_FloatingIpAddress
) – floating IP to remove- Return type
bool
- ex_detach_floating_ip_from_node(node, ip)[source]¶
Detach a floating IP from the given node
Note: the ‘node’ object is not used in this method but it is added to the signature of ex_detach_floating_ip_from_node anyway so it conforms to the interface of the method of the same name for other drivers like for example OpenStack.
- Parameters
node (
Node
) – Node from which the IP should be detachedip (
DigitalOcean_v2_FloatingIpAddress
) – Floating IP to detach
- Return type
bool
- ex_get_floating_ip(ip)[source]¶
Get specified floating IP
- Parameters
ip (
str
) – floating IP to get- Return type
DigitalOcean_v2_FloatingIpAddress
- ex_get_node_details(node_id)[source]¶
Lists details of the specified server.
- Parameters
node_id (
str
) – ID of the node which should be used- Return type
Node
- ex_list_floating_ips()[source]¶
List floating IPs
- Return type
list
ofDigitalOcean_v2_FloatingIpAddress
- ex_rebuild_node(node)[source]¶
Destroy and rebuild the node using its base image.
- Parameters
node (
Node
) – Node to rebuild
:return True if the operation began successfully :rtype
bool
- ex_resize_node(node, size)[source]¶
Resize the node to a different machine size. Note that some resize operations are reversible, and others are irreversible.
- Parameters
node (
NodeSize
) – Node to rebuildsize – New size for this machine
:return True if the operation began successfully :rtype
bool
- get_image(image_id)[source]¶
Get an image based on an image_id
@inherits:
NodeDriver.get_image
- Parameters
image_id (
int
) – Image identifier- Returns
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
- list_images()[source]¶
List images on a provider.
- Parameters
location (
NodeLocation
) – The location at which to list images.- Returns
list of node image objects.
- Return type
list
ofNodeImage
- list_key_pairs()[source]¶
List all the available SSH keys.
- Returns
Available SSH keys.
- Return type
list
ofKeyPair
- list_locations(ex_available=True)[source]¶
List locations
- Parameters
ex_available – Only return locations which are available.
- list_sizes(location=None)[source]¶
List sizes on a provider
- Parameters
location (
NodeLocation
) – The location at which to list sizes- Returns
list of node size objects
- Return type
list
ofNodeSize
- list_volume_snapshots(volume)[source]¶
List snapshots for a volume.
- Parameters
volume (class:StorageVolume) – Volume to list snapshots for
- Returns
List of volume snapshots.
- Return type
list
of :class: StorageVolume
- list_volumes()[source]¶
List storage volumes.
- Return type
list
ofStorageVolume
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. Default api_version is used unless specified.
- Parameters
key (
str
) – API key or username to be used (required)secret (
str
) – Secret password to be used (required)secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default.host (
str
) – Override hostname used for connections.port (
int
) – Override port used for connections.api_version (
str
) – Optional API version. Only used by drivers which support multiple API versions.region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
- Return type
None
- api_version = 1.0¶
- connectionCls¶
alias of
libcloud.common.dimensiondata.DimensionDataConnection
- create_node(name, image, auth, ex_network_domain=None, ex_primary_nic_private_ipv4=None, ex_primary_nic_vlan=None, ex_primary_nic_network_adapter=None, ex_additional_nics=None, ex_description=None, ex_disks=None, ex_cpu_specification=None, ex_memory_gb=None, ex_is_started=True, ex_primary_dns=None, ex_secondary_dns=None, ex_ipv4_gateway=None, ex_microsoft_time_zone=None, **kwargs)[source]¶
Create a new DimensionData node in MCP2. However, it is still backward compatible for MCP1 for a limited time. Please consider using MCP2 datacenter as MCP1 will phase out soon.
Legacy Create Node for MCP1 datacenter
>>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.base import NodeAuthPassword >>> from libcloud.compute.providers import get_driver >>> import libcloud.security >>> >>> # Get dimension data driver >>> libcloud.security.VERIFY_SSL_CERT = False >>> DimensionData = get_driver(Provider.DIMENSIONDATA) >>> driver = cls('myusername','mypassword', region='dd-au') >>> >>> # Password >>> root_pw = NodeAuthPassword('password123') >>> >>> # Get location >>> location = driver.ex_get_location_by_id(id='AU1') >>> >>> # Get network by location >>> my_network = driver.list_networks(location=location)[0] >>> pprint(my_network) >>> >>> # Get Image >>> images = driver.list_images(location=location) >>> image = images[0] >>> >>> node = driver.create_node(name='test_blah_2', image=image, >>> auth=root_pw, >>> ex_description='test3 node', >>> ex_network=my_network, >>> ex_is_started=False) >>> pprint(node)
Create Node in MCP2 Data Center
>>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.base import NodeAuthPassword >>> from libcloud.compute.providers import get_driver >>> import libcloud.security >>> >>> # Get dimension data driver >>> libcloud.security.VERIFY_SSL_CERT = True >>> cls = get_driver(Provider.DIMENSIONDATA) >>> driver = cls('myusername','mypassword', region='dd-au') >>> >>> # Password >>> root_pw = NodeAuthPassword('password123') >>> >>> # Get location >>> location = driver.ex_get_location_by_id(id='AU9') >>> >>> # Get network domain by location >>> networkDomainName = "Baas QA" >>> network_domains = driver.ex_list_network_domains(location=location) >>> my_network_domain = [d for d in network_domains if d.name == networkDomainName][0] >>> >>> vlan = driver.ex_list_vlans(location=location, >>> network_domain=my_network_domain)[0] >>> pprint(vlan) >>> >>> # Get Image >>> images = driver.list_images(location=location) >>> image = images[0] >>> >>> # Create node using vlan instead of private IPv4 >>> node = driver.create_node(name='test_server_01', image=image, >>> auth=root_pw, >>> ex_description='test2 node', >>> ex_network_domain=my_network_domain, >>> ex_primary_nic_vlan=vlan, >>> ex_is_started=False) >>> >>> # Option: Create node using private IPv4 instead of vlan >>> # node = driver.create_node(name='test_server_02', image=image, >>> # auth=root_pw, >>> # ex_description='test2 node', >>> # ex_network_domain=my_network_domain, >>> # ex_primary_nic_private_ipv4='10.1.1.7', >>> # ex_is_started=False) >>> >>> # Option: Create node using by specifying Network Adapter >>> # node = driver.create_node(name='test_server_03', image=image, >>> # auth=root_pw, >>> # ex_description='test2 node', >>> # ex_network_domain=my_network_domain, >>> # ex_primary_nic_vlan=vlan, >>> # ex_primary_nic_network_adapter='E1000', >>> # ex_is_started=False) >>>
- Parameters
name (
str
) – (required) String with a name for this new nodeimage (
NodeImage
orstr
) – (required) OS Image to boot on node.auth (
NodeAuthPassword
orstr
orNone
) – Initial authentication information for the node. (If this is a customer LINUX image auth will be ignored)ex_description (
str
) – (optional) description for this nodeex_network_domain (
DimensionDataNetworkDomain
orstr
) – (required) Network Domain or Network Domain ID to create the nodeex_primary_nic_private_ipv4 (:
str
) – Provide private IPv4. Ignore if ex_primary_nic_vlan is provided. Use one or the other. Not both.ex_primary_nic_vlan – Provide VLAN for the node if ex_primary_nic_private_ipv4 NOT provided. One or the other. Not both.
ex_primary_nic_network_adapter (:
str
) – (Optional) Default value for the Operating System will be used if leave empty. Example: “E1000”.ex_additional_nics (
list
of :class:’DimensionDataNic’ orstr
) – (optional) List :class:’DimensionDataNic’ or Noneex_memory_gb (
int
) – (optional) The amount of memory in GB for the server Can be used to override the memory value inherited from the source Server Image.ex_cpu_specification (
DimensionDataServerCpuSpecification
) – (optional) The spec of CPU to deployex_is_started (
bool
) – (required) Start server after creation. Default is set to true.ex_primary_dns (
str
) – (Optional) The node’s primary DNSex_secondary_dns (
str
) – (Optional) The node’s secondary DNSex_ipv4_gateway (
str
) – (Optional) IPv4 address in dot-decimal notation, which will be used as the Primary NIC gateway instead of the default gateway assigned by the system. If ipv4Gateway is provided it does not have to be on the VLAN of the Primary NIC but MUST be reachable or the Guest OS will not be configured correctly.ex_disks (List or tuple of :class:'DimensionDataServerDisk`) – (optional) Dimensiondata disks. Optional disk elements can be used to define the disk speed that each disk on the Server; inherited from the source Server Image will be deployed to. It is not necessary to include a diskelement for every disk; only those that you wish to set a disk speed value for. Note that scsiId 7 cannot be used.Up to 13 disks can be present in addition to the required OS disk on SCSI ID 0. Refer to https://docs.mcp-services.net/x/UwIu for disk
ex_microsoft_time_zone (str`) – (optional) For use with Microsoft Windows source Server Images only. For the exact value to use please refer to the table of time zone indexes in the following Microsoft Technet documentation. If none is supplied, the default time zone for the data center geographic region will be used.
- Returns
The newly created
Node
.- Return type
Node
- destroy_node(node)[source]¶
Deletes a node, node must be stopped before deletion
- Parameters
node (
Node
) – The node to delete- Return 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 toamount (
int
) – The amount of storage to add, in GBspeed (
str
) – The disk speed typescsi_id (
int
) – The target SCSI ID (optional)
- Return type
bool
- 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
- 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 usedvlan (
DimensionDataVlan
) – VLAN to attach the node to (required unless private_ipv4)private_ipv4 (
str
) – Private nic IPv4 Address (required unless vlan)
- Return type
bool
- 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 reportend_date (
str
in format YYYY-MM-DD) – End date for the report
- Return type
list
oflist
- 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 reportend_date (
str
in format YYYY-MM-DD) – End date for the reportlocation (
NodeLocation
orstr
) – Filters the node list to nodes that are located in this location
- Return type
list
oflist
- ex_change_nic_network_adapter(nic_id, network_adapter_name)[source]¶
Change network adapter of a NIC on a cloud server
- Parameters
nic_id (:
str
) – Nic IDnetwork_adapter_name (:
str
) – Network adapter name
- Return type
bool
- ex_change_storage_size(node, disk_id, size)[source]¶
Change the size of a disk
- Parameters
node (
Node
) – The server to change the disk ofdisk_id (
str
) – The ID of the disk to resizesize (
int
) – The disk size in GB
- Return type
bool
- 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 ofdisk_id (
str
) – The ID of the disk to changespeed (
str
) – The disk speed type e.g. STANDARD
- Return type
bool
- 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, cluster_id=None, is_guest_Os_Customization=None, tag_key_id=None, tag_value=None)[source]¶
Clone a server into a customer image.
- Parameters
node (
Node
) – The server to cloneimage_name (
str
) – The name of the clone imagedescription (
str
) – The description of the image
- Return type
bool
- 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 for- Return 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 rulerule (
DimensionDataFirewallRule
) – The rule in which to createposition (
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
- ex_create_ip_address_list(ex_network_domain, name, description, ip_version, ip_address_collection, child_ip_address_list=None)[source]¶
Create IP Address List. IP Address list.
>>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.providers import get_driver >>> from libcloud.common.dimensiondata import DimensionDataIpAddress >>> import libcloud.security >>> >>> # Get dimension data driver >>> libcloud.security.VERIFY_SSL_CERT = True >>> cls = get_driver(Provider.DIMENSIONDATA) >>> driver = cls('myusername','mypassword', region='dd-au') >>> >>> # Get location >>> location = driver.ex_get_location_by_id(id='AU9') >>> >>> # Get network domain by location >>> networkDomainName = "Baas QA" >>> network_domains = driver.ex_list_network_domains(location=location) >>> my_network_domain = [d for d in network_domains if d.name == networkDomainName][0] >>> >>> # IP Address collection >>> ipAddress_1 = DimensionDataIpAddress(begin='190.2.2.100') >>> ipAddress_2 = DimensionDataIpAddress(begin='190.2.2.106', end='190.2.2.108') >>> ipAddress_3 = DimensionDataIpAddress(begin='190.2.2.0', prefix_size='24') >>> ip_address_collection = [ipAddress_1, ipAddress_2, ipAddress_3] >>> >>> # Create IPAddressList >>> result = driver.ex_create_ip_address_list( >>> ex_network_domain=my_network_domain, >>> name='My_IP_AddressList_2', >>> ip_version='IPV4', >>> description='Test only', >>> ip_address_collection=ip_address_collection, >>> child_ip_address_list='08468e26-eeb3-4c3d-8ff2-5351fa6d8a04' >>> ) >>> >>> pprint(result)
- Parameters
ex_network_domain (
DimensionDataNetworkDomain
or ‘str’) – The network domain or network domain IDname (:
str
) – IP Address List Name (required)description (:
str
) – IP Address List Description (optional)ip_version (:
str
) – IP Version of ip address (required)ip_address_collection (:
str
) – List of IP Address. At least one ipAddress element or one childIpAddressListId element must be provided.child_ip_address_list (:class:’DimensionDataChildIpAddressList` or str`) – Child IP Address List or id to be included in this IP Address List. At least one ipAddress or one childIpAddressListId must be provided.
- Returns
a list of DimensionDataIpAddressList objects
- Return type
list
ofDimensionDataIpAddressList
- 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 tointernal_ip (
str
) – The IPv4 address internallyexternal_ip (
str
) – The IPv4 address externally
- Return type
DimensionDataNatRule
- 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 networkdescription (
str
) – Additional description of the network
- Returns
A new instance of DimensionDataNetwork
- Return type
Instance of
DimensionDataNetwork
- 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 listname (
str
) – The name of the network domain to createservice_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
- ex_create_node_uncustomized(name, image, ex_network_domain, ex_is_started=True, ex_description=None, ex_cluster_id=None, ex_cpu_specification=None, ex_memory_gb=None, ex_primary_nic_private_ipv4=None, ex_primary_nic_vlan=None, ex_primary_nic_network_adapter=None, ex_additional_nics=None, ex_disks=None, ex_tagid_value_pairs=None, ex_tagname_value_pairs=None)[source]¶
This MCP 2.0 only function deploys a new Cloud Server from a CloudControl compatible Server Image, which does not utilize VMware Guest OS Customization process.
Create Node in MCP2 Data Center
- Parameters
name (
str
) – (required) String with a name for this new nodeimage (
NodeImage
orstr
) – (UUID of the Server Image being used as the target for the new Server deployment. The source Server Image (OS Image or Customer Image) must have osCustomization set to true. See Get/List OS Image(s) and Get/List Customer Image(s).ex_network_domain (
DimensionDataNetworkDomain
orstr
) – (required) Network Domain or Network Domain ID to create the nodeex_description (
str
) – (optional) description for this nodeex_cluster_id – (optional) For multiple cluster
environments, it is possible to set a destination cluster for the new Customer Image. Note that performance of this function is optimal when either the Server cluster and destination are the same or when shared data storage is in place for the multiple clusters. :type ex_cluster_id:
str
- Parameters
ex_primary_nic_private_ipv4 (:
str
) – Provide private IPv4. Ignore if ex_primary_nic_vlan is provided. Use one or the other. Not both.ex_primary_nic_vlan – Provide VLAN for the node if ex_primary_nic_private_ipv4 NOT provided. One or the other. Not both.
ex_primary_nic_network_adapter (:
str
) – (Optional) Default value for the Operating System will be used if leave empty. Example: “E1000”.ex_additional_nics (
list
of :class:’DimensionDataNic’ orstr
) – (optional) List :class:’DimensionDataNic’ or Noneex_memory_gb (
int
) – (optional) The amount of memory in GB for the server Can be used to override the memory value inherited from the source Server Image.ex_cpu_specification (
DimensionDataServerCpuSpecification
) – (optional) The spec of CPU to deployex_is_started (
bool
) – (required) Start server after creation. Default is set to true.ex_disks (List or tuple of :class:'DimensionDataServerDisk`) – (optional) Dimensiondata disks. Optional disk elements can be used to define the disk speed that each disk on the Server; inherited from the source Server Image will be deployed to. It is not necessary to include a diskelement for every disk; only those that you wish to set a disk speed value for. Note that scsiId 7 cannot be used.Up to 13 disks can be present in addition to the required OS disk on SCSI ID 0. Refer to https://docs.mcp-services.net/x/UwIu for disk
ex_tagid_value_pairs – (Optional) up to 10 tag elements may be provided. A combination of tagById and tag name cannot be supplied in the same request. Note: ex_tagid_value_pairs and ex_tagname_value_pairs is mutually exclusive. Use one or other.
ex_tagname_value_pairs (
dict`
.) – (Optional) up to 10 tag elements may be provided. A combination of tagById and tag name cannot be supplied in the same request. Note: ex_tagid_value_pairs and ex_tagname_value_pairs is mutually exclusive. Use one or other.
- Returns
The newly created
Node
.- Return type
Node
- ex_create_portlist(ex_network_domain, name, description, port_collection, child_portlist_list=None)[source]¶
Create Port List.
>>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.providers import get_driver >>> from libcloud.common.dimensiondata import DimensionDataPort >>> import libcloud.security >>> >>> # Get dimension data driver >>> libcloud.security.VERIFY_SSL_CERT = True >>> cls = get_driver(Provider.DIMENSIONDATA) >>> driver = cls('myusername','mypassword', region='dd-au') >>> >>> # Get location >>> location = driver.ex_get_location_by_id(id='AU9') >>> >>> # Get network domain by location >>> networkDomainName = "Baas QA" >>> network_domains = driver.ex_list_network_domains(location=location) >>> my_network_domain = [d for d in network_domains if d.name == networkDomainName][0] >>> >>> # Port Collection >>> port_1 = DimensionDataPort(begin='1000') >>> port_2 = DimensionDataPort(begin='1001', end='1003') >>> port_collection = [port_1, port_2] >>> >>> # Create Port List >>> new_portlist = driver.ex_create_portlist( >>> ex_network_domain=my_network_domain, >>> name='MyPortListX', >>> description="Test only", >>> port_collection=port_collection, >>> child_portlist_list={'a9cd4984-6ff5-4f93-89ff-8618ab642bb9'} >>> ) >>> pprint(new_portlist)
- Parameters
ex_network_domain (:
str
) – (required) The network domain in which to create PortList. Provide networkdomain object or its id.name (:
str
) – Port List Namedescription (:
str
) – IP Address List Descriptionport_collection (:
str
) – List of Port Addresschild_portlist_list (:
str
or ‘’list of :class:’DimensionDataChildPortList’) – List of Child Portlist to be included in this Port List
- Returns
result of operation
- Return type
bool
- 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 keyvalue_required (
bool
) – If a value is required for the tag Tags themselves can be just a tag, or be a key/value pairdisplay_on_report (
bool
) – Should this key show up on the usage reports
- Return type
bool
- 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 toname (
str
) – The name of the VLAN to createprivate_ipv4_base_address (
str
) – The base IPv4 address e.g. 192.168.1.0description (
str
) – An additional description of the VLANprivate_ipv4_prefix_size (
int
) – The size of the IPv4 address space, e.g 24
- Returns
an instance of DimensionDataVlan
- Return type
DimensionDataVlan
- ex_delete_anti_affinity_rule(anti_affinity_rule)[source]¶
Remove anti affinity rule
- Parameters
anti_affinity_rule (
DimensionDataAntiAffinityRule
orstr
) – The anti affinity rule to delete- Return type
bool
- ex_delete_firewall_rule(rule)[source]¶
Delete a firewall rule
- Parameters
rule (
DimensionDataFirewallRule
) – The rule to delete- Return type
bool
- ex_delete_ip_address_list(ex_ip_address_list)[source]¶
Delete IP Address List by ID
>>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.providers import get_driver >>> import libcloud.security >>> >>> # Get dimension data driver >>> libcloud.security.VERIFY_SSL_CERT = True >>> cls = get_driver(Provider.DIMENSIONDATA) >>> driver = cls('myusername','mypassword', region='dd-au') >>> >>> ip_address_list_id = '5e7c323f-c885-4e4b-9a27-94c44217dbd3' >>> result = driver.ex_delete_ip_address_list(ip_address_list_id) >>> pprint(result)
- Parameters
ex_ip_address_list (:class:’DimensionDataIpAddressList’ or
str
) – IP Address List object or IP Address List ID (required)- Return type
bool
- ex_delete_nat_rule(rule)[source]¶
Delete an existing NAT rule
- Parameters
rule (
DimensionDataNatRule
) – The rule to delete- Return type
bool
- ex_delete_network(network)[source]¶
Delete a network from an MCP 1 data center
- Parameters
network (
DimensionDataNetwork
) – The network to delete- Return type
bool
- ex_delete_network_domain(network_domain)[source]¶
Delete a network domain
- Parameters
network_domain (
DimensionDataNetworkDomain
) – The network domain to delete- Return type
bool
- ex_delete_portlist(ex_portlist)[source]¶
Delete Port List
>>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.providers import get_driver >>> import libcloud.security >>> >>> # Get dimension data driver >>> libcloud.security.VERIFY_SSL_CERT = True >>> cls = get_driver(Provider.DIMENSIONDATA) >>> driver = cls('myusername','mypassword', region='dd-au') >>> >>> # Delete Port List >>> portlist_id = '157531ce-77d4-493c-866b-d3d3fc4a912a' >>> response = driver.ex_delete_portlist(portlist_id) >>> pprint(response)
- Parameters
ex_portlist (:
str
or :class:’DimensionDataPortList’) – Port List to be deleted- Return type
bool
- ex_delete_vlan(vlan)[source]¶
Deletes an existing VLAN
- Parameters
vlan (
DimensionDataNetworkDomain
) – The VLAN to delete- Return 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 remove- Return 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 reportend_date (
str
in format YYYY-MM-DD) – End date for the report
- Return type
list
oflist
- ex_disable_monitoring(node)[source]¶
Disables cloud monitoring for a node
- Parameters
node (
Node
) – The node to stop monitoring- Return type
bool
- ex_edit_firewall_rule(rule, position, relative_rule_for_position=None)[source]¶
Edit a firewall rule
>>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.providers import get_driver >>> import libcloud.security >>> >>> # Get dimension data driver >>> libcloud.security.VERIFY_SSL_CERT = True >>> cls = get_driver(Provider.DIMENSIONDATA) >>> driver = cls('myusername','mypassword', region='dd-au') >>> >>> # Get location >>> location = driver.ex_get_location_by_id(id='AU9') >>> >>> # Get network domain by location >>> networkDomainName = "Baas QA" >>> network_domains = driver.ex_list_network_domains(location=location) >>> my_network_domain = [d for d in network_domains if d.name == networkDomainName][0] >>> >>> >>> # List firewall rules >>> firewall_rules = driver.ex_list_firewall_rules(my_network_domain) >>> >>> # Get Firewall Rule by name >>> pprint("List specific firewall rule by name") >>> fire_rule_under_test = (list(filter(lambda x: x.name == 'My_New_Firewall_Rule', firewall_rules))[0]) >>> pprint(fire_rule_under_test.source) >>> pprint(fire_rule_under_test.destination) >>> >>> # Edit Firewall >>> fire_rule_under_test.destination.address_list_id = '5e7c323f-c885-4e4b-9a27-94c44217dbd3' >>> fire_rule_under_test.destination.port_list_id = 'b6557c5a-45fa-4138-89bd-8fe68392691b' >>> result = driver.ex_edit_firewall_rule(fire_rule_under_test, 'LAST') >>> pprint(result)
- Parameters
rule (
DimensionDataFirewallRule
) – (required) The rule in which to createposition (
str
) – (required) There are two types of positions with position_relative_to_rule arg and without it With: ‘BEFORE’ or ‘AFTER’ Without: ‘FIRST’ or ‘LAST’relative_rule_for_position (
DimensionDataFirewallRule
orstr
) – (optional) The rule or rule name in which to decide the relative rule for positioning.
- Return type
bool
- ex_edit_ip_address_list(ex_ip_address_list, description, ip_address_collection, child_ip_address_lists=None)[source]¶
Edit IP Address List. IP Address list.
>>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.providers import get_driver >>> from libcloud.common.dimensiondata import DimensionDataIpAddress >>> import libcloud.security >>> >>> # Get dimension data driver >>> libcloud.security.VERIFY_SSL_CERT = True >>> cls = get_driver(Provider.DIMENSIONDATA) >>> driver = cls('myusername','mypassword', region='dd-au') >>> >>> # IP Address collection >>> ipAddress_1 = DimensionDataIpAddress(begin='190.2.2.100') >>> ipAddress_2 = DimensionDataIpAddress(begin='190.2.2.106', >>> end='190.2.2.108') >>> ipAddress_3 = DimensionDataIpAddress( >>> begin='190.2.2.0', prefix_size='24') >>> ip_address_collection = [ipAddress_1, ipAddress_2, ipAddress_3] >>> >>> # Edit IP Address List >>> ip_address_list_id = '5e7c323f-c885-4e4b-9a27-94c44217dbd3' >>> result = driver.ex_edit_ip_address_list( >>> ex_ip_address_list=ip_address_list_id, >>> description="Edit Test", >>> ip_address_collection=ip_address_collection, >>> child_ip_address_lists=None >>> ) >>> pprint(result)
- Parameters
ex_ip_address_list (:class:’DimensionDataIpAddressList’ or
str
) – (required) IpAddressList object or IpAddressList IDdescription (:
str
) – IP Address List Descriptionip_address_collection (''list'' of :class:'DimensionDataIpAddressList') – List of IP Address
child_ip_address_lists (
list
of :class:’DimensionDataChildIpAddressList’ orstr
) – Child IP Address List or id to be included in this IP Address List
- Returns
a list of DimensionDataIpAddressList objects
- Return type
list
ofDimensionDataIpAddressList
- ex_edit_portlist(ex_portlist, description, port_collection, child_portlist_list=None)[source]¶
Edit Port List.
>>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.providers import get_driver >>> from libcloud.common.dimensiondata import DimensionDataPort >>> import libcloud.security >>> >>> # Get dimension data driver >>> libcloud.security.VERIFY_SSL_CERT = True >>> cls = get_driver(Provider.DIMENSIONDATA) >>> driver = cls('myusername','mypassword', region='dd-au') >>> >>> # Port Collection >>> port_1 = DimensionDataPort(begin='4200') >>> port_2 = DimensionDataPort(begin='4201', end='4210') >>> port_collection = [port_1, port_2] >>> >>> # Edit Port List >>> editPortlist = driver.ex_get_portlist( '27dd8c66-80ff-496b-9f54-2a3da2fe679e') >>> >>> result = driver.ex_edit_portlist( >>> ex_portlist=editPortlist.id, >>> description="Make Changes in portlist", >>> port_collection=port_collection, >>> child_portlist_list={'a9cd4984-6ff5-4f93-89ff-8618ab642bb9'} >>> ) >>> pprint(result)
- Parameters
ex_portlist (:
str
or :class:’DimensionDataPortList’) – Port List to be edited (required)description (:
str
) – Port List Descriptionport_collection (:
str
) – List of Portschild_portlist_list (:
list
of :class’DimensionDataChildPortList’ or ‘’str’’) – Child PortList to be included in this IP Address List
- Returns
a list of DimensionDataPortList objects
- Return type
list
ofDimensionDataPortList
- ex_enable_monitoring(node, service_plan='ESSENTIALS')[source]¶
Enables cloud monitoring on a node
- Parameters
node (
Node
) – The node to monitorservice_plan (
str
) – The service plan, one of ESSENTIALS or ADVANCED
- Return type
bool
- ex_exchange_nic_vlans(nic_id_1, nic_id_2)[source]¶
Exchange NIC Vlans
- Parameters
nic_id_1 (:
str
) – Nic ID 1nic_id_2 (:
str
) – Nic ID 2
- Return type
bool
- 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 update- Returns
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 image- Return 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 image- Return 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 image- Return type
NodeImage
- ex_get_ip_address_list(ex_network_domain, ex_ip_address_list_name)[source]¶
Get IP Address List by name in network domain specified
>>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.providers import get_driver >>> import libcloud.security >>> >>> # Get dimension data driver >>> libcloud.security.VERIFY_SSL_CERT = True >>> cls = get_driver(Provider.DIMENSIONDATA) >>> driver = cls('myusername','mypassword', region='dd-au') >>> >>> # Get location >>> location = driver.ex_get_location_by_id(id='AU9') >>> >>> # Get network domain by location >>> networkDomainName = "Baas QA" >>> network_domains = driver.ex_list_network_domains(location=location) >>> my_network_domain = [d for d in network_domains if d.name == networkDomainName][0] >>> >>> # Get IP Address List by Name >>> ipaddresslist_list_by_name = driver.ex_get_ip_address_list( >>> ex_network_domain=my_network_domain, >>> ex_ip_address_list_name='My_IP_AddressList_1') >>> pprint(ipaddresslist_list_by_name)
- Parameters
ex_network_domain (
DimensionDataNetworkDomain
or ‘str’) – (required) The network domain or network domain ID in which ipaddresslist resides.ex_ip_address_list_name (:
str
) – (required) Get ‘IP Address List’ by name
- Returns
a list of DimensionDataIpAddressList objects
- Return type
list
ofDimensionDataIpAddressList
- ex_get_location_by_id(id)[source]¶
Get location by ID.
- Parameters
id (
str
) – ID of the node location which should be used- Return 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 torule_id (
str
) – The ID of the NAT rule to fetch
- Return type
DimensionDataNatRule
- 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 domain- Return type
DimensionDataNetworkDomain
- ex_get_portlist(ex_portlist_id)[source]¶
Get Port List
>>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.providers import get_driver >>> import libcloud.security >>> >>> # Get dimension data driver >>> libcloud.security.VERIFY_SSL_CERT = True >>> cls = get_driver(Provider.DIMENSIONDATA) >>> driver = cls('myusername','mypassword', region='dd-au') >>> >>> # Get specific portlist by ID >>> portlist_id = '27dd8c66-80ff-496b-9f54-2a3da2fe679e' >>> portlist = driver.ex_get_portlist(portlist_id) >>> pprint(portlist)
- Parameters
ex_portlist_id (
DimensionDataNetworkDomain
or ‘str’) – The ex_port_list or ex_port_list ID- Returns
DimensionDataPortList object
- Return type
DimensionDataPort
- 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 VLAN- Returns
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 requirednetwork_domain (
DimensionDataNetworkDomain
orstr
) – The network domain to list anti affinity rules One of network, network_domain, or node is requirednode (
Node
orstr
) – The node to list anti affinity rules for One of network, netwok_domain, or node is requiredfilter_id (
str
) – This will allow you to filter the rules by this node id
- Return type
list
ofDimensionDataAntiAffinityRule
- ex_list_customer_images(location=None)[source]¶
Return a list of customer imported images
- Parameters
location (
NodeLocation
orstr
) – The target location- Return type
list
ofNodeImage
- ex_list_ip_address_list(ex_network_domain)[source]¶
List IP Address List by network domain ID specified
>>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.providers import get_driver >>> import libcloud.security >>> >>> # Get dimension data driver >>> libcloud.security.VERIFY_SSL_CERT = True >>> cls = get_driver(Provider.DIMENSIONDATA) >>> driver = cls('myusername','mypassword', region='dd-au') >>> >>> # Get location >>> location = driver.ex_get_location_by_id(id='AU9') >>> >>> # Get network domain by location >>> networkDomainName = "Baas QA" >>> network_domains = driver.ex_list_network_domains(location=location) >>> my_network_domain = [d for d in network_domains if d.name == networkDomainName][0] >>> >>> # List IP Address List of network domain >>> ipaddresslist_list = driver.ex_list_ip_address_list( >>> ex_network_domain=my_network_domain) >>> pprint(ipaddresslist_list)
- Parameters
ex_network_domain (
DimensionDataNetworkDomain
or ‘str’) – The network domain or network domain ID- Returns
a list of DimensionDataIpAddressList objects
- Return type
list
ofDimensionDataIpAddressList
- ex_list_nat_rules(network_domain)[source]¶
Get NAT rules for the network domain
- Parameters
network_domain (
DimensionDataNetworkDomain
) – The network domain the rules belongs to- Return 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 domain.
for your organization. The response includes the location of each network :param location: Only network domains in the location (optional) :type location:
NodeLocation
orstr
- Parameters
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
- 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 location- Returns
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 locationname – 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 addressipv4 (
str
) – Filters the node list to nodes that have this ipv4 addressvlan (
DimensionDataVlan
orstr
) – Filters the node list to nodes that are in this VLANimage (
NodeImage
orstr
) – Filters the node list to nodes that have this imagedeployed (
bool
) – Filters the node list to nodes that are deployed or notstarted (
bool
) – Filters the node list to nodes that are started or notstate (
str
) – Filters the node list to nodes that are in this statenetwork (
DimensionDataNetwork
orstr
) – Filters the node list to nodes in this networknetwork_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
- ex_list_portlist(ex_network_domain)[source]¶
List Portlist by network domain ID specified
>>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.providers import get_driver >>> import libcloud.security >>> >>> # Get dimension data driver >>> libcloud.security.VERIFY_SSL_CERT = True >>> cls = get_driver(Provider.DIMENSIONDATA) >>> driver = cls('myusername','mypassword', region='dd-au') >>> >>> # Get location >>> location = driver.ex_get_location_by_id(id='AU9') >>> >>> # Get network domain by location >>> networkDomainName = "Baas QA" >>> network_domains = driver.ex_list_network_domains(location=location) >>> my_network_domain = [d for d in network_domains if d.name == >>> networkDomainName][0] >>> >>> # List portlist >>> portLists = driver.ex_list_portlist( >>> ex_network_domain=my_network_domain) >>> pprint(portLists) >>>
- Parameters
ex_network_domain (
DimensionDataNetworkDomain
or ‘str’) – The network domain or network domain ID- Returns
a list of DimensionDataPortList objects
- Return type
list
ofDimensionDataPortList
- 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 keyname (
str
) – Filter the list to the name of the tag keyvalue_required (
bool
) – Filter the list to if a value is required for a tag keydisplay_on_report (
bool
) – Filter the list to if the tag key should show up on usage reports
- Return type
list
ofDimensionDataTagKey
- ex_list_tags(asset_id=None, asset_type=None, location=None, tag_key_name=None, tag_key_id=None, value=None, value_required=None, display_on_report=None)[source]¶
List tags in the Dimension Data Cloud
- Parameters
asset_id (
str
) – Filter the list by asset idasset_type (
str
) – Filter the list by asset typelocation (:class:
NodeLocation
orstr
) – Filter the list by the assets locationtag_key_name (
str
) – Filter the list by a tag key nametag_key_id (
str
) – Filter the list by a tag key idvalue (
str
) – Filter the list by a tag valuevalue_required (
bool
) – Filter the list to if a value is required for a tagdisplay_on_report (
bool
) – Filter the list to if the tag should show up on usage reports
- Return type
list
ofDimensionDataTag
- 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
- 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 keydescription (
str
) – Set to modify the description of the tag keyvalue_required (
bool
) – Set to modify if a value is required for the tag keydisplay_on_report (
bool
) – Set to modify if this tag key should display on the usage reports
- Return type
bool
- 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 used- Return 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 changememory_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
- ex_remove_storage(disk_id)[source]¶
Remove storage from a node
- Parameters
node (
Node
) – The server to add storage todisk_id (
str
) – The ID of the disk to remove
- Return type
bool
- ex_remove_storage_from_node(node, scsi_id)[source]¶
Remove storage from a node
- Parameters
node (
Node
) – The server to add storage toscsi_id (
str
) – The ID of the disk to remove
- Return type
bool
- 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
- 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 renamenew_name (
str
) – The new name of the network
- Return type
bool
- 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 used- Return 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 deletestate (
bool
) – The desired state enabled (True) or disabled (False)
- Return 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 reportend_date (
str
in format YYYY-MM-DD) – End date for the report
- Return type
list
oflist
- 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 reportend_date (
str
in format YYYY-MM-DD) – End date for the report
- Return type
list
oflist
- ex_update_monitoring_plan(node, service_plan='ESSENTIALS')[source]¶
Updates the service plan on a node with monitoring
- Parameters
node (
Node
) – The node to monitorservice_plan (
str
) – The service plan, one of ESSENTIALS or ADVANCED
- Return type
bool
- ex_update_network_domain(network_domain)[source]¶
Update the properties of a network domain
- Parameters
network_domain (
DimensionDataNetworkDomain
) – The network domain with updated properties- Returns
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 usedname (
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
- ex_update_vlan(vlan)[source]¶
Updates the properties of the given VLAN Only name and description are updated
- Parameters
vlan (
DimensionDataNetworkDomain
) – The VLAN to update- Returns
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 used- Return type
bool
- ex_wait_for_state(state, func, poll_interval=2, timeout=60, *args, **kwargs)[source]¶
Wait for the function which returns a instance with field status to match
Keep polling func until one of the desired states is matched
- Parameters
state (
str
orlist
) – Either the desired state (str) or a list of statesfunc (
function
) – The function to call, e.g. ex_get_vlanpoll_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
- features = {'create_node': ['password']}¶
- List of available features for a driver.
libcloud.compute.base.NodeDriver.create_node()
ssh_key: Supports
NodeAuthSSHKey
as an authentication method for nodes.password: Supports
NodeAuthPassword
as an authentication method for nodes.generates_password: Returns a password attribute on the Node object returned from creation.
- import_image(ovf_package_name, name, cluster_id=None, datacenter_id=None, description=None, is_guest_os_customization=None, tagkey_name_value_dictionaries=None)[source]¶
Import image
- Parameters
ovf_package_name (
str
) – Image OVF package namename (
str
) – Image namecluster_id (
str
) – Provide either cluster_id or datacenter_iddatacenter_id (
str
) – Provide either cluster_id or datacenter_iddescription (
str
) – Optional. Description of imageis_guest_os_customization (
bool
) – Optional. true for NGOC imagetagkey_name_value_dictionaries (dictionaries) – Optional tagkey name value dict
- Returns
Return true if successful
- Return type
bool
- list_images(location=None)[source]¶
List images available
- Note: Currently only returns the default ‘base OS images’
provided by DimensionData. Customer images (snapshots) use ex_list_customer_images
- Parameters
ex_location (
NodeLocation
orstr
) – Filters the node list to nodes that are located in this location- Returns
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 id- Returns
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 location- Returns
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 locationex_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 addressex_ipv4 (
str
) – Filters the node list to nodes that have this ipv4 addressex_vlan (
DimensionDataVlan
orstr
) – Filters the node list to nodes that are in this VLANex_image (
NodeImage
orstr
) – Filters the node list to nodes that have this imageex_deployed (
bool
) – Filters the node list to nodes that are deployed or notex_started (
bool
) – Filters the node list to nodes that are started or notex_state (
str
) – Filters the node list by nodes that are in this stateex_network (
DimensionDataNetwork
orstr
) – Filters the node list to nodes in this networkex_network_domain (
DimensionDataNetworkDomain
orstr
) – Filters the node list to nodes in this network domain
- Returns
a list of Node objects
- Return type
list
ofNode
- 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 reboot- Return type
bool
- selected_region = None¶
- start_node(node)[source]¶
Powers on an existing deployed server
- Parameters
node (
Node
) – Node which should be used- Return type
bool
- stop_node(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 used- Return type
bool
- 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
) – Credentials- Return type
None
- create_node(name, size, image)[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
- 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.
- Return type
KeyPair
object
- 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.
- 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 = {'pending': NodeState.PENDING, 'running': NodeState.RUNNING, 'shutting-down': NodeState.UNKNOWN, 'terminated': NodeState.TERMINATED}¶
- SNAPSHOT_STATE_MAP = {'completed': VolumeSnapshotState.AVAILABLE, 'error': VolumeSnapshotState.ERROR, 'pending': VolumeSnapshotState.CREATING}¶
- VOLUME_STATE_MAP = {'available': StorageVolumeState.AVAILABLE, 'creating': StorageVolumeState.CREATING, 'deleted': StorageVolumeState.DELETED, 'deleting': StorageVolumeState.DELETING, 'error': StorageVolumeState.ERROR, 'error_deleting': StorageVolumeState.ERROR, 'in-use': StorageVolumeState.INUSE}¶
- attach_volume(node, volume, device)[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
- connectionCls¶
alias of
libcloud.compute.drivers.ec2.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 residesimage (
NodeImage
) – Instance of class NodeImagename (
str
) – The name of the new imagedescription (
str
) – The description of the new image
- Returns
Instance of class
NodeImage
- Return type
NodeImage
- country = ''¶
- 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 imageblock_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
- create_key_pair(name)[source]¶
Create a new key pair object.
- Parameters
name (
str
) – Key pair name.- Return type
KeyPair
object
- create_node(name, size, image, location=None, auth=None, ex_keyname=None, ex_userdata=None, ex_security_groups=None, ex_securitygroup=None, ex_security_group_ids=None, ex_metadata=None, ex_mincount=1, ex_maxcount=1, ex_clienttoken=None, ex_blockdevicemappings=None, ex_iamprofile=None, ex_ebs_optimized=None, ex_subnet=None, ex_placement_group=None, ex_assign_public_ip=False, ex_terminate_on_shutdown=False, ex_spot=False, ex_spot_max_price=None)[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 pairex_userdata (
str
) – User dataex_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 nodeex_mincount (
int
) – Minimum number of instances to launchex_maxcount (
int
) – Maximum number of instances to launchex_clienttoken (
str
) – Unique identifier to ensure idempotencyex_blockdevicemappings (
list
ofdict
) –list
ofdict
block device mappings.ex_iam_profile (
str
) – Name or ARN of IAM profileex_ebs_optimized (
bool
) – EBS-Optimized if Trueex_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_spot (
bool
) – If true, ask for a Spot Instance instead of requesting On-Demand.ex_spot_max_price (
float
) – Maximum price to pay for the spot instance. If not specified, the on-demand price will be used.
- create_volume(size, name, location=None, snapshot=None, ex_volume_type='standard', ex_iops=None, ex_encrypted=False, ex_kms_key_id=None, ex_throughput=None)[source]¶
Create a new volume.
- Parameters
size (
int
) – Size of volume in gigabytes (required)name (
str
) – Name of the volume to be createdlocation (
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.ex_iops (
int
) – The number of I/O operations per second (IOPS) that the volume supports. Only used if ex_volume_type is io1, io2 or gp3.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.ex_throughput (
int
) – The throughput to provision for a volume, with a maximum of 1,000 MiB/s. Only used if ex_volume_type is gp3.
- Returns
The newly created volume.
- Return type
StorageVolume
- create_volume_snapshot(volume, name=None, ex_metadata=None)[source]¶
Create snapshot from volume
- Parameters
volume (
StorageVolume
) – Instance ofStorageVolume
name (
str
) – Name of snapshot (optional)ex_metadata (
dict
) – The Key/Value metadata to associate with a snapshot (optional)
- Return type
VolumeSnapshot
- 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
- delete_key_pair(key_pair)[source]¶
Delete an existing key pair.
- Parameters
key_pair (
KeyPair
) – Key pair object.- Return type
bool
- destroy_node(node)[source]¶
Destroy a node.
Depending upon the provider, this may destroy all data associated with the node, including backups.
- Parameters
node (
Node
) – The node to be destroyed- Returns
True if the destroy was successful, False otherwise.
- Return type
bool
- destroy_volume(volume)[source]¶
Destroys a storage volume.
- Parameters
volume (
StorageVolume
) – Volume to be destroyed- Return type
bool
- destroy_volume_snapshot(snapshot)[source]¶
Destroys a snapshot.
- Parameters
snapshot (
VolumeSnapshot
) – The snapshot to delete- Return type
- detach_volume(volume, ex_force=False)[source]¶
Detaches a volume from a node.
- Parameters
volume (
StorageVolume
) – Volume to be detached- 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 instanceelastic_ip (
ElasticIP
) – Elastic IP instancedomain (
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
- 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
- ex_attach_internet_gateway(gateway, network)[source]¶
Attach an Internet gateway to a VPC
- Parameters
gateway (
VPCInternetGateway
) – The gateway to attachnetwork (
EC2Network
) – The VPC network to attach to
- Return type
bool
- ex_attach_network_interface_to_node(network_interface, node, device_index)[source]¶
Attach a network interface to an instance.
- Parameters
network_interface (
EC2NetworkInterface
) – EC2NetworkInterface instancenode (
Node
) – Node instancedevice_index (
int
) – The interface device index
- Returns
String representation of the attachment id. This is required to detach the interface.
- Return type
str
- ex_authorize_security_group(name, from_port, to_port, cidr_ip, protocol='tcp')[source]¶
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 editfrom_port (
str
) – The beginning of the port range to opento_port (
str
) – The end of the port range to opencidr_ip (
str
) – The ip to allow traffic for.protocol (
str
) – tcp/udp/icmp
- Return type
bool
- ex_authorize_security_group_egress(id, from_port, to_port, cidr_ips, group_pairs=None, protocol='tcp')[source]¶
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 editfrom_port (
int
) – The beginning of the port range to opento_port (
int
) – The end of the port range to opencidr_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
- ex_authorize_security_group_ingress(id, from_port, to_port, cidr_ips=None, group_pairs=None, protocol='tcp', description=None)[source]¶
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 editfrom_port (
int
) – The beginning of the port range to opento_port (
int
) – The end of the port range to opencidr_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: To allow access from any system associated with security group sg-47ad482e on your own account
[{‘group_id’: ‘ sg-47ad482e’}]
protocol (
str
) – tcp/udp/icmpdescription (
str
) – description to be added to the rules inserted
- Return type
bool
- ex_authorize_security_group_permissive(name)[source]¶
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 edit- Return 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 instancenew_size (
NodeSize
) – NodeSize instance
- Returns
True on success, False otherwise.
- Return type
bool
- 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 networkname (
str
) – An optional name for the networkinstance_tenancy (
str
) – The allowed tenancy of instances launched into the VPC. Valid values: default/dedicated
- Returns
Dictionary of network properties
- Return type
dict
- 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 instancename (
str
) – Optional name of the interfacedescription (
str
) – Optional description of the network interfaceprivate_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
- ex_create_placement_group(name)[source]¶
Creates a new placement group.
- Parameters
name (
str
) – The name for the new placement group- Return 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.
- ex_create_route_table(network, name=None)[source]¶
Creates 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
- ex_create_subnet(vpc_id, cidr_block, availability_zone, name=None)[source]¶
Creates a network subnet within a VPC.
- Parameters
vpc_id (
str
) – The ID of the VPC that the subnet should be associated withcidr_block (
str
) – The CIDR block assigned to the subnetavailability_zone (
str
) – The availability zone where the subnet should residename (
str
) – An optional name for the network
- Return type
- class
EC2NetworkSubnet
- ex_create_tags(resource, tags)[source]¶
Creates tags for a resource (Node or StorageVolume).
- Parameters
resource (
Node
orStorageVolume
orVolumeSnapshot
) – The resource to be taggedtags (
dict
) – A dictionary or other mapping of strings to strings, associating tag names with tag values.
- Return type
bool
- ex_delete_internet_gateway(gateway)[source]¶
Deletes a VPC Internet gateway.
- Parameters
gateway (
VPCInternetGateway
) – The gateway to delete- Return type
bool
- ex_delete_keypair(keypair)[source]¶
Deletes 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 instance- Return type
bool
- ex_delete_placement_group(name)[source]¶
Deletes a placement group.
- Parameters
name (
str
) – The placement group name- Return 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
- 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]¶
A wrapper method which calls ex_delete_security_group_by_name.
- Parameters
name (
str
) – The name of the security group- Return 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 group- Return 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 group- Return type
bool
- ex_delete_subnet(subnet)[source]¶
Deletes a VPC subnet.
- Parameters
subnet (
EC2NetworkSubnet
) – The subnet to delete- Return type
bool
- ex_delete_tags(resource, tags)[source]¶
Deletes tags from a resource.
- Parameters
resource (
Node
orStorageVolume
) – The resource to be taggedtags (
dict
) – A dictionary or other mapping of strings to strings, specifying the tag names and tag values to be deleted.
- Return type
bool
- ex_describe_addresses(nodes)[source]¶
Returns Elastic IP addresses for all the nodes in the provided list.
- Parameters
nodes (
list
ofNode
) – A list ofNode
instances- Returns
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]¶
Returns a list of Elastic IP Addresses associated with this node.
- Parameters
node (
Node
) – Node instance- Returns
List Elastic IP Addresses attached to this node.
- Return type
list
ofstr
- ex_describe_all_addresses(only_associated=False)[source]¶
Returns all the Elastic IP addresses for this account optionally, returns only addresses associated with nodes.
- Parameters
only_associated (
bool
) – If true, return only the addresses that are associated with an instance.- Returns
List of Elastic IP addresses.
- Return type
list
ofElasticIP
- ex_describe_all_keypairs()[source]¶
Returns 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_import_snapshot_tasks(import_task_id, dry_run=None)[source]¶
Describes your import snapshot tasks. More information can be found at https://goo.gl/CI0MdS.
- Parameters
import_task_id (
str
) – Import task Id for the current Import Snapshot Taskdry_run (
bool
) – Checks whether you have the permission for the action, without actually making the request, and provides an error response.(optional)
- Return type
:class:
DescribeImportSnapshotTasks Object
- 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
- ex_describe_tags(resource)[source]¶
Returns a dictionary of tags for a resource (e.g. Node or StorageVolume).
- Parameters
resource (any resource class, such as
Node,
StorageVolume,
or :class:NodeImage`) – The resource to be used- Returns
A dictionary of Node tags
- Return type
dict
- ex_describe_volumes_modifications(dry_run=False, volume_ids=None, filters=None)[source]¶
Describes one or more of your volume modifications.
- Parameters
dry_run (
bool
) – dry_runvolume_ids (
dict
) – The volume_ids so that the response includes information for only said volumesfilters (
dict
) – The filters so that the response includes information for only certain volumes
- Returns
List of volume modification status objects
- Return type
list
of :class:`VolumeModification
- ex_detach_internet_gateway(gateway, network)[source]¶
Detaches an Internet gateway from a VPC.
- Parameters
gateway (
VPCInternetGateway
) – The gateway to detachnetwork (
EC2Network
) – The VPC network to detach from
- Return type
bool
- 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 interfaceforce (
bool
) – Forces the detachment.
- Returns
True
on successful detachment,False
otherwise.- Return type
bool
- ex_disassociate_address(elastic_ip, domain=None)[source]¶
Disassociates an Elastic IP address using the IP (EC2-Classic) or the association ID (VPC).
- Parameters
elastic_ip (
ElasticIP
) – ElasticIP instancedomain (
str
) – The domain where the IP resides (vpc only)
- Returns
True on success, False otherwise.
- Return type
bool
- 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]¶
Gets console output for the node.
- Parameters
node (
Node
) – Node which should be used- Returns
A dictionary with the following keys: - instance_id (
str
) - timestamp (datetime.datetime
) - last output timestamp - output (str
) - console output- Return type
dict
- ex_get_metadata_for_node(node)[source]¶
Returns the metadata associated with the node.
- Parameters
node (
Node
) – Node instance- Returns
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]¶
Returns a list of
EC2SecurityGroup
objects for the current region.- Parameters
group_ids (
list
) – Returns only groups matching the provided group IDs.group_names – Returns only groups matching the provided group names.
filters (
dict
) – The filters so that the list returned includes information for specific security groups only.
- Return type
list
ofEC2SecurityGroup
- 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 the path of the public key to import.
- Return type
dict
- 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
- ex_import_snapshot(client_data=None, client_token=None, description=None, disk_container=None, dry_run=None, role_name=None)[source]¶
Imports a disk into an EBS snapshot. More information can be found at https://goo.gl/sbXkYA.
- Parameters
client_data (
dict
) – Describes the client specific data (optional)client_token (
str
) – The token to enable idempotency for VM (optional)description (
str
) – The description string for the import snapshot task.(optional)
- :param disk_container:The disk container object for the
import snapshot request.
:type disk_container:
dict
- Parameters
dry_run (
bool
) – Checks whether you have the permission for the action, without actually making the request, and provides an error response.(optional)role_name (
str
) – The name of the role to use when not using the default role, ‘vmimport’.(optional)
- Return type
- class
VolumeSnapshot
- ex_list_availability_zones(only_available=True)[source]¶
Returns 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, returns 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
) – Returns 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 the list returned inclues information for certain gateways only.
- Return type
list
ofVPCInternetGateway
- ex_list_network_interfaces()[source]¶
Returns all network interfaces.
- Returns
List of EC2NetworkInterface instances
- Return type
list
of :class EC2NetworkInterface
- ex_list_networks(network_ids=None, filters=None)[source]¶
Returns a list of
EC2Network
objects for the current region.- Parameters
network_ids (
list
) – Returns 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 list returned includes information for certain networks only.
- Return type
list
ofEC2Network
- ex_list_placement_groups(names=None)[source]¶
A list of placement groups.
- Parameters
names (
list
ofstr
) – Placement Group names- Return type
list
ofEC2PlacementGroup
- ex_list_reserved_nodes()[source]¶
Lists 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
) – Returns 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 list returned includes information for certain route tables only.
- Return type
list
ofEC2RouteTable
- ex_list_security_groups()[source]¶
Lists 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]¶
Returns a list of
EC2NetworkSubnet
objects for the current region.- Parameters
subnet_ids (
list
) – Returns 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 list returned includes information for certain subnets only.
- Return type
list
ofEC2NetworkSubnet
- ex_modify_image_attribute(image, attributes)[source]¶
Modifies image attributes.
- Parameters
image (
NodeImage
) – NodeImage instanceattributes (
dict
) – A dictionary with node attributes
- Returns
True on success, False otherwise.
- Return type
bool
- 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 instanceattributes (
dict
) – Dictionary with node attributes
- Returns
True on success, False otherwise.
- Return type
bool
- ex_modify_snapshot_attribute(snapshot, attributes)[source]¶
Modify Snapshot attributes.
- Parameters
snapshot – VolumeSnapshot instance
attributes (
dict
) – Dictionary with snapshot attributes
- Returns
True on success, False otherwise.
- Return type
bool
- ex_modify_subnet_attribute(subnet, attribute='auto_public_ip', value=False)[source]¶
Modifies a subnet attribute. You can only modify one attribute at a time.
- Parameters
subnet (
EC2NetworkSubnet
) – The subnet to deleteattribute (
str
) – The attribute to set on the subnet; one of:'auto_public_ip'
: Automatically allocate a public IP address when a server is created'auto_ipv6'
: Automatically assign an IPv6 address when a server is createdvalue (
bool
) – The value to set the subnet attribute to (defaults toFalse
)
- Return type
bool
- ex_modify_volume(volume, parameters)[source]¶
Modify volume parameters. A list of valid parameters can be found at https://goo.gl/N0rPEQ
- Parameters
volume (
Volume
) – Volume instanceparameters (
dict
) – Dictionary with updated volume parameters
- Returns
Volume modification status object
- Return type
:class:`VolumeModification
- 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, ena_support=None, billing_products=None, sriov_net_support=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 registereddescription (
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 AMIroot_device_name (
str
) – The device name for the root device Required if registering an EBS-backed AMIblock_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)ena_support (
bool
) – Enable enhanced networking with Elastic Network Adapter for the AMIbilling_products (''list'') – The billing product codes
sriov_net_support (
str
) – Set to “simple” to enable enhanced networking with the Intel 82599 Virtual Function interface
- Return type
NodeImage
- ex_release_address(elastic_ip, domain=None)[source]¶
Releases an Elastic IP address using the IP (EC2-Classic) or using the allocation ID (VPC).
- Parameters
elastic_ip (
ElasticIP
) – Elastic IP instancedomain (
str
) – The domain where the IP resides (vpc only)
- Returns
True on success, False otherwise.
- Return type
bool
- 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.
- 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
A 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 editfrom_port (
int
) – The beginning of the port range to opento_port (
int
) – The end of the port range to opencidr_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
- ex_revoke_security_group_ingress(id, from_port, to_port, cidr_ips=None, group_pairs=None, protocol='tcp')[source]¶
Edits 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 editfrom_port (
int
) – The beginning of the port range to opento_port (
int
) – The end of the port range to opencidr_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
- features = {'create_node': ['ssh_key']}¶
- List of available features for a driver.
libcloud.compute.base.NodeDriver.create_node()
ssh_key: Supports
NodeAuthSSHKey
as an authentication method for nodes.password: Supports
NodeAuthPassword
as an authentication method for nodes.generates_password: Returns a password attribute on the Node object returned from creation.
- get_image(image_id)[source]¶
Gets an image based on an image_id.
- Parameters
image_id (
str
) – Image identifier- Returns
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
- 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.
- Return type
KeyPair
object
- list_images(location=None, ex_image_ids=None, ex_owner=None, ex_executableby=None, ex_filters=None)[source]¶
Lists 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 nameex_executableby (
str
) – Executable byex_filters (
dict
) – Filter by
- Return type
list
ofNodeImage
- list_key_pairs()[source]¶
List all the available key pair objects.
- Return type
list
ofKeyPair
objects
- list_locations()[source]¶
List data centers for a provider
- Returns
list of node location objects
- Return type
list
ofNodeLocation
- list_nodes(ex_node_ids=None, ex_filters=None)[source]¶
Lists 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 list includes information for certain nodes only.
- Return type
list
ofNode
- list_sizes(location=None)[source]¶
List sizes on a provider
- Parameters
location (
NodeLocation
) – The location at which to list sizes- Returns
list of node size objects
- Return type
list
ofNodeSize
- list_snapshots(snapshot=None, owner=None)[source]¶
Describes all snapshots.
- Parameters
snapshot – If provided, only returns snapshot information for the provided snapshot.
owner (
str
) – The owner of the snapshot: self|amazon|ID
- Return type
list
ofVolumeSnapshot
- list_volume_snapshots(volume)[source]¶
List snapshots for a storage volume.
- Return type
list
ofVolumeSnapshot
- list_volumes(node=None, ex_filters=None)[source]¶
List volumes that are attached to a node, if specified and those that satisfy the filters, if specified.
- Parameters
node (
Node
) – The node to which the volumes are attached.ex_filters (
dict
) – The dictionary of additional filters.
- Returns
The list of volumes that match the criteria.
- Return type
list
ofStorageVolume
- path = '/'¶
- reboot_node(node)[source]¶
Reboot a node.
- Parameters
node (
Node
) – The node to be rebooted- Returns
True if the reboot was successful, otherwise False
- Return type
bool
- region_name = ''¶
- signature_version = '2'¶
- class libcloud.compute.drivers.ec2.EC2ImportSnapshotTask(status, snapshotId)[source]¶
Bases:
object
Represents information about a describe_import_snapshot_task.
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.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.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.EC2NodeDriver(key, secret=None, secure=True, host=None, port=None, region='us-east-1', token=None, signature_version=None, **kwargs)[source]¶
Bases:
libcloud.compute.drivers.ec2.BaseEC2NodeDriver
Amazon EC2 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 = {'pending': NodeState.PENDING, 'running': NodeState.RUNNING, 'shutting-down': NodeState.UNKNOWN, 'stopped': NodeState.STOPPED, 'terminated': NodeState.TERMINATED}¶
- connectionCls¶
alias of
libcloud.compute.drivers.ec2.EC2Connection
- name = 'Amazon EC2'¶
- path = '/'¶
- type = 'ec2'¶
- website = 'http://aws.amazon.com/ec2/'¶
- class libcloud.compute.drivers.ec2.EC2NodeLocation(id, name, country, driver, availability_zone)[source]¶
Bases:
libcloud.compute.base.NodeLocation
- Parameters
id (
str
) – Location ID.name (
str
) – Location name.country (
str
) – Location country.driver (
NodeDriver
) – Driver this location belongs to.extra (
dict
) – Optional provided specific attributes associated with this location.
- 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.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.
- 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.
- 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.
- 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.
- 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.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.
- 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
libcloud.compute.drivers.ec2.EucConnection
- list_locations()[source]¶
List data centers for a provider
- Returns
list of node location objects
- Return type
list
ofNodeLocation
- name = 'Eucalyptus'¶
- region_name = 'us-east-1'¶
- signature_version = '2'¶
- website = 'http://www.eucalyptus.com/'¶
- 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.
- 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
libcloud.compute.drivers.ec2.NimbusConnection
- country = 'Private'¶
- ex_create_tags(resource, tags)[source]¶
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'¶
- list_sizes(location=None)[source]¶
List sizes on a provider
- Parameters
location (
NodeLocation
) – The location at which to list sizes- Returns
list of node size objects
- Return type
list
ofNodeSize
- name = 'Nimbus'¶
- region_name = 'nimbus'¶
- signature_version = '2'¶
- type = 'nimbus'¶
- website = 'http://www.nimbusproject.org/'¶
- libcloud.compute.drivers.ec2.OUTSCALE_INC_REGION_DETAILS = {'eu-west-1': {'api_name': 'osc_inc_eu_west_1', 'country': 'FRANCE', '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', 'p2.xlarge', 'p2.8xlarge', 'p2.16xlarge', 'nv1.small', 'nv1.medium', 'nv1.large', 'nv1.xlarge', 'cc1.4xlarge', 'cc2.8xlarge', 'm3.xlarge', 'm3.2xlarge', 'cr1.8xlarge', 'os1.8xlarge']}, 'eu-west-2': {'api_name': 'osc_inc_eu_west_2', 'country': 'FRANCE', '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': {'api_name': 'osc_inc_eu_west_3', 'country': 'FRANCE', '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']}, 'us-east-1': {'api_name': 'osc_inc_us_east_1', 'country': 'USA', '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': {'api_name': 'osc_inc_us_east_2', 'country': 'USA', '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']}}¶
Define the extra dictionary for specific resources
- libcloud.compute.drivers.ec2.OUTSCALE_INSTANCE_TYPES = {'c1.medium': {'bandwidth': None, 'disk': 340, 'id': 'c1.medium', 'name': 'Compute Optimized Medium Instance', 'ram': 1740}, 'c1.xlarge': {'bandwidth': None, 'disk': 1680, 'id': 'c1.xlarge', 'name': 'Compute Optimized Extra Large Instance', 'ram': 7168}, 'c3.2xlarge': {'bandwidth': None, 'disk': 160, 'id': 'c3.2xlarge', 'name': 'Compute Optimized Double Extra Large Instance', 'ram': 15359}, 'c3.4xlarge': {'bandwidth': None, 'disk': 320, 'id': 'c3.4xlarge', 'name': 'Compute Optimized Quadruple Extra Large Instance', 'ram': 30720}, 'c3.8xlarge': {'bandwidth': None, 'disk': 640, 'id': 'c3.8xlarge', 'name': 'Compute Optimized Eight Extra Large Instance', 'ram': 61440}, 'c3.large': {'bandwidth': None, 'disk': 32, 'id': 'c3.large', 'name': 'Compute Optimized Large Instance', 'ram': 3840}, 'c3.xlarge': {'bandwidth': None, 'disk': 80, 'id': 'c3.xlarge', 'name': 'Compute Optimized Extra Large Instance', 'ram': 7168}, 'cc1.4xlarge': {'bandwidth': None, 'disk': 1680, 'id': 'cc1.4xlarge', 'name': 'Cluster Compute Quadruple Extra Large Instance', 'ram': 24576}, 'cc2.8xlarge': {'bandwidth': None, 'disk': 3360, 'id': 'cc2.8xlarge', 'name': 'Cluster Compute Eight Extra Large Instance', 'ram': 65536}, 'cr1.8xlarge': {'bandwidth': None, 'disk': 240, 'id': 'cr1.8xlarge', 'name': 'Memory Optimized Eight Extra Large Instance', 'ram': 249855}, 'g2.2xlarge': {'bandwidth': None, 'disk': 60, 'id': 'g2.2xlarge', 'name': 'GPU Double Extra Large Instance', 'ram': 15360}, 'hi1.xlarge': {'bandwidth': None, 'disk': 1680, 'id': 'hi1.xlarge', 'name': 'High Storage Extra Large Instance', 'ram': 15361}, 'm1.large': {'bandwidth': None, 'disk': 840, 'id': 'm1.large', 'name': 'Standard Large Instance', 'ram': 7680}, 'm1.medium': {'bandwidth': None, 'disk': 420, 'id': 'm1.medium', 'name': 'Standard Medium Instance', 'ram': 3840}, 'm1.small': {'bandwidth': None, 'disk': 150, 'id': 'm1.small', 'name': 'Standard Small Instance', 'ram': 1740}, 'm1.xlarge': {'bandwidth': None, 'disk': 1680, 'id': 'm1.xlarge', 'name': 'Standard Extra Large Instance', 'ram': 15360}, 'm2.2xlarge': {'bandwidth': None, 'disk': 840, 'id': 'm2.2xlarge', 'name': 'High Memory Double Extra Large Instance', 'ram': 35020}, 'm2.4xlarge': {'bandwidth': None, 'disk': 1680, 'id': 'm2.4xlarge', 'name': 'High Memory Quadruple Extra Large Instance', 'ram': 70042}, 'm2.xlarge': {'bandwidth': None, 'disk': 420, 'id': 'm2.xlarge', 'name': 'High Memory Extra Large Instance', 'ram': 17510}, 'm3.2xlarge': {'bandwidth': None, 'disk': 0, 'id': 'm3.2xlarge', 'name': 'High Storage Optimized Double Extra Large Instance', 'ram': 30720}, 'm3.xlarge': {'bandwidth': None, 'disk': 0, 'id': 'm3.xlarge', 'name': 'High Storage Optimized Extra Large Instance', 'ram': 15357}, 'm3s.2xlarge': {'bandwidth': None, 'disk': 0, 'id': 'm3s.2xlarge', 'name': 'High Storage Optimized Double Extra Large Instance', 'ram': 30719}, 'm3s.xlarge': {'bandwidth': None, 'disk': 0, 'id': 'm3s.xlarge', 'name': 'High Storage Optimized Extra Large Instance', 'ram': 15359}, 'nv1.large': {'bandwidth': None, 'disk': 840, 'id': 'nv1.large', 'name': 'GPU Large Instance', 'ram': 7679}, 'nv1.medium': {'bandwidth': None, 'disk': 420, 'id': 'nv1.medium', 'name': 'GPU Medium Instance', 'ram': 3839}, 'nv1.small': {'bandwidth': None, 'disk': 150, 'id': 'nv1.small', 'name': 'GPU Small Instance', 'ram': 1739}, 'nv1.xlarge': {'bandwidth': None, 'disk': 1680, 'id': 'nv1.xlarge', 'name': 'GPU Extra Large Instance', 'ram': 15358}, 'oc1.4xlarge': {'bandwidth': None, 'disk': 1680, 'id': 'oc1.4xlarge', 'name': 'Outscale Quadruple Extra Large Instance', 'ram': 24575}, 'oc2.8xlarge': {'bandwidth': None, 'disk': 3360, 'id': 'oc2.8xlarge', 'name': 'Outscale Eight Extra Large Instance', 'ram': 65535}, 'os1.2xlarge': {'bandwidth': None, 'disk': 60, 'id': 'os1.2xlarge', 'name': 'Memory Optimized, High Storage, Passthrough NIC Double Extra Large Instance', 'ram': 65536}, 'os1.4xlarge': {'bandwidth': None, 'disk': 120, 'id': 'os1.4xlarge', 'name': 'Memory Optimized, High Storage, Passthrough NIC Quadruple Extra Large Instance', 'ram': 131072}, 'os1.8xlarge': {'bandwidth': None, 'disk': 500, 'id': 'os1.8xlarge', 'name': 'Memory Optimized, High Storage, Passthrough NIC Eight Extra Large Instance', 'ram': 249856}, 't1.micro': {'bandwidth': None, 'disk': 0, 'id': 't1.micro', 'name': 'Micro Instance', 'ram': 615}}¶
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.
- 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
- 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 = 'Outscale INC'¶
- type = 'outscale_inc'¶
- 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
- 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 = 'Outscale SAS'¶
- type = 'outscale_sas'¶
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
Initialize user_id and key; set secure to an
int
based on passed value.- add_default_headers(headers)[source]¶
Adds default headers (such as Authorization, X-Foo-Bar) to the passed headers
Should return a dictionary.
- host = ''¶
- port = (80, 443)¶
- responseCls¶
- 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¶
- create_node(name, size, image)[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
- 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/'¶
- 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.
- parse_body()[source]¶
Parse response body.
Override in a provider’s subclass.
- Returns
Parsed body.
- Return type
str
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.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: 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 = {'Running': NodeState.RUNNING, 'Starting': NodeState.PENDING, 'Stopped': NodeState.STOPPED, 'Stopping': NodeState.PENDING}¶
- SNAPSHOT_STATE_MAPPING = {'accomplished': VolumeSnapshotState.AVAILABLE, 'failed': VolumeSnapshotState.ERROR, 'progressing': VolumeSnapshotState.CREATING}¶
- VOLUME_STATE_MAPPING = {'Attaching': StorageVolumeState.ATTACHING, 'Available': StorageVolumeState.AVAILABLE, 'Creating': StorageVolumeState.CREATING, 'Detaching': StorageVolumeState.INUSE, 'In_use': StorageVolumeState.INUSE, 'ReIniting': StorageVolumeState.CREATING}¶
- 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 volumeex_delete_with_instance (
bool
) – if to delete this volume when the instance is deleted.
- connectionCls¶
alias of
libcloud.compute.drivers.ecs.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 regionex_client_token (
str
) – a token generated by client to identify each request.
- 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 imageex_client_token (
str
) – a token generated by client to identify each request.
- 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 typeex_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)
- create_public_ip(instance_id)[source]¶
Create public ip.
- Parameters
instance_id (
str
) – instance id for allocating public ip.
:return public ip :rtype
str
- 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 descriptionex_disk_category (
str
) – disk category for data diskex_client_token (
str
) – a token generated by client to identify each request.
- 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.
- delete_image(node_image)[source]¶
Deletes a node image from a provider.
- Parameters
node_image (
NodeImage
) – Node image object.- Returns
True
if delete_image was successful,False
otherwise.- Return type
bool
- destroy_node(node)[source]¶
Destroy a node.
Depending upon the provider, this may destroy all data associated with the node, including backups.
- Parameters
node (
Node
) – The node to be destroyed- Returns
True if the destroy was successful, False otherwise.
- Return type
bool
- destroy_volume(volume)[source]¶
Destroys a storage volume.
- Parameters
volume (
StorageVolume
) – Volume to be destroyed- Return type
bool
- destroy_volume_snapshot(snapshot)[source]¶
Destroys a snapshot.
- Parameters
snapshot (
VolumeSnapshot
) – The snapshot to delete- Return type
- 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¶
- ex_create_security_group(description=None, client_token=None)[source]¶
Create a new security group.
- Parameters
description (
unicode
) – security group descriptionclient_token (
str
) – a token generated by client to identify each request.
- ex_delete_security_group_by_id(group_id=None)[source]¶
Delete a new security group.
- Parameters
group_id (
str
) – security group id
- ex_join_security_group(node, group_id=None)[source]¶
Join a node into security group.
- Parameters
node (
Node
) – The node to join security groupgroup_id (
str
) – security group id.
- Returns
join operation result.
- Return type
bool
- ex_leave_security_group(node, group_id=None)[source]¶
Leave a node from security group.
- Parameters
node (
Node
) – The node to leave security groupgroup_id (
str
) – security group id.
- Returns
leave operation result.
- Return type
bool
- ex_list_security_group_attributes(group_id=None, nic_type='internet')[source]¶
List security group attributes in the current region.
- Parameters
group_id (
str
) – 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 from- Returns
list of zones
- Return type
list
ofECSZone
- ex_modify_security_group_by_id(group_id=None, name=None, description=None)[source]¶
Modify a new security group. :keyword group_id: id of the security group :type group_id:
str
:keyword name: new name of the security group :type name:unicode
:keyword description: new description of the security group :type description:unicode
- features = {'create_node': ['password']}¶
- List of available features for a driver.
libcloud.compute.base.NodeDriver.create_node()
ssh_key: Supports
NodeAuthSSHKey
as an authentication method for nodes.password: Supports
NodeAuthPassword
as an authentication method for nodes.generates_password: Returns a password attribute on the Node object returned from creation.
- get_image(image_id, ex_region_id=None)[source]¶
Returns a single node image from a provider.
- Parameters
image_id (
str
) – Node to run the task on.
:rtype
NodeImage
: :return: NodeImage instance on success.
- internet_charge_types¶
- 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.
- list_locations()[source]¶
List data centers for a provider
- Returns
list of node location objects
- Return type
list
ofNodeLocation
- 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.
- list_sizes(location=None)[source]¶
List sizes on a provider
- Parameters
location (
NodeLocation
) – The location at which to list sizes- Returns
list of node size objects
- Return type
list
ofNodeSize
- 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.
- 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.
- 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
- start_node(node)[source]¶
Start node to running state.
- Parameters
node (
Node
) – theNode
object to start- Returns
starting operation result.
- Return type
bool
- stop_node(node, ex_force_stop=False)[source]¶
Stop a running node.
- Parameters
node (
Node
) – The node to stopex_force_stop (
bool
) – ifTrue
, stop node force (maybe lose data) otherwise, stop node normally, default toFalse
- Returns
stopping operation result.
- Return type
bool
- website = 'https://www.aliyun.com/product/ecs'¶
- class libcloud.compute.drivers.ecs.ECSSecurityGroup(id, name, description=None, driver=None, vpc_id=None, creation_time=None)[source]¶
Bases:
object
Security group used to control nodes internet and intranet accessibility.
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
- 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 = '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
- 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 = '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
- 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 = 'ElasticHosts (cn-1)'¶
- 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
- 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 = 'elastichosts'¶
- features = {'create_node': ['generates_password']}¶
- List of available features for a driver.
libcloud.compute.base.NodeDriver.create_node()
ssh_key: Supports
NodeAuthSSHKey
as an authentication method for nodes.password: Supports
NodeAuthPassword
as an authentication method for nodes.generates_password: Returns a password attribute on the Node object returned from creation.
- 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
- 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 = '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
- 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 = '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
- 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 = '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
- 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 = '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
- 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 = '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
Initialize user_id and key; set secure to an
int
based on passed value.- add_default_headers(headers)[source]¶
Adds default headers (such as Authorization, X-Foo-Bar) to the passed headers
Should return a dictionary.
- host = None¶
- responseCls¶
alias of
libcloud.compute.drivers.elasticstack.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
libcloud.compute.drivers.elasticstack.ElasticStackBaseConnection
- create_node(name, size, image, smp='auto', nic_model='e1000', vnc_password=None, drive_type='hdd')[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 speednic_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.
- 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.
- destroy_node(node)[source]¶
Destroy a node.
Depending upon the provider, this may destroy all data associated with the node, including backups.
- Parameters
node (
Node
) – The node to be destroyed- Returns
True if the destroy was successful, False otherwise.
- Return type
bool
- ex_destroy_drive(drive_uuid)[source]¶
Deletes a drive
- Parameters
drive_uuid (
str
) – Drive uuid which should be used- Return type
bool
- ex_set_node_configuration(node, **kwargs)[source]¶
Changes the configuration of the running server
- Parameters
node (
Node
) – Node which should be usedkwargs (
dict
) – keyword arguments
- Return type
bool
- ex_shutdown_node(node)[source]¶
Sends the ACPI power-down event
- Parameters
node (
Node
) – Node which should be used- Return type
bool
- features = {'create_node': ['generates_password']}¶
- List of available features for a driver.
libcloud.compute.base.NodeDriver.create_node()
ssh_key: Supports
NodeAuthSSHKey
as an authentication method for nodes.password: Supports
NodeAuthPassword
as an authentication method for nodes.generates_password: Returns a password attribute on the Node object returned from creation.
- list_images(location=None)[source]¶
List images on a provider.
- Parameters
location (
NodeLocation
) – The location at which to list images.- Returns
list of node image objects.
- Return type
list
ofNodeImage
- list_sizes(location=None)[source]¶
List sizes on a provider
- Parameters
location (
NodeLocation
) – The location at which to list sizes- Returns
list of node size objects
- Return type
list
ofNodeSize
- reboot_node(node)[source]¶
Reboot a node.
- Parameters
node (
Node
) – The node to be rebooted- Returns
True if the reboot was successful, otherwise False
- Return type
bool
- website = 'http://www.elasticstack.com'¶
- class libcloud.compute.drivers.elasticstack.ElasticStackNodeSize(id, name, cpu, ram, disk, bandwidth, price, driver)[source]¶
Bases:
libcloud.compute.base.NodeSize
- Parameters
id (
str
) – Size ID.name (
str
) – Size name.ram (
int
) – Amount of memory (in MB) provided by this size.disk (
int
) – Amount of disk storage (in GB) provided by this image.bandwidth (
int
) – Amount of bandiwdth included with this size.price (
float
) – Price (in US dollars) of running this node for an hour.driver (
NodeDriver
) – Driver this size belongs to.extra (
dict
) – Optional provider specific attributes associated with this size.
- 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.
libcloud.compute.drivers.equinixmetal module¶
Equinix Metal Driver
- class libcloud.compute.drivers.equinixmetal.EquinixMetalConnection(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 Equinix Metal driver.
Initialize user_id and key; set secure to an
int
based on passed value.- host = 'api.equinix.com'¶
- responseCls¶
alias of
libcloud.compute.drivers.equinixmetal.EquinixMetalResponse
- class libcloud.compute.drivers.equinixmetal.EquinixMetalNodeDriver(key, project=None)[source]¶
Bases:
libcloud.compute.base.NodeDriver
Equinix Metal NodeDriver
Initialize a NodeDriver for Equinix Metal using the API token and optionally the project (name or id).
If project name is specified we validate it lazily and populate self.project_id during the first access of self.projects variable
- NODE_STATE_MAP = {'active': NodeState.RUNNING, 'deleted': NodeState.TERMINATED, 'deprovisioning': NodeState.TERMINATED, 'failed': NodeState.ERROR, 'inactive': NodeState.STOPPED, 'powering_off': NodeState.REBOOTING, 'powering_on': NodeState.REBOOTING, 'provisioning': NodeState.PENDING, 'queued': NodeState.PENDING, 'rebooting': NodeState.REBOOTING, 'rebuilding': NodeState.PENDING}¶
- attach_volume(node, volume)[source]¶
Attaches volume to node.
- Parameters
node (
Node
) – Node to attach volume to.volume (
StorageVolume
) – Volume to attach.
- Rytpe
bool
- connectionCls¶
alias of
libcloud.compute.drivers.equinixmetal.EquinixMetalConnection
- 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)
- create_node(name, size, image, location, ex_project_id=None, ip_addresses=[], cloud_init=None, disk=None, disk_size=0, **kwargs)[source]¶
Create a node.
- Returns
The newly created node.
- Return type
Node
- create_volume(size, location, plan='storage_1', description='', ex_project_id=None, locked=False, billing_cycle=None, customdata='', snapshot_policies=None, **kwargs)[source]¶
Create a new volume.
- Parameters
size (
int
) – Size of volume in gigabytes (required)location (
NodeLocation
) – Which data center to create a volume in. If empty, undefined behavior will be selected. (optional)
- Returns
The newly created volume.
- Return type
StorageVolume
- create_volume_snapshot(volume, name='')[source]¶
Create a new volume snapshot.
- Parameters
volume (class:StorageVolume) – Volume to create a snapshot for
- Returns
The newly created volume snapshot.
- Return type
VolumeSnapshot
- delete_key_pair(key)[source]¶
Delete an existing SSH key.
- Parameters
key (
KeyPair
) – SSH key (required)
- destroy_node(node)[source]¶
Destroy a node.
Depending upon the provider, this may destroy all data associated with the node, including backups.
- Parameters
node (
Node
) – The node to be destroyed- Returns
True if the destroy was successful, False otherwise.
- Return type
bool
- destroy_volume(volume)[source]¶
Destroys a storage volume.
- Parameters
volume (
StorageVolume
) – Volume to be destroyed- Return type
bool
- destroy_volume_snapshot(snapshot)[source]¶
Delete a volume snapshot
- Parameters
snapshot (class:VolumeSnapshot) – volume snapshot to delete
- Return type
bool
- detach_volume(volume, ex_node=None, ex_attachment_id='')[source]¶
Detaches a volume from a node.
- Parameters
volume (
StorageVolume
) – Volume to be detachedex_attachment_id – Attachment id to be detached, if empty detach all attachments
- Return type
bool
- ex_describe_all_addresses_for_project(ex_project_id, include=None, only_associated=False)[source]¶
Returns all the reserved IP addresses for this project optionally, returns only addresses associated with nodes.
- Parameters
only_associated (
bool
) – If true, return only the addresses that are associated with an instance.- Returns
List of IP addresses.
- Return type
list
ofdict
- ex_modify_volume(volume, description=None, size=None, locked=None, billing_cycle=None, customdata=None)[source]¶
- ex_request_address_reservation(ex_project_id, location_id=None, address_family='global_ipv4', quantity=1, comments='', customdata='')[source]¶
- list_images()[source]¶
List images on a provider.
- Parameters
location (
NodeLocation
) – The location at which to list images.- Returns
list of node image objects.
- Return type
list
ofNodeImage
- list_key_pairs()[source]¶
List all the available SSH keys.
- Returns
Available SSH keys.
- Return type
list
ofKeyPair
objects
- list_locations()[source]¶
List data centers for a provider
- Returns
list of node location objects
- Return type
list
ofNodeLocation
- list_nodes(ex_project_id=None)[source]¶
List all nodes.
- Returns
list of node objects
- Return type
list
ofNode
- list_sizes(ex_project_id=None)[source]¶
List sizes on a provider
- Parameters
location (
NodeLocation
) – The location at which to list sizes- Returns
list of node size objects
- Return type
list
ofNodeSize
- list_volume_snapshots(volume, include='')[source]¶
List snapshots for a volume.
- Parameters
volume (class:StorageVolume) – Volume to list snapshots for
- Returns
List of volume snapshots.
- Return type
list
of :class: VolumeSnapshot
- list_volumes(ex_project_id=None)[source]¶
List storage volumes.
- Return type
list
ofStorageVolume
- name = 'EquinixMetal'¶
- property projects¶
Lazily retrieve projects and set self.project_id variable on initial access to self.projects variable.
- reboot_node(node)[source]¶
Reboot a node.
- Parameters
node (
Node
) – The node to be rebooted- Returns
True if the reboot was successful, otherwise False
- Return type
bool
- start_node(node)[source]¶
Start a node.
- Parameters
node (
Node
) – The node to be started- Returns
True if the start was successful, otherwise False
- Return type
bool
- stop_node(node)[source]¶
Stop a node
- Parameters
node (
Node
) – The node to be stopped.- Returns
True if the stop was successful, otherwise False
- Return type
bool
- type = 'equinixmetal'¶
- website = 'https://metal.equinix.com/'¶
- class libcloud.compute.drivers.equinixmetal.EquinixMetalResponse(response, connection)[source]¶
Bases:
libcloud.common.base.JsonResponse
- Parameters
response (
httplib.HTTPResponse
) – HTTP response object. (optional)connection (
Connection
) – Parent connection object.
- parse_error()[source]¶
Parse the error messages.
Override in a provider’s subclass.
- Returns
Parsed error.
- Return type
str
- success()[source]¶
Determine if our request was successful.
The meaning of this can be arbitrary; did we receive OK status? Did the node get created? Were we authenticated?
- Return type
bool
- Returns
True
orFalse
- valid_response_codes = [<HTTPStatus.OK: 200>, <HTTPStatus.ACCEPTED: 202>, <HTTPStatus.CREATED: 201>, <HTTPStatus.NO_CONTENT: 204>]¶
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.com'¶
- name = 'Exoscale'¶
- path = '/compute'¶
- type = 'exoscale'¶
- website = 'https://www.exoscale.com/'¶
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 tovolume (
StorageVolume
) – The volume to attach.device (
None
) – Not used in this cloud.
- Returns
True if successful
- Return type
bool
- country = 'FR'¶
- create_node(name, size, image, location=None, login=None, password=None, inet_family=4, keypairs=None)[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
- 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 createlocation (
NodeLocation
orNone
) – Location (zone) to create the volume insnapshot (
Snapshot
) – Snapshot to create image from
- Returns
Storage Volume object
- Return type
StorageVolume
- 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 destroy- Returns
True if successful
- Return type
bool
- destroy_volume(volume)[source]¶
Destroy a volume.
- Parameters
volume (
StorageVolume
) – Volume object to destroy- Returns
True if successful
- Return type
bool
- detach_volume(node, volume)[source]¶
Detaches a volume from a node.
- Parameters
node (
Node
) – Node which should be usedvolume (
StorageVolume
) – Volume to be detached
- Return type
bool
- ex_get_node(node_id)[source]¶
Return a Node object based on a node id.
- Parameters
name (
int
) – The ID of the node- Returns
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 volume- Returns
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 useddisk (
GandiDisk
) – Disk which should be used
- Return type
bool
- ex_node_attach_interface(node, iface)[source]¶
Specific method to attach an interface to a node
- Parameters
node (
Node
) – Node which should be usediface (
GandiNetworkInterface
) – Network interface which should be used
- Return type
bool
- ex_node_detach_disk(node, disk)[source]¶
Specific method to detach a disk from a node
- Parameters
node (
Node
) – Node which should be useddisk (
GandiDisk
) – Disk which should be used
- Return type
bool
- ex_node_detach_interface(node, iface)[source]¶
Specific method to detach an interface from a node
- Parameters
node (
Node
) – Node which should be usediface (
GandiNetworkInterface
) – Network interface which should be used
- Return type
bool
- ex_snapshot_disk(disk, name=None)[source]¶
Specific method to make a snapshot of a disk
- Parameters
disk (
GandiDisk
) – Disk which should be usedname (
str
) – Name which should be used
- Return type
bool
- 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 usednew_size (
int
) – New sizenew_name (
str
) – New name
- Return type
bool
- features = {}¶
- List of available features for a driver.
libcloud.compute.base.NodeDriver.create_node()
ssh_key: Supports
NodeAuthSSHKey
as an authentication method for nodes.password: Supports
NodeAuthPassword
as an authentication method for nodes.generates_password: Returns a password attribute on the Node object returned from creation.
- 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
- 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
- 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 rebooted- Returns
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.GCEAcceleratorType(id, name, zone, driver, extra=None)[source]¶
Bases:
libcloud.compute.base.UuidMixin
A GCE AcceleratorType resource.
- 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.GCEBackend(instance_group, balancing_mode='UTILIZATION', max_utilization=None, max_rate=None, max_rate_per_instance=None, capacity_scaler=1, description=None)[source]¶
Bases:
libcloud.compute.base.UuidMixin
A GCE Backend. Only used for creating Backend Services.
- 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 3 reasons: modify request_path for GCE URI.
Implement gce_params functionality described below.
Add request_aggregated_items method for making aggregated API calls.
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">]
Determine authentication type, set up appropriate authentication connection and get initial authentication information.
- 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.auth_type (
str
) – See GoogleAuthType class for list and description of accepted values. If not supplied, auth_type will be guessed based on value of user_id or if the code is running on a GCE instance.credential_file (
str
) – Path to file for caching authentication information.scopes (
list
) – List of OAuth2 scope URLs. The empty default sets read/write access to Compute, Storage, and DNS.
- host = 'www.googleapis.com'¶
- paginated_request(*args, **kwargs)[source]¶
Generic function to create a paginated request to any API call not only aggregated or zone ones as request_aggregated_items.
@inherits:
GoogleBaseConnection.request
- 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
- request_aggregated_items(api_name, zone=None)[source]¶
Perform request(s) to obtain all results from ‘api_name’.
This method will make requests to the aggregated ‘api_name’ until all results are received. It will then, through a helper function, combine all results and return a single ‘items’ dictionary.
- Parameters
api_name (
str
) – Name of API to call. Consult API docs for valid names.zone (
GCEZone
) – Optional zone to use.
- Returns
dict in the format of the API response. format: { ‘items’: {‘key’: {api_name: []}} } ex: { ‘items’: {‘zones/us-central1-a’: {disks: []}} }
- Return type
dict
- responseCls¶
- 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, denied, direction, network, source_ranges, source_tags, priority, source_service_accounts, target_service_accounts, target_tags, target_ranges, driver, extra=None)[source]¶
Bases:
libcloud.compute.base.UuidMixin
A GCE Firewall rule class.
- 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, 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.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.
- add_instances(node_list)[source]¶
Adds a list of instances to the specified instance group. All of the instances in the instance group must be in the same network/subnetwork. Read Adding instances for more information.
Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute
- Parameters
instancegroup (:class:
GCEInstanceGroup
) – The Instance Group where you are adding instances.node_list (
list
ofNode
orlist
ofGCENode
) – List of nodes to add.
- Returns
Return True if successful.
- Return type
bool
- list_instances()[source]¶
Lists the instances in the specified 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 of
GCENode
objects.- Return type
list
ofGCENode
objects.
- remove_instances(node_list)[source]¶
Removes one or more instances from the specified instance group, but does not delete those instances.
Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute
- Parameters
instancegroup (:class:
GCEInstanceGroup
) – The Instance Group where you are removng instances.node_list (
list
ofNode
orlist
ofGCENode
) – List of nodes to add.
- Returns
Return True if successful.
- Return type
bool
- set_named_ports(named_ports)[source]¶
Sets the named ports for the specified instance group.
Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute
- Parameters
named_ports (
list
of {‘name’:str
, ‘port`:int
}) – 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.- Returns
Return True if successful.
- Return type
bool
- 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 (
str
) – 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.
- delete_instances(node_list)[source]¶
Removes one or more instances from the specified instance group, and delete those instances.
Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute
- Parameters
node_list (
list
ofNode
orlist
ofGCENode
) – List of nodes to delete.- Returns
Return True if successful.
- Return type
bool
- 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_autohealingpolicies(healthcheck, initialdelaysec)[source]¶
Sets the autohealing policies for the instance for the instance group controlled by this manager.
- Parameters
healthcheck (
GCEHealthCheck
) – Healthcheck to addinitialdelaysec (
int
) – The time to allow an instance to boot and applications to fully start before the first health check
- Returns
Return 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
- set_named_ports(named_ports)[source]¶
Sets the named ports for the instance group controlled by this manager.
Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute
- Parameters
named_ports (
list
of {‘name’:str
, ‘port`:int
}) – 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.- Returns
Return True if successful.
- Return type
bool
- 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
- 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">]
- 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/'¶
- BACKEND_SERVICE_PROTOCOLS = ['HTTP', 'HTTPS', 'HTTP2', 'TCP', 'SSL']¶
- IMAGE_PROJECTS = {'centos-cloud': ['centos-6', 'centos-7', 'centos-8'], 'coreos-cloud': ['coreos-alpha', 'coreos-beta', 'coreos-stable'], 'cos-cloud': ['cos-beta', 'cos-dev', 'cos-stable'], 'debian-cloud': ['debian-8', 'debian-9', 'debian-10'], 'opensuse-cloud': ['opensuse-leap'], 'rhel-cloud': ['rhel-6', 'rhel-7', 'rhel-8'], 'suse-byos-cloud': ['sles-11-byos', 'sles-12-byos', 'sles-12-sp2-sap-byos', 'sles-12-sp3-sap-byos', 'suse-manager-proxy-byos', 'suse-manager-server-byos'], 'suse-cloud': ['sles-11', 'sles-12', 'sles-15'], 'suse-sap-cloud': ['sles-12-sp2-sap', 'sles-12-sp3-sap', 'sles-12-sp4-sap', 'sles-15-sap'], 'ubuntu-os-cloud': ['ubuntu-1404-lts', 'ubuntu-1604-lts', 'ubuntu-minimal-1604-lts', 'ubuntu-1710', 'ubuntu-1804-lts', 'ubuntu-minimal-1804-lts', 'ubuntu-1810', 'ubuntu-minimal-1810', 'ubuntu-1904', 'ubuntu-minimal-1904', 'ubuntu-1910', 'ubuntu-minimal-1910', 'ubuntu-2004-lts', 'ubuntu-minimal-2004-lts'], 'windows-cloud': ['windows-1709-core-for-containers', 'windows-1709-core', 'windows-2008-r2', 'windows-2012-r2-core', 'windows-2012-r2', 'windows-2016-core', 'windows-2016'], 'windows-sql-cloud': ['sql-ent-2012-win-2012-r2', 'sql-std-2012-win-2012-r2', 'sql-web-2012-win-2012-r2', 'sql-ent-2014-win-2012-r2', 'sql-ent-2014-win-2016', 'sql-std-2014-win-2012-r2', 'sql-web-2014-win-2012-r2', 'sql-ent-2016-win-2012-r2', 'sql-ent-2016-win-2016', 'sql-std-2016-win-2012-r2', 'sql-std-2016-win-2016', 'sql-web-2016-win-2012-r2', 'sql-web-2016-win-2016', 'sql-ent-2017-win-2016', 'sql-exp-2017-win-2012-r2', 'sql-exp-2017-win-2016', 'sql-std-2017-win-2016', 'sql-web-2017-win-2016']}¶
- KIND_METHOD_MAP = {'compute#address': <function GCENodeDriver._to_address>, 'compute#backendService': <function GCENodeDriver._to_backendservice>, 'compute#disk': <function GCENodeDriver._to_storage_volume>, 'compute#firewall': <function GCENodeDriver._to_firewall>, 'compute#forwardingRule': <function GCENodeDriver._to_forwarding_rule>, 'compute#httpHealthCheck': <function GCENodeDriver._to_healthcheck>, 'compute#image': <function GCENodeDriver._to_node_image>, 'compute#instance': <function GCENodeDriver._to_node>, 'compute#machineType': <function GCENodeDriver._to_node_size>, 'compute#network': <function GCENodeDriver._to_network>, 'compute#project': <function GCENodeDriver._to_project>, 'compute#region': <function GCENodeDriver._to_region>, 'compute#snapshot': <function GCENodeDriver._to_snapshot>, 'compute#sslCertificate': <function GCENodeDriver._to_sslcertificate>, 'compute#targetHttpProxy': <function GCENodeDriver._to_targethttpproxy>, 'compute#targetHttpsProxy': <function GCENodeDriver._to_targethttpsproxy>, 'compute#targetInstance': <function GCENodeDriver._to_targetinstance>, 'compute#targetPool': <function GCENodeDriver._to_targetpool>, 'compute#urlMap': <function GCENodeDriver._to_urlmap>, 'compute#zone': <function GCENodeDriver._to_zone>}¶
- NODE_STATE_MAP = {'PROVISIONING': NodeState.PENDING, 'RUNNING': NodeState.RUNNING, 'STAGING': NodeState.PENDING, 'STOPPING': NodeState.PENDING, 'SUSPENDED': NodeState.SUSPENDED, 'TERMINATED': NodeState.STOPPED, 'UNKNOWN': NodeState.UNKNOWN}¶
- SA_SCOPES_MAP = {'bigquery': 'bigquery', 'cloud-platform': 'cloud-platform', 'compute-ro': 'compute.readonly', 'compute-rw': 'compute', 'datastore': 'datastore', 'logging-write': 'logging.write', 'monitoring': 'monitoring', 'monitoring-write': 'monitoring.write', 'service-control': 'servicecontrol', 'service-management': 'service.management', 'sql': 'sqlservice', 'sql-admin': 'sqlservice.admin', 'storage-full': 'devstorage.full_control', 'storage-ro': 'devstorage.read_only', 'storage-rw': 'devstorage.read_write', 'taskqueue': 'taskqueue', 'useraccounts-ro': 'cloud.useraccounts.readonly', 'useraccounts-rw': 'cloud.useraccounts', 'userinfo-email': 'userinfo.email'}¶
- 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 tovolume (
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 diskex_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
- connectionCls¶
- 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', internal_ip=None, 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, ex_labels=None, ex_accelerator_type=None, ex_accelerator_count=None, ex_disk_size=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.internal_ip (
GCEAddress
orstr
orNone
) – The private IP address to use.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.ex_labels (
dict
orNone
) – Labels dictionary for instance.ex_accelerator_type (
str
orNone
) – Defines the accelerator to use with this node. Must set ‘ex_on_host_maintenance’ to ‘TERMINATE’. Must include a count of accelerators to use in ‘ex_accelerator_count’.ex_accelerator_count (
int
orNone
) – The number of ‘ex_accelerator_type’ accelerators to attach to the node.ex_disk_size (
int
orNone
) – Defines size of the boot disk. Integer in gigabytes.
- Returns
A Node object for the new node.
- Return type
Node
- 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 createlocation (
str
orGCEZone
orNodeLocation
orNone
) – Location (zone) to create the volume insnapshot (
GCESnapshot
orstr
orNone
) – Snapshot to create image fromimage (
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
- create_volume_snapshot(volume, name)[source]¶
Create a snapshot of the provided Volume.
- Parameters
volume (
StorageVolume
) – A StorageVolume object- Returns
A GCE Snapshot object
- Return type
- destroy_node(node, destroy_boot_disk=False, ex_sync=True)[source]¶
Destroy a node.
- Parameters
node (
Node
) – Node object to destroydestroy_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.)ex_sync (
bool
) – If true, do not return until destroyed or timeout
- Returns
True if successful
- Return type
bool
- destroy_volume(volume)[source]¶
Destroy a volume.
- Parameters
volume (
StorageVolume
) – Volume object to destroy- Returns
True if successful
- Return type
bool
- destroy_volume_snapshot(snapshot)[source]¶
Destroy a snapshot.
- Parameters
snapshot (
GCESnapshot
) – Snapshot object to destroy- Returns
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 detachex_node (
Node
) – Node object to detach volume from (required)
- Returns
True if successful
- Return type
bool
- 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
- 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 imageurl (
str
) – The URL to the image. The URL can start with gs://description (
str
) – The description of the imagefamily (
str
) – The family of the imageguest_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
- ex_create_address(name, region=None, address=None, description=None, address_type='EXTERNAL', subnetwork=None)[source]¶
Create a static address in a region, or a global address.
- Parameters
name (
str
) – Name of static addressregion (
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
) – Optional descriptive comment.address_type – Optional The type of address to reserve, either INTERNAL or EXTERNAL. If unspecified, defaults to EXTERNAL.
subnetwork – Optional The URL of the subnetwork in which to reserve the address. If an IP address is specified, it must be within the subnetwork’s IP range. This field can only be used with INTERNAL type with GCE_ENDPOINT/DNS_RESOLVER purposes.
- Returns
Static Address object
- Return type
- 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 Autoscalerzone (
str
orGCEZone
) – The zone to which the Instance Group belongsinstance_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
- ex_create_backend(instance_group, balancing_mode='UTILIZATION', max_utilization=None, max_rate=None, max_rate_per_instance=None, capacity_scaler=1, description=None)[source]¶
Helper Object to create a backend.
- Parameters
instance_group – The Instance Group for this Backend.
balancing_mode (
str
) – Specifies the balancing mode for this backend. For global HTTP(S) load balancing, the valid values are UTILIZATION (default) and RATE. For global SSL load balancing, the valid values are UTILIZATION (default) and CONNECTION.max_utilization (
float
) – Used when balancingMode is UTILIZATION. This ratio defines the CPU utilization target for the group. The default is 0.8. Valid range is [0.0, 1.0].max_rate (
int
) – The max requests per second (RPS) of the group. Can be used with either RATE or UTILIZATION balancing modes, but required if RATE mode. For RATE mode, either maxRate or maxRatePerInstance must be set.max_rate_per_instance (
float
) – The max requests per second (RPS) that a single backend instance can handle. This is used to calculate the capacity of the group. Can be used in either balancing mode. For RATE mode, either maxRate or maxRatePerInstance must be set.capacity_scaler (
float
) – A multiplier applied to the group’s maximum servicing capacity (based on UTILIZATION, RATE, or CONNECTION). Default value is 1, which means the group will serve up to 100% of its configured capacity (depending on balancingMode). A setting of 0 means the group is completely drained, offering 0% of its available capacity. Valid range is [0.0,1.0].description (
str
) – An optional description of this resource. Provide this property when you create the resource.
- Returns
A GCEBackend object.
- Return type
- class
GCEBackend
- ex_create_backendservice(name, healthchecks, backends=[], protocol=None, description=None, timeout_sec=None, enable_cdn=False, port=None, port_name=None)[source]¶
Create a global Backend Service.
Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute
- Parameters
name (
str
) – Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.healthchecks (
list
of (str
orGCEHealthCheck
)) – A list of HTTP Health Checks to use for this service. There must be at least one.backends (
list
of :class GCEBackend or list ofdict
) – The list of backends that serve this BackendService.timeout_sec (
integer
) – How many seconds to wait for the backend before considering it a failed request. Default is 30 seconds.enable_cdn (
bool
) – If true, enable Cloud CDN for this BackendService. When the load balancing scheme is INTERNAL, this field is not used.port (
integer
) – Deprecated in favor of port_name. The TCP port to connect on the backend. The default value is 80. This cannot be used for internal load balancing.port_name (
str
) – Name of backend port. The same name should appear in the instance groups referenced by this service.protocol (
str
) – The protocol this Backend Service uses to communicate with backends. Possible values are HTTP, HTTPS, HTTP2, TCP and SSL.
- Returns
A Backend Service object.
- Return type
- ex_create_firewall(name, allowed=None, denied=None, network='default', target_ranges=None, direction='INGRESS', priority=1000, source_service_accounts=None, target_service_accounts=None, source_ranges=None, source_tags=None, target_tags=None, description=None)[source]¶
Create a firewall rule on a network. Rules can be for Ingress or Egress, and they may Allow or Deny traffic. They are also applied in order based on action (Deny, Allow) and Priority. Rules can be applied using various Source and Target filters.
Firewall rules should be supplied in the “allowed” or “denied” field. This is a list of dictionaries formatted 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"}]
Note that valid inputs vary by direction (INGRESS vs EGRESS), action (allow/deny), and source/target filters (tag vs range etc).
See Firewall Reference for more information.
- Parameters
name (
str
) – Name of the firewall to be createddescription (
str
) – Optional description of the rule.direction (
str
) – Direction of the FW rule - “INGRESS” or “EGRESS” Defaults to ‘INGRESS’.priority (
int
) – Priority integer of the rule - lower is applied first. Defaults to 1000allowed (
list
ofdict
) – List of dictionaries with rules for type INGRESSdenied (
list
ofdict
) – List of dictionaries with rules for type EGRESSnetwork (
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_service_accounts (
list
ofstr
) – A list of source service accounts the rules apply to.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.target_service_accounts (
list
ofstr
) – A list of target service accounts the rules apply to.target_ranges (
list
ofstr
) – A list of IP ranges in CIDR format that the EGRESS type rule should apply to. Defaults to [‘0.0.0.0/0’]
- Returns
Firewall object
- Return type
- ex_create_forwarding_rule(name, target=None, region=None, protocol='tcp', port_range=None, address=None, description=None, global_rule=False, targetpool=None, lb_scheme=None)[source]¶
Create a forwarding rule.
- Parameters
name (
str
) – Name of forwarding rule to be createdtarget (
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.lb_scheme (
str
orNone
) – Load balancing scheme, can be ‘EXTERNAL’ or ‘INTERNAL’. Defaults to ‘EXTERNAL’.
- Returns
Forwarding Rule object
- Return type
- 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 checkhost (
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
- ex_create_image(name, volume, description=None, family=None, guest_os_features=None, use_existing=True, wait_for_completion=True, ex_licenses=None, ex_labels=None)[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 URIdescription (
str
) – Description of the new Imagefamily (
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.guest_os_features (
list
ofstr
orNone
) – Features of the guest operating system, valid for bootable images only.ex_licenses (
list
ofstr
) – List of strings representing licenses to be associated with the image.ex_labels (
dict
orNone
) – Labels dictionary for image.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
- Returns
A GCENodeImage object for the new image
- Return type
- ex_create_instancegroup(name, zone, description=None, network=None, subnetwork=None, named_ports=None)[source]¶
Creates an instance group in the specified project using the parameters that are included in the request.
Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute
- 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 (
list
of {‘name’:str
, ‘port`:int
}) – 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.
- Returns
GCEInstanceGroup object.
- Return type
- 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 belongstemplate (
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
- ex_create_instancetemplate(name, size, source=None, image=None, disk_type='pd-standard', disk_auto_delete=True, network='default', subnetwork=None, can_ip_forward=None, external_ip='ephemeral', internal_ip=None, service_accounts=None, on_host_maintenance=None, automatic_restart=None, preemptible=None, tags=None, metadata=None, description=None, disks_gce_struct=None, nic_gce_struct=None)[source]¶
Creates an instance template in the specified project using the data that is included in the request. If you are creating a new template to update an existing instance group, your new instance template must use the same network or, if applicable, the same subnetwork as the original template.
Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute
- 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)network (
str
orGCENetwork
) – The network to associate with the template.subnetwork (
str
orGCESubnetwork
) – The subnetwork to associate with the node.tags (
list
ofstr
orNone
) – A list of tags to associate with the node.metadata (
dict
orNone
) – Metadata dictionary for instance.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.internal_ip (
GCEAddress
orstr
orNone
) – The private IP address to use.disk_type (
str
orGCEDiskType
) – Specify a pd-standard (default) disk or pd-ssd for an SSD disk.disk_auto_delete (
bool
) – Indicate that the boot disk should be deleted when the Node is deleted. Set to True by default.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).can_ip_forward (
bool
orNone
) – Set toTrue
to allow this node to send/receive non-matching src/dst packets.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.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.on_host_maintenance – 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
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.)preemptible (
bool
orNone
) – Defines whether the instance is preemptible. (If not supplied, the instance will not be preemptible)
- Returns
An Instance Template object.
- Return type
- ex_create_multiple_nodes(base_name, size, image, number, location=None, ex_network='default', ex_subnetwork=None, ex_tags=None, ex_metadata=None, ignore_errors=True, use_existing_disk=True, poll_interval=2, external_ip='ephemeral', internal_ip=None, 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, ex_preemptible=None, ex_labels=None, ex_disk_size=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.)internal_ip (
GCEAddress
orstr
orNone
) – The private IP address to use.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_preemptible (
bool
orNone
) – Defines whether the instance is preemptible. (If not supplied, the instance will not be preemptible)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.ex_labels (
dict
) – Label dict for node.ex_disk_size (
int
orNone
) – Defines size of the boot disk. Integer in gigabytes.
- Returns
A list of Node objects for the new nodes.
- Return type
list
ofNode
- ex_create_network(name, cidr, description=None, mode='legacy', routing_mode=None)[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 createdcidr (
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.routing_mode (
str
orNone
) – Create network with ‘Global’ or ‘Regional’ routing mode for BGP advertisements. Defaults to ‘Regional’
- Returns
Network object
- Return type
- 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 createddest_range (
str
) – Address range of route in CIDR format.priority (
int
) – Priority value, lower values take precedencenetwork (
str
orGCENetwork
) – The network the route belongs to. Can be either the full URL of the network, the name of the network or a libcloud object.tags (
list
ofstr
orNone
) – List of instance-tags for routing, empty for all nodesnext_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
- ex_create_sslcertificate(name, certificate=None, private_key=None, description=None)[source]¶
Creates a SslCertificate resource in the specified project using the data included in the request.
Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute
- Parameters
name (
str
) – Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.certificate (
str
) – A string containing local certificate file in PEM format. The certificate chain must be no greater than 5 certs long. The chain must include at least one intermediate cert.private_key (
str
) – A string containing a write-only private key in PEM format. Only insert RPCs will include this field.description (
str
) – An optional description of this resource. Provide this property when you create the resource.
- Returns
GCESslCertificate object.
- Return type
- ex_create_subnetwork(name, cidr=None, network=None, region=None, description=None, privateipgoogleaccess=None, secondaryipranges=None)[source]¶
Create a subnetwork.
- Parameters
name (
str
) – Name of subnetwork to be createdcidr (
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.privateipgoogleaccess (
bool` or ``None
) – Allow access to Google services without assigned external IP addresses.secondaryipranges (
list
ofdict
orNone
) – List of dicts of secondary or “alias” IP ranges for this subnetwork in [{“rangeName”: “second1”, “ipCidrRange”: “192.168.168.0/24”}, {k:v, k:v}] format.
- Returns
Subnetwork object
- Return type
- ex_create_targethttpproxy(name, urlmap)[source]¶
Create a target HTTP proxy.
- Parameters
name (
str
) – Name of target HTTP proxyurlmap – URL map defining the mapping from URl to the backendservice.
- Returns
Target Pool object
- Return type
- ex_create_targethttpsproxy(name, urlmap, sslcertificates, description=None)[source]¶
Creates a TargetHttpsProxy resource in the specified project using the data included in the request.
Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute
- Parameters
name (
str
) – Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.sslcertificates (
list
ofGCESslcertificates
) – URLs to SslCertificate resources that are used to authenticate connections between users and the load balancer. Currently, exactly one SSL certificate must be specified.urlmap (
GCEUrlMap
) – A fully-qualified or valid partial URL to the UrlMap resource that defines the mapping from URL to the BackendService.description (
str
) – An optional description of this resource. Provide this property when you create the resource.
- Returns
GCETargetHttpsProxy object.
- Return type
- 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 instanceregion (
str
orGCEZone
orNone
) – Zone to create the target pool in. Defaults to self.zonenode (
str
orNode
) – The actual instance to be used as the traffic target.description (
str
orNone
) – A text description for the target instancenat_policy (
str
) – The NAT option for how IPs are NAT’d to the node.
- Returns
Target Instance object
- Return type
- 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 poolregion (
str
orGCERegion
orNone
) – Region to create the target pool in. Defaults to self.regionhealthchecks (
list
ofstr
orGCEHealthCheck
) – Optional list of health checks to attachnodes (
list
ofstr
orNode
) – Optional list of nodes to attach to the poolsession_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
- 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
- ex_delete_access_config(node, name, nic)[source]¶
Delete a network interface access configuration from a node.
- Parameters
node (
Node
) – The existing target Node (instance) for the request.name (
str
) – Name of the access config.nic (
str
) – Name of the network interface.
- Returns
True if successful
- Return type
bool
- ex_delete_image(image)[source]¶
Delete a specific image resource.
- Parameters
image (
str
orGCENodeImage
) – Image object to delete- Returns
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 deprecatereplacement (
str
or :class: GCENodeImage) – Image object to use as a replacementstate (
str
) – State of the imagedeprecated (
str
orNone
) – RFC3339 timestamp to mark DEPRECATEDobsolete (
str
orNone
) – RFC3339 timestamp to mark OBSOLETEdeleted (
str
orNone
) – RFC3339 timestamp to mark DELETED
- Returns
True if successful
- Return type
bool
- ex_destroy_address(address)[source]¶
Destroy a static address.
- Parameters
address (
str
orGCEAddress
) – Address object to destroy- Returns
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 destroy- Returns
True if successful
- Return type
bool
- ex_destroy_firewall(firewall)[source]¶
Destroy a firewall.
- Parameters
firewall (
GCEFirewall
) – Firewall object to destroy- Returns
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 destroy- Returns
True if successful
- Return type
bool
- ex_destroy_healthcheck(healthcheck)[source]¶
Destroy a healthcheck.
- Parameters
healthcheck (
GCEHealthCheck
) – Health check object to destroy- Returns
True if successful
- Return type
bool
- ex_destroy_instancegroup(instancegroup)[source]¶
Deletes the specified instance group. The instances in the group are not deleted. Note that instance group must not belong to a backend service. Read Deleting an instance group for more information.
Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute
- Parameters
instancegroup (
GCEInstanceGroup
) – The name of the instance group to delete.- Returns
Return 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_instancetemplate(instancetemplate)[source]¶
Deletes the specified instance template. If you delete an instance template that is being referenced from another instance group, the instance group will not be able to create or recreate virtual machine instances. Deleting an instance template is permanent and cannot be undone.
Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute
- Parameters
instancetemplate (
str
) – The name of the instance template to delete.- Return instanceTemplate
Return True if successful.
- Rtype instanceTemplate
``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 destroyignore_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
- ex_destroy_network(network)[source]¶
Destroy a network.
- Parameters
network (
GCENetwork
) – Network object to destroy- Returns
True if successful
- Return type
bool
- ex_destroy_route(route)[source]¶
Destroy a route.
- Parameters
route (
GCERoute
) – Route object to destroy- Returns
True if successful
- Return type
bool
- ex_destroy_sslcertificate(sslcertificate)[source]¶
Deletes the specified SslCertificate resource.
Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute
- Parameters
sslcertificate (
str
) – Name of the SslCertificate resource to delete.- Return sslCertificate
Return True if successful.
- Rtype sslCertificate
``bool``
- ex_destroy_subnetwork(name, region=None)[source]¶
Delete a Subnetwork object based on name and region.
- Parameters
name (
str
orGCESubnetwork
) – The name, URL or object of the subnetworkregion (
str
orGCERegion
orNone
) – The region object, name, or URL of the subnetwork
- Returns
True if successful
- Return type
bool
- ex_destroy_targethttpproxy(targethttpproxy)[source]¶
Destroy a target HTTP proxy.
- Parameters
targethttpproxy (
GCETargetHttpProxy
) – TargetHttpProxy object to destroy- Returns
True if successful
- Return type
bool
- ex_destroy_targethttpsproxy(targethttpsproxy)[source]¶
Deletes the specified TargetHttpsProxy resource.
Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute
- Parameters
targethttpsproxy (
str
) – Name of the TargetHttpsProxy resource to delete.- Return targetHttpsProxy
Return True if successful.
- Rtype targetHttpsProxy
``bool``
- ex_destroy_targetinstance(targetinstance)[source]¶
Destroy a target instance.
- Parameters
targetinstance (
GCETargetInstance
) – TargetInstance object to destroy- Returns
True if successful
- Return type
bool
- ex_destroy_targetpool(targetpool)[source]¶
Destroy a target pool.
- Parameters
targetpool (
GCETargetPool
) – TargetPool object to destroy- Returns
True if successful
- Return type
bool
- ex_destroy_urlmap(urlmap)[source]¶
Destroy a URL map.
- Parameters
urlmap (
GCEUrlMap
) – UrlMap object to destroy- Returns
True if successful
- Return type
bool
- ex_get_accelerator_type(name, zone=None)[source]¶
Return an AcceleratorType object based on a name and zone.
- Parameters
name (
str
) – The name of the AcceleratorTypezone (
GCEZone
) – The zone to search for the AcceleratorType in.
- Returns
An AcceleratorType object for the name
- Return type
- 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 addressregion (
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
- 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
- ex_get_backendservice(name)[source]¶
Return a Backend Service object based on name
- Parameters
name (
str
) – The name of the backend service- Returns
A BackendService object for the backend service
- Return type
- 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 DiskTypezone (
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
- ex_get_firewall(name)[source]¶
Return a Firewall object based on the firewall name.
- Parameters
name (
str
) – The name of the firewall- Returns
A GCEFirewall object
- Return type
- 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 ruleregion (
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
- ex_get_healthcheck(name)[source]¶
Return a HealthCheck object based on the healthcheck name.
- Parameters
name (
str
) – The name of the healthcheck- Returns
A GCEHealthCheck object
- Return type
- 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 (
str
orlist
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 None if an image with that name is not found.
- Return type
GCENodeImage
or raiseResourceNotFoundError
- 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
- 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
- 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
- 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
- ex_get_license(project, name)[source]¶
Return a License object for specified project and name.
- Parameters
project (
str
) – The project to reference when looking up the license.name (
str
) – The name of the License
- Returns
A License object for the name
- Return type
- ex_get_network(name)[source]¶
Return a Network object based on a network name.
- Parameters
name (
str
) – The name or URL of the network- Returns
A Network object for the network
- Return type
- 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 nodezone (
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
- ex_get_project()[source]¶
Return a Project object with project-wide information.
- Returns
A GCEProject object
- Return type
- 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
- ex_get_route(name)[source]¶
Return a Route object based on a route name.
- Parameters
name (
str
) – The name of the route- Returns
A Route object for the named route
- Return type
- 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 nodezone (
str
orGCEZone
orNodeLocation
orNone
) – The zone to search for the machine type in
- Returns
A GCENodeSize object for the machine type
- Return type
- ex_get_snapshot(name)[source]¶
Return a Snapshot object based on snapshot name.
- Parameters
name (
str
) – The name of the snapshot- Returns
A GCESnapshot object for the snapshot
- Return type
- ex_get_sslcertificate(name)[source]¶
Returns the specified SslCertificate resource. Get a list of available SSL certificates 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
) – Name of the SslCertificate resource to return.- Returns
GCESslCertificate object.
- Return type
- ex_get_subnetwork(name, region=None)[source]¶
Return a Subnetwork object based on name and region.
- Parameters
name (
str
) – The name or URL of the subnetworkregion (
str
orGCERegion
orNone
) – The region of the subnetwork
- Returns
A Subnetwork object
- Return type
- 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
- ex_get_targethttpsproxy(name)[source]¶
Returns the specified TargetHttpsProxy resource. Get a list of available target HTTPS proxies 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
) – Name of the TargetHttpsProxy resource to return.- Returns
GCETargetHttpsProxy object.
- Return type
- 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 instancezone (
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
- 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 poolregion (
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
- ex_get_urlmap(name)[source]¶
Return a URL Map object based on name
- Parameters
name (
str
) – The name of the url map- Returns
A URL Map object for the backend service
- Return type
- ex_get_volume(name, zone=None, use_cache=False)[source]¶
Return a Volume object based on a volume name and optional zone.
To improve performance, we request all disks and allow the user to consult the cache dictionary rather than making an API call.
- Parameters
name (
str
) – The name of the volumezone (
str
orGCEZone
orNodeLocation
orNone
) – The zone to search for the volume in (set to ‘all’ to search all zones)use_cache (
bool
) – Search for the volume in the existing cache of volumes. If True, we omit the API call and search self.volumes_dict. If False, a call to disks/aggregatedList is made prior to searching self._ex_volume_dict.
- Returns
A StorageVolume object for the volume
- Return type
StorageVolume
- 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_instancegroup_add_instances(instancegroup, node_list)[source]¶
Adds a list of instances to the specified instance group. All of the instances in the instance group must be in the same network/subnetwork. Read Adding instances for more information.
Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute
- Parameters
instancegroup (:class:
GCEInstanceGroup
) – The Instance Group where you are adding instances.node_list (
list
ofNode
orlist
ofGCENode
) – List of nodes to add.
- Returns
Return True if successful.
- Return type
bool
- ex_instancegroup_list_instances(instancegroup)[source]¶
Lists the instances in the specified 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
- Parameters
instancegroup (
GCEInstanceGroup
) – The Instance Group where from which you want to generate a list of included instances.- Returns
List of
GCENode
objects.- Return type
list
ofGCENode
objects.
- ex_instancegroup_remove_instances(instancegroup, node_list)[source]¶
Removes one or more instances from the specified instance group, but does not delete those instances.
Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute
- Parameters
instancegroup (:class:
GCEInstanceGroup
) – The Instance Group where the specified instances will be removed.node_list (
list
ofNode
orlist
ofGCENode
) – List of nodes to add.
- Returns
True if successful.
- Return type
bool
- ex_instancegroup_set_named_ports(instancegroup, named_ports=[])[source]¶
Sets the named ports for the specified instance group.
Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute
- Parameters
instancegroup (
GCEInstanceGroup
) – The Instance Group where where the named ports are updated.named_ports (
list
of {‘name’:str
, ‘port`:int
}) – 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.
- Returns
Return True if successful.
- Return type
bool
- ex_instancegroupmanager_delete_instances(manager, node_list)[source]¶
Remove instances from GCEInstanceGroupManager and destroy the instance
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.node_list (
list
ofNode
) – list of Node objects to delete.
- Returns
True if successful
- Return type
bool
- 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
- 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
- ex_instancegroupmanager_set_autohealingpolicies(manager, healthcheck, initialdelaysec)[source]¶
Set the Autohealing Policies for this Instance Group.
- Parameters
healthcheck (
GCEHealthCheck
) – Healthcheck to addinitialdelaysec (
int
) – The time to allow an instance to boot and applications to fully start before the first health check
- Returns
True if successful
- Return type
bool
- 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
- 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
- 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
- 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_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_sslcertificates()[source]¶
Retrieves the list of SslCertificate resources available to the specified project.
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
A list of SSLCertificate objects.
- Return type
list
ofGCESslCertificate
- 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_targethttpsproxies()[source]¶
Return the list of target HTTPs proxies.
- Returns
A list of target https proxy objects
- Return type
list
ofGCETargetHttpsProxy
- 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_resize_volume(volume, size)[source]¶
Resize a volume to the specified size.
- Parameters
volume (
StorageVolume
) – Volume object to resizesize (
int
) – The size in GB of the volume to resize to.
- Returns
True if successful
- Return type
bool
- 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
- ex_set_image_labels(image, labels)[source]¶
Set labels for the specified image.
- Parameters
image (
NodeImage
) – The existing target Image for the request.labels (
dict
orNone
) – Set (or clear with None) labels for this image.
- Returns
True if successful
- Return type
bool
- 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 changemachine_type (
str
) – Desired machine type
- Returns
True if successful
- Return type
bool
- ex_set_node_labels(node, labels)[source]¶
Set labels for the specified node.
- Parameters
node (
Node
) – The existing target Node (instance) for the request.labels (
dict
orNone
) – Set (or clear with None) labels for this node.
- Returns
True if successful
- Return type
bool
- 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
- 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 objecton_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
- ex_set_node_tags(node, tags)[source]¶
Set the tags on a Node instance.
Note that this updates the node object directly.
- Parameters
node (
Node
) – Node objecttags (
list
ofstr
) – List of tags to apply to the object
- Returns
True if successful
- Return type
bool
- 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
- 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-deleteex_node (
Node
) – Node object to auto-delete volume fromauto_delete (
bool
(default True)) – Flag to set for the auto-delete value
- Returns
True if successful
- Return type
bool
- ex_set_volume_labels(volume, labels)[source]¶
Set labels for the specified volume (disk).
- Parameters
volume (
StorageVolume
) – The existing target StorageVolume for the request.labels (
dict
orNone
) – Set (or clear with None) labels for this image.
- Returns
True if successful
- Return type
bool
- ex_targethttpsproxy_set_sslcertificates(targethttpsproxy, sslcertificates)[source]¶
Replaces SslCertificates for TargetHttpsProxy.
Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute
- Parameters
targethttpsproxy (
str
) – Name of the TargetHttpsProxy resource to set an SslCertificates resource for.sslcertificates (
list
ofGCESslCertificates
) – sslcertificates to set.
- Returns
True
- Return type
bool
- ex_targethttpsproxy_set_urlmap(targethttpsproxy, urlmap)[source]¶
Changes the URL map for TargetHttpsProxy.
Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute
- Parameters
targethttpsproxy (
str
) – Name of the TargetHttpsProxy resource whose URL map is to be set.urlmap (
GCEUrlMap
) – urlmap to set.
- Returns
True
- 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 tohealthcheck (
str
orGCEHealthCheck
) – The healthcheck to add
- Returns
True if successful
- Return type
bool
- ex_targetpool_add_node(targetpool, node)[source]¶
Add a node to a target pool.
- Parameters
targetpool (
str
orGCETargetPool
) – The targetpool to add node tonode (
str
orNode
) – The node to add
- Returns
True if successful
- Return type
bool
- 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
- 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 fromhealthcheck (
str
orGCEHealthCheck
) – The healthcheck to remove
- Returns
True if successful
- Return type
bool
- ex_targetpool_remove_node(targetpool, node)[source]¶
Remove a node from a target pool.
- Parameters
targetpool (
str
orGCETargetPool
) – The targetpool to remove node fromnode (
str
orNode
) – The node to remove
- Returns
True if successful
- Return type
bool
- ex_targetpool_set_backup_targetpool(targetpool, backup_targetpool, failover_ratio=0.1)[source]¶
Set a backup targetpool.
- Parameters
targetpool (
GCETargetPool
) – The existing primary targetpoolbackup_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
- 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
- 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
- features = {'create_node': ['ssh_key']}¶
- List of available features for a driver.
libcloud.compute.base.NodeDriver.create_node()
ssh_key: Supports
NodeAuthSSHKey
as an authentication method for nodes.password: Supports
NodeAuthPassword
as an authentication method for nodes.generates_password: Returns a password attribute on the Node object returned from creation.
- 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
- 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, ex_use_disk_cache=True)[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’ex_use_disk_cache (
bool
) – Disk information for each node will retrieved from a dictionary rather than making a distinct API call for it.
- 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 sizes- Returns
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 object- Returns
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 rebooted- Returns
True if successful, False if not
- Return type
bool
- start_node(node, ex_sync=True)[source]¶
Start a node that is stopped and in TERMINATED state.
- Parameters
node (
Node
) – Node object to startsync (
bool
) – If true, do not return until destroyed or timeout
- Returns
True if successful
- Return type
bool
- stop_node(node, ex_sync=True)[source]¶
Stop a running node.
- Parameters
node (
Node
) – Node object to stopsync (
bool
) – If true, do not return until destroyed or timeout
- Returns
True if successful
- Return type
bool
- type = 'gce'¶
- website = 'https://cloud.google.com/'¶
- class libcloud.compute.drivers.gce.GCENodeImage(id, name, driver, extra=None)[source]¶
Bases:
libcloud.compute.base.NodeImage
A GCE Node Image class.
- Parameters
id (
str
) – Image ID.name (
str
) – Image name.driver (
NodeDriver
) – Driver this image belongs to.extra (
dict
) – Optional provided specific attributes associated with this image.
- deprecate(replacement, state, deprecated=None, obsolete=None, deleted=None)[source]¶
Deprecate this image
- Parameters
replacement (
str
or :class: GCENodeImage) – Image to use as a replacementstate (
str
) – Deprecation state of this image. Possible values include ‘ACTIVE’, ‘DELETED’, ‘DEPRECATED’ or ‘OBSOLETE’.deprecated (
str
orNone
) – RFC3339 timestamp to mark DEPRECATEDobsolete (
str
orNone
) – RFC3339 timestamp to mark OBSOLETEdeleted (
str
orNone
) – RFC3339 timestamp to mark DELETED
- Returns
True if successful
- Return type
bool
- 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.
- Parameters
id (
str
) – Size ID.name (
str
) – Size name.ram (
int
) – Amount of memory (in MB) provided by this size.disk (
int
) – Amount of disk storage (in GB) provided by this image.bandwidth (
int
) – Amount of bandiwdth included with this size.price (
float
) – Price (in US dollars) of running this node for an hour.driver (
NodeDriver
) – Driver this size belongs to.extra (
dict
) – Optional provider specific attributes associated with this size.
- 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
- 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
- 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.
- 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]¶
Bases:
libcloud.compute.base.VolumeSnapshot
VolumeSnapshot constructor.
- Parameters
id (
str
) – Snapshot ID.driver (NodeDriver) – The driver that represents a connection to the provider
size (
int
) – A snapshot size in GB.extra (
dict
) – Provider depends parameters for snapshot.created (
datetime.datetime
) – A datetime object that represents when the snapshot was createdstate (
StorageVolumeState
) – A string representing the state the snapshot is in. See libcloud.compute.types.StorageVolumeState.name (
str
) – A string representing the name of the snapshot
- class libcloud.compute.drivers.gce.GCESslCertificate(id, name, certificate, driver, extra, private_key=None, description=None)[source]¶
Bases:
libcloud.compute.base.UuidMixin
GCESslCertificate represents the SslCertificate resource.
- Parameters
name (
str
) – Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.certificate (
str
) – A local certificate file. The certificate must be in PEM format. The certificate chain must be no greater than 5 certs long. The chain must include at least one intermediate cert.private_key (
str
) – A write-only private key in PEM format. Only insert RPCs will include this field.description (
str
) – An optional description of this resource. Provide this property when you create the resource.driver (
:class: `GCENodeDriver`
) – An initialized :class: GCENodeDriverextra (
:class: ``dict``
) – A dictionary of extra information.
- 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.GCETargetHttpsProxy(id, name, description=None, sslcertificates=None, urlmap=None, driver=None, extra=None)[source]¶
Bases:
libcloud.compute.base.UuidMixin
GCETargetHttpsProxy represents the TargetHttpsProxy resource.
- Parameters
name (
str
) – Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.description (
str
) – An optional description of this resource. Provide this property when you create the resource.sslcertificates (
list
ofGCESslcertificates
) – URLs to SslCertificate resources that are used to authenticate connections between users and the load balancer. Currently, exactly one SSL certificate must be specified.urlmap (
GCEUrlMap
) – A fully-qualified or valid partial URL to the UrlMap resource that defines the mapping from URL to the BackendService. For example, the following are all valid URLs for specifying a URL map: - ht tps://www.googleapis.compute/v1/projects/project/gl obal/urlMaps/url-map - projects/project/global/urlMaps/url-map - global/urlMaps/url-mapdriver (
:class: `GCENodeDriver`
) – An initialized :class: GCENodeDriverextra (
:class: ``dict``
) – A dictionary of extra information.
- destroy()[source]¶
Destroy this TargetHttpsProxy.
- Returns
Return True if successful.
- Return type
bool
- set_sslcertificates(sslcertificates)[source]¶
Set the SSL Certificates for this TargetHTTPSProxy
- Parameters
sslcertificates (
list
ofGCESslCertificate
) – SSL Certificates to set.- Returns
True if successful
- Return type
bool
- set_urlmap(urlmap)[source]¶
Changes the URL map for TargetHttpsProxy.
Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute
- Parameters
targethttpsproxy (
str
) – Name of the TargetHttpsProxy resource whose URL map is to be set.urlmap (
GCEUrlMap
) – UrlMap to set.
- Returns
True
- Return type
bool
- 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 add- Returns
True if successful
- Return type
bool
- add_node(node)[source]¶
Add a node to this target pool.
- Parameters
node (
str
orNode
) – Node to add- Returns
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 returned- Returns
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 remove- Returns
True if successful
- Return type
bool
- remove_node(node)[source]¶
Remove a node from this target pool.
- Parameters
node (
str
orNode
) – Node to remove- Returns
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
- 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.
- Parameters
id (
str
) – Location ID.name (
str
) – Location name.country (
str
) – Location country.driver (
NodeDriver
) – Driver this location belongs to.extra (
dict
) – Optional provided specific attributes associated with this location.
- property next_mw_duration¶
Returns the duration of the next Maintenance Window as a datetime.timedelta object.
- property time_until_mw¶
Returns the time until the next Maintenance Window as a datetime.timedelta object.
libcloud.compute.drivers.gig_g8 module¶
GiG G8 Driver
- class libcloud.compute.drivers.gig_g8.G8Network(id, name, cidr, publicipaddress, driver, extra=None)[source]¶
Bases:
libcloud.compute.base.UuidMixin
G8 Network object class.
This class maps to a cloudspace
- property cidr¶
Cidr is not part of the list result we will lazily fetch it with a get request
- class libcloud.compute.drivers.gig_g8.G8NodeDriver(user_id, key, api_url)[source]¶
Bases:
libcloud.compute.base.NodeDriver
GiG G8 node driver
- Parameters
key (
str
) – Token to use for api (jwt)user_id (
int
) – Id of the account to connect to (accountId)api_url (
str
) – G8 api url
- Return type
None
- NODE_STATE_MAP = {'ADDING_DISK': NodeState.RECONFIGURING, 'ATTACHING_DISK': NodeState.RECONFIGURING, 'ATTACHING_NIC': NodeState.RECONFIGURING, 'CHANGING_DISK_LIMITS': NodeState.RECONFIGURING, 'CLONING': NodeState.PENDING, 'CREATING_TEMPLATE': NodeState.PENDING, 'DELETED': NodeState.TERMINATED, 'DELETING': NodeState.TERMINATED, 'DELETING_DISK': NodeState.RECONFIGURING, 'DEPLOYING': NodeState.PENDING, 'DESTROYED': NodeState.TERMINATED, 'DESTROYING': NodeState.TERMINATED, 'DETACHING_DISK': NodeState.RECONFIGURING, 'DETTACHING_NIC': NodeState.RECONFIGURING, 'ERROR': NodeState.ERROR, 'HALTED': NodeState.STOPPED, 'MOVING': NodeState.MIGRATING, 'PAUSED': NodeState.PAUSED, 'PAUSING': NodeState.PENDING, 'RESETTING': NodeState.REBOOTING, 'RESIZING': NodeState.RECONFIGURING, 'RESTORING': NodeState.PENDING, 'RESUMING': NodeState.PENDING, 'RUNNING': NodeState.RUNNING, 'STARTING': NodeState.STARTING, 'STOPPING': NodeState.STOPPING, 'VIRTUAL': NodeState.PENDING}¶
- attach_volume(node, volume)[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
- connectionCls¶
alias of
libcloud.common.gig_g8.G8Connection
- create_node(name, image, ex_network, ex_description, size=None, auth=None, ex_create_attr=None, ex_expose_ssh=False)[source]¶
Create a node.
The ex_create_attr parameter can include the following dictionary key and value pairs:
- memory:
int
Memory in MiB (only used if size is None and vcpus is passed
- memory:
- vcpus:
int
Amount of vcpus (only used if size is None and memory is passed)
- vcpus:
- disk_size:
int
Size of bootdisk defaults to minimumsize of the image
- disk_size:
user_data:
str
for cloud-config dataprivate_ip:
str
Private Ip inside network- data_disks:
list(int)
Extra data disks to assign to vm list of disk sizes in GiB
- data_disks:
- Parameters
name (
str
) – the name to assign the vmsize (:
str
) – the plan size to create mutual exclusive with memory vcpusimage (
NodeImage
) – which distribution to deploy on the vmnetwork – G8 Network to place vm in
ex_description – Descripton of vm
auth (
NodeAuthSSHKey
) – an SSH keyex_create_attr (
dict
) – A dictionary of optional attributes for vm creationex_expose_ssh (int) – Create portforward for ssh port
- Returns
The newly created node.
- Return type
Node
- create_volume(size, name, ex_description, ex_disk_type='D')[source]¶
Create volume
- Parameters
size (
int
) – Size of the volume to create in GiBname (
str
) – Name of the volumedescription (
str
) – Descripton of the volumedisk_type (
str
) – Type of the disk depending on the G8 D for datadisk is always available
- Return type
class:StorageVolume
- destroy_volume(volume)[source]¶
Destroys a storage volume.
- Parameters
volume (
StorageVolume
) – Volume to be destroyed- Return type
bool
- detach_volume(node, volume)[source]¶
Detaches a volume from a node.
- Parameters
volume (
StorageVolume
) – Volume to be detached- Return type
bool
- ex_create_network(name, private_network='192.168.103.0/24', type='vgw')[source]¶
Create network also known as cloudspace
- Parameters
name (
str
) – the name to assing to the networkprivate_network (
str
) – subnet used as private networktype (
str
) – type of the gateway vgw or routeros
- ex_expose_ssh_node(node)[source]¶
Create portforward for ssh purposed
- Parameters
node (
Node
) – Node to expose ssh for- Return type
int
- ex_list_networks()[source]¶
Return the list of networks.
- Returns
A list of network objects.
- Return type
list
ofG8Network
- list_images()[source]¶
Returns a list of images as a cloud provider might have
@inherits:
NodeDriver.list_images
- list_nodes(ex_network=None)[source]¶
List the nodes known to a particular driver; There are two default nodes created at the beginning
- list_volumes()[source]¶
List storage volumes.
- Return type
list
ofStorageVolume
- name = 'GiG G8 Node Provider'¶
- type = 'gig_g8'¶
- website = 'https://gig.tech'¶
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.
- get_uuid()[source]¶
Unique hash for a node, node image, or node size
The hash is a function of an SHA1 hash of the node, node image, or node size’s ID and its driver which means that it should be unique between all objects of its type. In some subclasses (e.g. GoGridNode) 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.compute.drivers.dummy import DummyNodeDriver >>> driver = DummyNodeDriver(0) >>> node = driver.create_node() >>> node.get_uuid() 'd3748461511d8b9b0e0bfa0d4d3383a619a2bb9f'
Note, for example, that this example will always produce the same UUID!
- Return type
str
- 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¶
- create_node(name, size, image, location=None, ex_description=None, ex_ip=None)[source]¶
Create a new GoGird node
@inherits:
NodeDriver.create_node
- Parameters
ex_description (
str
) – Description of a Nodeex_ip (
str
) – Public IP address to use for a Node. If not specified, first available IP address will be picked
- Return type
- destroy_node(node)[source]¶
@inherits:
NodeDriver.reboot_node
:type node:GoGridNode
- ex_create_node_nowait(name, size, image, location=None, ex_description=None, ex_ip=None)[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 Nodeex_ip (
str
) – Public IP address to use for a Node. If not specified, first available IP address will be picked
- Return type
- 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
- 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
- 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 typeassigned (
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 statelocation (
NodeLocation
) – filter IP addresses by location
- Return type
list
ofGoGridIpAddress
- 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 imagename (
str
) – name for new image
- Return type
NodeImage
- features = {'create_node': ['generates_password']}¶
- List of available features for a driver.
libcloud.compute.base.NodeDriver.create_node()
ssh_key: Supports
NodeAuthSSHKey
as an authentication method for nodes.password: Supports
NodeAuthPassword
as an authentication method for nodes.generates_password: Returns a password attribute on the Node object returned from creation.
- list_images(location=None)[source]¶
List images on a provider.
- Parameters
location (
NodeLocation
) – The location at which to list images.- Returns
list of node image objects.
- Return type
list
ofNodeImage
- list_locations()[source]¶
List data centers for a provider
- Returns
list of node location objects
- Return type
list
ofNodeLocation
- list_nodes()[source]¶
@inherits:
NodeDriver.list_nodes
:rtype:list
ofGoGridNode
- list_sizes(location=None)[source]¶
List sizes on a provider
- Parameters
location (
NodeLocation
) – The location at which to list sizes- Returns
list of node size objects
- Return type
list
ofNodeSize
- name = 'GoGrid'¶
- reboot_node(node)[source]¶
@inherits:
NodeDriver.reboot_node
:type node:GoGridNode
- type = 'gogrid'¶
- website = 'http://www.gogrid.com/'¶
libcloud.compute.drivers.gridscale module¶
- class libcloud.compute.drivers.gridscale.GridscaleIp(id, family, prefix, create_time, address, extra=None)[source]¶
Bases:
object
Ip Object
- Parameters
id (
str
) – uuidfamily (
str
) – family of ip (v4 or v6)prefix (
str
) – prefix of ipip_address (
str
) – Ip addresscreate_time (
str
) – Time ip was created
- class libcloud.compute.drivers.gridscale.GridscaleNetwork(id, name, status, create_time, relations)[source]¶
Bases:
object
Network Object
- Parameters
id (
str
) – uuidname (
str
) – Name of Networkstatus (
str
) – Network statusrelations (
object
) – object related to networkcreate_time (
str
) – Time Network was created
- class libcloud.compute.drivers.gridscale.GridscaleNodeDriver(user_id, key, **kwargs)[source]¶
Bases:
libcloud.common.gridscale.GridscaleBaseDriver
,libcloud.compute.base.NodeDriver
create and entry in libcloud/compute/providers for gridscale
- 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 = 'gridscale'¶
- attach_volume(node, volume)[source]¶
Attaches volume to node.
- Parameters
node (
Node
) – Node to attach volume to.volume (
StorageVolume
) – Volume to attach.
- Rytpe
bool
- connectionCls¶
- create_node(name, size, image, location, ex_ssh_key_ids=None, **kwargs)[source]¶
Create a simple node with a name, cores, memory at the designated location.
- Parameters
name (
str
) – Name of the server.size (
NodeSize
) – Nodesize object.image (
GridscaleTemplate
) – OS image to attach to the storage.location (
NodeLocation
) – The data center to create a node in.ex_ssh_key_ids (
list
ofstr
) – List of SSH key IDs to add to the server.
- Returns
The newly created Node.
- Return type
- create_volume(size, name, location=None, snapshot=None)[source]¶
Create a new volume.
- Parameters
size (
int
) – Integer in GB.name (
str
) – Name of the volume.location (
NodeLocation
) – The server location.snapshot (
VolumeSnapshot
) – Snapshot from which to create the new volume. (optional)
- Returns
Newly created StorageVolume.
- Return type
- create_volume_snapshot(volume, name)[source]¶
Creates a snapshot of the current state of your volume, you can rollback to.
- Parameters
volume (
StorageVolume
) – Volume you want to create a snapshot of.name (
str
) – Name of the snapshot.
- Returns
VolumeSnapshot.
- Return type
- delete_image(node_image)[source]¶
Destroy an image.
- Parameters
node_image (
NodeImage
) – Node image object.- Returns
True if the destroy was successful, otherwise False
- Return type
bool
- destroy_node(node, ex_destroy_associated_resources=False)[source]¶
Destroy node.
- Parameters
node (
Node
) – Node object.ex_destroy_associated_resources – True to destroy associated
resources such as storage volumes and IPs. :type ex_destroy_associated_resources:
bool
- Returns
True if the destroy was successful, otherwise False.
- Return type
bool
- destroy_volume(volume)[source]¶
Delete volume.
- Parameters
volume (
StorageVolume
) – Volume to be destroyed.- Returns
True if the destroy was successful, otherwise False.
- Return type
bool
- destroy_volume_snapshot(snapshot)[source]¶
Destroy a snapshot.
- Parameters
snapshot (:class:'.VolumeSnapshot`) – The snapshot to delete.
- Returns
True if the destroy was successful, otherwise False.
- Return type
bool
- detach_volume(volume)[source]¶
Detaches a volume from a node.
- Parameters
volume (
StorageVolume
) – Volume to be detached- Return type
bool
- ex_create_ip(family, location, name)[source]¶
Create either an ip_v4 ip or a ip_v6.
- Parameters
family (
int
) – Defines if the ip is v4 or v6 with int 4 or int 6.location (
NodeLocation
) – Defines which datacenter the created ip responds with.name (
str
) – Name of your Ip.
- Returns
Ip
- Return type
- ex_create_networks(name, location)[source]¶
Create a network at the data center location.
- Parameters
name (
str
) – Name of the network.location (
NodeLocation
) – Location.
- Returns
Network.
- Return type
- ex_destroy_ip(ip)[source]¶
Delete an ip.
- Parameters
ip (
GridscaleIp
) – IP object.- Returns
True
if delete_image was successful,False
otherwise.- Return type
bool
- ex_destroy_network(network)[source]¶
Delete network.
- Parameters
network (
GridscaleNetwork
) – Network object.- Returns
True
if destroyed successfully, otherwiseFalse
- Return type
bool
- ex_link_ip_to_node(node, ip)[source]¶
links a existing ip with a node
- Parameters
node (
object
) – node objectip (
object
) – ip object
- Returns
Request ID
- Return type
str
- ex_link_isoimage_to_node(node, isoimage)[source]¶
link and isoimage to a node
- Parameters
node (
object
) – Node you want to link the iso image toisoimage (
object
) – isomiage you want to link
- Returns
None -> success
- Return type
None
- ex_link_network_to_node(node, network)[source]¶
Link a network to a node.
- Parameters
node (
Node
) – Node object to link networks to.network (
GridscaleNetwork
) – Network you want to link.
- Returns
True
if linked sucessfully, otherwiseFalse
- Return type
bool
- ex_list_ips()[source]¶
Lists all IPs available.
- Returns
List of IP objects.
- Return type
list
ofGridscaleIp
- ex_list_ips_for_node(node)[source]¶
Return a list of associated IPs for the provided node.
- Rype
list
ofGridscaleIp
- ex_list_networks()[source]¶
List all networks.
- Returns
List of objects.
- Return type
list
ofGridscaleNetwork
- ex_list_volumes_for_node(node)[source]¶
Return a list of associated volumes for the provided node.
- Return type
list
ofStorageVolume
- ex_rename_network(network, name)[source]¶
Modify networks name.
- Parameters
network (
GridscaleNetwork
) – Network.name (
str
) – New network name.
- Returns
True
orFalse
- Return type
bool
- ex_rename_node(node, name)[source]¶
Modify node name.
- Parameters
name (
str
) – New node name.node (
Node
) – Node
- Returns
True
orFalse
- Return type
bool
- ex_rename_volume(volume, name)[source]¶
Modify storage volume name
- Parameters
volume (:class:.`StorageVolume`) – Storage.
name (
str
) – New storage name.
- Returns
True
orFalse
- Return type
bool
- ex_storage_rollback(volume, snapshot, rollback)[source]¶
initiate a rollback on your storage
- Parameters
volume (
string
) – storage uuidsnapshot (
string
) – snapshot uuidrollback (
bool
) – variable
- Returns
RequestID
- Return type
str
- ex_unlink_ip_from_node(node, ip)[source]¶
unlink ips from server
- Parameters
node (
object
) – node you want to unlink the ip fromip (
object
) – the ip you want to unlink
- Returns
None -> success
- Return type
None
- ex_unlink_isoimage_from_node(node, isoimage)[source]¶
unlink isoimages from server
- Parameters
node (
object
) – node you want to unlink the image fromisoimage (
object
) – isoimage you want to unlink
- Returns
None -> success
- Return type
None
- features = {'create_node': ['ssh_key']}¶
- List of available features for a driver.
libcloud.compute.base.NodeDriver.create_node()
ssh_key: Supports
NodeAuthSSHKey
as an authentication method for nodes.password: Supports
NodeAuthPassword
as an authentication method for nodes.generates_password: Returns a password attribute on the Node object returned from creation.
- get_image(image_id)[source]¶
Get an image based on an image_id.
- Parameters
image_id (
str
) – Image identifier.- Returns
A NodeImage object.
- Return type
- 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.
- Return type
KeyPair
object
- list_images()[source]¶
List images.
- Returns
List of node image objects
- Return type
list
ofNodeImage
- list_locations()[source]¶
List all available data centers.
- Returns
List of node location objects
- Return type
list
ofNodeLocation
- list_volume_snapshots(volume)[source]¶
Lists all snapshots for storage volume.
- Parameters
volume (
StorageVolume
) – storage the snapshot is attached to- Returns
Snapshots
- Return type
list
ofVolumeSnapshot
- list_volumes()[source]¶
List all volumes.
- Returns
List of StorageVolume object
- Return type
list
ofStorageVolume
- name = 'Gridscale'¶
- reboot_node(node, ex_sleep_interval=3)[source]¶
Reboot a node.
- Parameters
node (
Node
) – Node object.ex_sleep_interval (
int
) – time to let the shutdown process finish
- Returns
True if the reboot was successful, otherwise False.
- Return type
bool
- start_node(node)[source]¶
Start a node.
- Parameters
node (
Node
) – The node to be started- Returns
True if the start was successful, otherwise False
- Return type
bool
- type = 'gridscale'¶
- website = 'https://gridscale.io'¶
libcloud.compute.drivers.gridspot module¶
- 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.- add_default_params(params)[source]¶
Adds default parameters (such as API key, version, etc.) to the passed params
Should return a dictionary.
- host = 'gridspot.com'¶
- responseCls¶
- 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': NodeState.RUNNING, 'Starting': NodeState.PENDING}¶
- connectionCls¶
alias of
libcloud.compute.drivers.gridspot.GridspotConnection
- destroy_node(node)[source]¶
Destroy a node.
Depending upon the provider, this may destroy all data associated with the node, including backups.
- Parameters
node (
Node
) – The node to be destroyed- Returns
True if the destroy was successful, False otherwise.
- Return type
bool
- name = 'Gridspot'¶
- type = 'gridspot'¶
- website = 'http://www.gridspot.com/'¶
- 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.
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
libcloud.compute.drivers.hostvirtual.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.
- class libcloud.compute.drivers.hostvirtual.HostVirtualNodeDriver(key, secure=True, host=None, port=None)[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
libcloud.compute.drivers.hostvirtual.HostVirtualComputeConnection
- create_node(name, image, size, location=None, auth=None)[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)
- destroy_node(node)[source]¶
Destroy a node.
Depending upon the provider, this may destroy all data associated with the node, including backups.
- Parameters
node (
Node
) – The node to be destroyed- Returns
True if the destroy was successful, False otherwise.
- Return type
bool
- ex_cancel_package(node)[source]¶
Cancel a server package.
- Parameters
node (
Node
) – Node which should be used- Return type
str
- ex_delete_node(node)[source]¶
Delete a node.
- Parameters
node (
Node
) – Node which should be used- Return 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 for- Return 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 usedimage (
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
- ex_unlink_package(node)[source]¶
Unlink a server package from location.
- Parameters
node (
Node
) – Node which should be used- Return type
str
- features = {'create_node': ['ssh_key', 'password']}¶
- List of available features for a driver.
libcloud.compute.base.NodeDriver.create_node()
ssh_key: Supports
NodeAuthSSHKey
as an authentication method for nodes.password: Supports
NodeAuthPassword
as an authentication method for nodes.generates_password: Returns a password attribute on the Node object returned from creation.
- list_images()[source]¶
List images on a provider.
- Parameters
location (
NodeLocation
) – The location at which to list images.- Returns
list of node image objects.
- Return type
list
ofNodeImage
- list_locations()[source]¶
List data centers for a provider
- Returns
list of node location objects
- Return type
list
ofNodeLocation
- list_sizes(location=None)[source]¶
List sizes on a provider
- Parameters
location (
NodeLocation
) – The location at which to list sizes- Returns
list of node size objects
- Return type
list
ofNodeSize
- name = 'HostVirtual'¶
- reboot_node(node)[source]¶
Reboot a node.
- Parameters
node (
Node
) – The node to be rebooted- Returns
True if the reboot was successful, otherwise False
- Return type
bool
- start_node(node)[source]¶
Start a node.
- Parameters
node (
Node
) – Node which should be used- Return type
bool
- stop_node(node)[source]¶
Stop a node.
- Parameters
node (
Node
) – Node which should be used- Return type
bool
- 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'¶
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
- Parameters
key (
str
) – API key or username to be used (required)secret (
str
) – Secret password to be used (required)secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default.host (
str
) – Override hostname used for connections.port (
int
) – Override port used for connections.api_version (
str
) – Optional API version. Only used by drivers which support multiple API versions.region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
- Return type
None
- api_version = 1.0¶
- connectionCls¶
alias of
libcloud.common.dimensiondata.DimensionDataConnection
- features = {'create_node': ['password']}¶
- List of available features for a driver.
libcloud.compute.base.NodeDriver.create_node()
ssh_key: Supports
NodeAuthSSHKey
as an authentication method for nodes.password: Supports
NodeAuthPassword
as an authentication method for nodes.generates_password: Returns a password attribute on the Node object returned from creation.
- 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
- Parameters
key (
str
) – API key or username to be used (required)secret (
str
) – Secret password to be used (required)secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default.host (
str
) – Override hostname used for connections.port (
int
) – Override port used for connections.api_version (
str
) – Optional API version. Only used by drivers which support multiple API versions.region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
- Return type
None
- api_version = 1.0¶
- connectionCls¶
alias of
libcloud.common.dimensiondata.DimensionDataConnection
- features = {'create_node': ['password']}¶
- List of available features for a driver.
libcloud.compute.base.NodeDriver.create_node()
ssh_key: Supports
NodeAuthSSHKey
as an authentication method for nodes.password: Supports
NodeAuthPassword
as an authentication method for nodes.generates_password: Returns a password attribute on the Node object returned from creation.
- 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.
Initialize user_id and key; set secure to an
int
based on passed value.- add_default_headers(headers)[source]¶
Adds default headers (such as Authorization, X-Foo-Bar) to the passed headers
Should return a dictionary.
- allow_insecure = False¶
- responseCls¶
- 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.
- 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¶
- create_node(name, size, image)[source]¶
Create a new node instance. This instance will be started automatically.
Not all hosting API’s are created equal and to allow libcloud to support as many as possible there are some standard supported variations of
create_node
. These are declared using afeatures
API. You can inspectdriver.features['create_node']
to see what variation of the API you are dealing with:ssh_key
You can inject a public key into a new node allows key based SSH authentication.
password
You can inject a password into a new node for SSH authentication. If no password is provided libcloud will generated a password. The password will be available as
return_value.extra['password']
.generates_password
The hosting provider will generate a password. It will be returned to you via
return_value.extra['password']
.
Some drivers allow you to set how you will authenticate with the instance that is created. You can inject this initial authentication information via the
auth
parameter.If a driver supports the
ssh_key
feature flag forcreated_node
you can upload a public key into the new instance:>>> from libcloud.compute.drivers.dummy import DummyNodeDriver >>> driver = DummyNodeDriver(0) >>> auth = NodeAuthSSHKey('pubkey data here') >>> node = driver.create_node("test_node", auth=auth)
If a driver supports the
password
feature flag forcreate_node
you can set a password:>>> driver = DummyNodeDriver(0) >>> auth = NodeAuthPassword('mysecretpassword') >>> node = driver.create_node("test_node", auth=auth)
If a driver supports the
password
feature and you don’t provide theauth
argument libcloud will assign a password:>>> driver = DummyNodeDriver(0) >>> node = driver.create_node("test_node") >>> password = node.extra['password']
A password will also be returned in this way for drivers that declare the
generates_password
feature, though in that case the password is actually provided to the driver API by the hosting provider rather than generated by libcloud.You can only pass a
NodeAuthPassword
orNodeAuthSSHKey
tocreate_node
via the auth parameter if has the corresponding feature flag.- 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)location (
NodeLocation
) – Which data center to create a node in. If empty, undefined behavior will be selected. (optional)auth (
NodeAuthSSHKey
orNodeAuthPassword
) – Initial authentication information for the node (optional)
- Returns
The newly created node.
- Return type
- destroy_node(node)[source]¶
Destroy a node.
Depending upon the provider, this may destroy all data associated with the node, including backups.
- Parameters
node (
Node
) – The node to be destroyed- Returns
True if the destroy was successful, False otherwise.
- Return type
bool
- ex_get_node(node_id)[source]¶
Return a Node object based on a node ID.
- Parameters
node_id (
str
) – ID of the node- Returns
A Node object for the node
- Return type
Node
- features = {'create_node': ['generates_password']}¶
- List of available features for a driver.
libcloud.compute.base.NodeDriver.create_node()
ssh_key: Supports
NodeAuthSSHKey
as an authentication method for nodes.password: Supports
NodeAuthPassword
as an authentication method for nodes.generates_password: Returns a password attribute on the Node object returned from creation.
- list_images()[source]¶
List images on a provider.
- Parameters
location (
NodeLocation
) – The location at which to list images.- Returns
list of node image objects.
- Return type
list
ofNodeImage
- list_sizes()[source]¶
List sizes on a provider
- Parameters
location (
NodeLocation
) – The location at which to list sizes- Returns
list of node size objects
- Return type
list
ofNodeSize
- name = 'Joyent'¶
- reboot_node(node)[source]¶
Reboot a node.
- Parameters
node (
Node
) – The node to be rebooted- Returns
True if the reboot was successful, otherwise False
- Return type
bool
- start_node(node)[source]¶
Start node
- Parameters
node (
Node
) – The node to be stopped- Return type
bool
- 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.
- parse_error()[source]¶
Parse the error messages.
Override in a provider’s subclass.
- Returns
Parsed error.
- Return type
str
- success()[source]¶
Determine if our request was successful.
The meaning of this can be arbitrary; did we receive OK status? Did the node get created? Were we authenticated?
- Return type
bool
- Returns
True
orFalse
- valid_response_codes = [<HTTPStatus.OK: 200>, <HTTPStatus.ACCEPTED: 202>, <HTTPStatus.CREATED: 201>, <HTTPStatus.NO_CONTENT: 204>]¶
libcloud.compute.drivers.kamatera module¶
Kamatera node driver
- class libcloud.compute.drivers.kamatera.KamateraConnection(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 KamateraDriver
Initialize user_id and key; set secure to an
int
based on passed value.- host = 'cloudcli.cloudwm.com'¶
- responseCls¶
- class libcloud.compute.drivers.kamatera.KamateraNodeDriver(key, secret=None, secure=True, host=None, port=None, api_version=None, region=None, **kwargs)[source]¶
Bases:
libcloud.compute.base.NodeDriver
Kamatera node driver
- Parameters
key (
str
) – API Client ID, required for authenticationsecret (
str
) – API Secret, required for authentcaiontkey – 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 (
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_BILLINGCYCLE_HOURLY = 'hourly'¶
- EX_BILLINGCYCLE_MONTHLY = 'monthly'¶
- connectionCls¶
alias of
libcloud.compute.drivers.kamatera.KamateraConnection
- create_node(name, size, image, location, auth=None, ex_networks=None, ex_dailybackup=False, ex_managed=False, ex_billingcycle='hourly', ex_poweronaftercreate=True, ex_wait=True)[source]¶
Creates a Kamatera node.
If auth is not given then password will be generated.
- 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)location (
NodeLocation
) – Which data center to create a node in. (required)auth (
NodeAuthSSHKey
orNodeAuthPassword
) – Authentication information for the node (optional)ex_networks (
list
ofdict
) – Network configurations (optional)ex_dailybackup (
bool
) – Whether to create daily backups (optional)ex_managed (
bool
) – Whether to provide managed support (optional)ex_billingcycle (
str
) – billing cycle (hourly / monthly) (optional)ex_poweronaftercreate (
bool
) – power on after creation (optional)ex_wait (
bool
) – wait for server to be running (optional)
- Returns
The newly created node.
- Return type
- destroy_node(node, ex_wait=True)[source]¶
Destroy the given node
- Parameters
node (
Node
) – the node to destroyex_wait (
bool
) – wait for destroy to complete (optional)
- Return type
bool
- ex_get_command_status(command_id)[source]¶
Get Kamatera command status details
- Parameters
command_id (
int
) – Command ID to get details for. (required)- Returns
dict
- ex_get_location(id, name=None, country=None)[source]¶
Get a NodeLocation object to use for other methods
- Parameters
id (
str
) – Location ID - uppercase letters code (required)name (
str
) – Location Name (optional)name – Location country (optional)
- Return type
- ex_get_node(id=None, name=None, state=NodeState.UNKNOWN, public_ips=None, private_ips=None, size=None, image=None, created_at=None, location=None, dailybackup=None, managed=None, billingcycle=None, generated_password=None, create_command_id=None, poweronaftercreate=None)[source]¶
Get a Kamatera node object.
- Parameters
id (
str
) – Node ID (optional)name (
str
) – Node name (optional)state (
libcloud.compute.types.NodeState
) – Node state (optional)public_ips (
list
of :str:) – Node public IPS. (optional)private_ips (
list
of :str:) – Node private IPS. (optional)size (
NodeSize
) – node size. (optional)image (
NodeImage
) – Node OS Image. (optional)created_at (
datetime.datetime
) – Node creation time. (optional)location (
NodeLocation
) – Node datacenter. (optional)dailybackup (
bool
) – create daily backups for the node (optional)managed (
bool
) – provide managed support for the node (optional)billingcycle (
str
) – billing cycle (hourly / monthly) (optional)generated_password (
str
) – server generated password (optional)create_command_id (
int
) – creation task command ID (optional)poweronaftercreate (
bool
) – power on the node after create (optional)
- Returns
The node.
- Return type
- ex_get_size(ramMB, diskSizeGB, cpuType, cpuCores, extraDiskSizesGB=None, monthlyTrafficPackage=None, id=None, name=None)[source]¶
Get a NodeSize object to use for other methods
- Parameters
ramMB (
int
) – Amount of RAM to allocate in MB (required)diskSizeGB (
int
) – disk size GB for primary hard disk (required)cpuType (
str
) – CPU type ID (single uppercase letter), see ex_list_capabilities (required)cpuCores (
int
) – Number of CPU cores to allocate (required)extraDiskSizesGB (
list
of :int:) – additional disk sizes in GB (optional)monthlyTrafficPackage (
str
) – ID of monthly traffic package see ex_list_capabilities (optional)id (
str
) – Size ID (optional)name (
str
) – Size Name (optional)
- Return type
- ex_list_capabilities(location)[source]¶
List capabilities for given location.
- Parameters
location (
NodeLocation
) – Location of the deployment.- Returns
dict
- ex_node_operation(node, operation, wait=True)[source]¶
Run custom operations on the node
- Parameters
node (
Node
) – the node to run operation onoperation (
str
) – the operation to runex_wait (
bool
) – wait for destroy to complete (optional)
- Return type
bool
- ex_wait_command(command_id, timeout_seconds=600, poll_interval_seconds=2)[source]¶
Wait for command to complete and return the command status details
- Parameters
command_id (
int
) – Command ID to wait for. (required)timeout_seconds (
int
) – Max seconds to wait for command. (optional)poll_interval_seconds (
int
) – Poll interval in seconds (optional)
- Returns
dict
- features = {'create_node': ['password', 'generates_password', 'ssh_key']}¶
- List of available features for a driver.
libcloud.compute.base.NodeDriver.create_node()
ssh_key: Supports
NodeAuthSSHKey
as an authentication method for nodes.password: Supports
NodeAuthPassword
as an authentication method for nodes.generates_password: Returns a password attribute on the Node object returned from creation.
- list_images(location)[source]¶
List available disk images.
- Parameters
location (
NodeLocation
) – Location of the deployement. Available disk images depend on location.- Return type
list
ofNodeImage
- list_nodes(ex_name_regex=None, ex_full_details=False, ex_id=None)[source]¶
List nodes
- Parameters
ex_name_regex (
str
) – Regular expression to match node names if set returns full node details (optional)ex_full_details (
bool
) – Whether to return full node details takes longer to complete (optional)
- Returns
List of node objects
- Return type
list
ofNode
- list_sizes(location)[source]¶
List predefined sizes for the given location.
- Parameters
location (
NodeLocation
) – Location of the deployment.
@inherits:
NodeDriver.list_sizes
- name = 'Kamatera'¶
- reboot_node(node, ex_wait=True)[source]¶
Reboot the given node
- Parameters
node (
Node
) – the node to rebootex_wait (
bool
) – wait for reboot to complete (optional)
- Return type
bool
- start_node(node, ex_wait=True)[source]¶
Start the given node
- Parameters
node (
Node
) – the node to startex_wait (
bool
) – wait for start to complete (optional)
- Return type
bool
- stop_node(node, ex_wait=True)[source]¶
Stop the given node
- Parameters
node (
Node
) – the node to stopex_wait (
bool
) – wait for stop to complete (optional)
- Return type
bool
- type = 'kamatera'¶
- website = 'https://www.kamatera.com/'¶
- class libcloud.compute.drivers.kamatera.KamateraResponse(response, connection)[source]¶
Bases:
libcloud.common.base.JsonResponse
Response class for KamateraDriver
- Parameters
response (
httplib.HTTPResponse
) – HTTP response object. (optional)connection (
Connection
) – Parent connection object.
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=None, secure=True, host=None, port=None, api_version='1.1', **kwargs)[source]¶
Bases:
libcloud.compute.drivers.openstack.OpenStack_1_1_NodeDriver
Note: tenant_name argument is required for Kili cloud.
- connectionCls¶
alias of
libcloud.compute.drivers.kili.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'¶
- create_node(name, size, image, location=None, ex_usageplantype='hourly')[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 keypairex_userdata (
str
) – String containing user dataex_security_groups (
list
ofstr
) – List of security groups to assign to the nodeex_displayname (
str
) – String containing instance display nameex_ip_address (
str
) – String with ipaddress for the default nicex_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 templateex_affinity_groups (
list
ofCloudStackAffinityGroup
) – List of affinity groups to assign to the node
- Return type
- list_images(location=None)[source]¶
List images on a provider.
- Parameters
location (
NodeLocation
) – The location at which to list images.- Returns
list of node image objects.
- Return type
list
ofNodeImage
- name = 'KTUCloud'¶
- type = 'ktucloud'¶
- website = 'https://ucloudbiz.olleh.com/'¶
libcloud.compute.drivers.kubevirt module¶
kubevirt driver with support for nodes (vms)
- class libcloud.compute.drivers.kubevirt.KubeVirtNodeDriver(key=None, secret=None, secure=False, host='localhost', port=4243, key_file=None, cert_file=None, ca_cert=None, ex_token_bearer_auth=False)[source]¶
Bases:
libcloud.common.kubernetes.KubernetesDriverMixin
,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.key_file (
str
) – Path to the key file used to authenticate (when using key file auth).cert_file (
str
) – Path to the cert file used to authenticate (when using key file auth).ex_token_bearer_auth (
bool
) – True to use token bearer auth.
- Returns
None
- NODE_STATE_MAP = {'pending': NodeState.PENDING, 'running': NodeState.RUNNING, 'stopped': NodeState.STOPPED}¶
- attach_volume(node, volume, device='disk', ex_bus='virtio', ex_name=None)[source]¶
params: bus, name , device (disk or lun)
- connectionCls¶
alias of
libcloud.common.kubernetes.KubernetesBasicAuthConnection
- create_node(name, image, location=None, ex_memory=128, ex_cpu=1, ex_disks=None, ex_network=None, ex_termination_grace_period=0, ports=None)[source]¶
Creating a VM with a containerDisk. :param name: A name to give the VM. The VM will be identified by
this name and atm it cannot be changed after it is set.
- Parameters
image (str) – Either a libcloud NodeImage or a string. In both cases it must point to a Docker image with an embedded disk. May be a URI like kubevirt/cirros-registry-disk-demo, kubevirt will automatically pull it from https://hub.docker.com/u/URI. For more info visit: https://kubevirt.io/user-guide/docs/latest/creating-virtual-machines/disks-and-volumes.html#containerdisk
location (
str
) – The namespace where the VM will live. (default is ‘default’)ex_memory (
int
) – The RAM in MB to be allocated to the VMex_cpu (
int
) – The ammount of cpu to be allocated in miliCPUs ie: 400 will mean 0.4 of a core, 1000 will mean 1 core and 3000 will mean 3 cores.ex_disks (list of dict. For each dict the types for its keys are: -bus: str -device: str -disk_type: str -name: str -claim_name: str (for creating a claim:) -size: int -storage_class_name: str -volume_mode: str -access_mode: str) –
- A list containing disk dictionaries.
Each dictionaries should have the following optional keys: -bus: can be “virtio”, “sata”, or “scsi” -device: can be “lun” or “disk” The following are required keys: -disk_type: atm only “persistentVolumeClaim”
is supported
-name: The name of the disk configuration -claim_name: the name of the
Persistent Volume Claim
If you wish a new Persistent Volume Claim can be created by providing the following: required: -size: the desired size (implied in GB) -storage_class_name: the name of the storage class to # NOQA
be used for the creation of the Persistent Volume Claim. Make sure it allows for dymamic provisioning.
optional:
-access_mode: default is ReadWriteOnce -volume_mode: default is Filesystem,
it can also be Block
ex_network (iterable (tupple or list) [network_type, inteface, name] network_type: str | only “pod” is accepted atm interface: str | “masquerade” or “bridge” name: str) – Only the pod type is supported, and in the configuration masquerade or bridge are the accepted values. The parameter must be a tupple or list with (network_type, interface, name)
ports (dict with keys ‘ports_tcp`: list of int ‘ports_udp`: list of int) – A dictionary with keys: ‘ports_tcp’ and ‘ports_udp’ ‘ports_tcp’ value is a list of ints that indicate the ports to be exposed with TCP protocol, and ‘ports_udp’ is a list of ints that indicate the ports to be exposed with UDP protocol.
- create_volume(size, name, location=None, ex_storage_class_name='', ex_volume_mode='Filesystem', ex_access_mode='ReadWriteOnce', ex_dynamic=True, ex_reclaim_policy='Recycle', ex_volume_type=None, ex_volume_params=None)[source]¶
- Parameters
size (int) – The size in Gigabytes
volume_type (str) –
This is the type of volume to be created that is dependent on the underlying cloud where Kubernetes is deployed. K8s is supporting the following types: -gcePersistentDisk -awsElasticBlockStore -azureFile -azureDisk -csi -fc (Fibre Channel) -flexVolume -flocker -nfs -iSCSI -rbd (Ceph Block Device) -cephFS -cinder (OpenStack block storage) -glusterfs -vsphereVolume -quobyte Volumes -hostPath (Single node testing only – local storage is not supported in any way and WILL NOT WORK in a multi-node cluster) # NOQA -portworx Volumes -scaleIO Volumes -storageOS This parameter is a dict in the form {type: {key1:value1, key2:value2,…}}, where type is one of the above and key1, key2… are type specific keys and their corresponding values. eg: {nsf: {server: “172.0.0.0”, path: “/tmp”}}
{awsElasticBlockStore: {fsType: ‘ext4’, volumeID: “1234”}}
volume_params – A dict with the key:value that the volume_type needs. This parameter is a dict in the form {key1:value1, key2:value2,…}, where type is one of the above and key1, key2… are type specific keys and their corresponding values. eg: for nsf volume_type {server: “172.0.0.0”, path: “/tmp”} for awsElasticBlockStore volume_type {fsType: ‘ext4’, volumeID: “1234”}
- destroy_volume(volume)[source]¶
Destroys a storage volume.
- Parameters
volume (
StorageVolume
) – Volume to be destroyed- Return type
bool
- detach_volume(volume, ex_node)[source]¶
Detaches a volume from a node but the node must be given since a PVC can have more than one VMI’s pointing to it
- ex_create_service(node, ports, service_type='NodePort', cluster_ip=None, load_balancer_ip=None, override_existing_ports=False)[source]¶
Each node has a single service of one type on which the exposed ports are described. If a service exists then the port declared will be exposed alongside the existing ones, set override_existing_ports=True to delete existing exposed ports and expose just the ones in the port variable.
param node: the libcloud node for which the ports will be exposed type node: libcloud Node class
- param ports: a list of dictionaries with keys –> values:
‘port’ –> port to be exposed on the service ‘target_port’ –> port on the pod/node, optional
if empty then it gets the same value as ‘port’ value
‘protocol’ —> either ‘UDP’ or ‘TCP’, defaults to TCP ‘name’ –> A name for the service If ports is an empty list and a service exists of this type then the service will be deleted.
- type ports: list of dict where each dict has keys –> values:
‘port’ –> int ‘target_port’ –> int ‘protocol’ –> str ‘name’ –> str
param service_type: Valid types are ClusterIP, NodePort, LoadBalancer type service_type: str
- param cluster_ip: This can be set with an IP string value if you want
manually set the service’s internal IP. If the value is not correct the method will fail, this value can’t be updated.
type cluster_ip: str
- param override_existing_ports: Set to True if you want to delete the
existing ports exposed by the service and keep just the ones declared in the present ports argument. By default it is false and if the service already exists the ports will be added to the existing ones.
type override_existing_ports: boolean
- ex_list_services(namespace='default', node_name=None, service_name=None)[source]¶
If node_name is given then the services returned will be those that concern the node
- list_images(location=None)[source]¶
If location (namespace) is provided only the images in that location will be provided. Otherwise all of them.
- list_nodes(location=None)[source]¶
List all nodes.
- Returns
list of node objects
- Return type
list
ofNode
- list_sizes(location=None)[source]¶
List sizes on a provider
- Parameters
location (
NodeLocation
) – The location at which to list sizes- Returns
list of node size objects
- Return type
list
ofNodeSize
- name = 'kubevirt'¶
- start_node(node)[source]¶
Start a node.
- Parameters
node (
Node
) – The node to be started- Returns
True if the start was successful, otherwise False
- Return type
bool
- stop_node(node)[source]¶
Stop a node
- Parameters
node (
Node
) – The node to be stopped.- Returns
True if the stop was successful, otherwise False
- Return type
bool
- type = 'kubevirt'¶
- website = 'https://www.kubevirt.io'¶
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 serversecret – the password for a remote libvirtd server
- NODE_STATE_MAP = {0: NodeState.TERMINATED, 1: NodeState.RUNNING, 2: NodeState.PENDING, 3: NodeState.TERMINATED, 4: NodeState.TERMINATED, 5: NodeState.TERMINATED, 6: NodeState.UNKNOWN, 7: NodeState.UNKNOWN}¶
- destroy_node(node)[source]¶
Destroy a node.
Depending upon the provider, this may destroy all data associated with the node, including backups.
- Parameters
node (
Node
) – The node to be destroyed- Returns
True if the destroy was successful, False otherwise.
- Return type
bool
- 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 used- Return 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 used- Return type
bool
- ex_start_node(node)[source]¶
Start a stopped node.
- Parameters
node (
Node
) – Node which should be used- Return type
bool
- ex_suspend_node(node)[source]¶
Suspend a running node.
- Parameters
node (
Node
) – Node which should be used- Return 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
- name = 'Libvirt'¶
- reboot_node(node)[source]¶
Reboot a node.
- Parameters
node (
Node
) – The node to be rebooted- Returns
True if the reboot was successful, otherwise False
- Return type
bool
- start_node(node)[source]¶
Start a node.
- Parameters
node (
Node
) – The node to be started- Returns
True if the start was successful, otherwise False
- Return type
bool
- stop_node(node)[source]¶
Stop a node
- Parameters
node (
Node
) – The node to be stopped.- Returns
True if the stop was successful, otherwise False
- Return type
bool
- type = 'libvirt'¶
- website = 'http://libvirt.org/'¶
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, secret=None, secure=True, host=None, port=None, api_version='4.0', 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 = 'Linode'¶
- type = 'linode'¶
- website = 'http://www.linode.com/'¶
- class libcloud.compute.drivers.linode.LinodeNodeDriverV3(key, secret=None, secure=True, host=None, port=None, api_version='4.0', region=None, **kwargs)[source]¶
Bases:
libcloud.compute.drivers.linode.LinodeNodeDriver
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 = {-2: NodeState.UNKNOWN, -1: NodeState.PENDING, 0: NodeState.PENDING, 1: NodeState.RUNNING, 2: NodeState.STOPPED, 3: NodeState.REBOOTING, 4: NodeState.UNKNOWN}¶
- connectionCls¶
- create_node(name, image, size, auth, location=None, ex_swap=None, ex_rsize=None, ex_kernel=None, ex_payment=None, ex_comment=None, ex_private=False, lconfig=None, lroot=None, lswap=None)[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 inex_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
- 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 destroy- Return 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 destroyed- Return 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 creatednode (
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
- 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
- ex_resize_node(node, size)[source]¶
Resizes a Linode from one plan to another
Immediately shuts the Linode down, charges/credits the account, and issue a migration to another host server. Requires a size (numeric), which is the desired PlanID available from avail.LinodePlans() After resize is complete the node needs to be booted
- features = {'create_node': ['ssh_key', 'password']}¶
- List of available features for a driver.
libcloud.compute.base.NodeDriver.create_node()
ssh_key: Supports
NodeAuthSSHKey
as an authentication method for nodes.password: Supports
NodeAuthPassword
as an authentication method for nodes.generates_password: Returns a password attribute on the Node object returned from creation.
- 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 specified- Return 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 in- Return type
list
ofNodeSize
- class libcloud.compute.drivers.linode.LinodeNodeDriverV4(key, secret=None, secure=True, host=None, port=None, api_version='4.0', region=None, **kwargs)[source]¶
Bases:
libcloud.compute.drivers.linode.LinodeNodeDriver
- 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
- LINODE_DISK_STATES = {'deleting': StorageVolumeState.DELETING, 'not ready': StorageVolumeState.CREATING, 'ready': StorageVolumeState.AVAILABLE}¶
- LINODE_STATES = {'booting': NodeState.STARTING, 'cloning': NodeState.MIGRATING, 'deleting': NodeState.PENDING, 'migrating': NodeState.MIGRATING, 'offline': NodeState.STOPPED, 'provisioning': NodeState.STARTING, 'rebooting': NodeState.REBOOTING, 'rebuilding': NodeState.UPDATING, 'resizing': NodeState.RECONFIGURING, 'restoring': NodeState.PENDING, 'running': NodeState.RUNNING, 'shutting_down': NodeState.STOPPING, 'stopped': NodeState.STOPPED}¶
- LINODE_VOLUME_STATES = {'active': StorageVolumeState.AVAILABLE, 'contact_support': StorageVolumeState.UNKNOWN, 'creating': StorageVolumeState.CREATING, 'resizing': StorageVolumeState.UPDATING}¶
- attach_volume(node, volume, persist_across_boots=True)[source]¶
Attaches a volume to a node. Volume and node must be located in the same region
- Parameters
node (
Node
) – Node to attach the volume to(required)volume (
StorageVolume
) – Volume to be attached (required)persist_across_boots (bool) – Wether volume should be attached to node across boots
- Return type
- class
StorageVolume
- connectionCls¶
- create_image(disk, name=None, description=None)[source]¶
- Creates a private image from a LinodeDisk.
Images are limited to three per account.
- Parameters
disk (
LinodeDisk
) – LinodeDisk to create the image from (required)name (str) – A name for the image. Defaults to the name of the disk it is being created from if not provided
description (str) – A description of the image
- Returns
The newly created NodeImage
- Return type
NodeImage
- create_node(location, size, image=None, name=None, root_pass=None, ex_authorized_keys=None, ex_authorized_users=None, ex_tags=None, ex_backups_enabled=False, ex_private_ip=False)[source]¶
Creates a Linode Instance. In order for this request to complete successfully, the user must have the add_linodes grant as this call will incur a charge.
- Parameters
location (
NodeLocation
) – which region to create the node insize (
NodeSize
) – the plan size to createimage (
NodeImage
) – which distribution to deploy on the nodename (
str
) – the name to assign to node. Must start with an alpha character. May only consist of alphanumeric characters, dashes (-), underscores (_) or periods (.). Cannot have two dashes (–), underscores (__) or periods (..) in a row.root_pass (
str
) – the root password (required if image is provided)ex_authorized_keys (
list
ofstr
) – a list of public SSH keysex_authorized_users (
list
ofstr
) – a list of usernames. If the usernames have associated SSH keys, the keys will be appended to the root users authorized_keysex_tags (
list
ofstr
) – list of tags for the nodeex_backups_enabled (
bool
) – whether to be enrolled in the Linode Backup service (False)ex_private_ip (
bool
) – whether or not to request a private IP
- Returns
Node representing the newly-created node
- Return type
Node
- create_volume(name, size, location=None, node=None, tags=None)[source]¶
Creates a volume and optionally attaches it to a node.
- Parameters
name (str) – The name to be given to volume (required). Must start with an alpha character. May only consist of alphanumeric characters, dashes (-), underscores (_) Cannot have two dashes (–), underscores (__) in a row.
size (int) – Size in gigabytes (required)
location (
NodeLocation
) – Location to create the node. Required if node is not given.volume (
Node
) – Node to attach the volume totags (list of str) – tags to apply to volume
- Return type
- class
StorageVolume
- delete_image(image)[source]¶
Deletes a private image
- Parameters
image (
NodeImage
) – NodeImage to delete (required)- Return type
bool
- destroy_node(node)[source]¶
Deletes a node the API Key has permission to read_write
- Parameters
node (
Node
) – the Linode to destroy- Return type
bool
- destroy_volume(volume)[source]¶
Destroys the volume given.
- Parameters
volume (
StorageVolume
) – Volume to be deleted (required)- Return type
bool
- detach_volume(volume)[source]¶
Detaches a volume from a node.
- Parameters
volume (
StorageVolume
) – Volume to be detached (required)- Return type
bool
- ex_allocate_private_address(node, address_type='ipv4')[source]¶
Allocates a private IPv4 address to node.Only ipv4 is currently supported
- Parameters
node (
Node
) – Node to attach the IP addressaddress_type (str) – Type of IP address
- Returns
The newly created LinodeIPAddress
- Return type
LinodeIPAddress
- ex_clone_volume(volume, name)[source]¶
Clones the volume given
- Parameters
volume (
StorageVolume
) – Volume to be clonedname (str) – new cloned volume name
- Return type
StorageVolume
- ex_create_disk(size, name, node, fs_type, image=None, ex_root_pass=None, ex_authorized_keys=None, ex_authorized_users=None, ex_read_only=False)[source]¶
Adds a new disk to node
- Parameters
size (
int
) – Size of disk in megabytes (required)name (
str
) – Name of the disk to be created (required)node (
Node
) – Node to attach disk to (required)fs_type (
str
) – The formatted type of this disk. Valid types are: ext3, ext4, swap, raw, initrdimage (
NodeImage
) – Image to deploy the volume fromex_root_pass (
str
) – root password,required if an image is providedex_authorized_keys (
list
ofstr
) – a list of SSH keysex_authorized_users (
list
ofstr
) – a list of usernames that will have their SSH keys, if any, automatically appended to the root user’s ~/.ssh/authorized_keys file.ex_read_only (
bool
) – if true, this disk is read-only
- Returns
LinodeDisk representing the newly-created disk
- Return type
LinodeDisk
- ex_destroy_disk(node, disk)[source]¶
Destroys disk for the given node.
- Parameters
node (
Node
) – The Node the disk is attached to. (required)disk (
LinodeDisk
) – LinodeDisk to be destroyed (required)
- Return type
bool
- ex_get_node(node_id)[source]¶
Return a Node object based on a node ID.
- Parameters
node_id (
str
) – Node’s ID- Returns
Created node
:rtype :
Node
- ex_get_volume(volume_id)[source]¶
Return a Volume object based on a volume ID.
- Parameters
volume_id (
str
) – Volume’s id- Returns
A StorageVolume object for the volume
- Return type
StorageVolume
- ex_list_addresses()[source]¶
List IP addresses
- Returns
LinodeIPAddress list
- Return type
list of
LinodeIPAddress
- ex_list_disks(node)[source]¶
List disks associated with the node.
- Parameters
node (
Node
) – Node to list disks. (required)- Return type
list
ofLinodeDisk
- ex_list_node_addresses(node)[source]¶
List all IPv4 addresses attached to node
- Parameters
node (
Node
) – Node to list IP addresses- Returns
LinodeIPAddress list
- Return type
list of
LinodeIPAddress
- ex_rename_node(node, name)[source]¶
Renames a node
- Parameters
node (
Node
) – the Linode to resizename (
str
) – the node’s new name
- Returns
Changed Node
- Return type
Node
- ex_resize_node(node, size, allow_auto_disk_resize=False)[source]¶
Resizes a node the API Key has read_write permission to a different Type. The following requirements must be met: - The node must not have a pending migration - The account cannot have an outstanding balance - The node must not have more disk allocation than the new size allows
- Parameters
node (
Node
) – the Linode to resizesize (
NodeSize
) – the size of the new nodeallow_auto_disk_resize (
bool
) – Automatically resize disks when resizing a node.
- Return type
bool
- ex_resize_volume(volume, size)[source]¶
Resizes the volume given.
- Parameters
volume (
StorageVolume
) – Volume to be resizedsize (int) – new volume size in gigabytes, must be greater than current size
- Return type
bool
- Shares an IP with another node.This can be used to allow one Linode
to begin serving requests should another become unresponsive.
- Parameters
node (
Node
) – Node to share the IP addresses withaddresses – List of IP addresses to share
- Return type
bool
- list_locations()[source]¶
Lists the Regions available for Linode services
- Return type
list
ofNodeLocation
- list_nodes()[source]¶
Returns a list of Linodes the API key in use has access to view.
- Returns
List of node objects
- Return type
list
ofNode
- reboot_node(node)[source]¶
Reboots a node the API Key has permission to modify.
- Parameters
node (
Node
) – the Linode to destroy- Return type
bool
libcloud.compute.drivers.maxihost module¶
- class libcloud.compute.drivers.maxihost.MaxihostNodeDriver(key, secret=None, secure=True, host=None, port=None, api_version=None, region=None, **kwargs)[source]¶
Bases:
libcloud.compute.base.NodeDriver
Base Maxihost 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¶
- create_key_pair(name, public_key)[source]¶
Create a new SSH key.
- Parameters
name (
str
) – Key name (required)public_key (
str
) – base64 encoded public key string (required)
- create_node(name, size, image, location, ex_ssh_key_ids=None)[source]¶
Create a node.
- Returns
The newly created node.
- Return type
Node
- list_key_pairs()[source]¶
List all the available SSH keys.
- Returns
Available SSH keys.
- Return type
list
ofKeyPair
- list_locations(ex_available=True)[source]¶
List locations
If ex_available is True, show only locations which are available
- name = 'Maxihost'¶
- type = 'maxihost'¶
- website = 'https://www.maxihost.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
- Parameters
key (
str
) – API key or username to be used (required)secret (
str
) – Secret password to be used (required)secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default.host (
str
) – Override hostname used for connections.port (
int
) – Override port used for connections.api_version (
str
) – Optional API version. Only used by drivers which support multiple API versions.region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
- Return type
None
- api_version = 1.0¶
- connectionCls¶
alias of
libcloud.common.dimensiondata.DimensionDataConnection
- features = {'create_node': ['password']}¶
- List of available features for a driver.
libcloud.compute.base.NodeDriver.create_node()
ssh_key: Supports
NodeAuthSSHKey
as an authentication method for nodes.password: Supports
NodeAuthPassword
as an authentication method for nodes.generates_password: Returns a password attribute on the Node object returned from creation.
- 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
Initialize user_id and key; set secure to an
int
based on passed value.- allow_insecure = False¶
- host = 'api.nephoscale.com'¶
- responseCls¶
alias of
libcloud.compute.drivers.nephoscale.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
libcloud.compute.drivers.nephoscale.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
- features = {'create_node': ['ssh_key']}¶
- List of available features for a driver.
libcloud.compute.base.NodeDriver.create_node()
ssh_key: Supports
NodeAuthSSHKey
as an authentication method for nodes.password: Supports
NodeAuthPassword
as an authentication method for nodes.generates_password: Returns a password attribute on the Node object returned from creation.
- name = 'NephoScale'¶
- rename_node(node, name, hostname=None)[source]¶
rename a cloud server, optionally specify hostname too
- type = 'nephoscale'¶
- website = 'http://www.nephoscale.com'¶
- 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.
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
- Parameters
key (
str
) – API key or username to be used (required)secret (
str
) – Secret password to be used (required)secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default.host (
str
) – Override hostname used for connections.port (
int
) – Override port used for connections.api_version (
str
) – Optional API version. Only used by drivers which support multiple API versions.region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
- Return type
None
- api_version = 1.0¶
- connectionCls¶
alias of
libcloud.common.dimensiondata.DimensionDataConnection
- features = {'create_node': ['password']}¶
- List of available features for a driver.
libcloud.compute.base.NodeDriver.create_node()
ssh_key: Supports
NodeAuthSSHKey
as an authentication method for nodes.password: Supports
NodeAuthPassword
as an authentication method for nodes.generates_password: Returns a password attribute on the Node object returned from creation.
- name = 'NTTAmerica'¶
- selected_region = None¶
- type = 'ntta'¶
- website = 'http://www.nttamerica.com/'¶
libcloud.compute.drivers.nttcis module¶
NTT CIS Driver
- class libcloud.compute.drivers.nttcis.NttCisNodeDriver(key, secret=None, secure=True, host=None, port=None, api_version=None, region='na', **kwargs)[source]¶
Bases:
libcloud.compute.base.NodeDriver
NttCis node driver. Default api_version is used unless specified.
- Parameters
key (
str
) – API key or username to be used (required)secret (
str
) – Secret password to be used (required)secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default.host (
str
) – Override hostname used for connections.port (
int
) – Override port used for connections.api_version (
str
) – Optional API version. Only used by drivers which support multiple API versions.region (
str
) – Optional driver region. Only used by drivers which support multiple regions.
- Return type
None
- api_version = 1.0¶
- connectionCls¶
- create_node(name, image, auth, ex_network_domain=None, ex_primary_nic_private_ipv4=None, ex_primary_nic_vlan=None, ex_primary_nic_network_adapter=None, ex_additional_nics=None, ex_description=None, ex_disks=None, ex_cpu_specification=None, ex_memory_gb=None, ex_is_started=True, ex_primary_dns=None, ex_secondary_dns=None, ex_ipv4_gateway=None, ex_microsoft_time_zone=None, **kwargs)[source]¶
Create a new NTTCIS node in MCP2. However, it is still backward compatible for MCP1 for a limited time. Please consider using MCP2 datacenter as MCP1 will phase out soon.
Legacy Create Node for MCP1 datacenter
>>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.base import NodeAuthPassword >>> from libcloud.compute.providers import get_driver >>> import libcloud.security >>> >>> # Get NTTC-CIS driver >>> libcloud.security.VERIFY_SSL_CERT = False >>> NTTCIS = get_driver(Provider.NTTCIS) >>> driver = cls('myusername','mypassword', region='dd-au') >>> >>> # Password >>> root_pw = NodeAuthPassword('password123') >>> >>> # Get location >>> location = driver.ex_get_location_by_id(id='AU1') >>> >>> # Get network by location >>> my_network = driver.list_networks(location=location)[0] >>> pprint(my_network) >>> >>> # Get Image >>> images = driver.list_images(location=location) >>> image = images[0] >>> >>> node = driver.create_node(name='test_blah_2', image=image, >>> auth=root_pw, >>> ex_description='test3 node', >>> ex_network=my_network, >>> ex_is_started=False) >>> pprint(node)
Create Node in MCP2 Data CenterF
>>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.base import NodeAuthPassword >>> from libcloud.compute.providers import get_driver >>> import libcloud.security >>> >>> # Get NTTC-CIS driver >>> libcloud.security.VERIFY_SSL_CERT = True >>> cls = get_driver(Provider.NTTCIS) >>> driver = cls('myusername','mypassword', region='dd-au') >>> >>> # Password >>> root_pw = NodeAuthPassword('password123') >>> >>> # Get location >>> location = driver.ex_get_location_by_id(id='AU9') >>> >>> # Get network domain by location >>> networkDomainName = "Baas QA" >>> network_domains = driver.ex_list_network_domains(location=location) >>> my_network_domain = [d for d in network_domains if d.name == networkDomainName][0] >>> >>> vlan = driver.ex_list_vlans(location=location, >>> network_domain=my_network_domain)[0] >>> pprint(vlan) >>> >>> # Get Image >>> images = driver.list_images(location=location) >>> image = images[0] >>> >>> # Create node using vlan instead of private IPv4 >>> node = driver.create_node(name='test_server_01', image=image, >>> auth=root_pw, >>> ex_description='test2 node', >>> ex_network_domain=my_network_domain, >>> ex_primary_nic_vlan=vlan, >>> ex_is_started=False) >>> >>> # Option: Create node using private IPv4 instead of vlan >>> # node = driver.create_node(name='test_server_02', image=image, >>> # auth=root_pw, >>> # ex_description='test2 node', >>> # ex_network_domain=my_network_domain, >>> # ex_primary_nic_private_ipv4='10.1.1.7', >>> # ex_is_started=False) >>> >>> # Option: Create node using by specifying Network Adapter >>> # node = driver.create_node(name='test_server_03', image=image, >>> # auth=root_pw, >>> # ex_description='test2 node', >>> # ex_network_domain=my_network_domain, >>> # ex_primary_nic_vlan=vlan, >>> # ex_primary_nic_network_adapter='E1000', >>> # ex_is_started=False) >>>
- Parameters
name (
str
) – (required) String with a name for this new nodeimage (
NodeImage
orstr
) – (required) OS Image to boot on node.auth (
NodeAuthPassword
orstr
orNone
) – Initial authentication information for the node. (If this is a customer LINUX image auth will be ignored)ex_description (
str
) – (optional) description for this nodeex_network_domain (
DimensionDataNetworkDomain
orstr
) – (required) Network Domain or Network Domain ID to create the nodeex_primary_nic_private_ipv4 (:
str
) – Provide private IPv4. Ignore if ex_primary_nic_vlan is provided. Use one or the other. Not both.ex_primary_nic_vlan – Provide VLAN for the node if ex_primary_nic_private_ipv4 NOT provided. One or the other. Not both.
ex_primary_nic_network_adapter (:
str
) – (Optional) Default value for the Operating System will be used if leave empty. Example: “E1000”.ex_additional_nics (
list
of :class:’NttCisNic’ orstr
) – (optional) List :class:’NttCisNic’ or Noneex_memory_gb (
int
) – (optional) The amount of memory in GB for the server Can be used to override the memory value inherited from the source Server Image.ex_cpu_specification (
DimensionDataServerCpuSpecification
) – (optional) The spec of CPU to deployex_is_started (
bool
) – (required) Start server after creation. Default is set to true.ex_primary_dns (
str
) – (Optional) The node’s primary DNSex_secondary_dns (
str
) – (Optional) The node’s secondary DNSex_ipv4_gateway (
str
) – (Optional) IPv4 address in dot-decimal notation, which will be used as the Primary NIC gateway instead of the default gateway assigned by the system. If ipv4Gateway is provided it does not have to be on the VLAN of the Primary NIC but MUST be reachable or the Guest OS will not be configured correctly.ex_disks (List or tuple of :class:'DimensionDataServerDisk`) – (optional) NTTCIS disks. Optional disk elements can be used to define the disk speed that each disk on the Server; inherited from the source Server Image will be deployed to. It is not necessary to include a diskelement for every disk; only those that you wish to set a disk speed value for. Note that scsiId 7 cannot be used.Up to 13 disks can be present in addition to the required OS disk on SCSI ID 0. Refer to https://docs.mcp-services.net/x/UwIu for disk
ex_microsoft_time_zone (str`) – (optional) For use with Microsoft Windows source Server Images only. For the exact value to use please refer to the table of time zone indexes in the following Microsoft Technet documentation. If none is supplied, the default time zone for the data center geographic region will be used.
- Returns
The newly created
Node
.- Return type
Node
- destroy_node(node)[source]¶
Deletes a node, node must be stopped before deletion
- Parameters
node (
Node
) – The node to delete- Return type
bool
- ex_add_scsi_controller_to_node(server_id, adapter_type, bus_number=None)[source]¶
Added 8/27/18: Adds a SCSI Controller by node id :param server_id: server id :param adapter_type: the type of SCSI Adapter, i.e., LSI_LOGIC_PARALLEL :param bus_number: optional number of server’s bus :return: whether addition is in progress or ‘OK’ otherwise false
- ex_add_storage_to_node(amount, node=None, speed='STANDARD', controller_id=None, scsi_id=None)[source]¶
Updated 8/23/18 Add storage to the node One of node or controller_id must be selected
- Parameters
node (
Node
) – The server to add storage to (required if controller_id is not usedamount (
int
) – The amount of storage to add, in GBspeed (
str
) – The disk speed typeconrollter_id – The disk may be added using the cotnroller id (required if node object is not used)
scsi_id (
int
) – The target SCSI ID (optional)
- Return type
bool
- ex_apply_tag_to_asset(asset, tag_key, value=None)[source]¶
Apply a tag to a NTTC-CIS Asset
- Parameters
asset (
Node
orNodeImage
orNttCisNewtorkDomain
orNttCisVlan
orNttCisPublicIpBlock
) – The asset to apply a tag to. (required)tag_key (
NttCisTagKey
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 theNttCisTagKey
requires it
- Return type
bool
- 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 usedvlan (
NttCisVlan
) – VLAN to attach the node to (required unless private_ipv4)private_ipv4 (
str
) – Private nic IPv4 Address (required unless vlan)
- Return type
bool
- 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 reportend_date (
str
in format YYYY-MM-DD) – End date for the report
- Return type
list
oflist
- 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 reportend_date (
str
in format YYYY-MM-DD) – End date for the reportlocation (
NodeLocation
orstr
) – Filters the node list to nodes that are located in this location
- Return type
list
oflist
- ex_change_nic_network_adapter(nic_id, network_adapter_name)[source]¶
Change network adapter of a NIC on a cloud server
- Parameters
nic_id (:
str
) – Nic IDnetwork_adapter_name (:
str
) – Network adapter name
- Return type
bool
- ex_change_storage_size(disk_id, size)[source]¶
Change the size of a disk
- Parameters
node (
Node
) – The server to change the disk ofdisk_id (
str
) – The ID of the disk to resizesize (
int
) – The disk size in GB
- Return type
bool
- ex_change_storage_speed(disk_id, speed, iops=None)[source]¶
Change the speed (disk tier) of a disk
- Parameters
node (
Node
) – The server to change the disk speed ofdisk_id (
str
) – The ID of the disk to changespeed (
str
) – The disk speed type e.g. STANDARD
- Return type
bool
- 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, cluster_id=None, is_guest_Os_Customization=None, tag_key_id=None, tag_value=None)[source]¶
Clone a server into a customer image.
- Parameters
node (
Node
) – The server to cloneimage_name (
str
) – The name of the clone imagedescription (
str
) – The description of the image
- Return type
bool
- ex_create_anti_affinity_rule(node_list)[source]¶
Edited to work with api 2.x. No longer supports 1.0 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 for- Return type
bool
- ex_create_consistency_group(name, journal_size_gb, source_server_id, target_server_id, description=None)[source]¶
Create a consistency group
- Parameters
name (
str
) – Name of consistency groupjournal_size_gb (
str
) – Journal size in GBsource_server_id (
str
) – Id of the server to copytarget_server_id – Id of the server to receive the copy
description – (Optional) Description of consistency group
- Type
target_server_id:
str
- Type
description:
str
- Return type
NttCisConsistencyGroup
- ex_create_firewall_rule(network_domain, name, action, ip_version, protocol, source_addr, dest_addr, position, enabled=1, position_relative_to_rule=None)[source]¶
Creates a firewall rule
- Parameters
network_domain (
NttCisNetworkDomain
orstr
) – The network domain in which to create the firewall rulename (
str
) – The rule’s nameaction (
str
) – ‘ACCEPT_DECISIVELY’ or ‘DROP’ip_version (
str
) – ‘IPV4’ or ‘IPV6’protocol (
str
) – One of ‘IP’, ‘ICMP’, ‘TCP’, or ‘UDP’source_addr (
NttCisFirewallAddress
) – The source address, which must be an NttCisFirewallAddress instancedest_addr (NttCisFirewallAddress`) – The destination address, which must be an NttCisFirewallAddress instance
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’enabled (
int
) – Firewall rule is enabled upon creation. Set to 1 for true or 0 for false.position_relative_to_rule (:
NttCisFirewallRule
orstr
) – The rule or rule name in which to decide positioning by
- Return type
bool
- ex_create_ip_address_list(ex_network_domain, name, description, ip_version, ip_address_collection, child_ip_address_list=None)[source]¶
Create IP Address List. IP Address list.
>>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.providers import get_driver >>> from libcloud.common.nttcis import NttCisIpAddress >>> import libcloud.security >>> >>> # Get NTTC-CIS driver >>> libcloud.security.VERIFY_SSL_CERT = True >>> cls = get_driver(Provider.NTTCIS) >>> driver = cls('myusername','mypassword', region='dd-au') >>> >>> # Get location >>> location = driver.ex_get_location_by_id(id='AU9') >>> >>> # Get network domain by location >>> networkDomainName = "Baas QA" >>> network_domains = driver.ex_list_network_domains(location=location) >>> my_network_domain = [d for d in network_domains if d.name == networkDomainName][0] >>> >>> # IP Address collection >>> ipAddress_1 = NttCisIpAddress(begin='190.2.2.100') >>> ipAddress_2 = NttCisIpAddress(begin='190.2.2.106', end='190.2.2.108') >>> ipAddress_3 = NttCisIpAddress(begin='190.2.2.0', prefix_size='24') >>> ip_address_collection = [ipAddress_1, ipAddress_2, ipAddress_3] >>> >>> # Create IPAddressList >>> result = driver.ex_create_ip_address_list( >>> ex_network_domain=my_network_domain, >>> name='My_IP_AddressList_2', >>> ip_version='IPV4', >>> description='Test only', >>> ip_address_collection=ip_address_collection, >>> child_ip_address_list='08468e26-eeb3-4c3d-8ff2-5351fa6d8a04' >>> ) >>> >>> pprint(result)
- Parameters
ex_network_domain (
NttCisNetworkDomain
or ‘str’) – The network domain or network domain IDname (:
str
) – IP Address List Name (required)description (:
str
) – IP Address List Description (optional)ip_version (:
str
) – IP Version of ip address (required)ip_address_collection (:
str
) – List of IP Address. At least one ipAddress element or one childIpAddressListId element must be provided.child_ip_address_list (:class:’NttCisChildIpAddressList` or str`) – Child IP Address List or id to be included in this IP Address List. At least one ipAddress or one childIpAddressListId must be provided.
- Returns
a list of NttCisIpAddressList objects
- Return type
list
ofNttCisIpAddressList
- ex_create_nat_rule(network_domain, internal_ip, external_ip)[source]¶
Create a NAT rule
- Parameters
network_domain (
NttCisNetworkDomain
) – The network domain the rule belongs tointernal_ip (
str
) – The IPv4 address internallyexternal_ip (
str
) – The IPv4 address externally
- Return type
NttCisNatRule
- 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 networkdescription (
str
) – Additional description of the network
- Returns
A new instance of NttCisNetwork
- Return type
Instance of
NttCisNetwork
- 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 listname (
str
) – The name of the network domain to createservice_plan (
str
) – The service plan, either “ESSENTIALS” or “ADVANCED”description (
str
) – An additional description of the network domain
- Returns
an instance of NttCisNetworkDomain
- Return type
NttCisNetworkDomain
- ex_create_node_uncustomized(name, image, ex_network_domain, ex_is_started=True, ex_description=None, ex_cluster_id=None, ex_cpu_specification=None, ex_memory_gb=None, ex_primary_nic_private_ipv4=None, ex_primary_nic_vlan=None, ex_primary_nic_network_adapter=None, ex_additional_nics=None, ex_disks=None, ex_tagid_value_pairs=None, ex_tagname_value_pairs=None)[source]¶
This MCP 2.0 only function deploys a new Cloud Server from a CloudControl compatible Server Image, which does not utilize VMware Guest OS Customization process.
Create Node in MCP2 Data Center
- Parameters
name (
str
) – (required) String with a name for this new nodeimage (
NodeImage
orstr
) – (UUID of the Server Image being used as the target for the new Server deployment. The source Server Image (OS Image or Customer Image) must have osCustomization set to true. See Get/List OS Image(s) and Get/List Customer Image(s).ex_network_domain (
NttCisNetworkDomain
orstr
) – (required) Network Domain or Network Domain ID to create the nodeex_description (
str
) – (optional) description for this nodeex_cluster_id – (optional) For multiple cluster
environments, it is possible to set a destination cluster for the new Customer Image. Note that performance of this function is optimal when either the Server cluster and destination are the same or when shared data storage is in place for the multiple clusters. :type ex_cluster_id:
str
- Parameters
ex_primary_nic_private_ipv4 (:
str
) – Provide private IPv4. Ignore if ex_primary_nic_vlan is provided. Use one or the other. Not both.ex_primary_nic_vlan – Provide VLAN for the node if ex_primary_nic_private_ipv4 NOT provided. One or the other. Not both.
ex_primary_nic_network_adapter (:
str
) – (Optional) Default value for the Operating System will be used if leave empty. Example: “E1000”.ex_additional_nics (
list
of :class:’NttCisNic’ orstr
) – (optional) List :class:’NttCisNic’ or Noneex_memory_gb (
int
) – (optional) The amount of memory in GB for the server Can be used to override the memory value inherited from the source Server Image.ex_cpu_specification (
NttCisServerCpuSpecification
) – (optional) The spec of CPU to deployex_is_started (
bool
) – (required) Start server after creation. Default is set to true.ex_disks (List or tuple of :class:'NttCisServerDisk`) – (optional) NttCis disks. Optional disk elements can be used to define the disk speed that each disk on the Server; inherited from the source Server Image will be deployed to. It is not necessary to include a diskelement for every disk; only those that you wish to set a disk speed value for. Note that scsiId 7 cannot be used.Up to 13 disks can be present in addition to the required OS disk on SCSI ID 0. Refer to https://docs.mcp-services.net/x/UwIu for disk
ex_tagid_value_pairs – (Optional) up to 10 tag elements may be provided. A combination of tagById and tag name cannot be supplied in the same request. Note: ex_tagid_value_pairs and ex_tagname_value_pairs is mutually exclusive. Use one or other.
ex_tagname_value_pairs (
dict`
.) – (Optional) up to 10 tag elements may be provided. A combination of tagById and tag name cannot be supplied in the same request. Note: ex_tagid_value_pairs and ex_tagname_value_pairs is mutually exclusive. Use one or other.
- Returns
The newly created
Node
.- Return type
Node
- ex_create_portlist(ex_network_domain, name, description, port_collection, child_portlist_list=None)[source]¶
Create Port List.
>>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.providers import get_driver >>> from libcloud.common.nttcis import NttCisPort >>> import libcloud.security >>> >>> # Get NTTC-CIS driver >>> libcloud.security.VERIFY_SSL_CERT = True >>> cls = get_driver(Provider.NTTCIS) >>> driver = cls('myusername','mypassword', region='dd-au') >>> >>> # Get location >>> location = driver.ex_get_location_by_id(id='AU9') >>> >>> # Get network domain by location >>> networkDomainName = "Baas QA" >>> network_domains = driver.ex_list_network_domains(location=location) >>> my_network_domain = [d for d in network_domains if d.name == networkDomainName][0] >>> >>> # Port Collection >>> port_1 = DimensionDataPort(begin='1000') >>> port_2 = DimensionDataPort(begin='1001', end='1003') >>> port_collection = [port_1, port_2] >>> >>> # Create Port List >>> new_portlist = driver.ex_create_portlist( >>> ex_network_domain=my_network_domain, >>> name='MyPortListX', >>> description="Test only", >>> port_collection=port_collection, >>> child_portlist_list={'a9cd4984-6ff5-4f93-89ff-8618ab642bb9'} >>> ) >>> pprint(new_portlist)
- Parameters
ex_network_domain (:
str
) – (required) The network domain in which to create PortList. Provide networkdomain object or its id.name (:
str
) – Port List Namedescription (:
str
) – IP Address List Descriptionport_collection (:
str
) – List of Port Addresschild_portlist_list (:
str
or ‘’list of :class:’NttCisChildPortList’) – List of Child Portlist to be included in this Port List
- Returns
result of operation
- Return type
bool
- ex_create_snapshot_preview_server(snapshot_id, server_name, server_started, nics_connected, server_description=None, target_cluster_id=None, preserve_mac_addresses=None, tag_key_name=None, tag_key_id=None, tag_value=None)[source]¶
Create a snapshot preview of a server to clone to a new server
- Parameters
snapshot_id (
str
) – ID of the specific snahpshot to use in creating preview server.server_name – Name of the server created from the snapshot
:type
str
- Parameters
nics_connected – ‘true’ or ‘false’. Should the nics be automatically connected
:type
str
- Parameters
server_description – (Optional) A brief description of the server.
:type
str
- Parameters
target_cluster_id – (Optional) The ID of a specific cluster as opposed to the default.
:type
str
- Parameters
preserve_mac_address – (Optional) If set to ‘true’ will preserve mac address from the original server.
:type
str
- Parameters
tag_key_name – (Optional) If tagging is desired and by name is desired, set this to the tag name.
:type
str
- Parameters
tag_key_id – (Optional) If tagging is desired and by id is desired, set this to the tag id.
:type
str
- Parameters
tag_value – (Optional) If using a tag_key_id or tag_key_name, set the value fo tag_value.
- Return type
str
- ex_create_tag_key(name, description=None, value_required=True, display_on_report=True)[source]¶
Creates a tag key in the NTTC-CIS Cloud
- Parameters
name (
str
) – The name of the tag key (required)description (
str
) – The description of the tag keyvalue_required (
bool
) – If a value is required for the tag Tags themselves can be just a tag, or be a key/value pairdisplay_on_report (
bool
) – Should this key show up on the usage reports
- Return type
bool
- 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 (
NttCisNetworkDomain
) – The network domain to add the VLAN toname (
str
) – The name of the VLAN to createprivate_ipv4_base_address (
str
) – The base IPv4 address e.g. 192.168.1.0description (
str
) – An additional description of the VLANprivate_ipv4_prefix_size (
int
) – The size of the IPv4 address space, e.g 24
- Returns
an instance of NttCisVlan
- Return type
NttCisVlan
- ex_delete_anti_affinity_rule(anti_affinity_rule)[source]¶
Remove anti affinity rule
- Parameters
anti_affinity_rule (
NttCisAntiAffinityRule
orstr
) – The anti affinity rule to delete- Return type
bool
- ex_delete_consistency_group(consistency_group_id)[source]¶
Delete’s a Consistency Group
- Parameters
consistency_group_id – Id of Consistency Group to delete
:type
str
:return: True if response_code contains either IN_PROGRESS’ or ‘OK’ otherwise False :rtype:bool
- ex_delete_firewall_rule(rule)[source]¶
Delete a firewall rule
- Parameters
rule (
NttCisFirewallRule
) – The rule to delete- Return type
bool
- ex_delete_ip_address_list(ex_ip_address_list)[source]¶
Delete IP Address List by ID
>>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.providers import get_driver >>> import libcloud.security >>> >>> # Get NTTC-CIS driver >>> libcloud.security.VERIFY_SSL_CERT = True >>> cls = get_driver(Provider.NTTCIS) >>> driver = cls('myusername','mypassword', region='dd-au') >>> >>> ip_address_list_id = '5e7c323f-c885-4e4b-9a27-94c44217dbd3' >>> result = driver.ex_delete_ip_address_list(ip_address_list_id) >>> pprint(result)
- Parameters
ex_ip_address_list (:class:’NttCisIpAddressList’ or
str
) – IP Address List object or IP Address List ID (required)- Return type
bool
- ex_delete_nat_rule(rule)[source]¶
Delete an existing NAT rule
- Parameters
rule (
NttCisNatRule
) – The rule to delete- Return type
bool
- ex_delete_network(network)[source]¶
Delete a network from an MCP 1 data center
- Parameters
network (
NttCisNetwork
) – The network to delete- Return type
bool
- ex_delete_network_domain(network_domain)[source]¶
Delete a network domain
- Parameters
network_domain (
NttCisNetworkDomain
) – The network domain to delete- Return type
bool
- ex_delete_portlist(ex_portlist)[source]¶
Delete Port List
>>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.providers import get_driver >>> import libcloud.security >>> >>> # Get NTTC-CIS driver >>> libcloud.security.VERIFY_SSL_CERT = True >>> cls = get_driver(Provider.NTTCIS) >>> driver = cls('myusername','mypassword', region='dd-au') >>> >>> # Delete Port List >>> portlist_id = '157531ce-77d4-493c-866b-d3d3fc4a912a' >>> response = driver.ex_delete_portlist(portlist_id) >>> pprint(response)
- Parameters
ex_portlist (:
str
or :class:’NttCisPortList’) – Port List to be deleted- Return type
bool
- ex_delete_vlan(vlan)[source]¶
Deletes an existing VLAN
- Parameters
vlan (
DNttCisNetworkDomain
) – The VLAN to delete- Return 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 remove- Return 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 reportend_date (
str
in format YYYY-MM-DD) – End date for the report
- Return type
list
oflist
- ex_disable_monitoring(node)[source]¶
Disables cloud monitoring for a node
- Parameters
node (
Node
) – The node to stop monitoring- Return type
bool
- ex_disable_snapshots(node)[source]¶
Disable snapshots on a server. This also deletes current snapshots.
- Parameters
node (
str
) – Node ID of the node on which to enable snapshots.
:return True or False :rtype:
bool
- ex_edit_firewall_rule(rule, position=None, relative_rule_for_position=None)[source]¶
Edit a firewall rule
>>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.providers import get_driver >>> import libcloud.security >>> >>> # Get NTTC-CIS driver >>> libcloud.security.VERIFY_SSL_CERT = True >>> cls = get_driver(Provider.NTTCIS) >>> driver = cls('myusername','mypassword', region='dd-au') >>> >>> # Get location >>> location = driver.ex_get_location_by_id(id='AU9') >>> >>> # Get network domain by location >>> networkDomainName = "Baas QA" >>> network_domains = driver.ex_list_network_domains(location=location) >>> my_network_domain = [d for d in network_domains if d.name == networkDomainName][0] >>> >>> >>> # List firewall rules >>> firewall_rules = driver.ex_list_firewall_rules(my_network_domain) >>> >>> # Get Firewall Rule by name >>> pprint("List specific firewall rule by name") >>> fire_rule_under_test = (list(filter(lambda x: x.name == 'My_New_Firewall_Rule', firewall_rules))[0]) >>> pprint(fire_rule_under_test.source) >>> pprint(fire_rule_under_test.destination) >>> >>> # Edit Firewall >>> fire_rule_under_test.destination.address_list_id = '5e7c323f-c885-4e4b-9a27-94c44217dbd3' >>> fire_rule_under_test.destination.port_list_id = 'b6557c5a-45fa-4138-89bd-8fe68392691b' >>> result = driver.ex_edit_firewall_rule(fire_rule_under_test, 'LAST') >>> pprint(result)
- Parameters
rule (
DNttCisFirewallRule
) – (required) The rule in which to createposition (
str
) – (required) There are two types of positions with position_relative_to_rule arg and without it With: ‘BEFORE’ or ‘AFTER’ Without: ‘FIRST’ or ‘LAST’relative_rule_for_position (
NttCisFirewallRule
orstr
) – (optional) The rule or rule name in which to decide the relative rule for positioning.
- Return type
bool
- ex_edit_ip_address_list(ex_ip_address_list, description=None, ip_address_collection=None, child_ip_address_lists=None)[source]¶
Edit IP Address List. IP Address list. Bear in mind you cannot add ip addresses to >>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.providers import get_driver >>> from libcloud.common.NTTCIS import NttCisIpAddress >>> import libcloud.security >>> >>> # Get NTTC-CIS driver >>> libcloud.security.VERIFY_SSL_CERT = True >>> cls = get_driver(Provider.NTTCIS) >>> driver = cls(‘myusername’,’mypassword’, region=’dd-au’) >>> >>> # IP Address collection >>> ipAddress_1 = NttCisIpAddress(begin=’190.2.2.100’) >>> ipAddress_2 = NttCisIpAddress(begin=’190.2.2.106’, >>> end=’190.2.2.108’) >>> ipAddress_3 = NttCisIpAddress( >>> begin=’190.2.2.0’, prefix_size=’24’) >>> ip_address_collection = [ipAddress_1, ipAddress_2, ipAddress_3] >>> >>> # Edit IP Address List >>> ip_address_list_id = ‘5e7c323f-c885-4e4b-9a27-94c44217dbd3’ >>> result = driver.ex_edit_ip_address_list( >>> ex_ip_address_list=ip_address_list_id, >>> description=”Edit Test”, >>> ip_address_collection=ip_address_collection, >>> child_ip_address_lists=None >>> ) >>> pprint(result)
- Parameters
ex_ip_address_list (:class:’NttCisIpAddressList’ or
str
) – (required) IpAddressList object or IpAddressList IDdescription (:
str
) – IP Address List Descriptionip_address_collection (''list'' of :class:'NttCisIpAddressList') – List of IP Address
child_ip_address_lists (
list
of :class:’NttCisChildIpAddressList’ orstr
) – Child IP Address List or id to be included in this IP Address List
- Returns
a list of NttCisIpAddressList objects
- Return type
list
ofNttCisIpAddressList
- ex_edit_portlist(ex_portlist, description=None, port_collection=None, child_portlist_list=None)[source]¶
Edit Port List.
>>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.providers import get_driver >>> from libcloud.common.NTTCIS import DimensionDataPort >>> import libcloud.security >>> >>> # Get NTTC-CIS driver >>> libcloud.security.VERIFY_SSL_CERT = True >>> cls = get_driver(Provider.NTTCIS) >>> driver = cls('myusername','mypassword', region='dd-au') >>> >>> # Port Collection >>> port_1 = DimensionDataPort(begin='4200') >>> port_2 = DimensionDataPort(begin='4201', end='4210') >>> port_collection = [port_1, port_2] >>> >>> # Edit Port List >>> editPortlist = driver.ex_get_portlist( '27dd8c66-80ff-496b-9f54-2a3da2fe679e') >>> >>> result = driver.ex_edit_portlist( >>> ex_portlist=editPortlist.id, >>> description="Make Changes in portlist", >>> port_collection=port_collection, >>> child_portlist_list={'a9cd4984-6ff5-4f93-89ff-8618ab642bb9'} >>> ) >>> pprint(result)
- Parameters
ex_portlist (:
str
or :class:’DNttCisPortList’) – Port List to be edited (required)description (:
str
) – Port List Descriptionport_collection (:
str
) – List of Portschild_portlist_list (:
list
of :class’NttCisChildPortList’ or ‘’str’’) – Child PortList to be included in this IP Address List
- Returns
a list of NttCisPortList objects
- Return type
list
ofNttCisPortList
- ex_enable_monitoring(node, service_plan='ESSENTIALS')[source]¶
Enables cloud monitoring on a node
- Parameters
node (
Node
) – The node to monitorservice_plan (
str
) – The service plan, one of ESSENTIALS or ADVANCED
- Return type
bool
- ex_enable_snapshots(node, window, plan='ADVANCED', initiate='true')[source]¶
Enable snapshot service on a server
- Parameters
node (
str
) – Node ID of the node on which to enable snapshots.window – The window id of the window in which the snapshot is enabled.
plan (
str
) – Pland type ‘ESSENTIALS’ or ‘ADVANCEDinitiate – Run a snapshot upon configuration of the snapshot.
:type
str
- Return type
bool
- ex_exchange_nic_vlans(nic_id_1, nic_id_2)[source]¶
Exchange NIC Vlans
- Parameters
nic_id_1 (:
str
) – Nic ID 1nic_id_2 (:
str
) – Nic ID 2
- Return type
bool
- ex_expand_journal(consistency_group_id, size_gb)[source]¶
Expand the consistency group’s journhal size in 100Gb increments.
- Parameters
consistency_group_id (
str
) – The consistency group’s UUIDsize_gb (
str
) – Gb in 100 Gb increments
- Returns
True if response_code contains either ‘IN_PROGRESS’ or ‘OK’ otherwise False
- Return type
bool
- 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 (
NttCisNetworkDomain
) – The VLAN to update- Returns
an instance of NttCisVlan
- Return type
NttCisVlan
- ex_get_base_image_by_id(id)[source]¶
Gets a Base image in the NTTC-CIS Cloud given the id
- Parameters
id (
str
) – The id of the image- Return type
NodeImage
- ex_get_consistency_group(consistency_group_id)[source]¶
Retrieves a Consistency by it’s id and is more efficient thatn listing all consistency groups and filtering that result.
- Parameters
consistency_group_id (
str
) – An id of a consistency group- Return type
NttCisConsistencygroup
- ex_get_customer_image_by_id(id)[source]¶
Gets a Customer image in the NTTC-CIS Cloud given the id
- Parameters
id (
str
) – The id of the image- Return type
NodeImage
- ex_get_image_by_id(id)[source]¶
Gets a Base/Customer image in the NTTC-CIS 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 NttCisAPIException is thrown
- Parameters
id (
str
) – The id of the image- Return type
NodeImage
- ex_get_ip_address_list(ex_network_domain, ex_ip_address_list_name)[source]¶
Get IP Address List by name in network domain specified
>>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.providers import get_driver >>> import libcloud.security >>> >>> # Get NTTC-CIS driver >>> libcloud.security.VERIFY_SSL_CERT = True >>> cls = get_driver(Provider.NTTCIS) >>> driver = cls('myusername','mypassword', region='dd-au') >>> >>> # Get location >>> location = driver.ex_get_location_by_id(id='AU9') >>> >>> # Get network domain by location >>> networkDomainName = "Baas QA" >>> network_domains = driver.ex_list_network_domains(location=location) >>> my_network_domain = [d for d in network_domains if d.name == networkDomainName][0] >>> >>> # Get IP Address List by Name >>> ipaddresslist_list_by_name = driver.ex_get_ip_address_list( >>> ex_network_domain=my_network_domain, >>> ex_ip_address_list_name='My_IP_AddressList_1') >>> pprint(ipaddresslist_list_by_name)
- Parameters
ex_network_domain (
NttCisNetworkDomain
or ‘str’) – (required) The network domain or network domain ID in which ipaddresslist resides.ex_ip_address_list_name (:
str
) – (required) Get ‘IP Address List’ by name
- Returns
a list of NttCisIpAddressList objects
- Return type
list
ofNttCisIpAddressList
- ex_get_location_by_id(id)[source]¶
Get location by ID.
- Parameters
id (
str
) – ID of the node location which should be used- Return type
NodeLocation
- ex_get_nat_rule(network_domain, rule_id)[source]¶
Get a NAT rule by ID
- Parameters
network_domain (
NttCisNetworkDomain
) – The network domain the rule belongs torule_id (
str
) – The ID of the NAT rule to fetch
- Return type
NttCisNatRule
- 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 domain- Return type
NttCisNetworkDomain
- ex_get_portlist(ex_portlist_id)[source]¶
Get Port List
>>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.providers import get_driver >>> import libcloud.security >>> >>> # Get NTTC-CIS driver >>> libcloud.security.VERIFY_SSL_CERT = True >>> cls = get_driver(Provider.NTTCIS) >>> driver = cls('myusername','mypassword', region='dd-au') >>> >>> # Get specific portlist by ID >>> portlist_id = '27dd8c66-80ff-496b-9f54-2a3da2fe679e' >>> portlist = driver.ex_get_portlist(portlist_id) >>> pprint(portlist)
- Parameters
ex_portlist_id (
NttCisNetworkDomain
or ‘str’) – The ex_port_list or ex_port_list ID- Returns
NttCisPortList object
- Return type
NttCisPort
- 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
NttCisTagKey
- ex_get_tag_key_by_name(name)[source]¶
- NOTICE: Tag key is one of those instances where Libloud
handles the search of a list for the client code. This behavior exists inconsistently across libcloud. Get a specific tag key by Name
- Parameters
name (
str
) – Name of the tag key you want (required)- Return type
NttCisTagKey
- ex_get_vlan(vlan_id)[source]¶
Get a single VLAN, by it’s identifier
- Parameters
vlan_id (
str
) – The identifier of the VLAN- Returns
an instance of NttCisVlan
- Return type
NttCisVlan
- ex_initiate_drs_failover(consistency_group_id)[source]¶
This method is irreversible. It will failover the Consistency Group while removing it as well.
- Parameters
consistency_group_id (
str
) – Consistency Group’s Id to failover- Returns
True if response_code contains either
IN_PROGRESS’ or ‘OK’ otherwise False :rtype:
bool
- ex_initiate_manual_snapshot(name=None, server_id=None)[source]¶
Initiate a manual snapshot of server on the fly
- Parameters
name (
str
) – optional name of serverserver_id – optinal parameter to use instead of name
:type server_id`str`
- Returns
True of False
- Return type
bool
- 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 (
NttCisNetwork
orstr
) – The network to list anti affinity rules for One of network, network_domain, or node is requirednetwork_domain (
NttCisNetworkDomain
orstr
) – The network domain to list anti affinity rules One of network, network_domain, or node is requirednode (
Node
orstr
) – The node to list anti affinity rules for One of network, netwok_domain, or node is requiredfilter_id (
str
) – This will allow you to filter the rules by this node id
- Return type
list
of :class:NttCisAntiAffinityRule`
- ex_list_consistency_group_snapshots(consistency_group_id, create_time_min=None, create_time_max=None)[source]¶
Optional parameters identify the date of creation of Consistency Group snapshots in *XML Schema (XSD) date time format. Best used as a combination of createTime.MIN and createTime.MAX. If neither is provided then all snapshots up to the possible maximum of 1014 will be returned. If MIN is provided by itself, all snapshots between the time specified by MIN and the point in time of execution will be returned. If MAX is provided by itself, then all snapshots up to that point in time (up to the maximum number of 1014) will be returned. MIN and MAX are inclusive for this API function
- Parameters
consistency_group_id (
str
) – The id of consistency groupcreate_time_min (
str
) – (Optional) in form YYYY-MM-DDT00:00.00.00Z or substitute time offset for Z, i.e, -05:00create_time_max (
str
) – (Optional) in form YYYY-MM-DDT00:00:00.000Z or substitute time offset for Z, i.e, -05:00
- Return type
list of
NttCisSnapshots
- ex_list_consistency_groups(params={})[source]¶
Functions takes a named parameter that must be one of the following :param params: A dictionary composed of one of the following keys and a value * target_data_center_id= * source_network_domain_id= * target_network_domain_id= * source_server_id= * target_server_id= * name= * state= * operation_status= * drs_infrastructure_status= :rtype: list of :class: NttCisConsistencyGroup
- ex_list_customer_images(location=None)[source]¶
Return a list of customer imported images
- Parameters
location (
NodeLocation
orstr
) – The target location- Return type
list
ofNodeImage
- ex_list_ip_address_list(ex_network_domain)[source]¶
List IP Address List by network domain ID specified
>>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.providers import get_driver >>> import libcloud.security >>> >>> # Get NTTC-CIS driver >>> libcloud.security.VERIFY_SSL_CERT = True >>> cls = get_driver(Provider.NTTCIS) >>> driver = cls('myusername','mypassword', region='dd-au') >>> >>> # Get location >>> location = driver.ex_get_location_by_id(id='AU9') >>> >>> # Get network domain by location >>> networkDomainName = "Baas QA" >>> network_domains = driver.ex_list_network_domains(location=location) >>> my_network_domain = [d for d in network_domains if d.name == networkDomainName][0] >>> >>> # List IP Address List of network domain >>> ipaddresslist_list = driver.ex_list_ip_address_list( >>> ex_network_domain=my_network_domain) >>> pprint(ipaddresslist_list)
- Parameters
ex_network_domain (
NttCisNetworkDomain
or ‘str’) – The network domain or network domain ID- Returns
a list of NttCisIpAddressList objects
- Return type
list
ofNttCisIpAddressList
- ex_list_nat_rules(network_domain)[source]¶
Get NAT rules for the network domain
- Parameters
network_domain (
NttCisNetworkDomain
) – The network domain the rules belongs to- Return type
list
ofNttCisNatRule
- ex_list_network_domains(location=None, name=None, service_plan=None, state=None)[source]¶
List networks domains deployed across all data center locations domain.
for your organization. The response includes the location of each network :param location: Only network domains in the location (optional) :type location:
NodeLocation
orstr
- Parameters
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 NttCisNetwork objects
- Return type
list
ofNttCisNetwork
- 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 location- Returns
a list of NttCisNetwork objects
- Return type
list
ofNttCisNetwork
- 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 locationname – 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 addressipv4 (
str
) – Filters the node list to nodes that have this ipv4 addressvlan (
NttCisVlan
orstr
) – Filters the node list to nodes that are in this VLANimage (
NodeImage
orstr
) – Filters the node list to nodes that have this imagedeployed (
bool
) – Filters the node list to nodes that are deployed or notstarted (
bool
) – Filters the node list to nodes that are started or notstate (
str
) – Filters the node list to nodes that are in this statenetwork (
NttCisNetwork
orstr
) – Filters the node list to nodes in this networknetwork_domain (
NttCisNetworkDomain
orstr
) – Filters the node list to nodes in this network domain
- Returns
a list of Node objects
- Return type
generator
of list ofNode
- ex_list_portlist(ex_network_domain)[source]¶
List Portlist by network domain ID specified
>>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.providers import get_driver >>> import libcloud.security >>> >>> # Get NTTC-CIS driver >>> libcloud.security.VERIFY_SSL_CERT = True >>> cls = get_driver(Provider.NTTCIS) >>> driver = cls('myusername','mypassword', region='dd-au') >>> >>> # Get location >>> location = driver.ex_get_location_by_id(id='AU9') >>> >>> # Get network domain by location >>> networkDomainName = "Baas QA" >>> network_domains = driver.ex_list_network_domains(location=location) >>> my_network_domain = [d for d in network_domains if d.name == >>> networkDomainName][0] >>> >>> # List portlist >>> portLists = driver.ex_list_portlist( >>> ex_network_domain=my_network_domain) >>> pprint(portLists) >>>
- Parameters
ex_network_domain (
NttCisNetworkDomain
or ‘str’) – The network domain or network domain ID- Returns
a list of NttCisPortList objects
- Return type
list
ofNttCisPortList
- ex_list_tag_keys(id=None, name=None, value_required=None, display_on_report=None)[source]¶
List tag keys in the NTTC-CIS Cloud
- Parameters
id (
str
) – Filter the list to the id of the tag keyname (
str
) – Filter the list to the name of the tag keyvalue_required (
bool
) – Filter the list to if a value is required for a tag keydisplay_on_report (
bool
) – Filter the list to if the tag key should show up on usage reports
- Return type
list
ofNttCisTagKey
- ex_list_tags(asset_id=None, asset_type=None, location=None, tag_key_name=None, tag_key_id=None, value=None, value_required=None, display_on_report=None)[source]¶
List tags in the NTTC-CIS Cloud
- Parameters
asset_id (
str
) – Filter the list by asset idasset_type (
str
) – Filter the list by asset typelocation (:class:
NodeLocation
orstr
) – Filter the list by the assets locationtag_key_name (
str
) – Filter the list by a tag key nametag_key_id (
str
) – Filter the list by a tag key idvalue (
str
) – Filter the list by a tag valuevalue_required (
bool
) – Filter the list to if a value is required for a tagdisplay_on_report (
bool
) – Filter the list to if the tag should show up on usage reports
- Return type
list
ofNttCisTag
- 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 (
NttCisNetworkDomain
) – 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 NttCisVlan objects
- Return type
list
ofNttCisVlan
- 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 (
NttCisTagKey
orstr
) – The tag key you want to modify (required)name (
str
) – Set to modifiy the name of the tag keydescription (
str
) – Set to modify the description of the tag keyvalue_required (
bool
) – Set to modify if a value is required for the tag keydisplay_on_report (
bool
) – Set to modify if this tag key should display on the usage reports
- Return type
bool
- 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 used- Return type
bool
- ex_reconfigure_node(node, memory_gb=None, cpu_count=None, cores_per_socket=None, cpu_performance=None)[source]¶
Reconfigure the virtual hardware specification of a node
- Parameters
node (
Node
) – The server to changememory_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
- ex_remove_scsi_controller(controller_id)[source]¶
Added 8/27/18: Adds a SCSI Controller by node id :param controller_id: Scsi controller’s id :return: whether addition is in progress or ‘OK’ otherwise false
- ex_remove_storage(disk_id)[source]¶
Remove storage from a node
- Parameters
node (
Node
) – The server to add storage todisk_id (
str
) – The ID of the disk to remove
- Return type
bool
- ex_remove_storage_from_node(node, scsi_id)[source]¶
Remove storage from a node
- Parameters
node (
Node
) – The server to add storage toscsi_id (
str
) – The ID of the disk to remove
- Return type
bool
- ex_remove_tag_from_asset(asset, tag_key)[source]¶
Remove a tag from an asset
- Parameters
asset (
Node
orNodeImage
orNttCisNewtorkDomain
orNttCisVlan
orNttCisPublicIpBlock
) – The asset to remove a tag from. (required)tag_key (
NttCisTagKey
orstr
) – The tag key you want to remove (required)
- Return type
bool
- ex_remove_tag_key(tag_key)[source]¶
Modify a specific tag key
- Parameters
tag_key (
NttCisTagKey
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 (
NttCisNetwork
) – The network to renamenew_name (
str
) – The new name of the network
- Return type
bool
- 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 used- Return type
bool
- ex_set_firewall_rule_state(rule, state)[source]¶
Change the state (enabled or disabled) of a rule
- Parameters
rule (
NttCisFirewallRule
) – The rule to deletestate (
bool
) – The desired state enabled (True) or disabled (False)
- Return 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 reportend_date (
str
in format YYYY-MM-DD) – End date for the report
- Return type
list
oflist
- ex_start_drs_failover_preview(consistency_group_id, snapshot_id)[source]¶
Brings a Consistency Group into PREVIEWING_SNAPSHOT mode.
- Parameters
consistency_group_id (
str
) – Id of the Consistency Group to put into PRIEVEW_MODEsnapshot_id (
str
) – Id of the Snapshot to preview
- Returns
True if response_code contains either ‘IN_PROGRESS’ or ‘OK’ otherwise False
- Return type
bool
- ex_stop_drs_failover_preview(consistency_group_id)[source]¶
Takes a Consistency Group out of PREVIEW_MODE and back to DRS_MODE
- Parameters
consistency_group_id – Consistency Group’s Id
:type
str
- Returns
True if response_code contains either ‘IN_PROGRESS’ or ‘OK’ otherwise False
- Return 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 reportend_date (
str
in format YYYY-MM-DD) – End date for the report
- Return type
list
oflist
- ex_update_monitoring_plan(node, service_plan='ESSENTIALS')[source]¶
Updates the service plan on a node with monitoring
- Parameters
node (
Node
) – The node to monitorservice_plan (
str
) – The service plan, one of ESSENTIALS or ADVANCED
- Return type
bool
- ex_update_network_domain(network_domain)[source]¶
Update the properties of a network domain
- Parameters
network_domain (
NttCisNetworkDomain
) – The network domain with updated properties- Returns
an instance of NttCisNetworkDomain
- Return type
NttCisNetworkDomain
- 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 usedname (
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
- ex_update_vlan(vlan)[source]¶
Updates the properties of the given VLAN Only name and description are updated
- Parameters
vlan (
NttCisetworkDomain
) – The VLAN to update- Returns
an instance of NttCisVlan
- Return type
NttCisVlan
- 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 used- Return type
bool
- ex_wait_for_state(state, func, poll_interval=2, timeout=60, *args, **kwargs)[source]¶
Wait for the function which returns a instance with field status to match
Keep polling func until one of the desired states is matched
- Parameters
state (
str
orlist
) – Either the desired state (str) or a list of statesfunc (
function
) – The function to call, e.g. ex_get_vlanpoll_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
- features = {'create_node': ['password']}¶
- List of available features for a driver.
libcloud.compute.base.NodeDriver.create_node()
ssh_key: Supports
NodeAuthSSHKey
as an authentication method for nodes.password: Supports
NodeAuthPassword
as an authentication method for nodes.generates_password: Returns a password attribute on the Node object returned from creation.
- get_snapshot(snapshot_id)[source]¶
Get snapshot of a server by snapshot id.
- Parameters
snapshot_id (
str
) – ID of snapshot to retrieve.
:return a snapshot :rtype:
dict
- import_image(ovf_package_name, name, cluster_id=None, datacenter_id=None, description=None, is_guest_os_customization=None, tagkey_name_value_dictionaries=None)[source]¶
Import image
- Parameters
ovf_package_name (
str
) – Image OVF package namename (
str
) – Image namecluster_id (
str
) – Provide either cluster_id or datacenter_iddatacenter_id (
str
) – Provide either cluster_id or datacenter_iddescription (
str
) – Optional. Description of imageis_guest_os_customization (
bool
) – Optional. true for NGOC imagetagkey_name_value_dictionaries (dictionaries) – Optional tagkey name value dict
- Returns
Return true if successful
- Return type
bool
- list_datacenter_properties(location)[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
- list_images(location=None)[source]¶
List images available
- Note: Currently only returns the default ‘base OS images’
provided by NTTCIS. Customer images (snapshots) use ex_list_customer_images
- Parameters
ex_location (
NodeLocation
orstr
) – Filters the node list to nodes that are located in this location- Returns
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 id- Returns
List of locations
- Return type
list
ofNttCisDatacenter
- 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 location- Returns
a list of NttCisNetwork objects
- Return type
list
ofNttCisNetwork
- 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_domain=None, ex_snaphots=None)[source]¶
List nodes deployed for your organization.
- keyword ex_location
Filters the node list to nodes that are located in this location
- type ex_location
NodeLocation
orstr
- keyword ex_name
Filters the node list to nodes that have this name
:type ex_name
str
- keyword ex_ipv6
Filters the node list to nodes that have this ipv6 address
- type ex_ipv6
str
- keyword ex_ipv4
Filters the node list to nodes that have this ipv4 address
- type ex_ipv4
str
- keyword ex_vlan
Filters the node list to nodes that are in this VLAN
- type ex_vlan
DimensionDataVlan
orstr
- keyword ex_image
Filters the node list to nodes that have this image
- type ex_image
NodeImage
orstr
- keyword ex_deployed
Filters the node list to nodes that are deployed or not
- type ex_deployed
bool
- keyword ex_started
Filters the node list to nodes that are started or not
- type ex_started
bool
- keyword ex_state
Filters the node list by nodes that are in this state
- type ex_state
str
- Parameters
ex_network_domain –
- Filters the node list to nodes in this
network domain
- type ex_network_domain
NttCisNetworkDomain
orstr
- return
a list of Node objects
- rtype
list
ofNode
- 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
- list_snapshot_windows(location, plan)[source]¶
List snapshot windows in a given location :param location: a location object or location id such as “NA9” :param plan: ‘ESSENTIALS’ or ‘ADVANCED’ :return: dictionary with keys id, day_of_week, start_hour, availability :rtype: dict
- list_snapshots(node, page_size=None)[source]¶
List snapshots of a server. The list of snapshots can get large. Therefore, page_size is optional to limit this if desired.
- Parameters
node (
str
) – Node nameof the node on which to enable snapshots.page_size – (Optional) Limit the number of records returned
:return snapshots :rtype:
list
of dictionaries
- name = 'NTTC-CIS'¶
- reboot_node(node)[source]¶
Reboots a node by requesting the OS restart via the hypervisor
- Parameters
node (
Node
) – The node to reboot- Return type
bool
- selected_region = None¶
- start_node(node)[source]¶
Powers on an existing deployed server
- Parameters
node (
Node
) – Node which should be used- Return type
bool
- stop_node(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 used- Return type
bool
- type = 'nttcis'¶
- website = 'https://www.us.ntt.com/en/services/cloud/enterprise-cloud.html'¶
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¶
- 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 VS- Return type
OnAppNode
- delete_key_pair(key)[source]¶
Delete an existing key pair.
- Parameters
key_pair (
KeyPair
) – Key pair object.- Returns
True on success
- Return type
bool
- 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 0destroy_all_backups (
int
) – set 1 to destroy all existing backups of this VS, otherwise set 0
- get_key_pair(name)[source]¶
Retrieve a single key pair.
- Parameters
name (
str
) – ID of the key pair to retrieve.- Return type
KeyPair
object
- import_key_pair_from_string(name, key_material)[source]¶
Import a new public key from string.
- Parameters
name (
str
) – Key pair name (unused).key_material (
str
) – Public key material.
- Return type
KeyPair
object
- list_key_pairs()[source]¶
List all the available key pair objects.
- Return type
list
ofKeyPair
objects
- name = 'OnApp'¶
- type = 'onapp'¶
- website = 'http://onapp.com/'¶
libcloud.compute.drivers.oneandone module¶
1&1 Cloud Server Compute driver
- class libcloud.compute.drivers.oneandone.OneAndOneConnection(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 1&1 driver
Initialize user_id and key; set secure to an
int
based on passed value.- add_default_headers(headers)[source]¶
Add headers that are necessary for every request
This method adds
token
andContent-Type
to the request.
- api_prefix = '/v1/'¶
- host = 'cloudpanel-api.1and1.com'¶
- request(action, params=None, data=None, headers=None, method='GET', raw=False)[source]¶
Some requests will use the href attribute directly. If this is not the case, then we should formulate the url based on the action specified. If we are using a full url, we need to remove the host and protocol components.
- responseCls¶
alias of
libcloud.compute.drivers.oneandone.OneAndOneResponse
- class libcloud.compute.drivers.oneandone.OneAndOneNodeDriver(key, secret=None, secure=True, host=None, port=None, api_version=None, region=None, **kwargs)[source]¶
Bases:
libcloud.compute.base.NodeDriver
Base OneAndOne 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 = {'CONFIGURING': NodeState.RECONFIGURING, 'DEPLOYING': NodeState.STARTING, 'POWERED_OFF': NodeState.STOPPING, 'POWERED_ON': NodeState.RUNNING, 'POWERING_OFF': NodeState.PENDING, 'POWERING_ON': NodeState.STARTING, 'REBOOTING': NodeState.REBOOTING, 'REMOVING': NodeState.UNKNOWN}¶
Core Functions
- connectionCls¶
alias of
libcloud.compute.drivers.oneandone.OneAndOneConnection
- create_node(name, image, ex_fixed_instance_size_id, location=None, auth=None, ex_ip=None, ex_monitoring_policy_id=None, ex_firewall_policy_id=None, ex_loadbalancer_id=None, ex_description=None, ex_power_on=None)[source]¶
Creates a node.
- Parameters
name (str) – The name of the new node
ex_fixed_instance_size_id –
Fixed instance size ID from list_sizes :type ex_fixed_instance_size_id:
str
- Parameters
location (NodeLocation) – 1&1 Data center Location
ex_ip (str) – IP address
ex_ssh_key (str) – SSH Key
password (str) – Password
ex_monitoring_policy_id –
ex_firewall_policy_id (str) –
ex_loadbalancer_id (str) –
ex_description (str) –
ex_power_on (bool) –
- Returns
Instance of class
Node
- Return type
Node
- destroy_node(node, ex_keep_ips=False)[source]¶
Destroys a node.
- Parameters
node – The node you wish to destroy.
ex_keep_ips (:
bool
) – True to keep all IP addresses assigned to the node
- Returns
Instance of class
Node
- Return type
- class
Node
- ex_add_hdd(server_id, size, is_main)[source]¶
Add a hard disk to the server
- Parameters
server_id – Id of the server
size – Size of the new disk
is_main – Indicates if the disk is going to be the boot disk
- Type
str
- Type
str
- Type
boolean
- Returns
Instance of class
Node
- Type
- class
Node
- ex_add_load_balancer_rule(lb_id, protocol, port_balancer, port_server, source=None)[source]¶
Adds a rule to load balancer
- Parameters
lb_id – Load balancer ID
protocol – Load balancer protocol
port_balancer – Port to be balananced
port_server – Server port
source – Source IP address
- Return type
str
- Return type
str
- Return type
int
- Return type
int
- Return type
str
- Returns
Instance of load balancer
- Return type
dict
- ex_add_monitoring_policy_ports(policy_id, ports)[source]¶
Add monitoring policy ports
- Parameters
policy_id (
str
) – Id of the monitoring policyports (
dict
) – List of ports
- [
- {
‘protocol’:’TCP’, ‘port’:’80’, ‘alert_if’:’RESPONDING’, ‘email_notification’:true
}
]
- Returns
Instance of a monitoring policy
- Return type
dict
- ex_add_monitoring_policy_processes(policy_id, processes)[source]¶
Add monitoring policy processes
- Parameters
policy_id (
str
) – Id of the monitoring policyprocesses (
list
ofdict
) – List of processes
- [
- {
‘process’: ‘taskmmgr’, ‘alert_if’: ‘RUNNING’, ‘email_notification’: true
}
]
- Returns
Instance of a monitoring policy
- Return type
dict
- ex_add_private_network_server(network_id, server_ids)[source]¶
Add servers to private network
- Parameters
network_id (
str
) – Private Network IDserver_ids (
list
ofstr
) – List of server IDs
- Returns
List of attached servers
- Return type
dict
- ex_add_server_firewall_policy(server_id, ip_id, firewall_id)[source]¶
Adds a firewall policy to the server’s IP address
- Parameters
server_id – Id of the server
ip_id – ID of the IP address
firewall_id – ID of the firewall policy
- Type
str
- Type
str
- Type
str
- Returns
Node
instance- Return type
Node
- ex_add_servers_to_load_balancer(lb_id, server_ips=[])[source]¶
Adds server’s IP address to load balancer
- Parameters
lb_id – Load balancer ID
server_ips – Array of server IP IDs
- Type
str
- Type
list
ofstr
- Returns
Instance of load balancer
- Return type
dict
- ex_add_servers_to_monitoring_policy(policy_id, servers)[source]¶
Adds servers to monitoring policy
- Parameters
policy_id (
str
) – Id of the monitoring policyservers (
list
ofstr
) – List of server ID
- Returns
Instance of a monitoring policy
- Return type
dict
- ex_assign_server_ip(server_id, ip_type)[source]¶
Assigns a new IP address to the server
- Parameters
server_id – Id of the server
ip_type – Type of the IP address [IPV4,IPV6]
- Type
str
- Type
str
- Returns
Node
instance- Return type
Node
Attaches a single server to a shared storage
- Parameters
storage_id – Id of the shared storage
server_id – Id of the server to be attached to the shared storage
rights –
- Returns
- Return type
‘dict’
- ex_create_firewall_policy(name, rules, description=None)[source]¶
Creates a firewall Policy.
- Parameters
name –
description –
rules –
- Return type
dict
- Returns
dict firewall policy
- ex_create_load_balancer(name, method, rules, persistence=None, persistence_time=None, health_check_test=None, health_check_interval=None, health_check_path=None, health_check_parser=None, datacenter_id=None, description=None)[source]¶
- Parameters
name – Name of the load balancer
method – Load balancer method
rules (
list
ofdict
) – Load balancer rulespersistence (
boolean
) – Indictes if persistance is setpersistence_time (
int
) – Persistance timehealth_check_test – Type of test
:type health_check_test:
str
- Parameters
health_check_interval – Interval of the check
health_check_path (
str
) – Pathhealth_check_parser – Parser
:type health_check_parser:
str
- Parameters
datacenter_id – Data center id
:type datacenter_id:
str
- Parameters
description – Description of load balancer
:type description:
str
- Returns
dict
- ex_create_monitoring_policy(name, thresholds, ports, processes, description=None, email=None, agent=None)[source]¶
Creates a monitoring policy
- Parameters
name (
str
) – Name for the monitoring policythresholds (
dict
) – Thresholds for the monitoring policyports (
list
ofdict
) – Monitoring policies for portsprocesses (
list
ofdict
) – Processes to be monitoreddescription (
str
) – Description for the monitoring policyemail (
str
) – Email for notificationsagent (
boolean
) – Indicates if agent application will be installed
- Returns
Newly created instance of monitofing policy
- Return type
dict
- ex_create_private_network(name, description=None, datacenter_id=None, network_address=None, subnet_mask=None)[source]¶
Creates a private network
- Parameters
name (
str
) – Name of the private networkdescription (
str
) – Description of the private networkdatacenter_id (
str
) – ID of the data center for the private networknetwork_address (
str
) – Network address of the private networksubnet_mask (
str
) – Subnet mask of the private network
- Returns
Newly created private network
- Return type
dict
- ex_create_public_ip(type, reverse_dns=None, datacenter_id=None)[source]¶
Creates a public IP
- Parameters
type (
str
) – Type of IP (IPV4 or IPV6)reverse_dns (
str
) – Reverse DNSdatacenter_id (
str
) – Datacenter ID where IP address will be crated
- Returns
Instance of Public IP
- Return type
dict
Creates a shared storage :param name: Name of the storage :param size: Size of the storage :param datacenter_id: datacenter where storage should be created :param description: description ot the storage :return: ‘dict’
- ex_delete_firewall_policy(fw_id)[source]¶
Deletes firewall policy
- Parameters
fw_id – ID of the Firewall
- Returns
‘dict’
- ex_delete_load_balancer(lb_id)[source]¶
Deletes a load balancer rule
- Parameters
lb_id (
str
) – ID of the load balancerrule_id (
str
) – Rule ID
- Returns
Instance of load balancer
- Return type
dict
- ex_delete_monitoring_policy(policy_id)[source]¶
Deletes a monitoring policy
- Parameters
policy_id (
str
) – Id of the monitoring policy- Returns
Instance of the monitoring policy being deleted
- Return type
dict
- ex_delete_private_network(network_id)[source]¶
Deletes a private network
- Parameters
network_id (
str
) – Id of the private network- Returns
Instance of the private network being deleted
- Return type
dict
- ex_delete_public_ip(ip_id)[source]¶
Deletes a public IP
- Parameters
ip_id (
str
) – ID of public IP- Returns
Instance of IP Address
- Return type
dict
Removes a shared storage
- Parameters
storage_id – Id of the shared storage
- Type
str
- Returns
Instnace of shared storage
- Return type
list
ofdict
Detaches a server from shared storage
- Parameters
storage_id – Id of the shared storage
server_id – Id of the server
- Type
str
- Type
str
- Returns
Instance of shared storage
- Return type
dict
- ex_get_firewall_policy(fw_id)[source]¶
Gets firewall policy
- Parameters
fw_id – ID of the firewall policy
- Returns
‘dict’
- ex_get_load_balancer(lb_id)[source]¶
Gets a single load balancer
- Parameters
lb_id (
str
) – ID of the load balancer- Returns
Instance of load balancer
- Return type
dict
- ex_get_load_balancer_rule(lb_id, rule_id)[source]¶
Get a load balancer rule
- Parameters
lb_id (
str
) – ID of the load balancerrule_id (
str
) – Rule ID
- Returns
A load balancer rule
- Return type
dict
- ex_get_load_balancer_server_ip(lb_id, server_ip)[source]¶
Gets load balanced server id
- Parameters
lb_id (
str
) – ID of the load balancerserver_ip (
str
) – ID of the server IP
- Returns
Server IP
- Return type
dict
- ex_get_monitoring_policy(policy_id)[source]¶
Fetches a monitoring policy
- Parameters
policy_id (
str
) – Id of the monitoring policy- Returns
Instance of a monitoring policy
- Return type
dict
- ex_get_monitoring_policy_port(policy_id, port_id)[source]¶
Fetches monitoring policy port
- Parameters
policy_id (
str
) – Id of the monitoring policyport_id (
str
) – Id of the port
- Returns
Instance of a monitoring policy
- Return type
dict
- ex_get_monitoring_policy_ports(policy_id)[source]¶
Fetches monitoring policy ports
- Parameters
policy_id – Id of the monitoring policy
- Returns
Instance of a monitoring policy
- Return type
dict
- ex_get_monitoring_policy_process(policy_id, process_id)[source]¶
Fetches monitoring policy process
- Parameters
policy_id (
str
) – Id of the monitoring policyprocess_id (
str
) – Id of the process
- Returns
Instance of a monitoring policy
- Return type
dict
- ex_get_monitoring_policy_processes(policy_id)[source]¶
Fetches monitoring policy processes
- Parameters
policy_id (
str
) – Id of the monitoring policy- Returns
Instance of a monitoring policy
- Return type
dict
- ex_get_public_ip(ip_id)[source]¶
Gets a Public IP
- Parameters
ip_id (
str
) – ID of the IP- Returns
Instance of Public IP
- Return type
dict
- ex_get_server(server_id)[source]¶
Gets a server
- Parameters
server_id – Id of the server to be retrieved
- Type
str
- Returns
Instance of class
Node
- Return type
- class
Node
- ex_get_server_firewall_policies(server_id, ip_id)[source]¶
Gets a firewall policy of attached to the server’s IP
- Parameters
server_id – Id of the server
ip_id – ID of the IP address
- Type
str
- Type
str
- Returns
IP address object
- Return type
dict
- ex_get_server_hardware(server_id)[source]¶
Gets all server hardware
- Parameters
server_id – Id of the server
- Type
str
- Returns
Server’s hardware
- Return type
dict
- ex_get_server_image(server_id)[source]¶
Gets server image
- Parameters
server_id – Id of the server
- Type
str
- Returns
Server image
- Return type
dict
- ex_get_server_ip(server_id, ip_id)[source]¶
Get a single server IP object
- Parameters
server_id – Id of the server
ip_id – ID of the IP address
- Type
str
- Type
str
- Returns
IP address object
- Return type
dict
Gets a shared storage :return: ‘dict’
Gets a shared storage’s server :param storage_id: :param server_id: :return:
- ex_list_load_balancer_rules(lb_id)[source]¶
Lists loadbalancer rules
- Parameters
lb_id (
str
) – ID of the load balancer- Returns
Lists of rules
- Return type
list
ofdict
- ex_list_load_balancer_server_ips(lb_id)[source]¶
List balanced server IP addresses
- Parameters
lb_id (
str
) – ID of the load balancer- Returns
Array of IP address IDs
- Return type
dict
- ex_list_load_balancers()[source]¶
Lists all load balancers
- Returns
List of load balancers
- Return type
list
ofdict
- ex_list_monitoring_policies()[source]¶
Lists all monitoring policies
- Returns
List of monitoring policies
- Return type
dict
- ex_list_monitoring_policy_servers(policy_id)[source]¶
List all servers that are being monitoried by the policy
- Parameters
policy_id (
str
) – Id of the monitoring policy- Returns
List of servers being monitored
- Return type
list
ofdict
- ex_list_private_network_servers(network_id)[source]¶
Lists all private network servers
- Parameters
network_id (
str
) – Private network ID- Returns
List of private network servers
- Return type
dict
- ex_list_private_networks()[source]¶
Lists all private networks
- Returns
List of private networks
- Return type
dict
- ex_list_public_ips()[source]¶
Lists all public IP addresses
- Returns
Array of public addresses
- Return type
list
ofdict
- ex_list_server_ips(server_id)[source]¶
Gets all server IP objects
- Parameters
server_id – Id of the server
- Type
str
- Returns
List of server IP objects
- Return type
list
ofdict
List of shared storages :return: ‘dict’
- ex_modify_server_hardware(server_id, fixed_instance_size_id=None, vcore=None, cores_per_processor=None, ram=None)[source]¶
Modifies server’s hardware
- Parameters
server_id –
fixed_instance_size_id – Id of the fixed instance size
vcore – Virtual cores count
cores_per_processor – Count of cores per procesor
ram – Amount of ram for the server
- Type
str
- Type
str
- Type
int
- Type
int
- Type
int
- Returns
Instance of class
Node
- Type
- class
Node
- ex_modify_server_hdd(server_id, hdd_id=None, size=None)[source]¶
Modifies server hard disk drives
- Parameters
server_id – Id of the server
hdd_id – Id of the hard disk
size – Size of the hard disk
- Type
str
- Type
str
- Type
str
- Returns
Instance of class
Node
- Return type
- class
Node
- ex_reinstall_server_image(server_id, image_id, password=None)[source]¶
Installs a new image on the server
- Parameters
server_id – Id of the server
image_id – Id of the image (Server Appliance)
password – New password for the server
- Type
str
- Type
str
- Returns
Instance of class
Node
- Return type
- class
Node
- ex_remove_hdd(server_id, hdd_id)[source]¶
Removes existing hard disk
- Parameters
server_id – Id of the server
hdd_id – Id of the hard disk
- Type
str
- Type
str
- Returns
Instance of class
Node
- Return type
- class
Node
- ex_remove_load_balancer_rule(lb_id, rule_id)[source]¶
Removes load balancer rule
- Parameters
lb_id – Load balancer ID
rule_id – Rule ID
- Return type
str
- Return type
str
- Returns
Instance of load balancer
- Return type
dict
- ex_remove_monitoring_policy_port(policy_id, port_id)[source]¶
Removes monitoring policy port
- Parameters
policy_id (
str
) – Id of the monitoring policyport_id (
str
) – Id of the port
- Returns
Instance of a monitoring policy
- Return type
dict
- ex_remove_monitoring_policy_process(policy_id, process_id)[source]¶
Removes monitoring policy process
- Parameters
policy_id (
str
) – Id of the monitoring policyprocess_id (
str
) – Id of the process
- Returns
Instance of a monitoring policy
- Return type
dict
- ex_remove_server_from_load_balancer(lb_id, server_ip)[source]¶
Removes server’s IP from load balancer
- Parameters
lb_id – Load balancer ID
server_ip – ID of the server IP
- Type
str
- Type
str
- Returns
Instance of load balancer
- Return type
dict
- ex_remove_server_from_monitoring_policy(policy_id, server_id)[source]¶
Removes a server from monitoring policy
- Parameters
policy_id (
str
) – Id of the monitoring policyserver_id (
str
) – Id of the server
- Returns
Instance of a monitoring policy
- Return type
dict
- ex_remove_server_from_private_network(network_id, server_id)[source]¶
Removes a server from the private network
- Parameters
network_id (
str
) – Private Network IDserver_id (
str
) – Id of the server
- Returns
Instance of the private network
- Return type
dict
- ex_remove_server_ip(server_id, ip_id, keep_ip=None)[source]¶
Removes an IP address from the server
- Parameters
server_id – Id of the server
ip_id – ID of the IP address
keep_ip – Indicates whether IP address will be removed from the Cloud Panel
- Type
str
- Type
str
- Type
boolean
- Returns
Node
instance- Return type
Node
- ex_rename_server(server_id, name=None, description=None)[source]¶
Renames the server :param server_id: ID of the server you want to rename
- Parameters
name – New name of the server
description – New description of the server
- Type
str
- Type
str
- Returns
Instance of class
Node
- Return type
- class
Node
- ex_shutdown_server(server_id, method='SOFTWARE')[source]¶
Shuts down the server
- Parameters
server_id – Id of the server to be shut down
method – Method of shutting down “SOFTWARE” or “HARDWARE”
- Type
str
- Returns
Instance of class
Node
- Return type
- class
Node
- ex_update_load_balancer(lb_id, name=None, description=None, health_check_test=None, health_check_interval=None, persistence=None, persistence_time=None, method=None)[source]¶
- ex_update_monitoring_policy(policy_id, email, thresholds, name=None, description=None)[source]¶
Updates monitoring policy
- Parameters
policy_id (
str
) – Id of the monitoring policyemail (
str
) – Email to send notifications tothresholds (
dict
) – Thresholds for the monitoring policyname (
str
) – Name of the monitoring policydescription (
str
) – Description of the monitoring policy
- Returns
Instance of the monitoring policy being deleted
- Return type
dict
- ex_update_private_network(network_id, name=None, description=None, datacenter_id=None, network_address=None, subnet_mask=None)[source]¶
Updates a private network
- Parameters
name (
str
) – Name of the private networkdescription (
str
) – Description of the private networkdatacenter_id (
str
) – ID of the data center for the private networknetwork_address (
str
) – Network address of the private networksubnet_mask (
str
) – Subnet mask of the private network
- Returns
Instance of private network
- Return type
dict
- ex_update_public_ip(ip_id, reverse_dns)[source]¶
Updates a Public IP
- Parameters
ip_id (
str
) – ID of public IPreverse_dns (
str
) – Reverse DNS
- Returns
Instance of Public IP
- Return type
dict
- get_image(image_id)[source]¶
Returns a single node image from a provider.
- Parameters
image_id (
str
) – Node to run the task on.
:rtype
NodeImage
: :return: NodeImage instance on success.
- list_sizes()[source]¶
Lists all sizes
- Returns
A list of all configurable node sizes.
- Return type
list
ofNodeSize
- name = '1and1'¶
- reboot_node(node)[source]¶
Reboots the node.
- Parameters
node – The node you wish to destroy.
- Returns
Instance of class
Node
- Return type
- class
Node
- type = 'oneandone'¶
- website = 'http://www.1and1.com'¶
- class libcloud.compute.drivers.oneandone.OneAndOneResponse(response, connection)[source]¶
Bases:
libcloud.common.base.JsonResponse
OneAndOne response parsing.
- Parameters
response (
httplib.HTTPResponse
) – HTTP response object. (optional)connection (
Connection
) – Parent connection object.
- parse_error()[source]¶
Parse the error messages.
Override in a provider’s subclass.
- Returns
Parsed error.
- Return type
str
- success()[source]¶
Determine if our request was successful.
The meaning of this can be arbitrary; did we receive OK status? Did the node get created? Were we authenticated?
- Return type
bool
- Returns
True
orFalse
- valid_response_codes = [<HTTPStatus.OK: 200>, <HTTPStatus.CREATED: 201>, <HTTPStatus.ACCEPTED: 202>]¶
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.OpenNebulaConnection(*args, **kwargs)[source]¶
Bases:
libcloud.common.base.ConnectionUserAndKey
Connection class for the OpenNebula.org driver. with plain_auth support
Initialize user_id and key; set secure to an
int
based on passed value.- 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
libcloud.compute.drivers.opennebula.OpenNebulaResponse
- secure = True¶
- 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, api_version='3.2', **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 = {'ACTIVE': NodeState.RUNNING, 'DONE': NodeState.TERMINATED, 'FAILED': NodeState.TERMINATED, 'HOLD': NodeState.PENDING, 'INIT': NodeState.PENDING, 'PENDING': NodeState.PENDING, 'STOPPED': NodeState.TERMINATED, 'SUSPENDED': NodeState.PENDING}¶
- connectionCls¶
alias of
libcloud.compute.drivers.opennebula.OpenNebulaConnection
- create_node(name, size, image, networks=None)[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)
- destroy_node(node)[source]¶
Destroy a node.
Depending upon the provider, this may destroy all data associated with the node, including backups.
- Parameters
node (
Node
) – The node to be destroyed- Returns
True if the destroy was successful, False otherwise.
- Return type
bool
- 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
- list_images(location=None)[source]¶
List images on a provider.
- Parameters
location (
NodeLocation
) – The location at which to list images.- Returns
list of node image objects.
- Return type
list
ofNodeImage
- list_locations()[source]¶
List data centers for a provider
- Returns
list of node location objects
- Return type
list
ofNodeLocation
- 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/'¶
- 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.
- Parameters
id (
str
) – Size ID.name (
str
) – Size name.ram (
int
) – Amount of memory (in MB) provided by this size.disk (
int
) – Amount of disk storage (in GB) provided by this image.bandwidth (
int
) – Amount of bandiwdth included with this size.price (
float
) – Price (in US dollars) of running this node for an hour.driver (
NodeDriver
) – Driver this size belongs to.extra (
dict
) – Optional provider specific attributes associated with this size.
- 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.
- class libcloud.compute.drivers.opennebula.OpenNebula_1_4_NodeDriver(key, secret=None, api_version='3.2', **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)'¶
- class libcloud.compute.drivers.opennebula.OpenNebula_2_0_NodeDriver(key, secret=None, api_version='3.2', **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(name, size, image, networks=None, context=None)[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
- destroy_node(node)[source]¶
Destroy a node.
Depending upon the provider, this may destroy all data associated with the node, including backups.
- Parameters
node (
Node
) – The node to be destroyed- Returns
True if the destroy was successful, False otherwise.
- Return type
bool
- 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)'¶
- class libcloud.compute.drivers.opennebula.OpenNebula_3_0_NodeDriver(key, secret=None, api_version='3.2', **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
- name = 'OpenNebula (v3.0)'¶
- class libcloud.compute.drivers.opennebula.OpenNebula_3_2_NodeDriver(key, secret=None, api_version='3.2', **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)'¶
- class libcloud.compute.drivers.opennebula.OpenNebula_3_8_NodeDriver(key, secret=None, api_version='3.2', **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¶
libcloud.compute.drivers.openstack module¶
OpenStack driver
- class libcloud.compute.drivers.openstack.OpenStackNodeDriver(key, secret=None, secure=True, host=None, port=None, api_version='1.1', **kwargs)[source]¶
Bases:
libcloud.compute.base.NodeDriver
,libcloud.common.openstack.OpenStackDriverMixin
Base OpenStack node driver. Should not be used directly.
- 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': NodeState.RUNNING, 'BUILD': NodeState.PENDING, 'DELETED': NodeState.TERMINATED, 'DELETE_IP': NodeState.PENDING, 'ERROR': NodeState.ERROR, 'HARD_REBOOT': NodeState.REBOOTING, 'PASSWORD': NodeState.PENDING, 'PREP_RESIZE': NodeState.PENDING, 'QUEUE_RESIZE': NodeState.PENDING, 'REBOOT': NodeState.REBOOTING, 'REBUILD': NodeState.PENDING, 'RESCUE': NodeState.PENDING, 'RESIZE': NodeState.RECONFIGURING, 'SHARE_IP': NodeState.PENDING, 'SHARE_IP_NO_CONFIG': NodeState.PENDING, 'SHUTOFF': NodeState.STOPPED, 'SUSPENDED': NodeState.SUSPENDED, 'UNKNOWN': NodeState.UNKNOWN, 'VERIFY_RESIZE': NodeState.RUNNING}¶
- SNAPSHOT_STATE_MAP = {'available': VolumeSnapshotState.AVAILABLE, 'creating': VolumeSnapshotState.CREATING, 'deleting': VolumeSnapshotState.DELETING, 'error': VolumeSnapshotState.ERROR, 'error_restoring': VolumeSnapshotState.ERROR, 'restoring': VolumeSnapshotState.RESTORING}¶
- VOLUME_STATE_MAP = {'attaching': StorageVolumeState.ATTACHING, 'available': StorageVolumeState.AVAILABLE, 'backing-up': StorageVolumeState.BACKUP, 'creating': StorageVolumeState.CREATING, 'deleting': StorageVolumeState.DELETING, 'error': StorageVolumeState.ERROR, 'error_deleting': StorageVolumeState.ERROR, 'error_extending': StorageVolumeState.ERROR, 'error_restoring': StorageVolumeState.ERROR, 'in-use': StorageVolumeState.INUSE, 'restoring-backup': StorageVolumeState.BACKUP}¶
- api_name = 'openstack'¶
- attach_volume(node, volume, device='auto')[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
- 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 createdlocation (
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
- destroy_node(node)[source]¶
Destroy a node.
Depending upon the provider, this may destroy all data associated with the node, including backups.
- Parameters
node (
Node
) – The node to be destroyed- Returns
True if the destroy was successful, False otherwise.
- Return type
bool
- destroy_volume(volume)[source]¶
Destroys a storage volume.
- Parameters
volume (
StorageVolume
) – Volume to be destroyed- Return type
bool
- detach_volume(volume, ex_node=None)[source]¶
Detaches a volume from a node.
- Parameters
volume (
StorageVolume
) – Volume to be detached- Return type
bool
- ex_get_node_details(node_id)[source]¶
Lists details of the specified server.
- Parameters
node_id (
str
) – ID of the node which should be used- Return type
Node
- ex_hard_reboot_node(node)[source]¶
Hard reboots the specified server
- Parameters
node (
Node
) – node- Return type
bool
- ex_soft_reboot_node(node)[source]¶
Soft reboots the specified server
- Parameters
node (
Node
) – node- Return type
bool
- get_image(image_id)[source]¶
Get an image based on an image_id
@inherits:
NodeDriver.get_image
- Parameters
image_id (
str
) – Image identifier- Returns
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 (optional)
- list_locations()[source]¶
List data centers for a provider
- Returns
list of node location objects
- Return type
list
ofNodeLocation
- 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.
- list_sizes(location=None)[source]¶
List sizes on a provider
- Parameters
location (
NodeLocation
) – The location at which to list sizes- Returns
list of node size objects
- Return type
list
ofNodeSize
- list_volumes()[source]¶
List storage volumes.
- Return type
list
ofStorageVolume
- name = 'OpenStack'¶
- reboot_node(node)[source]¶
Reboot a node.
- Parameters
node (
Node
) – The node to be rebooted- Returns
True if the reboot was successful, otherwise False
- Return type
bool
- start_node(node)[source]¶
Start a node.
- Parameters
node (
Node
) – The node to be started- Returns
True if the start was successful, otherwise False
- Return type
bool
- stop_node(node)[source]¶
Stop a node
- Parameters
node (
Node
) – The node to be stopped.- Returns
True if the stop was successful, otherwise False
- Return type
bool
- website = 'http://openstack.org/'¶
- 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_tenant_domain_id='default', ex_force_service_type=None, ex_force_service_name=None, ex_force_service_region=None, ex_force_microversion=None, ex_auth_cache=None, retry_delay=None, backoff=None)[source]¶
Bases:
libcloud.compute.drivers.openstack.OpenStackComputeConnection
Initialize user_id and key; set secure to an
int
based on passed value.- 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
libcloud.compute.drivers.openstack.OpenStack_1_0_Response
- class libcloud.compute.drivers.openstack.OpenStack_1_0_NodeDriver(key, secret=None, secure=True, host=None, port=None, api_version='1.1', **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
- 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
libcloud.compute.drivers.openstack.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 imagename (
str
) – name for new image
- Return type
NodeImage
- create_node(name, size, image, ex_metadata=None, ex_files=None, ex_shared_ip_group=None, ex_shared_ip_group_id=None)[source]¶
Create a new node
@inherits:
NodeDriver.create_node
- Parameters
ex_metadata (
dict
) – Key/Value metadata to associate with a nodeex_files (
dict
) – File Path => File contents to create on the nodeex_shared_ip_group_id (
str
) – The server is launched into that shared IP group
- delete_image(image)[source]¶
Delete an image for node.
@inherits:
NodeDriver.delete_image
- Parameters
image (
NodeImage
) – the image to be deleted- Return 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 usednode_id (
str
) – ID of the node which should be used
- Return type
bool
- ex_delete_ip_group(group_id)[source]¶
Deletes the specified shared IP group.
- Parameters
group_id (
str
) – group id which should be used- Return 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 used- Return type
- 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 required- Return 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 usedimage_id (
str
) – ID of the image which should be used
- Return type
bool
- ex_resize(node, size)[source]¶
NOTE: This method is here for backward compatibility reasons.
You should use
ex_resize_node
instead.
- ex_resize_node(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
- 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 passwordpassword (
str
) – new password.
- Return type
bool
- 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 namename (
str
) – new name
- Return type
bool
Shares an IP address to the specified server.
- Parameters
group_id (
str
) – group id which should be usednode_id (
str
) – ID of the node which should be usedip (
str
) – ip which should be usedconfigure_node (
bool
) – configure node
- Return type
bool
Removes a shared IP address from the specified server.
- Parameters
node_id (
str
) – ID of the node which should be usedip (
str
) – ip which should be used
- Return type
bool
- features = {'create_node': ['generates_password']}¶
- List of available features for a driver.
libcloud.compute.base.NodeDriver.create_node()
ssh_key: Supports
NodeAuthSSHKey
as an authentication method for nodes.password: Supports
NodeAuthPassword
as an authentication method for nodes.generates_password: Returns a password attribute on the Node object returned from creation.
- type = 'openstack'¶
- 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_0_Response(*args, **kwargs)[source]¶
Bases:
libcloud.common.openstack.OpenStackResponse
- Parameters
response (
httplib.HTTPResponse
) – HTTP response object. (optional)connection (
Connection
) – Parent connection object.
Bases:
object
Shared IP group info.
- 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_tenant_domain_id='default', ex_force_service_type=None, ex_force_service_name=None, ex_force_service_region=None, ex_force_microversion=None, ex_auth_cache=None, retry_delay=None, backoff=None)[source]¶
Bases:
libcloud.compute.drivers.openstack.OpenStackComputeConnection
Initialize user_id and key; set secure to an
int
based on passed value.- accept_format = 'application/json'¶
- default_content_type = 'application/json; charset=UTF-8'¶
- responseCls¶
alias of
libcloud.compute.drivers.openstack.OpenStack_1_1_Response
- 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.OpenStack_1_1_FloatingIpPool(name, connection)[source]¶
Bases:
object
Floating IP Pool info.
- delete_floating_ip(ip)[source]¶
Delete specified floating IP from the pool
- Parameters
ip (
OpenStack_1_1_FloatingIpAddress
) – floating IP to remove- Return type
bool
- get_floating_ip(ip)[source]¶
Get specified floating IP from the pool
- Parameters
ip (
str
) – floating IP to get- Return type
- 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_NodeDriver(key, secret=None, secure=True, host=None, port=None, api_version='1.1', **kwargs)[source]¶
Bases:
libcloud.compute.drivers.openstack.OpenStackNodeDriver
OpenStack 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
libcloud.compute.drivers.openstack.OpenStack_1_1_Connection
- create_image(node, name, metadata=None)[source]¶
Creates a new image.
- Parameters
node (
Node
) – Nodename (
str
) – The name for the new image.metadata (
dict
) – Key and value pairs for metadata.
- Return type
NodeImage
- create_key_pair(name)[source]¶
Create a new key pair object.
- Parameters
name (
str
) – Key pair name.- Return type
KeyPair
object
- create_node(name, size, image=None, ex_keyname=None, ex_userdata=None, ex_config_drive=None, ex_security_groups=None, ex_metadata=None, ex_files=None, networks=None, ex_disk_config=None, ex_admin_pass=None, ex_availability_zone=None, ex_blockdevicemappings=None, ex_os_scheduler_hints=None)[source]¶
Create a new node
@inherits:
NodeDriver.create_node
- Parameters
ex_keyname (
str
) – The name of the key pairex_userdata (
str
) – String containing user data see https://help.ubuntu.com/community/CloudInitex_config_drive (
bool
) – Enable config drive see http://docs.openstack.org/grizzly/openstack-compute/admin/content/config-drive.htmlex_security_groups (
list
ofOpenStackSecurityGroup
) – List of security groups to assign to the nodeex_metadata (
dict
) – Key/Value metadata to associate with a nodeex_files (
dict
) – File Path => File contents to create on the nodenetworks (
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 nodeex_availability_zone (
str
) – Nova availability zone for the nodeex_blockdevicemappings (
dict
) – Enables fine grained control of the block device mapping for an instance.ex_os_scheduler_hints (
dict
) – The dictionary of data to send to the scheduler.
- 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 | NoneType) – Name of snapshot (optional)
ex_description (str | NoneType) – 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 used- Return type
bool
- delete_key_pair(key_pair)[source]¶
Delete a KeyPair.
- Parameters
keypair (
OpenStackKeyPair
) – KeyPair to delete- Return type
bool
- destroy_volume_snapshot(snapshot)[source]¶
Destroys a snapshot.
- Parameters
snapshot (
VolumeSnapshot
) – The snapshot to delete- Return type
- ex_attach_floating_ip_to_node(node, ip)[source]¶
Attach the floating IP to the node
- Parameters
node (
Node
) – nodeip (
str
orOpenStack_1_1_FloatingIpAddress
) – floating IP to attach
- Return type
bool
- 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 pool- Return type
- ex_create_keypair(name)[source]¶
Create a new KeyPair
- Parameters
name (
str
) – Name of the new KeyPair- Return type
OpenStackKeyPair
- ex_create_network(name, cidr)[source]¶
Create a new Network
- Parameters
name (
str
) – Name of network which should be usedcidr (
str
) – cidr of network which should be used
- Return type
OpenStackNetwork
- ex_create_security_group(name, description)[source]¶
Create a new Security Group
- Parameters
name (
str
) – Name of the new Security Groupdescription (
str
) – Description of the new Security Group
- Return type
OpenStackSecurityGroup
- 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 ruleip_protocol (
str
) – Protocol to which this rule applies Examples: tcp, udp, …from_port (
int
) – First port of the port rangeto_port (
int
) – Last port of the port rangecidr (
str
) – CIDR notation of the source IP range for this rulesource_security_group (L{OpenStackSecurityGroup) – Existing Security Group to use as the source (instead of CIDR)
- Return type
OpenStackSecurityGroupRule
- ex_create_snapshot(volume, name, description=None, force=False)[source]¶
Create a snapshot based off of a volume.
- Parameters
volume (
StorageVolume
) – volumename (
str
) – New name for the volume snapshotdescription (
str
) – Description of the snapshot (optional)force (
bool
) – Whether to force creation (optional)
- Return type
VolumeSnapshot
- ex_delete_floating_ip(ip)[source]¶
Delete specified floating IP
- Parameters
ip (
OpenStack_1_1_FloatingIpAddress
) – floating IP to remove- Return type
bool
- ex_delete_keypair(keypair)[source]¶
Delete a KeyPair.
- Parameters
keypair (
OpenStackKeyPair
) – KeyPair to delete- Return type
bool
- ex_delete_network(network)[source]¶
Delete a Network
- Parameters
network (
OpenStackNetwork
) – Network which should be used- Return type
bool
- ex_delete_security_group(security_group)[source]¶
Delete a Security Group.
- Parameters
security_group (
OpenStackSecurityGroup
) – Security Group should be deleted- Return type
bool
- ex_delete_security_group_rule(rule)[source]¶
Delete a Rule from a Security Group.
- Parameters
rule (
OpenStackSecurityGroupRule
) – Rule should be deleted- Return type
bool
- ex_delete_snapshot(snapshot)[source]¶
Delete a VolumeSnapshot
- Parameters
snapshot (
VolumeSnapshot
) – snapshot- Return type
bool
- ex_detach_floating_ip_from_node(node, ip)[source]¶
Detach the floating IP from the node
- Parameters
node (
Node
) – nodeip (
str
orOpenStack_1_1_FloatingIpAddress
) – floating IP to remove
- Return type
bool
- ex_get_console_output(node, length=None)[source]¶
Get console output
- Parameters
node (
Node
) – nodelength (
int
) – Optional number of lines to fetch from the console log
- Returns
Dictionary with the output
- Return type
dict
- ex_get_floating_ip(ip)[source]¶
Get specified floating IP
- Parameters
ip (
str
) – floating IP to get- Return type
- ex_get_metadata(node)[source]¶
Get a Node’s metadata.
- Parameters
node (
Node
) – Node- Returns
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 instance- Returns
A dictionary or other mapping of strings to strings, associating tag names with tag values.
- ex_get_network(network_id)[source]¶
Retrieve the Network with the given ID
- Parameters
networkId (
str
) – ID of the network
:rtype
OpenStackNetwork
- 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 used- Return type
NodeSize
- ex_get_size_extra_specs(size_id)[source]¶
Get the extra_specs field of a NodeSize
- Parameters
size_id (
str
) – ID of the size which should be used- Return type
dict
- ex_import_keypair(name, keyfile)[source]¶
Import a KeyPair from a file
- Parameters
name (
str
) – Name of the new KeyPairkeyfile (
str
) – Path to the public key file (in OpenSSH format)
- Return type
OpenStackKeyPair
- ex_import_keypair_from_string(name, key_material)[source]¶
Import a KeyPair from a string
- Parameters
name (
str
) – Name of the new KeyPairkey_material (
str
) – Public key (in OpenSSH format)
- Return type
OpenStackKeyPair
- 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 nodeex_files (
dict
) – File Path => File contents to create on the nodeex_keyname (
str
) – Name of existing public key to inject into instanceex_userdata (
str
) – String containing user data see https://help.ubuntu.com/community/CloudInitex_security_groups (
list
ofOpenStackSecurityGroup
) – List of security groups to assign to the nodeex_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
- ex_rescue(node, password=None)[source]¶
Rescue a node
- Parameters
node (
Node
) – nodepassword (
str
) – password
- Return type
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
- 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
) – Nodemetadata (
dict
) – Key/Value metadata to associate with a node
- Return type
dict
- 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
- ex_set_server_name(node, name)[source]¶
Sets the Node’s name.
- Parameters
node (
Node
) – Nodename (
str
) – The name of the server.
- Return type
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
) – Nodename (
str
) – New name for the server
- Return type
Node
- features = {'create_node': ['generates_password']}¶
- List of available features for a driver.
libcloud.compute.base.NodeDriver.create_node()
ssh_key: Supports
NodeAuthSSHKey
as an authentication method for nodes.password: Supports
NodeAuthPassword
as an authentication method for nodes.generates_password: Returns a password attribute on the Node object returned from creation.
- get_image(image_id)[source]¶
Get a NodeImage
@inherits:
NodeDriver.get_image
- Parameters
image_id (
str
) – ID of the image which should be used- 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
- 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.
- Return type
KeyPair
object
- list_key_pairs()[source]¶
List all the available key pair objects.
- Return type
list
ofKeyPair
objects
- list_volume_snapshots(volume)[source]¶
List snapshots for a storage volume.
- Return type
list
ofVolumeSnapshot
- type = 'openstack'¶
- class libcloud.compute.drivers.openstack.OpenStack_1_1_Response(*args, **kwargs)[source]¶
Bases:
libcloud.common.openstack.OpenStackResponse
- Parameters
response (
httplib.HTTPResponse
) – HTTP response object. (optional)connection (
Connection
) – Parent connection object.
- class libcloud.compute.drivers.openstack.OpenStack_2_FloatingIpAddress(id, ip_address, pool, node_id=None, driver=None, extra=None)[source]¶
Bases:
libcloud.compute.drivers.openstack.OpenStack_1_1_FloatingIpAddress
Floating IP info 2.0.
- class libcloud.compute.drivers.openstack.OpenStack_2_FloatingIpPool(id, name, connection)[source]¶
Bases:
object
Floating IP Pool info.
- delete_floating_ip(ip)[source]¶
Delete specified floating IP from the pool
- Parameters
ip (
OpenStack_1_1_FloatingIpAddress
) – floating IP to remove- Return type
bool
- get_floating_ip(ip)[source]¶
Get specified floating IP from the pool
- Parameters
ip (
str
) – floating IP to get- Return type
- list_floating_ips()[source]¶
List floating IPs in the pool
- Return type
list
ofOpenStack_2_FloatingIpAddress
- class libcloud.compute.drivers.openstack.OpenStack_2_PortInterface(id, state, driver, created=None, extra=None)[source]¶
Bases:
libcloud.compute.base.UuidMixin
Port Interface info. Similar in functionality to a floating IP (can be attached / detached from a compute instance) but implementation-wise a bit different.
> A port is a connection point for attaching a single device, such as the > NIC of a server, to a network. The port also describes the associated > network configuration, such as the MAC and IP addresses to be used on > that port. https://docs.openstack.org/python-openstackclient/pike/cli/command-objects/port.html
Also see: https://developer.openstack.org/api-ref/compute/#port-interfaces-servers-os-interface
- Parameters
id (
str
) – Port Interface ID.state (
OpenStack_2_PortInterfaceState
) – State of the OpenStack_2_PortInterface.created (
datetime.datetime
) – A datetime object that represents when the port interface was createdextra (
dict
) – Optional provided specific attributes associated with this image.
libcloud.compute.drivers.outscale module¶
Outscale SDK
- class libcloud.compute.drivers.outscale.OutscaleNodeDriver(key: Optional[str] = None, secret: Optional[str] = None, region: str = 'eu-west-2', service: str = 'api', version: str = 'latest', base_uri: str = 'outscale.com')[source]¶
Bases:
libcloud.compute.base.NodeDriver
Outscale SDK 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
- attach_volume(node: libcloud.compute.base.Node, volume: libcloud.compute.base.StorageVolume, device: Optional[str] = None)[source]¶
Attach a volume to a node.
- Parameters
node (
Node
) – the ID of the VM you want to attach the volume to (required)volume (
StorageVolume
) – the ID of the volume you want to attach (required)device (
str
) – the name of the device (required)
- Returns
the attached volume
- Return type
dict
- create_image(ex_architecture: Optional[str] = None, node: Optional[libcloud.compute.base.Node] = None, name: Optional[str] = None, description: Optional[str] = None, ex_block_device_mapping: Optional[dict] = None, ex_no_reboot: bool = False, ex_root_device_name: Optional[str] = None, ex_dry_run: bool = False, ex_source_region_name: Optional[str] = None, ex_file_location: Optional[str] = None)[source]¶
Create a new image.
- Parameters
node (
str
) – a valid Node objectex_architecture – The architecture of the OMI (by default,
i386). :type ex_architecture:
str
- Parameters
description (
str
) – a description for the new OMIname (
str
) – A unique name for the new OMI.ex_block_device_mapping (
dict
) – One or more block device mappings.ex_no_reboot – If false, the VM shuts down before creating
the OMI and then reboots. If true, the VM does not. :type ex_no_reboot:
bool
- Parameters
ex_root_device_name (
str
) – The name of the root device.ex_source_region_name – The name of the source Region,
which must be the same as the Region of your account. :type ex_source_region_name:
str
- Parameters
ex_file_location – The pre-signed URL of the OMI manifest
file, or the full path to the OMI stored in an OSU bucket. If you specify this parameter, a copy of the OMI is created in your account. :type ex_file_location:
str
- Parameters
ex_dry_run – If true, checks whether you have the required
permissions to perform the action. :type ex_dry_run:
bool
- Returns
the created image
- Return type
dict
- create_key_pair(name: str, ex_dry_run: bool = False, ex_public_key: Optional[str] = None)[source]¶
Create a new key pair.
- Parameters
name – A unique name for the keypair, with a maximum
length of 255 ASCII printable characters. :type name:
str
- Parameters
ex_dry_run – If true, checks whether you have the required
permissions to perform the action. :type ex_dry_run:
bool
- Parameters
ex_public_key (
str
) – The public key. It must be base64-encoded.- Returns
the created key pair
- Return type
dict
- create_node(image: libcloud.compute.base.NodeImage, name: Optional[str] = None, ex_dry_run: bool = False, ex_block_device_mapping: Optional[dict] = None, ex_boot_on_creation: bool = True, ex_bsu_optimized: bool = True, ex_client_token: Optional[str] = None, ex_deletion_protection: bool = False, ex_keypair_name: Optional[str] = None, ex_max_vms_count: Optional[int] = None, ex_min_vms_count: Optional[int] = None, ex_nics: Optional[List[dict]] = None, ex_performance: Optional[str] = None, ex_placement: Optional[dict] = None, ex_private_ips: Optional[List[str]] = None, ex_security_group_ids: Optional[List[str]] = None, ex_security_groups: Optional[List[str]] = None, ex_subnet_id: Optional[str] = None, ex_user_data: Optional[str] = None, ex_vm_initiated_shutdown_behavior: Optional[str] = None, ex_vm_type: Optional[str] = None)[source]¶
Create a new instance.
- Parameters
image (
NodeImage
) – The image used to create the VM.name (
str
) – The name of the Node.ex_dry_run – If true, checks whether you have the required
permissions to perform the action. :type ex_dry_run:
bool
- Parameters
ex_block_device_mapping (
dict
) – One or more block device mappings.ex_boot_on_creation – By default or if true, the VM is
started on creation. If false, the VM is stopped on creation. :type ex_boot_on_creation:
bool
- Parameters
ex_bsu_optimized – If true, the VM is created with optimized
BSU I/O. :type ex_bsu_optimized:
bool
- Parameters
ex_client_token – A unique identifier which enables you to
manage the idempotency. :type ex_client_token:
bool
- Parameters
ex_deletion_protection – If true, you cannot terminate the
VM using Cockpit, the CLI or the API. If false, you can. :type ex_deletion_protection:
bool
- Parameters
ex_keypair_name (
str
) – The name of the keypair.ex_max_vms_count – The maximum number of VMs you want to
create. If all the VMs cannot be created, the largest possible number of VMs above MinVmsCount is created. :type ex_max_vms_count:
integer
- Parameters
ex_min_vms_count – The minimum number of VMs you want to
create. If this number of VMs cannot be created, no VMs are created. :type ex_min_vms_count:
integer
- Parameters
ex_nics – One or more NICs. If you specify this parameter,
you must define one NIC as the primary network interface of the VM with 0 as its device number. :type ex_nics:
list
ofdict
- Parameters
ex_performance – The performance of the VM (standard | high
highest).- Parameters
ex_placement (
dict
) – Information about the placement of the VM.ex_private_ips (
list
) – One or more private IP addresses of the VM.ex_security_group_ids – One or more IDs of security group
for the VMs. :type ex_security_group_ids:
list
- Parameters
ex_security_groups – One or more names of security groups
for the VMs. :type ex_security_groups:
list
- Parameters
ex_subnet_id – The ID of the Subnet in which you want to
create the VM. :type ex_subnet_id:
str
- Parameters
ex_user_data – Data or script used to add a specific
configuration to the VM. It must be base64-encoded. :type ex_user_data:
str
- Parameters
ex_vm_initiated_shutdown_behavior – The VM behavior when
you stop it. By default or if set to stop, the VM stops. If set to restart, the VM stops then automatically restarts. If set to terminate, the VM stops and is terminated. create the VM. :type ex_vm_initiated_shutdown_behavior:
str
- Parameters
ex_vm_type (
str
) – The type of VM (t2.small by default).- Returns
the created instance
- Return type
dict
- create_volume(ex_subregion_name: str, ex_dry_run: bool = False, ex_iops: Optional[int] = None, size: Optional[int] = None, snapshot: Optional[libcloud.compute.base.VolumeSnapshot] = None, ex_volume_type: Optional[str] = None)[source]¶
Create a new volume.
- Parameters
snapshot (
str
) – the ID of the snapshot from which you want to create the volume (required)ex_dry_run – If true, checks whether you have the required
permissions to perform the action. :type ex_dry_run:
bool
- Parameters
size (
int
) – the size of the volume, in gibibytes (GiB), the maximum allowed size for a volume is 14,901 GiBex_subregion_name – The Subregion in which you want to
create the volume. :type ex_subregion_name:
str
- Parameters
ex_volume_type – the type of volume you want to create (io1
gp2 | standard)- Parameters
ex_iops – The number of I/O operations per second (IOPS).
This parameter must be specified only if you create an io1 volume. The maximum number of IOPS allowed for io1 volumes is 13000. :type ex_iops:
integer
- Returns
the created volume
- Return type
dict
- create_volume_snapshot(ex_description: Optional[str] = None, ex_dry_run: bool = False, ex_file_location: Optional[str] = None, ex_snapshot_size: Optional[int] = None, ex_source_region_name: Optional[str] = None, ex_source_snapshot: Optional[libcloud.compute.base.VolumeSnapshot] = None, volume: Optional[libcloud.compute.base.StorageVolume] = None)[source]¶
Create a new volume snapshot.
- Parameters
ex_description (
str
) – a description for the new OMIex_snapshot_size – The size of the snapshot created in your
account, in bytes. This size must be exactly the same as the source snapshot one. :type ex_snapshot_size:
integer
- Parameters
ex_source_snapshot – The ID of the snapshot you want to
copy. :type ex_source_snapshot:
str
- Parameters
volume – The ID of the volume you want to create a
snapshot of. :type volume:
str
- Parameters
ex_source_region_name – The name of the source Region,
which must be the same as the Region of your account. :type ex_source_region_name:
str
- Parameters
ex_file_location – The pre-signed URL of the OMI manifest
file, or the full path to the OMI stored in an OSU bucket. If you specify this parameter, a copy of the OMI is created in your account. :type ex_file_location:
str
- Parameters
ex_dry_run – If true, checks whether you have the required
permissions to perform the action. :type ex_dry_run:
bool
- Returns
the created snapshot
- Return type
dict
- delete_image(node_image: libcloud.compute.base.NodeImage)[source]¶
Delete an image.
- Parameters
node_image (
str
) – the ID of the OMI you want to delete (required)- Returns
request
- Return type
bool
- delete_key_pair(key_pair: libcloud.compute.base.KeyPair)[source]¶
Delete a key pair.
- Parameters
key_pair – the name of the keypair
you want to delete (required) :type key_pair:
KeyPair
- Returns
bool
- Return type
bool
- destroy_node(node: libcloud.compute.base.Node)[source]¶
Delete instance.
- Parameters
node (
Node
) – one or more IDs of VMs (required)- Returns
request
- Return type
bool
- destroy_volume(volume: libcloud.compute.base.StorageVolume)[source]¶
Delete a volume.
- Parameters
volume (
StorageVolume
) – the ID of the volume you want to delete (required)- Returns
request
- Return type
bool
- destroy_volume_snapshot(snapshot: libcloud.compute.base.VolumeSnapshot)[source]¶
Delete a volume snapshot.
- Parameters
snapshot (
VolumeSnapshot
) – the ID of the snapshot you want to delete (required)- Returns
request
- Return type
bool
- detach_volume(volume: libcloud.compute.base.StorageVolume, ex_dry_run: bool = False, ex_force_unlink: bool = False)[source]¶
Detach a volume from a node.
- Parameters
volume – the ID of the volume you want to detach
(required) :type volume:
str
- Parameters
ex_force_unlink – Forces the detachment of the volume in
case of previous failure. Important: This action may damage your data or file systems. :type ex_force_unlink:
bool
- Parameters
ex_dry_run – If true, checks whether you have the required
permissions to perform the action. :type ex_dry_run:
bool
- Returns
the attached volume
- Return type
dict
- ex_accept_net_peering(net_peering_id: Optional[List[str]] = None, dry_run: bool = False)[source]¶
Accepts a Net peering connection request. To accept this request, you must be the owner of the peer Net. If you do not accept the request within 7 days, the state of the Net peering connection becomes expired.
- Parameters
net_peering_id – The ID of the Net peering connection you
want to accept. (required) :type net_peering_id:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
The accepted Net Peering
- Return type
dict
- ex_attach_public_ip(allow_relink: Optional[bool] = None, dry_run: bool = False, nic_id: Optional[str] = None, vm_id: Optional[str] = None, public_ip: Optional[str] = None, public_ip_id: Optional[str] = None)[source]¶
Attach public ip to a node.
- Parameters
allow_relink – If true, allows the EIP to be associated
with the VM or NIC that you specify even if it is already associated with another VM or NIC. :type allow_relink:
bool
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
:param nic_id:(Net only) The ID of the NIC. This parameter is required if the VM has more than one NIC attached. Otherwise, you need to specify the VmId parameter instead. You cannot specify both parameters at the same time. :type nic_id:
str
- Parameters
vm_id – the ID of the VM
public_ip – The EIP. In the public Cloud, this parameter
is required. :type public_ip:
str
- Parameters
public_ip_id – The allocation ID of the EIP. In a Net,
this parameter is required. :type public_ip_id:
str
- Returns
the attached volume
- Return type
dict
- ex_check_account(login: str, password: str, dry_run: bool = False)[source]¶
Validates the authenticity of the account.
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Parameters
login (
str
) – the login of the accountpassword (
str
) – the password of the accountdry_run (
bool
) – the password of the account
- Returns
True if the action successful
- Return type
bool
- ex_create_access_key(expiration_date: Optional[datetime.datetime] = None, dry_run: bool = False)[source]¶
Creates a new secret access key and the corresponding access key ID for a specified user. The created key is automatically set to ACTIVE.
- Parameters
expiration_date – The date and time at which you want the
access key to expire, in ISO 8601 format (for example, 2017-06-14 or 2017-06-14T00:00:00Z). If not specified, the access key has no expiration date. :type expiration_date:
datetime
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
access key if action is successful
- Return type
dict
- ex_create_account(city: Optional[str] = None, company_name: Optional[str] = None, country: Optional[str] = None, customer_id: Optional[str] = None, email: Optional[str] = None, first_name: Optional[str] = None, last_name: Optional[str] = None, zip_code: Optional[str] = None, job_title: Optional[str] = None, mobile_number: Optional[str] = None, phone_number: Optional[str] = None, state_province: Optional[str] = None, vat_number: Optional[str] = None, dry_run: bool = False)[source]¶
Creates a new 3DS OUTSCALE account.
You need 3DS OUTSCALE credentials and the appropriate quotas to create a new account via API. To get quotas, you can send an email to sales@outscale.com. If you want to pass a numeral value as a string instead of an integer, you must wrap your string in additional quotes (for example, ‘“92000”’).
- Parameters
city (
str
) – The city of the account owner.company_name – The name of the company for the account.
permissions to perform the action. :type company_name:
str
- Parameters
country (
str
) – The country of the account owner.customer_id (
str
) – The ID of the customer. It must be 8 digits.email (
str
) – The email address for the account.first_name (
str
) – The first name of the account owner.last_name (
str
) – The last name of the account owner.zip_code (
str
) – The ZIP code of the city.job_title (
str
) – The job title of the account owner.mobile_number – The mobile phone number of the account
owner. :type mobile_number:
str
- Parameters
phone_number – The landline phone number of the account
owner. :type phone_number:
str
- Parameters
state_province (
str
) – The state/province of the account.vat_number – The value added tax (VAT) number for
the account. :type vat_number:
str
- Parameters
dry_run (
bool
) – the password of the account- Returns
True if the action is successful
- Return type
bool
- ex_create_api_access_rule(description: Optional[str] = None, ip_ranges: Optional[List[str]] = None, ca_ids: Optional[List[str]] = None, cns: Optional[List[str]] = None, dry_run: bool = False)[source]¶
Create an API access rule. It is a rule to allow access to the API from your account. You need to specify at least the CaIds or the IpRanges parameter.
- Parameters
description (
str
) – The description of the new rule.ip_ranges – One or more IP ranges, in CIDR notation
(for example, 192.0.2.0/16). :type ip_ranges:
List
ofstr
- Parameters
ca_ids – One or more IDs of Client Certificate Authorities
(CAs). :type ca_ids:
List
ofstr
- Parameters
cns – One or more Client Certificate Common Names (CNs).
If this parameter is specified, you must also specify the ca_ids parameter. :type cns:
List
ofstr
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
a dict containing the API access rule created.
- Return type
dict
- ex_create_certificate_authority(ca_perm: str, description: Optional[str] = None, dry_run: bool = False)[source]¶
Creates a Client Certificate Authority (CA).
- Parameters
ca_perm (
str
) – The CA in PEM format. (required)description (
bool
) – The description of the CA.dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
the created Ca.
- Return type
dict
- ex_create_client_gateway(bgp_asn: Optional[int] = None, connection_type: Optional[str] = None, public_ip: Optional[str] = None, dry_run: bool = False)[source]¶
Provides information about your client gateway. This action registers information to identify the client gateway that you deployed in your network. To open a tunnel to the client gateway, you must provide the communication protocol type, the valid fixed public IP address of the gateway, and an Autonomous System Number (ASN).
- Parameters
bgp_asn – An Autonomous System Number (ASN) used by
the Border Gateway Protocol (BGP) to find the path to your client gateway through the Internet. (required) :type bgp_asn:
int
(required)- Parameters
connection_type – The communication protocol used to
establish tunnel with your client gateway (only ipsec.1 is supported). (required) :type connection_type:
str
- Parameters
public_ip – The public fixed IPv4 address of your
client gateway. (required) :type public_ip:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
Client Gateway as
dict
- Return type
dict
- ex_create_dhcp_options(domaine_name: Optional[str] = None, domaine_name_servers: Optional[list] = None, ntp_servers: Optional[list] = None, dry_run: bool = False)[source]¶
Creates a new set of DHCP options, that you can then associate with a Net using the UpdateNet method.
- Parameters
domaine_name – Specify a domain name
(for example, MyCompany.com). You can specify only one domain name. :type domaine_name:
str
- Parameters
domaine_name_servers – The IP addresses of domain name
servers. If no IP addresses are specified, the OutscaleProvidedDNS value is set by default. :type domaine_name_servers:
list
ofstr
- Parameters
ntp_servers – The IP addresses of the Network Time
Protocol (NTP) servers. :type ntp_servers:
list
ofstr
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
The created Dhcp Options
- Return type
dict
- ex_create_direct_link(bandwidth: Optional[str] = None, direct_link_name: Optional[str] = None, location: Optional[str] = None, dry_run: bool = False)[source]¶
Creates a new DirectLink between a customer network and a specified DirectLink location.
- Parameters
bandwidth – The bandwidth of the DirectLink
(1Gbps | 10Gbps). (required) :type bandwidth:
str
- Parameters
direct_link_name (
str
) – The name of the DirectLink. (required)location – The code of the requested location for
the DirectLink, returned by the list_locations method. Protocol (NTP) servers. :type location:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
The new Direct Link
- Return type
dict
- ex_create_direct_link_interface(direct_link_id: Optional[str] = None, bgp_asn: Optional[int] = None, bgp_key: Optional[str] = None, client_private_ip: Optional[str] = None, direct_link_interface_name: Optional[str] = None, outscale_private_ip: Optional[str] = None, virtual_gateway_id: Optional[str] = None, vlan: Optional[int] = None, dry_run: bool = False)[source]¶
Creates a DirectLink interface. DirectLink interfaces enable you to reach one of your Nets through a virtual gateway.
- Parameters
direct_link_id – The ID of the existing DirectLink for which
you want to create the DirectLink interface. (required) :type direct_link_id:
str
- Parameters
bgp_asn – The BGP (Border Gateway Protocol) ASN (Autonomous
System Number) on the customer’s side of the DirectLink interface. (required) :type bgp_asn:
int
- Parameters
bgp_key (
str
) – The BGP authentication key.client_private_ip – The IP address on the customer’s side
of the DirectLink interface. (required) :type client_private_ip:
str
- Parameters
direct_link_interface_name – The name of the DirectLink
interface. (required) :type direct_link_interface_name:
str
- Parameters
outscale_private_ip – The IP address on 3DS OUTSCALE’s side
of the DirectLink interface. :type outscale_private_ip:
str
:param virtual_gateway_id:The ID of the target virtual gateway. (required) :type virtual_gateway_id:
str
- Parameters
vlan – The VLAN number associated with the DirectLink
interface. (required) :type vlan:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
The new Direct Link Interface
- Return type
dict
- ex_create_flexible_gpu(delete_on_vm_deletion: Optional[bool] = None, generation: Optional[str] = None, model_name: Optional[str] = None, subregion_name: Optional[str] = None, dry_run: bool = False)[source]¶
Allocates a flexible GPU (fGPU) to your account. You can then attach this fGPU to a virtual machine (VM).
- Parameters
delete_on_vm_deletion – If true, the fGPU is deleted when
the VM is terminated. :type delete_on_vm_deletion:
bool
- Parameters
generation – The processor generation that the fGPU must be
compatible with. If not specified, the oldest possible processor generation is selected (as provided by ReadFlexibleGpuCatalog for the specified model of fGPU). :type generation:
str
- Parameters
model_name – The model of fGPU you want to allocate. For
more information, see About Flexible GPUs: https://wiki.outscale.net/display/EN/About+Flexible+GPUs (required) :type model_name:
str
- Parameters
subregion_name – The Subregion in which you want to create
the fGPU. (required) :type subregion_name:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
The new Flexible GPU
- Return type
dict
- ex_create_image_export_task(image: Optional[libcloud.compute.base.NodeImage] = None, osu_export_disk_image_format: Optional[str] = None, osu_export_api_key_id: Optional[str] = None, osu_export_api_secret_key: Optional[str] = None, osu_export_bucket: Optional[str] = None, osu_export_manifest_url: Optional[str] = None, osu_export_prefix: Optional[str] = None, dry_run: bool = False)[source]¶
Exports an Outscale machine image (OMI) to an Object Storage Unit (OSU) bucket. This action enables you to copy an OMI between accounts in different Regions. To copy an OMI in the same Region, you can also use the CreateImage method. The copy of the OMI belongs to you and is independent from the source OMI.
- Parameters
image (
NodeImage
) – The ID of the OMI to export. (required)dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Parameters
osu_export_disk_image_format – The format of the
export disk (qcow2 | vdi | vmdk). (required) :type osu_export_disk_image_format:
str
- Parameters
osu_export_api_key_id – The API key of the OSU
account that enables you to access the bucket. :type osu_export_api_key_id:
str
- Parameters
osu_export_api_secret_key – The secret key of the
OSU account that enables you to access the bucket. :type osu_export_api_secret_key:
str
- Parameters
osu_export_bucket – The name of the OSU bucket
you want to export the object to. (required) :type osu_export_bucket:
str
- Parameters
osu_export_manifest_url (
str
) – The URL of the manifest file.osu_export_prefix – The prefix for the key of
the OSU object. This key follows this format: prefix + object_export_task_id + ‘.’ + disk_image_format. :type osu_export_prefix:
str
- Returns
the created image export task
- Return type
dict
- ex_create_internet_service(dry_run: bool = False)[source]¶
Creates an Internet service you can use with a Net. An Internet service enables your virtual machines (VMs) launched in a Net to connect to the Internet. By default, a Net includes an Internet service, and each Subnet is public. Every VM launched within a default Subnet has a private and a public IP addresses.
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
The new Internet Service
- Return type
dict
- ex_create_listener_rule()[source]¶
Creates a rule for traffic redirection for the specified listener. Each rule must have either the HostNamePattern or PathPattern parameter specified. Rules are treated in priority order, from the highest value to the lowest value. Once the rule is created, you need to register backend VMs with it. For more information, see the RegisterVmsInLoadBalancer method. https://docs.outscale.com/api#registervmsinloadbalancer
- Parameters
vms (
list
ofNode
) – The IDs of the backend VMs. (required)l_load_balancer_name – The name of the load balancer to
which the listener is attached. (required) :type l_load_balancer_name:
str
- Parameters
l_load_balancer_port – The port of load balancer on which
the load balancer is listening (between 1 and 65535 both included). (required) :type l_load_balancer_port:
int
- Parameters
lr_action – The type of action for the rule
(always forward). :type lr_action:
str
- Parameters
lr_host_name_pattern – A host-name pattern for the rule,
with a maximum length of 128 characters. This host-name pattern supports maximum three wildcards, and must not contain any special characters except [-.?]. :type lr_host_name_pattern:
str
- Parameters
lr_id (
str
) – The ID of the listener.lr_name (
str
) – A human-readable name for the listener rule.lr_path_pattern – A path pattern for the rule, with a
maximum length of 128 characters. This path pattern supports maximum three wildcards, and must not contain any special characters except [_-.$/~”’@:+?]. :type lr_path_pattern:
str
- Parameters
lr_priority – The priority level of the listener rule,
between 1 and 19999 both included. Each rule must have a unique priority level. Otherwise, an error is returned. (required) :type lr_priority:
int
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
The new Listener Rule
- Return type
dict
- ex_create_load_balancer(load_balancer_name: Optional[str] = None, load_balancer_type: Optional[str] = None, security_groups: Optional[List[str]] = None, subnets: Optional[List[str]] = None, subregion_names: Optional[str] = None, tag_keys: Optional[List[str]] = None, tag_values: Optional[List[str]] = None, l_backend_port: Optional[int] = None, l_backend_protocol: Optional[str] = None, l_load_balancer_port: Optional[int] = None, l_load_balancer_protocol: Optional[str] = None, l_server_certificate_id: Optional[str] = None, dry_run: bool = False)[source]¶
Creates a load balancer. The load balancer is created with a unique Domain Name Service (DNS) name. It receives the incoming traffic and routes it to its registered virtual machines (VMs). By default, this action creates an Internet-facing load balancer, resolving to public IP addresses. To create an internal load balancer in a Net, resolving to private IP addresses, use the LoadBalancerType parameter.
- Parameters
load_balancer_name – The name of the load balancer for
which you want to create listeners. (required) :type load_balancer_name:
str
- Parameters
load_balancer_type – The type of load balancer:
internet-facing or internal. Use this parameter only for load balancers in a Net. :type load_balancer_type:
str
- Parameters
security_groups – One or more IDs of security groups you
want to assign to the load balancer. :type security_groups:
list
ofstr
- Parameters
subnets – One or more IDs of Subnets in your Net that you
want to attach to the load balancer. :type subnets:
list
ofstr
- Parameters
subregion_names – One or more names of Subregions
(currently, only one Subregion is supported). This parameter is not required if you create a load balancer in a Net. To create an internal load balancer, use the LoadBalancerType parameter. :type subregion_names:
list
ofstr
- Parameters
tag_keys – The key of the tag, with a minimum of 1
character. (required) :type tag_keys:
list
ofstr
- Parameters
tag_values – The value of the tag, between 0 and 255
characters. (required) :type tag_values:
list
ofstr
- Parameters
l_backend_port – The port on which the back-end VM is
listening (between 1 and 65535, both included). (required) :type l_backend_port:
int
- Parameters
l_backend_protocol – The protocol for routing traffic to
back-end VMs (HTTP | HTTPS | TCP | SSL | UDP). :type l_backend_protocol:
int
- Parameters
l_load_balancer_port – The port on which the load balancer
is listening (between 1 and 65535, both included). (required) :type l_load_balancer_port:
int
- Parameters
l_load_balancer_protocol – The routing protocol
(HTTP | HTTPS | TCP | SSL | UDP). (required) :type l_load_balancer_protocol:
str
- Parameters
l_server_certificate_id – The ID of the server certificate.
(required) :type l_server_certificate_id:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
The new Load Balancer
- Return type
dict
- ex_create_load_balancer_listeners(load_balancer_name: Optional[str] = None, l_backend_port: Optional[int] = None, l_backend_protocol: Optional[str] = None, l_load_balancer_port: Optional[int] = None, l_load_balancer_protocol: Optional[str] = None, l_server_certificate_id: Optional[str] = None, dry_run: bool = False)[source]¶
Creates one or more listeners for a specified load balancer.
- Parameters
load_balancer_name – The name of the load balancer for
which you want to create listeners. (required) :type load_balancer_name:
str
- Parameters
l_backend_port – The port on which the back-end VM is
listening (between 1 and 65535, both included). (required) :type l_backend_port:
int
- Parameters
l_backend_protocol – The protocol for routing traffic to
back-end VMs (HTTP | HTTPS | TCP | SSL | UDP). :type l_backend_protocol:
int
- Parameters
l_load_balancer_port – The port on which the load balancer
is listening (between 1 and 65535, both included). (required) :type l_load_balancer_port:
int
- Parameters
l_load_balancer_protocol – The routing protocol
(HTTP | HTTPS | TCP | SSL | UDP). (required) :type l_load_balancer_protocol:
str
- Parameters
l_server_certificate_id – The ID of the server certificate.
(required) :type l_server_certificate_id:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
The new Load Balancer Listener
- Return type
dict
- ex_create_load_balancer_policy(cookie_name: Optional[str] = None, load_balancer_name: Optional[str] = None, policy_name: Optional[str] = None, policy_type: Optional[str] = None, dry_run: bool = False)[source]¶
Creates a stickiness policy with sticky session lifetimes defined by the browser lifetime. The created policy can be used with HTTP or HTTPS listeners only. If this policy is implemented by a load balancer, this load balancer uses this cookie in all incoming requests to direct them to the specified back-end server virtual machine (VM). If this cookie is not present, the load balancer sends the request to any other server according to its load-balancing algorithm.
You can also create a stickiness policy with sticky session lifetimes following the lifetime of an application-generated cookie. Unlike the other type of stickiness policy, the lifetime of the special Load Balancer Unit (LBU) cookie follows the lifetime of the application-generated cookie specified in the policy configuration. The load balancer inserts a new stickiness cookie only when the application response includes a new application cookie. The session stops being sticky if the application cookie is removed or expires, until a new application cookie is issued.
- Parameters
cookie_name – The name of the application cookie used for
stickiness. This parameter is required if you create a stickiness policy based on an application-generated cookie. :type cookie_name:
str
- Parameters
load_balancer_name – The name of the load balancer for
which you want to create a policy. (required) :type load_balancer_name:
str
- Parameters
policy_name – The name of the policy. This name must be
unique and consist of alphanumeric characters and dashes (-). (required) :type policy_name:
str
- Parameters
policy_type – The type of stickiness policy you want to
create: app or load_balancer. (required) :type policy_type:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
The new Load Balancer Policy
- Return type
dict
- ex_create_load_balancer_tags(load_balancer_names: Optional[List[str]] = None, tag_keys: Optional[List[str]] = None, tag_values: Optional[List[str]] = None, dry_run: bool = False)[source]¶
Adds one or more tags to the specified load balancers. If a tag with the same key already exists for the load balancer, the tag value is replaced.
- Parameters
load_balancer_names – The name of the load balancer for
which you want to create listeners. (required) :type load_balancer_names:
str
- Parameters
tag_keys – The key of the tag, with a minimum of 1
character. (required) :type tag_keys:
list
ofstr
- Parameters
tag_values – The value of the tag, between 0 and 255
characters. (required) :type tag_values:
list
ofstr
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
The new Load Balancer Tags
- Return type
dict
- ex_create_nat_service(public_ip: Optional[str] = None, subnet_id: Optional[str] = None, dry_run: bool = False)[source]¶
Creates a network address translation (NAT) service in the specified public Subnet of a Net. A NAT service enables virtual machines (VMs) placed in the private Subnet of this Net to connect to the Internet, without being accessible from the Internet. When creating a NAT service, you specify the allocation ID of the External IP (EIP) you want to use as public IP for the NAT service. Once the NAT service is created, you need to create a route in the route table of the private Subnet, with 0.0.0.0/0 as destination and the ID of the NAT service as target. For more information, see LinkPublicIP and CreateRoute. This action also enables you to create multiple NAT services in the same Net (one per public Subnet).
- Parameters
public_ip – The allocation ID of the EIP to associate
with the NAT service. (required) :type public_ip:
str
- Parameters
subnet_id – The ID of the Subnet in which you want to
create the NAT service. (required) :type subnet_id:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
The new Nat Service
- Return type
dict
- ex_create_net(ip_range: Optional[str] = None, tenancy: Optional[str] = None, dry_run: bool = False)[source]¶
Creates a Net with a specified IP range. The IP range (network range) of your Net must be between a /28 netmask (16 IP addresses) and a /16 netmask (65 536 IP addresses).
- Parameters
ip_range – The IP range for the Net, in CIDR notation
(for example, 10.0.0.0/16). (required) :type ip_range:
str
- Parameters
tenancy – The tenancy options for the VMs (default if a VM
created in a Net can be launched with any tenancy, dedicated if it can be launched with dedicated tenancy VMs running on single-tenant hardware). :type tenancy:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
The new Nat Service
- Return type
dict
- ex_create_net_access_point(net_id: Optional[str] = None, route_table_ids: Optional[List[str]] = None, service_name: Optional[str] = None, dry_run: bool = False)[source]¶
Creates a Net access point to access a 3DS OUTSCALE service from this Net without using the Internet and External IP addresses. You specify the service using its prefix list name. For more information, see DescribePrefixLists: https://docs.outscale.com/api#describeprefixlists To control the routing of traffic between the Net and the specified service, you can specify one or more route tables. Virtual machines placed in Subnets associated with the specified route table thus use the Net access point to access the service. When you specify a route table, a route is automatically added to it with the destination set to the prefix list ID of the service, and the target set to the ID of the access point.
- Parameters
net_id (
str
) – The ID of the Net. (required)route_table_ids – One or more IDs of route tables to use
for the connection. :type route_table_ids:
list
ofstr
- Parameters
service_name – The prefix list name corresponding to the
service (for example, com.outscale.eu-west-2.osu for OSU). (required) :type service_name:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
The new Access Net Point
- Return type
dict
- ex_create_net_peering(accepter_net_id: Optional[str] = None, source_net_id: Optional[str] = None, dry_run: bool = False)[source]¶
Requests a Net peering connection between a Net you own and a peer Net that belongs to you or another account. This action creates a Net peering connection that remains in the pending-acceptance state until it is accepted by the owner of the peer Net. If the owner of the peer Net does not accept the request within 7 days, the state of the Net peering connection becomes expired. For more information, see AcceptNetPeering: https://docs.outscale.com/api#acceptnetpeering
- Parameters
accepter_net_id – The ID of the Net you want to connect
with. (required) :type accepter_net_id:
str
- Parameters
source_net_id – The ID of the Net you send the peering
request from. (required) :type source_net_id:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
The new Net Peering
- Return type
dict
- ex_create_nic(description: Optional[str] = None, private_ips_is_primary: Optional[List[str]] = None, private_ips: Optional[List[str]] = None, security_group_ids: Optional[List[str]] = None, subnet_id: Optional[str] = None, dry_run: bool = False)[source]¶
Creates a network interface card (NIC) in the specified Subnet.
- Parameters
description (
str
) – A description for the NIC.private_ips_is_primary – If true, the IP address is the
primary private IP address of the NIC. :type private_ips_is_primary:
list
ofstr
- Parameters
private_ips (
list
ofstr
) – The private IP addresses of the NIC.security_group_ids – One or more IDs of security groups for
the NIC. :type security_group_ids:
list
ofstr
- Parameters
subnet_id – The ID of the Subnet in which you want to
create the NIC. (required) :type subnet_id:
list
ofstr
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
The new Nic
- Return type
dict
- ex_create_public_ip(dry_run: bool = False)[source]¶
Create a new public ip.
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
the created public ip
- Return type
dict
- ex_create_route(destination_ip_range: Optional[str] = None, gateway_id: Optional[str] = None, nat_service_id: Optional[str] = None, net_peering_id: Optional[str] = None, nic_id: Optional[str] = None, route_table_id: Optional[str] = None, vm_id: Optional[str] = None, dry_run: bool = False)[source]¶
Creates a route in a specified route table within a specified Net. You must specify one of the following elements as the target:
Net peering connection
NAT VM
Internet service
Virtual gateway
NAT service
Network interface card (NIC)
The routing algorithm is based on the most specific match.
- Parameters
destination_ip_range – The IP range used for the
destination match, in CIDR notation (for example, 10.0.0.0/24). (required) :type destination_ip_range:
str
- Parameters
gateway_id – The ID of an Internet service or virtual
gateway attached to your Net. :type gateway_id:
str
- Parameters
nat_service_id (
str
) – The ID of a NAT service.net_peering_id (
str
) – The ID of a Net peering connection.nic_id (
str
) – The ID of a NIC.vm_id – The ID of a NAT VM in your Net (attached to exactly
one NIC). :type vm_id:
str
- Parameters
route_table_id – The ID of the route table for which you
want to create a route. (required) :type route_table_id: str`
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
The new Route
- Return type
dict
- ex_create_route_table(net_id: Optional[str] = None, dry_run: bool = False)[source]¶
Creates a route table for a specified Net. You can then add routes and associate this route table with a Subnet.
- Parameters
net_id – The ID of the Net for which you want to create a
route table. (required) :type net_id:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
The new Route Table
- Return type
dict
- ex_create_security_group(description: Optional[str] = None, net_id: Optional[str] = None, security_group_name: Optional[str] = None, dry_run: bool = False)[source]¶
Creates a security group. This action creates a security group either in the public Cloud or in a specified Net. By default, a default security group for use in the public Cloud and a default security group for use in a Net are created. When launching a virtual machine (VM), if no security group is explicitly specified, the appropriate default security group is assigned to the VM. Default security groups include a default rule granting VMs network access to each other. When creating a security group, you specify a name. Two security groups for use in the public Cloud or for use in a Net cannot have the same name. You can have up to 500 security groups in the public Cloud. You can create up to 500 security groups per Net. To add or remove rules, use the ex_create_security_group_rule method.
- Parameters
description – A description for the security group, with a
maximum length of 255 ASCII printable characters. (required) :type description:
str
- Parameters
net_id (
str
) – The ID of the Net for the security group.security_group_name – The name of the security group.
(required) :type security_group_name:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
The new Security Group
- Return type
dict
- ex_create_security_group_rule(flow: Optional[str] = None, from_port_range: Optional[int] = None, ip_range: Optional[str] = None, rules: Optional[List[dict]] = None, sg_account_id_to_link: Optional[str] = None, sg_id: Optional[str] = None, sg_name_to_link: Optional[str] = None, to_port_range: Optional[int] = None, dry_run: bool = False)[source]¶
Configures the rules for a security group. The modifications are effective at virtual machine (VM) level as quickly as possible, but a small delay may occur.
You can add one or more egress rules to a security group for use with a Net. It allows VMs to send traffic to either one or more destination IP address ranges or destination security groups for the same Net. We recommend using a set of IP permissions to authorize outbound access to a destination security group. We also recommended this method to create a rule with a specific IP protocol and a specific port range. In a set of IP permissions, we recommend to specify the the protocol.
You can also add one or more ingress rules to a security group. In the public Cloud, this action allows one or more IP address ranges to access a security group for your account, or allows one or more security groups (source groups) to access a security group for your own 3DS OUTSCALE account or another one. In a Net, this action allows one or more IP address ranges to access a security group for your Net, or allows one or more other security groups (source groups) to access a security group for your Net. All the security groups must be for the same Net.
- Parameters
flow – The direction of the flow: Inbound or Outbound.
You can specify Outbound for Nets only.type (required) description:
bool
- Parameters
from_port_range – The beginning of the port range for
the TCP and UDP protocols, or an ICMP type number. :type from_port_range:
int
- Parameters
ip_range – The name The IP range for the security group
rule, in CIDR notation (for example, 10.0.0.0/16). :type ip_range:
str
- Parameters
rules – Information about the security group rule to create:
https://docs.outscale.com/api#createsecuritygrouprule :type rules:
list
ofdict
- Parameters
sg_account_id_to_link – The account ID of the
owner of the security group for which you want to create a rule. :type sg_account_id_to_link:
str
- Parameters
sg_id – The ID of the security group for which
you want to create a rule. (required) :type sg_id:
str
- Parameters
sg_name_to_link – The ID of the source security
group. If you are in the Public Cloud, you can also specify the name of the source security group. :type sg_name_to_link:
str
- Parameters
to_port_range – TThe end of the port range for the TCP and
UDP protocols, or an ICMP type number. :type to_port_range:
int
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
The new Security Group Rule
- Return type
dict
- ex_create_server_certificate(body: Optional[str] = None, chain: Optional[str] = None, name: Optional[str] = None, path: Optional[str] = None, private_key: Optional[str] = None, dry_run: bool = False)[source]¶
Creates a server certificate and its matching private key. These elements can be used with other services (for example, to configure SSL termination on load balancers). You can also specify the chain of intermediate certification authorities if your certificate is not directly signed by a root one. You can specify multiple intermediate certification authorities in the CertificateChain parameter. To do so, concatenate all certificates in the correct order (the first certificate must be the authority of your certificate, the second must the the authority of the first one, and so on). The private key must be a RSA key in PKCS1 form. To check this, open the PEM file and ensure its header reads as follows: BEGIN RSA PRIVATE KEY. [IMPORTANT] This private key must not be protected by a password or a passphrase.
- Parameters
body (
str
) – The PEM-encoded X509 certificate. (required)chain – The PEM-encoded intermediate certification
authorities. :type chain:
str
- Parameters
name – A unique name for the certificate. Constraints:
1-128 alphanumeric characters, pluses (+), equals (=), commas (,), periods (.), at signs (@), minuses (-), or underscores (_). (required) :type name:
str
- Parameters
path – The path to the server certificate, set to a slash
(/) if not specified. :type path:
str
- Parameters
private_key – The PEM-encoded private key matching
the certificate. (required) :type private_key:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
The new server certificate
- Return type
dict
- ex_create_snapshot_export_task(osu_export_disk_image_format: Optional[str] = None, osu_export_api_key_id: Optional[str] = None, osu_export_api_secret_key: Optional[str] = None, osu_export_bucket: Optional[str] = None, osu_export_manifest_url: Optional[str] = None, osu_export_prefix: Optional[str] = None, snapshot: Optional[libcloud.compute.base.VolumeSnapshot] = None, dry_run: bool = False)[source]¶
Exports a snapshot to an Object Storage Unit (OSU) bucket. This action enables you to create a backup of your snapshot or to copy it to another account. You, or other users you send a pre-signed URL to, can then download this snapshot from the OSU bucket using the CreateSnapshot method. This procedure enables you to copy a snapshot between accounts within the same Region or in different Regions. To copy a snapshot within the same Region, you can also use the CreateSnapshot direct method. The copy of the source snapshot is independent and belongs to you.
- Parameters
osu_export_disk_image_format – The format of the export
disk (qcow2 | vdi | vmdk). (required) :type osu_export_disk_image_format:
str
- Parameters
osu_export_api_key_id – The API key of the OSU account
that enables you to access the bucket. :type osu_export_api_key_id :
str
- Parameters
osu_export_api_secret_key – The secret key of the OSU
account that enables you to access the bucket. :type osu_export_api_secret_key :
str
- Parameters
osu_export_bucket – The name of the OSU bucket you want
to export the object to. (required) :type osu_export_bucket :
str
- Parameters
osu_export_manifest_url – The URL of the manifest file.
:type osu_export_manifest_url :
str
- Parameters
osu_export_prefix – The prefix for the key of the OSU
object. This key follows this format: prefix + object_export_task_id + ‘.’ + disk_image_format. :type osu_export_prefix :
str
- Parameters
snapshot – The ID of the snapshot to export. (required)
:type snapshot :
VolumeSnapshot
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run :
bool
- Returns
the created snapshot export task
- Return type
dict
- ex_create_subnet(ip_range: Optional[str] = None, net_id: Optional[str] = None, subregion_name: Optional[str] = None, dry_run: bool = False)[source]¶
Creates a Subnet in an existing Net. To create a Subnet in a Net, you have to provide the ID of the Net and the IP range for the Subnet (its network range). Once the Subnet is created, you cannot modify its IP range. The IP range of the Subnet can be either the same as the Net one if you create only a single Subnet in this Net, or a subset of the Net one. In case of several Subnets in a Net, their IP ranges must not overlap. The smallest Subnet you can create uses a /30 netmask (four IP addresses).
- Parameters
ip_range – The IP range in the Subnet, in CIDR notation
(for example, 10.0.0.0/16). (required) :type ip_range:
str
- Parameters
net_id – The ID of the Net for which you want to create a
Subnet. (required) :type net_id:
str
- Parameters
subregion_name – TThe name of the Subregion in which you
want to create the Subnet. :type subregion_name:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
The new Subnet
- Return type
dict
- ex_create_tag(resource_ids: list, tag_key: Optional[str] = None, tag_value: Optional[str] = None, dry_run: bool = False)[source]¶
Adds one tag to the specified resources. If a tag with the same key already exists for the resource, the tag value is replaced. You can tag the following resources using their IDs:
- Parameters
resource_ids (
list
) – One or more resource IDs. (required)tag_key – The key of the tag, with a minimum of 1 character.
(required) :type tag_key:
str
- Parameters
tag_value – The value of the tag, between
0 and 255 characters. (required) :type tag_value:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. (required) :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_create_tags(resource_ids: list, tags: Optional[list] = None, dry_run: bool = False)[source]¶
Adds one or more tags to the specified resources. If a tag with the same key already exists for the resource, the tag value is replaced. You can tag the following resources using their IDs:
- Parameters
resource_ids (
list
) – One or more resource IDs. (required)tags – The key of the tag, with a minimum of 1 character.
(required) :type tags:
list
ofdict
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_create_virtual_gateway(connection_type: Optional[str] = None, dry_run: bool = False)[source]¶
Creates a virtual gateway. A virtual gateway is the access point on the Net side of a VPN connection.
- Parameters
connection_type – The type of VPN connection supported
by the virtual gateway (only ipsec.1 is supported). (required) :type connection_type:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
The new virtual gateway
- Return type
dict
- ex_create_vpn_connection(client_gateway_id: Optional[str] = None, connection_type: Optional[str] = None, static_routes_only: Optional[bool] = None, virtual_gateway_id: Optional[str] = None, dry_run: bool = False)[source]¶
Creates a VPN connection between a specified virtual gateway and a specified client gateway. You can create only one VPN connection between a virtual gateway and a client gateway.
- Parameters
client_gateway_id (
str
) – The ID of the client gateway. (required)connection_type – The type of VPN connection (only ipsec.1
is supported). (required) :type connection_type:
str
- Parameters
static_routes_only – If false, the VPN connection uses
dynamic routing with Border Gateway Protocol (BGP). If true, routing is controlled using static routes. For more information about how to create and delete static routes, see CreateVpnConnectionRoute: https://docs.outscale.com/api#createvpnconnectionroute and DeleteVpnConnectionRoute: https://docs.outscale.com/api#deletevpnconnectionroute :type static_routes_only:
bool
- Parameters
virtual_gateway_id – The ID of the virtual gateway.
(required) :type virtual_gateway_id:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
The new Vpn Connection
- Return type
dict
- ex_create_vpn_connection_route(destination_ip_range: Optional[str] = None, vpn_connection_id: Optional[str] = None, dry_run: bool = False)[source]¶
Creates a static route to a VPN connection. This enables you to select the network flows sent by the virtual gateway to the target VPN connection.
- Parameters
destination_ip_range – The network prefix of the route, in
CIDR notation (for example, 10.12.0.0/16).(required) :type destination_ip_range:
str
- Parameters
vpn_connection_id – The ID of the target VPN connection of
the static route. (required) :type vpn_connection_id:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_delete_access_key(access_key_id: str, dry_run: bool = False)[source]¶
Deletes the specified access key associated with the account that sends the request.
- Parameters
access_key_id – The ID of the access key you want to
delete. (required) :type access_key_id:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_delete_api_access_rule(api_access_rule_id: str, dry_run: bool = False)[source]¶
Delete an API access rule. You cannot delete the last remaining API access rule.
- Parameters
api_access_rule_id – The id of the targeted rule
(required). :type api_access_rule_id:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
true if successfull.
- Return type
bool
if successful ordict
- ex_delete_certificate_authority(ca_id: str, dry_run: bool = False)[source]¶
Deletes a specified Client Certificate Authority (CA).
- Parameters
ca_id (
str
) – The ID of the CA you want to delete. (required)dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- ex_delete_client_gateway(client_gateway_id: Optional[str] = None, dry_run: bool = False)[source]¶
Deletes a client gateway. You must delete the VPN connection before deleting the client gateway.
- Parameters
client_gateway_id – The ID of the client gateway
you want to delete. (required) :type client_gateway_id:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
Returns True if action is successful
- Return type
bool
- ex_delete_dhcp_options(dhcp_options_set_id: Optional[str] = None, dry_run: bool = False)[source]¶
Deletes a specified DHCP options set. Before deleting a DHCP options set, you must disassociate it from the Nets you associated it with. To do so, you need to associate with each Net a new set of DHCP options, or the default one if you do not want to associate any DHCP options with the Net.
- Parameters
dhcp_options_set_id – The ID of the DHCP options set
you want to delete. (required) :type dhcp_options_set_id:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_delete_direct_link(direct_link_id: Optional[str] = None, dry_run: bool = False)[source]¶
Deletes a specified DirectLink. Before deleting a DirectLink, ensure that all your DirectLink interfaces related to this DirectLink are deleted.
- Parameters
direct_link_id – The ID of the DirectLink you want to
delete. (required) :type direct_link_id:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_delete_direct_link_interface(direct_link_interface_id: Optional[str] = None, dry_run: bool = False)[source]¶
Deletes a specified DirectLink interface.
- Parameters
direct_link_interface_id – TThe ID of the DirectLink
interface you want to delete. (required) :type direct_link_interface_id:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_delete_export_task(export_task_id: Optional[str] = None, dry_run: bool = False)[source]¶
Deletes an export task. If the export task is not running, the command fails and an error is returned.
- Parameters
export_task_id – The ID of the export task to delete.
(required) :type export_task_id:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_delete_flexible_gpu(flexible_gpu_id: Optional[str] = None, dry_run: bool = False)[source]¶
Releases a flexible GPU (fGPU) from your account. The fGPU becomes free to be used by someone else.
- Parameters
flexible_gpu_id – The ID of the fGPU you want
to delete. (required) :type flexible_gpu_id:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_delete_internet_service(internet_service_id: Optional[str] = None, dry_run: bool = False)[source]¶
Deletes an Internet service. Before deleting an Internet service, you must detach it from any Net it is attached to.
- Parameters
internet_service_id – The ID of the Internet service you
want to delete.(required) :type internet_service_id:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_delete_listener_rule(listener_rule_name: Optional[str] = None, dry_run: bool = False)[source]¶
Deletes a listener rule. The previously active rule is disabled after deletion.
- Parameters
listener_rule_name – The name of the rule you want to
delete. (required) :type listener_rule_name:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_delete_load_balancer(load_balancer_name: Optional[str] = None, dry_run: bool = False)[source]¶
Deletes a specified load balancer.
- Parameters
load_balancer_name – The name of the load balancer you want
to delete. (required) :type load_balancer_name:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_delete_load_balancer_listeners(load_balancer_name: Optional[str] = None, load_balancer_ports: Optional[List[int]] = None, dry_run: bool = False)[source]¶
Deletes listeners of a specified load balancer.
- Parameters
load_balancer_name – The name of the load balancer for
which you want to delete listeners. (required) :type load_balancer_name:
str
- Parameters
load_balancer_ports – One or more port numbers of the
listeners you want to delete.. (required) :type load_balancer_ports:
list
ofint
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_delete_load_balancer_policy(load_balancer_name: Optional[str] = None, policy_name: Optional[str] = None, dry_run: bool = False)[source]¶
Deletes a specified policy from a load balancer. In order to be deleted, the policy must not be enabled for any listener.
- Parameters
load_balancer_name – The name of the load balancer for
which you want to delete a policy. (required) :type load_balancer_name:
str
- Parameters
policy_name – The name of the policy you want to delete.
(required) :type policy_name:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_delete_load_balancer_tags(load_balancer_names: Optional[List[str]] = None, tag_keys: Optional[List[str]] = None, dry_run: bool = False)[source]¶
Deletes a specified load balancer tags.
- Parameters
load_balancer_names – The names of the load balancer for
which you want to delete tags. (required) :type load_balancer_names:
str
- Parameters
tag_keys – The key of the tag, with a minimum of
1 character. :type tag_keys:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_delete_nat_service(nat_service_id: Optional[str] = None, dry_run: bool = False)[source]¶
Deletes a specified network address translation (NAT) service. This action disassociates the External IP address (EIP) from the NAT service, but does not release this EIP from your account. However, it does not delete any NAT service routes in your route tables.
- Parameters
nat_service_id – TThe ID of the NAT service you want to
delete. (required) :type nat_service_id:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_delete_net(net_id: Optional[str] = None, dry_run: bool = False)[source]¶
Deletes a specified Net. Before deleting the Net, you need to delete or detach all the resources associated with the Net:
Virtual machines (VMs)
Net peering connections
Custom route tables
External IP addresses (EIPs) allocated to resources in the Net
Network Interface Cards (NICs) created in the Subnets
Virtual gateways, Internet services and NAT services
Load balancers
Security groups
Subnets
- Parameters
net_id (
str
) – The ID of the Net you want to delete. (required)dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_delete_net_access_point(net_access_point_id: Optional[str] = None, dry_run: bool = False)[source]¶
Deletes one or more Net access point. This action also deletes the corresponding routes added to the route tables you specified for the Net access point.
- Parameters
net_access_point_id – The ID of the Net access point.
(required) :type net_access_point_id:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_delete_net_peering(net_peering_id: Optional[List[str]] = None, dry_run: bool = False)[source]¶
Deletes a Net peering connection. If the Net peering connection is in the active state, it can be deleted either by the owner of the requester Net or the owner of the peer Net. If it is in the pending-acceptance state, it can be deleted only by the owner of the requester Net. If it is in the rejected, failed, or expired states, it cannot be deleted.
- Parameters
net_peering_id – The ID of the Net peering connection you
want to delete. (required) :type net_peering_id:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_delete_nic(nic_id: Optional[str] = None, dry_run: bool = False)[source]¶
Deletes the specified network interface card (NIC). The network interface must not be attached to any virtual machine (VM).
- Parameters
nic_id (
str
) – The ID of the NIC you want to delete. (required)dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_delete_public_ip(dry_run: bool = False, public_ip: Optional[str] = None, public_ip_id: Optional[str] = None)[source]¶
Delete public ip.
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Parameters
public_ip – The EIP. In the public Cloud, this parameter is
required. :type public_ip:
str
- Parameters
public_ip_id – The ID representing the association of the
EIP with the VM or the NIC. In a Net, this parameter is required. :type public_ip_id:
str
- Returns
request
- Return type
dict
- ex_delete_route(destination_ip_range: Optional[str] = None, route_table_id: Optional[str] = None, dry_run: bool = False)[source]¶
Deletes a route from a specified route table.
- Parameters
destination_ip_range – The exact IP range for the route.
(required) :type destination_ip_range:
str
- Parameters
route_table_id – The ID of the route table from which you
want to delete a route. (required) :type route_table_id:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_delete_route_table(route_table_id: Optional[str] = None, dry_run: bool = False)[source]¶
Deletes a specified route table. Before deleting a route table, you must disassociate it from any Subnet. You cannot delete the main route table.
- Parameters
route_table_id – The ID of the route table you want to
delete. (required) :type route_table_id:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_delete_security_group(security_group_id: Optional[str] = None, security_group_name: Optional[str] = None, dry_run: bool = False)[source]¶
Deletes a specified security group. You can specify either the name of the security group or its ID. This action fails if the specified group is associated with a virtual machine (VM) or referenced by another security group.
- Parameters
security_group_id – The ID of the security group you want
to delete. :type security_group_id:
str
- Parameters
security_group_name (
str
) – TThe name of the security group.dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_delete_security_group_rule(flow: Optional[str] = None, from_port_range: Optional[int] = None, ip_protocol: Optional[str] = None, ip_range: Optional[str] = None, rules: Optional[List[dict]] = None, sg_account_id_to_unlink: Optional[str] = None, sg_id: Optional[str] = None, sg_name_to_unlink: Optional[str] = None, to_port_range: Optional[int] = None, dry_run: bool = False)[source]¶
Deletes one or more inbound or outbound rules from a security group. For the rule to be deleted, the values specified in the deletion request must exactly match the value of the existing rule. In case of TCP and UDP protocols, you have to indicate the destination port or range of ports. In case of ICMP protocol, you have to specify the ICMP type and code. Rules (IP permissions) consist of the protocol, IP address range or source security group. To remove outbound access to a destination security group, we recommend to use a set of IP permissions. We also recommend to specify the protocol in a set of IP permissions.
- Parameters
flow – The direction of the flow: Inbound or Outbound.
You can specify Outbound for Nets only.type (required) description:
bool
- Parameters
from_port_range – The beginning of the port range for
the TCP and UDP protocols, or an ICMP type number. :type from_port_range:
int
- Parameters
ip_range – The name The IP range for the security group
rule, in CIDR notation (for example, 10.0.0.0/16). :type ip_range:
str
- Parameters
ip_protocol – The IP protocol name (tcp, udp, icmp) or
protocol number. By default, -1, which means all protocols. :type ip_protocol:
str
- Parameters
rules – Information about the security group rule to create:
https://docs.outscale.com/api#createsecuritygrouprule :type rules:
list
ofdict
- Parameters
sg_account_id_to_unlink – The account ID of the
owner of the security group for which you want to delete a rule. :type sg_account_id_to_unlink:
str
- Parameters
sg_id – The ID of the security group for which
you want to delete a rule. (required) :type sg_id:
str
- Parameters
sg_name_to_unlink – The ID of the source security
group. If you are in the Public Cloud, you can also specify the name of the source security group. :type sg_name_to_unlink:
str
- Parameters
to_port_range – TThe end of the port range for the TCP and
UDP protocols, or an ICMP type number. :type to_port_range:
int
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
The new Security Group Rule
- Return type
dict
- ex_delete_server_certificate(name: Optional[str] = None, dry_run: bool = False)[source]¶
Deletes a specified server certificate.
- Parameters
name – The name of the server certificate you
want to delete. (required) :type name:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_delete_subnet(subnet_id: Optional[str] = None, dry_run: bool = False)[source]¶
Deletes a specified Subnet. You must terminate all the running virtual machines (VMs) in the Subnet before deleting it.
- Parameters
subnet_id – The ID of the Subnet you want to delete.
(required) :type subnet_id:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_delete_tags(resource_ids: list, tags: Optional[list] = None, dry_run: bool = False)[source]¶
Deletes one or more tags from the specified resources.
- Parameters
resource_ids (
list
) – One or more resource IDs. (required)tags – The key of the tag, with a minimum of 1 character.
(required) :type tags:
list
ofdict
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_delete_virtual_gateway(virtual_gateway_id: Optional[str] = None, dry_run: bool = False)[source]¶
Deletes a specified virtual gateway. Before deleting a virtual gateway, we recommend to detach it from the Net and delete the VPN connection.
- Parameters
virtual_gateway_id – The ID of the virtual gateway
you want to delete. (required) :type virtual_gateway_id:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_delete_vpn_connection(vpn_connection_id: Optional[str] = None, dry_run: bool = False)[source]¶
Deletes a specified VPN connection. If you want to delete a Net and all its dependencies, we recommend to detach the virtual gateway from the Net and delete the Net before deleting the VPN connection. This enables you to delete the Net without waiting for the VPN connection to be deleted.
- Parameters
vpn_connection_id – TThe ID of the VPN connection you want
to delete. (required) :type vpn_connection_id:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_delete_vpn_connection_route(vpn_connection_id: Optional[str] = None, destination_ip_range: Optional[str] = None, dry_run: bool = False)[source]¶
Deletes a specified VPN connection. If you want to delete a Net and all its dependencies, we recommend to detach the virtual gateway from the Net and delete the Net before deleting the VPN connection. This enables you to delete the Net without waiting for the VPN connection to be deleted.
- Parameters
vpn_connection_id – TThe ID of the VPN connection you want
to delete. (required) :type vpn_connection_id:
str
- Parameters
destination_ip_range – The network prefix of the route to
delete, in CIDR notation (for example, 10.12.0.0/16). (required) :type destination_ip_range:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_deregister_vms_in_load_balancer(backend_vm_ids: Optional[List[str]] = None, load_balancer_name: Optional[str] = None, dry_run: bool = False)[source]¶
Deregisters a specified virtual machine (VM) from a load balancer.
- Parameters
backend_vm_ids – One or more IDs of back-end VMs.
(required) :type backend_vm_ids:
str
- Parameters
load_balancer_name – The name of the load balancer.
(required) :type load_balancer_name:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_detach_public_ip(public_ip: Optional[str] = None, link_public_ip_id: Optional[str] = None, dry_run: bool = False)[source]¶
Detach public ip from a node.
- Parameters
public_ip – (Required in a Net) The ID representing the
association of the EIP with the VM or the NIC :type public_ip:
str
- Parameters
link_public_ip_id – (Required in a Net) The ID
representing the association of the EIP with the VM or the NIC. :type link_public_ip_id:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
the attached volume
- Return type
dict
- ex_link_flexible_gpu(flexible_gpu_id: Optional[str] = None, vm_id: Optional[str] = None, dry_run: bool = False)[source]¶
Attaches one of your allocated flexible GPUs (fGPUs) to one of your virtual machines (Nodes). The fGPU is in the attaching state until the VM is stopped, after which it becomes attached.
- Parameters
flexible_gpu_id – The ID of the fGPU you want to attach.
(required) :type flexible_gpu_id:
str
- Parameters
vm_id – The ID of the VM you want to attach the fGPU to.
(required) :type vm_id:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_link_internet_service(internet_service_id: Optional[str] = None, net_id: Optional[str] = None, dry_run: bool = False)[source]¶
Attaches an Internet service to a Net. To enable the connection between the Internet and a Net, you must attach an Internet service to this Net.
- Parameters
internet_service_id – The ID of the Internet service you
want to attach. (required) :type internet_service_id:
str
- Parameters
net_id – The ID of the Net to which you want to attach the
Internet service. (required) :type net_id:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_link_nic(device_number: Optional[int] = None, nic_id: Optional[str] = None, node: Optional[str] = None, dry_run: bool = False)[source]¶
Attaches a network interface card (NIC) to a virtual machine (VM). The interface and the VM must be in the same Subregion. The VM can be either running or stopped. The NIC must be in the available state.
- Parameters
nic_id (
str
) – The ID of the NIC you want to delete. (required)device_number – The ID of the NIC you want to delete.
(required) :type device_number:
str
- Parameters
node – The index of the VM device for the NIC attachment
(between 1 and 7, both included). :type node:
Node
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
a Link Id
- Return type
str
- ex_link_private_ips(allow_relink: Optional[bool] = None, nic_id: Optional[str] = None, private_ips: Optional[List[str]] = None, secondary_private_ip_count: Optional[int] = None, dry_run: bool = False)[source]¶
Assigns one or more secondary private IP addresses to a specified network interface card (NIC). This action is only available in a Net. The private IP addresses to be assigned can be added individually using the PrivateIps parameter, or you can specify the number of private IP addresses to be automatically chosen within the Subnet range using the SecondaryPrivateIpCount parameter. You can specify only one of these two parameters. If none of these parameters are specified, a private IP address is chosen within the Subnet range.
- Parameters
allow_relink – If true, allows an IP address that is
already assigned to another NIC in the same Subnet to be assigned to the NIC you specified. :type allow_relink:
str
- Parameters
nic_id (
str
) – The ID of the NIC. (required)private_ips – The secondary private IP address or addresses
you want to assign to the NIC within the IP address range of the Subnet. :type private_ips:
list
ofstr
- Parameters
secondary_private_ip_count – The secondary private IP a
ddress or addresses you want to assign to the NIC within the IP address range of the Subnet. :type secondary_private_ip_count:
int
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
:return:True if the action is successful :rtype:
bool
- ex_link_route_table(route_table_id: Optional[str] = None, subnet_id: Optional[str] = None, dry_run: bool = False)[source]¶
Associates a Subnet with a route table. The Subnet and the route table must be in the same Net. The traffic is routed according to the route table defined within this Net. You can associate a route table with several Subnets.
- Parameters
route_table_id (
str
) – The ID of the route table. (required)subnet_id (
str
) – The ID of the Subnet. (required)dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
Link Route Table Id
- Return type
str
- ex_link_virtual_gateway(net_id: Optional[str] = None, virtual_gateway_id: Optional[str] = None, dry_run: bool = False)[source]¶
Attaches a virtual gateway to a Net.
- Parameters
net_id – The ID of the Net to which you want to attach
the virtual gateway. (required) :type net_id:
str
- Parameters
virtual_gateway_id – The ID of the virtual
gateway. (required) :type virtual_gateway_id:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
- Return type
dict
- ex_list_access_keys(access_key_ids: Optional[list] = None, states: Optional[list] = None, dry_run: bool = False)[source]¶
Returns information about the access key IDs of a specified user. If the user does not have any access key ID, this action returns an empty list.
- Parameters
access_key_ids (
list
ofstr
) – The IDs of the access keys.states (
list
ofstr
) – The states of the access keys (ACTIVE | INACTIVE).dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
list
of Access Keys- Return type
list
ofdict
- ex_list_client_gateways(client_gateway_ids: Optional[list] = None, bgp_asns: Optional[list] = None, connection_types: Optional[list] = None, public_ips: Optional[list] = None, states: Optional[list] = None, tag_keys: Optional[list] = None, tag_values: Optional[list] = None, tags: Optional[list] = None, dry_run: bool = False)[source]¶
Deletes a client gateway. You must delete the VPN connection before deleting the client gateway.
- Parameters
client_gateway_ids – The IDs of the client gateways.
you want to delete. (required) :type client_gateway_ids:
list
of ``str`- Parameters
bgp_asns – The Border Gateway Protocol (BGP) Autonomous
System Numbers (ASNs) of the connections. :type bgp_asns:
list
ofint
- Parameters
connection_types – The types of communication tunnels
used by the client gateways (only ipsec.1 is supported). (required) :type connection_types:
list```of ``str
- Parameters
public_ips – The public IPv4 addresses of the
client gateways. :type public_ips:
list
ofstr
- Parameters
states – The states of the client gateways
(pending | available | deleting | deleted). :type states:
list
ofstr
- Parameters
tag_keys – The keys of the tags associated with
the client gateways. :type tag_keys:
list
ofstr
- Parameters
tag_values – The values of the tags associated with the
client gateways. :type tag_values:
list
ofstr
- Parameters
tags – TThe key/value combination of the tags
associated with the client gateways, in the following format: “Filters”:{“Tags”:[“TAGKEY=TAGVALUE”]}. :type tags:
list
ofstr
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
Returns
list
of Client Gateway- Return type
list
ofdict
- ex_list_consumption_account(from_date: Optional[str] = None, to_date: Optional[str] = None, dry_run: bool = False)[source]¶
Displays information about the consumption of your account for each billable resource within the specified time period.
- Parameters
from_date – The beginning of the time period, in
ISO 8601 date-time format (for example, 2017-06-14 or 2017-06-14T00:00:00Z). (required) :type from_date:
str
- Parameters
to_date – The end of the time period, in
ISO 8601 date-time format (for example, 2017-06-30 or 2017-06-30T00:00:00Z). (required) :type to_date:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
a list of Consumption Entries
- Return type
list
ofdict
- ex_list_dhcp_options(default: Optional[bool] = None, dhcp_options_set_id: Optional[list] = None, domaine_names: Optional[list] = None, domaine_name_servers: Optional[list] = None, ntp_servers: Optional[list] = None, tag_keys: Optional[list] = None, tag_values: Optional[list] = None, tags: Optional[list] = None, dry_run: bool = False)[source]¶
Retrieves information about the content of one or more DHCP options sets.
- Parameters
default – SIf true, lists all default DHCP options set.
If false, lists all non-default DHCP options set. :type default:
list
ofbool
- Parameters
dhcp_options_set_id (
list
ofstr
) – The IDs of the DHCP options sets.domaine_names – The domain names used for the DHCP
options sets. :type domaine_names:
list
ofstr
- Parameters
domaine_name_servers – The domain name servers used for
the DHCP options sets. :type domaine_name_servers:
list
ofstr
- Parameters
ntp_servers – The Network Time Protocol (NTP) servers used
for the DHCP options sets. :type ntp_servers:
list
ofstr
- Parameters
tag_keys – The keys of the tags associated with the DHCP
options sets. :type ntp_servers:
list
ofstr
- Parameters
tag_values – The values of the tags associated with the
DHCP options sets. :type tag_values:
list
ofstr
- Parameters
tags – The key/value combination of the tags associated
with the DHCP options sets, in the following format: “Filters”:{“Tags”:[“TAGKEY=TAGVALUE”]}. :type tags:
list
ofstr
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
a
list
of Dhcp Options- Return type
list
ofdict
- ex_list_direct_link_interfaces(direct_link_ids: Optional[list] = None, direct_link_interface_ids: Optional[list] = None, dry_run: bool = False)[source]¶
Lists all DirectLinks in the Region.
- Parameters
direct_link_interface_ids – The IDs of the DirectLink
interfaces. :type direct_link_interface_ids:
list
ofstr
- Parameters
direct_link_ids (
list
ofstr
) – The IDs of the DirectLinks.dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
list
of Direct Link interfaces- Return type
list
ofdict
- ex_list_direct_links(direct_link_ids: Optional[list] = None, dry_run: bool = False)[source]¶
Lists all DirectLinks in the Region.
- Parameters
direct_link_ids (
list
ofstr
) – The IDs of the DirectLinks. (required)dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
list
of Direct Links- Return type
list
ofdict
- ex_list_flexible_gpu_catalog(dry_run: bool = False)[source]¶
Lists all flexible GPUs available in the public catalog.
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
Returns the Flexible Gpu Catalog
- Return type
list
ofdict
- ex_list_flexible_gpus(delete_on_vm_deletion: Optional[bool] = None, flexible_gpu_ids: Optional[list] = None, generations: Optional[list] = None, model_names: Optional[list] = None, states: Optional[list] = None, subregion_names: Optional[list] = None, vm_ids: Optional[list] = None, dry_run: bool = False)[source]¶
Lists one or more flexible GPUs (fGPUs) allocated to your account.
- Parameters
delete_on_vm_deletion – Indicates whether the fGPU is
deleted when terminating the VM. :type delete_on_vm_deletion:
bool
- Parameters
flexible_gpu_ids (
list
ofstr
) – One or more IDs of fGPUs.generations – The processor generations that the fGPUs are
compatible with. (required) :type generations:
list
ofstr
- Parameters
model_names – One or more models of fGPUs. For more
information, see About Flexible GPUs: https://wiki.outscale.net/display/EN/About+Flexible+GPUs :type model_names:
list
ofstr
- Parameters
states – The states of the fGPUs
(allocated | attaching | attached | detaching). :type states:
list
ofstr
- Parameters
subregion_names – The Subregions where the fGPUs are
located. :type subregion_names:
list
ofstr
- Parameters
vm_ids (
list
ofstr
) – One or more IDs of VMs.dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
Returns the Flexible Gpu Catalog
- Return type
list
ofdict
- ex_list_image_export_tasks(dry_run: bool = False, task_ids: Optional[List[str]] = None)[source]¶
Lists one or more image export tasks.
- Parameters
task_ids (
list
ofstr
) – The IDs of the export tasks.dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
image export tasks
- Return type
list
ofdict
- ex_list_internet_services(internet_service_ids: Optional[List[str]] = None, link_net_ids: Optional[List[str]] = None, link_states: Optional[List[str]] = None, tag_keys: Optional[List[str]] = None, tag_values: Optional[List[str]] = None, tags: Optional[List[str]] = None, dry_run: bool = False)[source]¶
Lists one or more of your Internet services. An Internet service enables your virtual machines (VMs) launched in a Net to connect to the Internet. By default, a Net includes an Internet service, and each Subnet is public. Every VM launched within a default Subnet has a private and a public IP addresses.
- Parameters
internet_service_ids (
list
ofstr
) – One or more filters.link_net_ids – The IDs of the Nets the Internet services
are attached to. :type link_net_ids:
list
ofstr
- Parameters
link_states – The current states of the attachments
between the Internet services and the Nets (only available, if the Internet gateway is attached to a VPC). (required) :type link_states:
list
ofstr
- Parameters
tag_keys – The keys of the tags associated with the
Internet services. :type tag_keys:
list
ofstr
- Parameters
tag_values – The values of the tags associated with the
Internet services. :type tag_values:
list
ofstr
- Parameters
tags – The key/value combination of the tags associated
with the Internet services, in the following format: “Filters”:{“Tags”:[“TAGKEY=TAGVALUE”]}. :type tags:
list
ofstr
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
Returns the list of Internet Services
- Return type
list
ofdict
- ex_list_listener_rules(listener_rule_names: Optional[List[str]] = None, dry_run: bool = False)[source]¶
Describes one or more listener rules. By default, this action returns the full list of listener rules for the account.
- Parameters
listener_rule_names (
list
ofstr
) – The names of the listener rules.dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
Returns the list of Listener Rules
- Return type
list
ofdict
- ex_list_load_balancer_tags(load_balancer_names: Optional[List[str]] = None, dry_run: bool = False)[source]¶
Describes the tags associated with one or more specified load balancers.
- Parameters
load_balancer_names – The names of the load balancer.
(required) :type load_balancer_names:
list
ofstr
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
a list of load balancer tags
- Return type
list
ofdict
- ex_list_load_balancers(load_balancer_names: Optional[List[str]] = None, dry_run: bool = False)[source]¶
Lists one or more load balancers and their attributes.
- Parameters
load_balancer_names – The names of the load balancer.
(required) :type load_balancer_names:
list
ofstr
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
a list of load balancer
- Return type
list
ofdict
- ex_list_nat_services(nat_service_ids: Optional[List[str]] = None, net_ids: Optional[List[str]] = None, states: Optional[List[str]] = None, subnet_ids: Optional[List[str]] = None, tag_keys: Optional[List[str]] = None, tag_values: Optional[List[str]] = None, tags: Optional[List[str]] = None, dry_run: bool = False)[source]¶
Lists one or more network address translation (NAT) services.
- Parameters
nat_service_ids (
list
ofstr
) – The IDs of the NAT services.net_ids (
list
ofstr
) – The IDs of the Nets in which the NAT services are.states – The states of the NAT services
(pending | available | deleting | deleted). :type states:
list
ofstr
- Parameters
subnet_ids – The IDs of the Subnets in which the NAT
services are. :type subnet_ids:
list
ofstr
- Parameters
tag_keys – The keys of the tags associated with the NAT
services. :type tag_keys:
list
ofstr
- Parameters
tag_values – The values of the tags associated with the NAT
services. :type tag_values:
list
ofstr
- Parameters
tags – The values of the tags associated with the NAT
services. :type tags:
list
ofstr
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
a list of back end vms health
- Return type
list
ofdict
- ex_list_net_peerings(accepter_net_account_ids: Optional[List[str]] = None, accepter_net_ip_ranges: Optional[List[str]] = None, accepter_net_net_ids: Optional[List[str]] = None, net_peering_ids: Optional[List[str]] = None, source_net_account_ids: Optional[List[str]] = None, source_net_ip_ranges: Optional[List[str]] = None, source_net_net_ids: Optional[List[str]] = None, state_messages: Optional[List[str]] = None, states_names: Optional[List[str]] = None, tag_keys: Optional[List[str]] = None, tag_values: Optional[List[str]] = None, tags: Optional[List[str]] = None, dry_run: bool = False)[source]¶
Lists one or more peering connections between two Nets.
- Parameters
accepter_net_account_ids – The account IDs of the owners of
the peer Nets. :type accepter_net_account_ids:
list
ofstr
- Parameters
accepter_net_ip_ranges – The IP ranges of the peer Nets, in
CIDR notation (for example, 10.0.0.0/24). :type accepter_net_ip_ranges:
list
ofstr
- Parameters
accepter_net_net_ids (
list
ofstr
) – The IDs of the peer Nets.source_net_account_ids – The account IDs of the owners of
the peer Nets. :type source_net_account_ids:
list
ofstr
- Parameters
source_net_ip_ranges (
list
ofstr
) – The IP ranges of the peer Nets.source_net_net_ids (
list
ofstr
) – The IDs of the peer Nets.net_peering_ids (
list
ofstr
) – The IDs of the Net peering connections.state_messages – Additional information about the states of
the Net peering connections. :type state_messages:
list
ofstr
- Parameters
states_names – The states of the Net peering connections
(pending-acceptance | active | rejected | failed | expired | deleted). :type states_names:
list
ofstr
- Parameters
tag_keys – The keys of the tags associated with the Net
peering connections. :type tag_keys:
list
ofstr
- Parameters
tag_values – TThe values of the tags associated with the
Net peering connections. :type tag_values:
list
ofstr
- Parameters
tags – The key/value combination of the tags associated
with the Net peering connections, in the following format: “Filters”:{“Tags”:[“TAGKEY=TAGVALUE”]}. :type tags:
list
ofstr
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
A list of Net Access Points
- Return type
list
ofdict
- ex_list_nets(dhcp_options_set_ids: Optional[List[str]] = None, ip_ranges: Optional[List[str]] = None, is_default: Optional[bool] = None, net_ids: Optional[List[str]] = None, states: Optional[List[str]] = None, tag_keys: Optional[List[str]] = None, tag_values: Optional[List[str]] = None, tags: Optional[List[str]] = None, dry_run: bool = False)[source]¶
Lists one or more Nets.
- Parameters
dhcp_options_set_ids (
list
ofstr
) – The IDs of the DHCP options sets.ip_ranges – The IP ranges for the Nets, in CIDR notation
(for example, 10.0.0.0/16). :type ip_ranges:
list
ofstr
- Parameters
is_default (
bool
) – If true, the Net used is the default one.net_ids (
list
ofstr
) – The IDs of the Nets.states (
list
ofstr
) – The states of the Nets (pending | available).tag_keys (
list
ofstr
) – The keys of the tags associated with the Nets.tag_values – The values of the tags associated with the
Nets. :type tag_values:
list
ofstr
- Parameters
tags – The key/value combination of the tags associated
with the Nets, in the following format: “Filters”:{“Tags”:[“TAGKEY=TAGVALUE”]}. :type tags:
list
ofstr
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
A list of Nets
- Return type
list
ofdict
- ex_list_nets_access_point_services(service_ids: Optional[List[str]] = None, service_names: Optional[List[str]] = None, dry_run: bool = False)[source]¶
Describes 3DS OUTSCALE services available to create Net access points. For more information, see CreateNetAccessPoint: https://docs.outscale.com/api#createnetaccesspoint
- Parameters
service_ids (
list
ofstr
) – The IDs of the services.service_names – The names of the prefix lists, which
identify the 3DS OUTSCALE services they are associated with. :type service_names:
list
ofstr
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
A list of Services
- Return type
list
ofdict
- ex_list_nets_access_points(net_access_point_ids: Optional[List[str]] = None, net_ids: Optional[List[str]] = None, service_names: Optional[List[str]] = None, states: Optional[List[str]] = None, tag_keys: Optional[List[str]] = None, tag_values: Optional[List[str]] = None, tags: Optional[List[str]] = None, dry_run: bool = False)[source]¶
Describes one or more Net access points.
- Parameters
net_access_point_ids (
list
ofstr
) – The IDs of the Net access points.net_ids (
list
ofstr
) – The IDs of the Nets.service_names – The The names of the prefix lists
corresponding to the services. For more information, see DescribePrefixLists: https://docs.outscale.com/api#describeprefixlists :type service_names:
list
ofstr
- Parameters
states – The states of the Net access points
(pending | available | deleting | deleted). :type states:
list
ofstr
- Parameters
tag_keys – The keys of the tags associated with the Net
access points. :type tag_keys:
list
ofstr
- Parameters
tag_values – The values of the tags associated with the
Net access points. :type tag_values:
list
ofstr
- Parameters
tags – The key/value combination of the tags associated
with the Net access points, in the following format: “Filters”:{“Tags”:[“TAGKEY=TAGVALUE”]}. :type tags:
list
ofstr
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
A list of Net Access Points
- Return type
list
ofdict
- ex_list_nics(link_nic_sort_numbers: Optional[List[int]] = None, link_nic_vm_ids: Optional[List[str]] = None, nic_ids: Optional[List[str]] = None, private_ips_private_ips: Optional[List[str]] = None, subnet_ids: Optional[List[str]] = None, dry_run: bool = False)[source]¶
Lists one or more network interface cards (NICs). A NIC is a virtual network interface that you can attach to a virtual machine (VM) in a Net.
- Parameters
link_nic_sort_numbers – The device numbers the NICs are
attached to. :type link_nic_sort_numbers:
list
ofint
- Parameters
link_nic_vm_ids – The IDs of the VMs the NICs are attached
to. :type link_nic_vm_ids:
list
ofstr
- Parameters
nic_ids (
list
ofstr
) – The IDs of the NICs.private_ips_private_ips – The private IP addresses of the
NICs. :type private_ips_private_ips:
list
ofstr
- Parameters
subnet_ids (
list
ofstr
) – The IDs of the Subnets for the NICs.dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
A list of the Nics
- Return type
list
ofdict
- ex_list_node_types(bsu_optimized: Optional[bool] = None, memory_sizes: Optional[List[int]] = None, vcore_counts: Optional[List[int]] = None, vm_type_names: Optional[List[str]] = None, volume_counts: Optional[List[int]] = None, volume_sizes: Optional[List[int]] = None, dry_run: bool = False)[source]¶
Lists one or more predefined VM types.
- Parameters
bsu_optimized – Indicates whether the VM is optimized for
BSU I/O. :type bsu_optimized:
bool
- Parameters
memory_sizes (
list
ofint
) – The amounts of memory, in gibibytes (GiB).vcore_counts (
list
ofint
) – The numbers of vCores.vm_type_names – The names of the VM types. For more
information, see Instance Types. :type vm_type_names:
list
ofstr
- Parameters
volume_counts – The maximum number of ephemeral storage
disks. :type volume_counts:
list
ofint
- Parameters
volume_sizes – The size of one ephemeral storage disk,
in gibibytes (GiB). :type volume_sizes:
list
ofint
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
list of vm types
- Return type
list
ofdict
- ex_list_nodes_states(all_vms: Optional[bool] = None, subregion_names: Optional[List[str]] = None, vm_ids: Optional[List[str]] = None, vm_states: Optional[List[str]] = None, dry_run: bool = False)[source]¶
Lists the status of one or more virtual machines (VMs).
- Parameters
all_vms – If true, includes the status of all VMs. By
default or if set to false, only includes the status of running VMs. :type all_vms:
bool
- Parameters
subregion_names (
list
ofstr
) – The names of the Subregions of the VMs.vm_ids (
list
ofstr
) – One or more IDs of VMs.vm_states – The states of the VMs
(pending | running | stopping | stopped | shutting-down | terminated | quarantine) :type vm_states:
list
ofstr
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
list the status of one ore more vms
- Return type
list
ofdict
- ex_list_product_types(product_type_ids: Optional[List[str]] = None, dry_run: bool = False)[source]¶
Describes one or more product types.
- Parameters
product_type_ids (
list
ofstr
) – The IDs of the product types.dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
A
list
of Product Type- Return type
list
ofdict
- ex_list_public_ip_ranges(dry_run: bool = False)[source]¶
Lists available regions details.
- Parameters
dry_run – If true, checks whether you have the
required permissions to perform the action. :type dry_run:
bool
- Returns
regions details
- Return type
dict
- ex_list_public_ips(data: str = '{}')[source]¶
List all public IPs.
- Parameters
data – json stringify following the outscale api
documentation for filter :type data:
string
- Returns
nodes
- Return type
dict
- ex_list_quotas(collections: Optional[List[str]] = None, quota_names: Optional[List[str]] = None, quota_types: Optional[List[str]] = None, short_descriptions: Optional[List[str]] = None, dry_run: bool = False)[source]¶
Describes one or more of your quotas.
- Parameters
collections (
list
ofstr
) – The group names of the quotas.quota_names (
list
ofstr
) – The names of the quotas.quota_types – The resource IDs if these are
resource-specific quotas, global if they are not. :type quota_types:
list
ofstr
- Parameters
short_descriptions (
list
ofstr
) – The description of the quotas.dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
A
list
of Product Type- Return type
list
ofdict
- ex_list_regions(ex_dry_run: bool = False)[source]¶
Lists available regions details.
- Parameters
ex_dry_run – If true, checks whether you have the required
permissions to perform the action. :type ex_dry_run:
bool
:return: regions details :rtype:dict
- ex_list_route_tables(link_route_table_ids: Optional[List[str]] = None, link_route_table_link_route_table_ids: Optional[List[str]] = None, link_route_table_main: Optional[bool] = None, link_subnet_ids: Optional[List[str]] = None, net_ids: Optional[List[str]] = None, route_creation_methods: Optional[List[str]] = None, route_destination_ip_ranges: Optional[List[str]] = None, route_destination_service_ids: Optional[List[str]] = None, route_gateway_ids: Optional[List[str]] = None, route_nat_service_ids: Optional[List[str]] = None, route_net_peering_ids: Optional[List[str]] = None, route_states: Optional[List[str]] = None, route_table_ids: Optional[List[str]] = None, route_vm_ids: Optional[List[str]] = None, tag_keys: Optional[List[str]] = None, tag_values: Optional[List[str]] = None, tags: Optional[List[str]] = None, dry_run: bool = False)[source]¶
Lists one or more of your route tables. In your Net, each Subnet must be associated with a route table. If a Subnet is not explicitly associated with a route table, it is implicitly associated with the main route table of the Net.
- Parameters
link_route_table_ids – The IDs of the route tables involved
in the associations. :type link_route_table_ids:
list
ofstr
- Parameters
link_route_table_link_route_table_ids – The IDs of the
associations between the route tables and the Subnets. :type link_route_table_link_route_table_ids:
list
ofstr
- Parameters
link_route_table_main – If true, the route tables are the
main ones for their Nets. :type link_route_table_main:
bool
- Parameters
link_subnet_ids – The IDs of the Subnets involved in the
associations. :type link_subnet_ids:
list
ofstr
- Parameters
net_ids – The IDs of the route tables involved
in the associations. :type net_ids:
list
ofstr
- Parameters
route_creation_methods (
list
ofstr
) – The methods used to create a route.route_destination_ip_ranges – The IP ranges specified in
routes in the tables. :type route_destination_ip_ranges:
list
ofstr
- Parameters
route_destination_service_ids – The service IDs specified
in routes in the tables. :type route_destination_service_ids:
list
ofstr
- Parameters
route_gateway_ids – The IDs of the gateways specified in
routes in the tables. :type route_gateway_ids:
list
ofstr
- Parameters
route_nat_service_ids – The IDs of the NAT services
specified in routes in the tables. :type route_nat_service_ids:
list
ofstr
- Parameters
route_net_peering_ids – The IDs of the Net peering
connections specified in routes in the tables. :type route_net_peering_ids:
list
ofstr
- Parameters
route_states – The states of routes in the route tables
(active | blackhole). The blackhole state indicates that the target of the route is not available. :type route_states:
list
ofstr
- Parameters
route_table_ids (
list
ofstr
) – The IDs of the route tables.route_vm_ids – The IDs of the VMs specified in routes in
the tables. :type route_vm_ids:
list
ofstr
- Parameters
tag_keys – The keys of the tags associated with the route
tables. :type tag_keys:
list
ofstr
- Parameters
tag_values – The values of the tags associated with the
route tables. :type tag_values:
list
ofstr
- Parameters
tags – The key/value combination of the tags associated
with the route tables, in the following format: “Filters”:{“Tags”:[“TAGKEY=TAGVALUE”]}. :type tags:
list
ofstr
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
list of Route Tables
- Return type
list
ofdict
- ex_list_secret_access_key(access_key_id: Optional[str] = None, dry_run: bool = False)[source]¶
Gets information about the secret access key associated with the account that sends the request.
- Parameters
access_key_id (
str
) – The ID of the access key. (required)dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
Access Key
- Return type
dict
- ex_list_security_groups(account_ids: Optional[List[str]] = None, net_ids: Optional[List[str]] = None, security_group_ids: Optional[List[str]] = None, security_group_names: Optional[List[str]] = None, tag_keys: Optional[List[str]] = None, tag_values: Optional[List[str]] = None, tags: Optional[List[str]] = None, dry_run: bool = False)[source]¶
Lists one or more security groups. You can specify either the name of the security groups or their IDs.
- Parameters
account_ids – The account IDs of the owners of the security
groups. :type account_ids:
list
ofstr
- Parameters
net_ids – The IDs of the Nets specified when the security
groups were created. :type net_ids:
list
ofstr
- Parameters
security_group_ids (
list
ofstr
) – The IDs of the security groups.security_group_names (
list
ofstr
) – The names of the security groups.tag_keys – TThe keys of the tags associated with the
security groups. :type tag_keys:
list
ofstr
- Parameters
tag_values – The values of the tags associated with the
security groups. :type tag_values:
list
ofstr
- Parameters
tags – TThe key/value combination of the tags associated
with the security groups, in the following format: “Filters”:{“Tags”:[“TAGKEY=TAGVALUE”]}. :type tags:
list
ofstr
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
a list of Security Groups
- Return type
list
ofdict
- ex_list_server_certificates(paths: Optional[str] = None, dry_run: bool = False)[source]¶
List your server certificates.
- Parameters
paths (
str
) – The path to the server certificate.dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
server certificate
- Return type
list
ofdict
- ex_list_snapshot_export_tasks(dry_run: bool = False, task_ids: Optional[List[str]] = None)[source]¶
Lists one or more image export tasks.
- Parameters
task_ids (
list
ofstr
) – The IDs of the export tasks.dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
snapshot export tasks
- Return type
list
ofdict
- ex_list_subnets(available_ip_counts: Optional[List[str]] = None, ip_ranges: Optional[List[str]] = None, net_ids: Optional[List[str]] = None, states: Optional[List[str]] = None, subnet_ids: Optional[List[str]] = None, subregion_names: Optional[List[str]] = None, tag_keys: Optional[List[str]] = None, tag_values: Optional[List[str]] = None, tags: Optional[List[str]] = None, dry_run: bool = False)[source]¶
Lists one or more of your Subnets. If you do not specify any Subnet ID, this action describes all of your Subnets.
- Parameters
available_ip_counts (
str
) – The number of available IPs.ip_ranges – The IP ranges in the Subnets, in CIDR notation
(for example, 10.0.0.0/16). :type ip_ranges:
str
- Parameters
net_ids (
str
) – The IDs of the Nets in which the Subnets are.states (
str
) – The states of the Subnets (pending | available).subnet_ids (
str
) – The IDs of the Subnets.subregion_names – The names of the Subregions in which the
Subnets are located. :type subregion_names:
str
- Parameters
tag_keys – TThe keys of the tags associated with the
subnets. :type tag_keys:
list
ofstr
- Parameters
tag_values – The values of the tags associated with the
subnets. :type tag_values:
list
ofstr
- Parameters
tags – TThe key/value combination of the tags associated
with the subnets, in the following format: “Filters”:{“Tags”:[“TAGKEY=TAGVALUE”]}. :type tags:
list
ofstr
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
a list of Subnets
- Return type
list
ofdict
- ex_list_subregions(ex_dry_run: bool = False)[source]¶
Lists available subregions details.
- Parameters
ex_dry_run – If true, checks whether you have the required
permissions to perform the action. :type ex_dry_run:
bool
:return: subregions details :rtype:dict
- ex_list_tags(resource_ids: Optional[list] = None, resource_types: Optional[list] = None, keys: Optional[list] = None, values: Optional[list] = None, dry_run: bool = False)[source]¶
Lists one or more tags for your resources.
- Parameters
resource_ids (
list
) – One or more resource IDs.resource_types (
list
) – One or more resource IDs.keys (
list
) – One or more resource IDs.values (
list
) – One or more resource IDs.dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
list of tags
- Return type
list
ofdict
- ex_list_virtual_gateways(connection_types: Optional[List[str]] = None, link_net_ids: Optional[List[str]] = None, link_states: Optional[List[str]] = None, states: Optional[List[str]] = None, tag_keys: Optional[List[str]] = None, tag_values: Optional[List[str]] = None, tags: Optional[List[str]] = None, virtual_gateway_id: Optional[List[str]] = None, dry_run: bool = False)[source]¶
Lists one or more virtual gateways.
- Parameters
connection_types – The types of the virtual gateways
(only ipsec.1 is supported). :type connection_types:
list
ofdict
- Parameters
link_net_ids – The IDs of the Nets the virtual gateways
are attached to. :type link_net_ids:
list
ofdict
- Parameters
link_states – The current states of the attachments
between the virtual gateways and the Nets (attaching | attached | detaching | detached). :type link_states:
list
ofdict
- Parameters
states – The states of the virtual gateways
(pending | available | deleting | deleted). :type states:
list
ofdict
- Parameters
tag_keys – The keys of the tags associated with the
virtual gateways. :type tag_keys:
list
ofdict
- Parameters
tag_values – The values of the tags associated with
the virtual gateways. :type tag_values:
list
ofdict
- Parameters
tags – The key/value combination of the tags associated
with the virtual gateways, in the following format: “Filters”:{“Tags”:[“TAGKEY=TAGVALUE”]}. :type tags:
list
ofdict
- Parameters
virtual_gateway_id (
list
ofdict
) – The IDs of the virtual gateways.dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
list of virtual gateway
- Return type
list
ofdict
- ex_list_vms_health(backend_vm_ids: Optional[List[str]] = None, load_balancer_name: Optional[str] = None, dry_run: bool = False)[source]¶
Lists the state of one or more back-end virtual machines (VMs) registered with a specified load balancer.
- Parameters
load_balancer_name – The name of the load balancer.
(required) :type load_balancer_name:
str
- Parameters
backend_vm_ids (
list
ofstr
) – One or more IDs of back-end VMs.dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
a list of back end vms health
- Return type
list
ofdict
- ex_list_vpn_connections(bgp_asns: Optional[List[int]] = None, client_gateway_ids: Optional[List[str]] = None, connection_types: Optional[List[str]] = None, route_destination_ip_ranges: Optional[List[str]] = None, states: Optional[List[str]] = None, static_routes_only: Optional[bool] = None, tag_keys: Optional[List[str]] = None, tag_values: Optional[List[str]] = None, tags: Optional[List[str]] = None, dry_run: bool = False)[source]¶
Describes one or more VPN connections.
- Parameters
bgp_asns – The Border Gateway Protocol (BGP) Autonomous
System Numbers (ASNs) of the connections. :type bgp_asns:
list
ofint
- Parameters
client_gateway_ids (
list
ofstr
) – The IDs of the client gateways.connection_types – The types of the VPN connections (only
ipsec.1 is supported). :type connection_types:
list
ofstr
- Parameters
states – The states of the vpn connections
(pending | available). :type states:
str
- Parameters
route_destination_ip_ranges (
str
) – The destination IP ranges.static_routes_only – If false, the VPN connection uses
dynamic routing with Border Gateway Protocol (BGP). If true, routing is controlled using static routes. For more information about how to create and delete static routes, see CreateVpnConnectionRoute: https://docs.outscale.com/api#createvpnconnectionroute and DeleteVpnConnectionRoute: https://docs.outscale.com/api#deletevpnconnectionroute :type static_routes_only:
bool
- Parameters
tag_keys – TThe keys of the tags associated with the
subnets. :type tag_keys:
list
ofstr
- Parameters
tag_values – The values of the tags associated with the
subnets. :type tag_values:
list
ofstr
- Parameters
tags – TThe key/value combination of the tags associated
with the subnets, in the following format: “Filters”:{“Tags”:[“TAGKEY=TAGVALUE”]}. :type tags:
list
ofstr
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
a list of Subnets
- Return type
list
ofdict
- ex_read_account(dry_run: bool = False)[source]¶
Gets information about the account that sent the request.
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
the account information
- Return type
dict
- ex_read_admin_password_node(node: libcloud.compute.base.Node, dry_run: bool = False)[source]¶
Retrieves the administrator password for a Windows running virtual machine (VM). The administrator password is encrypted using the keypair you specified when launching the VM.
- Parameters
node (
Node
) – the ID of the VM (required)dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
The Admin Password of the specified Node.
- Return type
str
- ex_read_api_access_rules(api_access_rules_ids: Optional[List[str]] = None, ca_ids: Optional[List[str]] = None, cns: Optional[List[str]] = None, descriptions: Optional[List[str]] = None, ip_ranges: Optional[List[str]] = None, dry_run: bool = False)[source]¶
Read API access rules.
- Parameters
api_access_rules_ids – The List containing rules ids to
filter the request. :type api_access_rules_ids:
List
ofstr
- Parameters
ca_ids (
List
ofstr
) – The List containing CA ids to filter the request.cns (
List
ofstr
) – The List containing cns to filter the request.descriptions – The List containing descriptions to filter
the request. :type descriptions:
List
ofstr
- Parameters
ip_ranges – The List containing ip ranges in CIDR notation
(for example, 192.0.2.0/16) to filter the request. :type ip_ranges:
List
ofstr
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
a List of API access rules.
- Return type
List
ofdict
if successfull ordict
- ex_read_certificate_authorities(ca_fingerprints: Optional[List[str]] = None, ca_ids: Optional[List[str]] = None, descriptions: Optional[List[str]] = None, dry_run: bool = False)[source]¶
Returns information about one or more of your Client Certificate Authorities (CAs).
- Parameters
ca_fingerprints (
list
ofstr
) – The fingerprints of the CAs.ca_ids (
list
ofstr
) – The IDs of the CAs.descriptions (
list
ofstr
) – The descriptions of the CAs.dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
a list of all Ca matching filled filters.
- Return type
list
ofdict
- ex_read_console_output_node(node: libcloud.compute.base.Node, dry_run: bool = False)[source]¶
Gets the console output for a virtual machine (VM). This console provides the most recent 64 KiB output.
- Parameters
node (
Node
) – the ID of the VM (required)dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
The Console Output of the specified Node.
- Return type
str
- ex_register_vms_in_load_balancer(backend_vm_ids: Optional[List[str]] = None, load_balancer_name: Optional[str] = None, dry_run: bool = False)[source]¶
Registers one or more virtual machines (VMs) with a specified load balancer. The VMs must be running in the same network as the load balancer (in the public Cloud or in the same Net). It may take a little time for a VM to be registered with the load balancer. Once the VM is registered with a load balancer, it receives traffic and requests from this load balancer and is called a back-end VM.
- Parameters
load_balancer_name – The name of the load balancer.
(required) :type load_balancer_name:
str
- Parameters
backend_vm_ids (
list
ofstr
) – One or more IDs of back-end VMs.dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
a list of back end vms health
- Return type
list
ofdict
- ex_reject_net_peering(net_peering_id: Optional[List[str]] = None, dry_run: bool = False)[source]¶
Rejects a Net peering connection request. The Net peering connection must be in the pending-acceptance state to be rejected. The rejected Net peering connection is then in the rejected state.
- Parameters
net_peering_id – The ID of the Net peering connection you
want to reject. (required) :type net_peering_id:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
The rejected Net Peering
- Return type
dict
- ex_reset_account_password(password: str = '', token: str = '', dry_run: bool = False)[source]¶
Sends an email to the email address provided for the account with a token to reset your password.
- Parameters
password (
str
) – The new password for the account.token – The token you received at the email address
provided for the account. :type token:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_send_reset_password_email(email: str, dry_run: bool = False)[source]¶
Replaces the account password with the new one you provide. You must also provide the token you received by email when asking for a password reset using the SendResetPasswordEmail method.
- Parameters
email (
str
) – The email address provided for the account.dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_unlink_flexible_gpu(flexible_gpu_id: Optional[str] = None, dry_run: bool = False)[source]¶
Detaches a flexible GPU (fGPU) from a virtual machine (VM). The fGPU is in the detaching state until the VM is stopped, after which it becomes available for allocation again.
- Parameters
flexible_gpu_id – The ID of the fGPU you want to attach.
(required) :type flexible_gpu_id:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_unlink_internet_service(internet_service_id: Optional[str] = None, net_id: Optional[str] = None, dry_run: bool = False)[source]¶
Detaches an Internet service from a Net. This action disables and detaches an Internet service from a Net. The Net must not contain any running virtual machine (VM) using an External IP address (EIP).
- Parameters
internet_service_id – The ID of the Internet service you
want to detach. (required) :type internet_service_id:
str
- Parameters
net_id – The ID of the Net from which you want to detach
the Internet service. (required) :type net_id:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_unlink_nic(link_nic_id: Optional[str] = None, dry_run: bool = False)[source]¶
Detaches a network interface card (NIC) from a virtual machine (VM). The primary NIC cannot be detached.
- Parameters
link_nic_id – The ID of the NIC you want to delete.
(required) :type link_nic_id:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_unlink_private_ips(nic_id: Optional[str] = None, private_ips: Optional[List[str]] = None, dry_run: bool = False)[source]¶
Unassigns one or more secondary private IPs from a network interface card (NIC).
- Parameters
nic_id (
str
) – The ID of the NIC. (required)private_ips – One or more secondary private IP addresses
you want to unassign from the NIC. (required) :type private_ips:
list
ofstr
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_unlink_route_table(link_route_table_id: Optional[str] = None, dry_run: bool = False)[source]¶
Disassociates a Subnet from a route table. After disassociation, the Subnet can no longer use the routes in this route table, but uses the routes in the main route table of the Net instead.
- Parameters
link_route_table_id (
str
) – The ID of the route table. (required)dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_unlink_virtual_gateway(net_id: Optional[str] = None, virtual_gateway_id: Optional[str] = None, dry_run: bool = False)[source]¶
Detaches a virtual gateway from a Net. You must wait until the virtual gateway is in the detached state before you can attach another Net to it or delete the Net it was previously attached to.
- Parameters
net_id – The ID of the Net from which you want to detach
the virtual gateway. (required) :type net_id:
str
- Parameters
virtual_gateway_id – The ID of the Net from which you
want to detach the virtual gateway. (required) :type virtual_gateway_id:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
True if the action is successful
- Return type
bool
- ex_update_access_key(access_key_id: Optional[str] = None, state: Optional[str] = None, dry_run: bool = False)[source]¶
Modifies the status of the specified access key associated with the account that sends the request. When set to ACTIVE, the access key is enabled and can be used to send requests. When set to INACTIVE, the access key is disabled.
- Parameters
access_key_id (
str
) – The ID of the access key. (required)state – The new state of the access key
(ACTIVE | INACTIVE). (required) :type state:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
Access Key
- Return type
dict
- ex_update_account(city: Optional[str] = None, company_name: Optional[str] = None, country: Optional[str] = None, email: Optional[str] = None, first_name: Optional[str] = None, last_name: Optional[str] = None, zip_code: Optional[str] = None, job_title: Optional[str] = None, mobile_number: Optional[str] = None, phone_number: Optional[str] = None, state_province: Optional[str] = None, vat_number: Optional[str] = None, dry_run: bool = False)[source]¶
Updates the account information for the account that sends the request.
- Parameters
city (
str
) – The city of the account owner.company_name – The name of the company for the account.
permissions to perform the action. :type company_name:
str
- Parameters
country (
str
) – The country of the account owner.email (
str
) – The email address for the account.first_name (
str
) – The first name of the account owner.last_name (
str
) – The last name of the account owner.zip_code (
str
) – The ZIP code of the city.job_title (
str
) – The job title of the account owner.mobile_number – The mobile phone number of the account
owner. :type mobile_number:
str
- Parameters
phone_number – The landline phone number of the account
owner. :type phone_number:
str
- Parameters
state_province (
str
) – The state/province of the account.vat_number – The value added tax (VAT) number for
the account. :type vat_number:
str
- Parameters
dry_run (
bool
) – the password of the account- Returns
The new account information
- Return type
dict
- ex_update_api_access_rule(api_access_rule_id: str, ca_ids: Optional[List[str]] = None, cns: Optional[List[str]] = None, description: Optional[str] = None, ip_ranges: Optional[List[str]] = None, dry_run: bool = False)[source]¶
Update an API access rules. The new rule you specify fully replaces the old rule. Therefore, for a parameter that is not specified, any previously set value is deleted.
- Parameters
api_access_rule_id – The id of the rule we want to update
(required). :type api_access_rule_id:
str
- Parameters
ca_ids – One or more IDs of Client Certificate Authorities
(CAs). :type ca_ids:
List
ofstr
- Parameters
cns – One or more Client Certificate Common Names (CNs).
If this parameter is specified, you must also specify the ca_ids parameter. :type cns:
List
ofstr
- Parameters
description (
str
) – The description of the new rule.ip_ranges – One or more IP ranges, in CIDR notation
(for example, 192.0.2.0/16). :type ip_ranges:
List
ofstr
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
a List of API access rules.
- Return type
List
ofdict
if successfull ordict
- ex_update_certificate_authority(ca_id: str, description: Optional[str] = None, dry_run: bool = False)[source]¶
Modifies the specified attribute of a Client Certificate Authority (CA).
- Parameters
ca_id (
str
) – The ID of the CA. (required)description (
str
) – The description of the CA.dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
a the created Ca or the request result.
- Return type
dict
- ex_update_flexible_gpu(delete_on_vm_deletion: Optional[bool] = None, flexible_gpu_id: Optional[str] = None, dry_run: bool = False)[source]¶
Modifies a flexible GPU (fGPU) behavior.
- Parameters
delete_on_vm_deletion – If true, the fGPU is deleted when
the VM is terminated. :type delete_on_vm_deletion:
bool
- Parameters
flexible_gpu_id (
str
) – The ID of the fGPU you want to modify.dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
the updated Flexible GPU
- Return type
dict
- ex_update_image(dry_run: bool = False, image: Optional[libcloud.compute.base.NodeImage] = None, perm_to_launch_addition_account_ids: Optional[List[str]] = None, perm_to_launch_addition_global_permission: Optional[bool] = None, perm_to_launch_removals_account_ids: Optional[List[str]] = None, perm_to_launch_removals_global_permission: Optional[bool] = None)[source]¶
Modifies the specified attribute of an Outscale machine image (OMI). You can specify only one attribute at a time. You can modify the permissions to access the OMI by adding or removing account IDs or groups. You can share an OMI with a user that is in the same Region. The user can create a copy of the OMI you shared, obtaining all the rights for the copy of the OMI. For more information, see CreateImage.
- Parameters
image (
NodeImage
) – The ID of the OMI to export. (required)perm_to_launch_addition_account_ids – The account
ID of one or more users who have permissions for the resource. :type perm_to_launch_addition_account_ids:
list
ofdict
- Parameters
perm_to_launch_addition_global_permission –
If true, the resource is public. If false, the resource is private. :type perm_to_launch_addition_global_permission:
boolean
- Parameters
perm_to_launch_removals_account_ids – The account
ID of one or more users who have permissions for the resource. :type perm_to_launch_removals_account_ids:
list
ofdict
- Parameters
perm_to_launch_removals_global_permission – If true,
the resource is public. If false, the resource is private. :type perm_to_launch_removals_global_permission:
boolean
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
the new image
- Return type
dict
- ex_update_listener_rule(host_pattern: Optional[str] = None, listener_rule_name: Optional[str] = None, path_pattern: Optional[str] = None, dry_run: bool = False)[source]¶
Updates the pattern of the listener rule. This call updates the pattern matching algorithm for incoming traffic.
- Parameters
host_pattern – TA host-name pattern for the rule, with a
maximum length of 128 characters. This host-name pattern supports maximum three wildcards, and must not contain any special characters except [-.?]. :type host_pattern: ``str`
- Parameters
listener_rule_name – The name of the listener rule.
(required) :type listener_rule_name:
str
- Parameters
path_pattern – A path pattern for the rule, with a maximum
length of 128 characters. This path pattern supports maximum three wildcards, and must not contain any special characters except [_-.$/~”’@:+?]. :type path_pattern:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
Update the specified Listener Rule
- Return type
dict
- ex_update_load_balancer(access_log_is_enabled: Optional[bool] = None, access_log_osu_bucket_name: Optional[str] = None, access_log_osu_bucket_prefix: Optional[str] = None, access_log_publication_interval: Optional[int] = None, health_check_interval: Optional[int] = None, health_check_healthy_threshold: Optional[int] = None, health_check_path: Optional[str] = None, health_check_port: Optional[int] = None, health_check_protocol: Optional[str] = None, health_check_timeout: Optional[int] = None, health_check_unhealthy_threshold: Optional[int] = None, load_balancer_name: Optional[str] = None, load_balancer_port: Optional[int] = None, policy_names: Optional[List[str]] = None, server_certificate_id: Optional[str] = None, dry_run: bool = False)[source]¶
Modifies the specified attributes of a load balancer.
You can set a new SSL certificate to an SSL or HTTPS listener of a load balancer. This certificate replaces any certificate used on the same load balancer and port.
You can also replace the current set of policies for a load balancer with another specified one. If the PolicyNames parameter is empty, all current policies are disabled.
- Parameters
access_log_is_enabled – If true, access logs are enabled
for your load balancer. If false, they are not. If you set this to true in your request, the OsuBucketName parameter is required. :type access_log_is_enabled: ``bool`
- Parameters
access_log_osu_bucket_name – The name of the Object Storage
Unit (OSU) bucket for the access logs. :type access_log_osu_bucket_name:
str
- Parameters
access_log_osu_bucket_prefix – The path to the folder of
the access logs in your Object Storage Unit (OSU) bucket (by default, the root level of your bucket). :type access_log_osu_bucket_prefix:
str
- Parameters
access_log_publication_interval – The time interval for the
publication of access logs in the Object Storage Unit (OSU) bucket, in minutes. This value can be either 5 or 60 (by default, 60). :type access_log_publication_interval:
int
- Parameters
health_check_interval – Information about the health check
configuration. (required) :type health_check_interval:
int
- Parameters
health_check_path – The path for HTTP or HTTPS requests.
(required) :type health_check_path:
str
- Parameters
health_check_port – The port number (between 1 and 65535,
both included). (required) :type health_check_port:
int
- Parameters
health_check_protocol – The protocol for the URL of the VM
(HTTP | HTTPS | TCP | SSL | UDP). (required) :type health_check_protocol:
str
- Parameters
health_check_timeout – The maximum waiting time for a
response before considering the VM as unhealthy, in seconds (between 2 and 60 both included). (required) :type health_check_timeout:
int
- Parameters
health_check_healthy_threshold – The number of consecutive
failed pings before considering the VM as unhealthy (between 2 and 10 both included). (required) :type health_check_healthy_threshold:
int
- Parameters
health_check_unhealthy_threshold – The number of
consecutive failed pings before considering the VM as unhealthy (between 2 and 10 both included).(required) :type health_check_unhealthy_threshold:
int
- Parameters
load_balancer_name – The name of the load balancer.
(required) :type load_balancer_name:
str
- Parameters
load_balancer_port – The port on which the load balancer is
listening (between 1 and 65535, both included). :type load_balancer_port:
int
- Parameters
policy_names – The list of policy names (must contain all
the policies to be enabled). :type policy_names:
list
ofstr
- Parameters
server_certificate_id – The list of policy names (must
contain all the policies to be enabled). :type server_certificate_id:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
Update the specified Load Balancer
- Return type
dict
- ex_update_net(net_id: Optional[str] = None, dhcp_options_set_id: Optional[str] = None, dry_run: bool = False)[source]¶
Associates a DHCP options set with a specified Net.
- Parameters
net_id (
str
) – The ID of the Net. (required)dhcp_options_set_id – The ID of the DHCP options set
(or default if you want to associate the default one). (required) :type dhcp_options_set_id:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
The modified Nat Service
- Return type
dict
- ex_update_net_access_point(add_route_table_ids: Optional[List[str]] = None, net_access_point_id: Optional[str] = None, remove_route_table_ids: Optional[List[str]] = None, dry_run: bool = False)[source]¶
Modifies the attributes of a Net access point. This action enables you to add or remove route tables associated with the specified Net access point.
- Parameters
add_route_table_ids – One or more IDs of route tables to
associate with the specified Net access point. :type add_route_table_ids:
list
ofstr
- Parameters
net_access_point_id – The ID of the Net access point.
(required) :type net_access_point_id:
str
- Parameters
remove_route_table_ids – One or more IDs of route tables to
disassociate from the specified Net access point. :type remove_route_table_ids:
list
ofstr
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
The modified Net Access Point
- Return type
dict
- ex_update_nic(description: Optional[str] = None, link_nic_delete_on_vm_deletion: Optional[str] = None, link_nic_id: Optional[str] = None, security_group_ids: Optional[List[str]] = None, nic_id: Optional[str] = None, dry_run: bool = False)[source]¶
Modifies the specified network interface card (NIC). You can specify only one attribute at a time.
- Parameters
description (
str
) – A new description for the NIC.link_nic_delete_on_vm_deletion – If true, the NIC is
deleted when the VM is terminated. :type link_nic_delete_on_vm_deletion:
str
- Parameters
link_nic_id (
str
) – The ID of the NIC attachment.security_group_ids – One or more IDs of security groups
for the NIC. :type security_group_ids:
list
ofstr
- Parameters
nic_id (
list
ofstr
) – The ID of the NIC you want to modify. (required)dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
The new Nic
- Return type
dict
- ex_update_node(block_device_mapping: List[dict], bsu_optimized: Optional[bool] = None, deletion_protection: bool = False, is_source_dest_checked: Optional[bool] = None, keypair_name: str = True, performance: str = True, security_group_ids: Optional[List[str]] = None, user_data: str = False, vm_id: Optional[str] = None, vm_initiated_shutown_behavior: Optional[str] = None, vm_type: Optional[int] = None, dry_run: bool = False)[source]¶
Modifies a specific attribute of a Node (VM). You can modify only one attribute at a time. You can modify the IsSourceDestChecked attribute only if the VM is in a Net. You must stop the VM before modifying the following attributes:
VmType
UserData
BsuOptimized
- Parameters
block_device_mapping – One or more block device mappings
of the VM. :type block_device_mapping:
dict
- Parameters
bsu_optimized (
bool
) – If true, the VM is optimized for BSU I/O.dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Parameters
deletion_protection – If true, you cannot terminate the VM
using Cockpit, the CLI or the API. If false, you can. :type deletion_protection:
bool
- Parameters
is_source_dest_checked – (Net only) If true, the
source/destination check is enabled. If false, it is disabled. This value must be false for a NAT VM to perform network address translation (NAT) in a Net. :type is_source_dest_checked:
bool
- Parameters
keypair_name (
str
) – The name of the keypair.performance – The performance of the VM
(standard | high | highest). :type performance:
str
- Parameters
security_group_ids – One or more IDs of security groups for
the VM. :type security_group_ids:
bool
- Parameters
user_data (
str
) – The Base64-encoded MIME user data.vm_id (
str
) – The ID of the VM. (required)vm_initiated_shutown_behavior – The VM behavior when you
stop it. By default or if set to stop, the VM stops. If set to restart, the VM stops then automatically restarts. If set to terminate, the VM stops and is terminated. :type vm_initiated_shutown_behavior:
str
- Parameters
vm_type – The type of VM. For more information,
see Instance Types: https://wiki.outscale.net/display/EN/Instance+Types :type vm_type:
str
- Returns
the updated Node
- Return type
dict
- ex_update_route(destination_ip_range: Optional[str] = None, gateway_id: Optional[str] = None, nat_service_id: Optional[str] = None, net_peering_id: Optional[str] = None, nic_id: Optional[str] = None, route_table_id: Optional[str] = None, vm_id: Optional[str] = None, dry_run: bool = False)[source]¶
Replaces an existing route within a route table in a Net. You must specify one of the following elements as the target:
Net peering connection
NAT virtual machine (VM)
Internet service
Virtual gateway
NAT service
Network interface card (NIC)
The routing algorithm is based on the most specific match.
- Parameters
destination_ip_range – The IP range used for the
destination match, in CIDR notation (for example, 10.0.0.0/24). (required) :type destination_ip_range:
str
- Parameters
gateway_id – The ID of an Internet service or virtual
gateway attached to your Net. :type gateway_id:
str
- Parameters
nat_service_id (
str
) – The ID of a NAT service.net_peering_id (
str
) – The ID of a Net peering connection.nic_id (
str
) – The ID of a NIC.vm_id – The ID of a NAT VM in your Net (attached to exactly
one NIC). :type vm_id:
str
- Parameters
route_table_id – The ID of the route table for which you
want to create a route. (required) :type route_table_id: str`
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
The updated Route
- Return type
dict
- ex_update_route_propagation(enable: Optional[bool] = None, route_table_id: Optional[str] = None, virtual_gateway_id: Optional[str] = None, dry_run: bool = False)[source]¶
Configures the propagation of routes to a specified route table of a Net by a virtual gateway.
- Parameters
enable – If true, a virtual gateway can propagate routes
to a specified route table of a Net. If false, the propagation is disabled. (required) :type enable:
boolean
- Parameters
route_table_id (
str
) – The ID of the route table. (required)virtual_gateway_id – The ID of the virtual
gateway. (required) :type virtual_gateway_id:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
route propagation
- Return type
dict
- ex_update_server_certificate(name: Optional[str] = None, new_name: Optional[str] = None, new_path: Optional[str] = None, dry_run: bool = False)[source]¶
Modifies the name and/or the path of a specified server certificate.
- Parameters
name – The name of the server certificate
you want to modify. :type name:
str
- Parameters
new_name (
str
) – A new name for the server certificate.
:param new_path:A new path for the server certificate. :type new_path:
str
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
the new server certificate
- Return type
dict
- ex_update_snapshot(perm_to_create_volume_addition_account_id: Optional[List[str]] = None, perm_to_create_volume_addition_global_perm: Optional[bool] = None, perm_to_create_volume_removals_account_id: Optional[List[str]] = None, perm_to_create_volume_removals_global_perm: Optional[bool] = None, snapshot: Optional[libcloud.compute.base.VolumeSnapshot] = None, dry_run: bool = False)[source]¶
Modifies the permissions for a specified snapshot. You can add or remove permissions for specified account IDs or groups. You can share a snapshot with a user that is in the same Region. The user can create a copy of the snapshot you shared, obtaining all the rights for the copy of the snapshot.
- Parameters
perm_to_create_volume_addition_account_id –
The account ID of one or more users who have permissions for the resource. :type perm_to_create_volume_addition_account_id:
list
ofstr
- Parameters
perm_to_create_volume_addition_global_perm – If true,
the resource is public. If false, the resource is private. :type perm_to_create_volume_addition_global_perm:
bool
- Parameters
perm_to_create_volume_removals_account_id – The account ID of one or more users who have permissions for the resource.
list
ofstr
- Parameters
perm_to_create_volume_removals_global_perm (
bool
) – If true, the resource is public. If false, the resource is private.snapshot (
VolumeSnapshot
) – The ID of the snapshot. (required)dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
snapshot export tasks
- Return type
list
ofdict
- ex_update_subnet(subnet_id: Optional[str] = None, map_public_ip_on_launch: Optional[bool] = None, dry_run: bool = False)[source]¶
Deletes a specified Subnet. You must terminate all the running virtual machines (VMs) in the Subnet before deleting it.
- Parameters
subnet_id – The ID of the Subnet you want to delete.
(required) :type subnet_id:
str
- Parameters
map_public_ip_on_launch – If true, a public IP address is
assigned to the network interface cards (NICs) created in the s pecified Subnet. (required) :type map_public_ip_on_launch:
bool
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
The updated Subnet
- Return type
dict
- get_image(image_id: str)[source]¶
Get a specific image.
- Parameters
image_id (
str
) – the ID of the image you want to select (required)- Returns
the selected image
- Return type
dict
- get_key_pair(name: str)[source]¶
Get a specific key pair.
- Parameters
name (
str
) – the name of the key pair you want to select (required)- Returns
the selected key pair
- Return type
dict
- list_images(account_aliases: Optional[List[str]] = None, account_ids: Optional[List[str]] = None, architectures: Optional[List[str]] = None, block_device_mapping_delete_on_vm_deletion: bool = False, block_device_mapping_device_names: Optional[List[str]] = None, block_device_mapping_snapshot_ids: Optional[List[str]] = None, block_device_mapping_volume_sizes: Optional[List[int]] = None, block_device_mapping_volume_types: Optional[List[str]] = None, descriptions: Optional[List[str]] = None, file_locations: Optional[List[str]] = None, image_ids: Optional[List[str]] = None, image_names: Optional[List[str]] = None, permission_to_launch_account_ids: Optional[List[str]] = None, permission_to_lauch_global_permission: bool = False, root_device_names: Optional[List[str]] = None, root_device_types: Optional[List[str]] = None, states: Optional[List[str]] = None, tag_keys: Optional[List[str]] = None, tag_values: Optional[List[str]] = None, tags: Optional[List[str]] = None, virtualization_types: Optional[List[str]] = None, dry_run: bool = False)[source]¶
Lists one or more Outscale machine images (OMIs) you can use.
- Parameters
account_aliases – The account aliases of the
owners of the OMIs. :type account_aliases:
list
ofstr
- Parameters
account_ids – The account IDs of the owners of the
OMIs. By default, all the OMIs for which you have launch permissions are described. :type account_ids:
list
ofstr
- Parameters
architectures – The architectures of the
OMIs (i386 | x86_64). :type architectures:
list
ofstr
- Parameters
block_device_mapping_delete_on_vm_deletion – Indicates
whether the block device mapping is deleted when terminating the VM. :type block_device_mapping_delete_on_vm_deletion:
bool
- Parameters
block_device_mapping_device_names – The device names for
the volumes. :type block_device_mapping_device_names:
list
ofstr
- Parameters
block_device_mapping_snapshot_ids – The IDs of the
snapshots used to create the volumes. :type block_device_mapping_snapshot_ids:
list
ofstr
- Parameters
block_device_mapping_volume_sizes – The sizes of the
volumes, in gibibytes (GiB). :type block_device_mapping_volume_sizes:
list
ofint
- Parameters
block_device_mapping_volume_types – The types of
volumes (standard | gp2 | io1). :type block_device_mapping_volume_types:
list
ofstr
- Parameters
descriptions – The descriptions of the OMIs, provided
when they were created. :type descriptions:
list
ofstr
- Parameters
file_locations – The locations where the OMI files are
stored on Object Storage Unit (OSU). :type file_locations:
list
ofstr
- Parameters
image_ids (
list
ofstr
) – The IDs of the OMIs.image_names – The names of the OMIs, provided when
they were created. :type image_names:
list
ofstr
- Parameters
permission_to_launch_account_ids – The account IDs of the
users who have launch permissions for the OMIs. :type permission_to_launch_account_ids:
list
ofstr
- Parameters
permission_to_lauch_global_permission – If true, lists
all public OMIs. If false, lists all private OMIs. :type permission_to_lauch_global_permission:
list
ofstr
- Parameters
root_device_names – The device names of the root
devices (for example, /dev/sda1). :type root_device_names:
list
ofstr
- Parameters
root_device_types – The types of root device used by
the OMIs (always bsu). :type root_device_types:
list
ofstr
- Parameters
states – The states of the OMIs
(pending | available | failed). :type states:
list
ofstr
- Parameters
tag_keys (
list
ofstr
) – The keys of the tags associated with the OMIs.tag_values – The values of the tags associated
with the OMIs. :type tag_values:
list
ofstr
- Parameters
tags – The key/value combination of the tags associated
with the OMIs, in the following format:”Filters”: {“Tags”:[“TAGKEY=TAGVALUE”]}. :type tags:
list
ofstr
- Parameters
virtualization_types – The virtualization types
(always hvm). :type virtualization_types:
list
ofstr
- Parameters
dry_run – If true, checks whether you have the required
permissions to perform the action. :type dry_run:
bool
- Returns
a list of image
- Return type
list
ofdict
- list_locations(ex_dry_run: bool = False)[source]¶
Lists available locations details.
- Parameters
ex_dry_run – If true, checks whether you have the required
permissions to perform the action. :type ex_dry_run:
bool
:return: locations details :rtype:dict
- list_snapshots(ex_data: str = '{}')[source]¶
List all volume snapshots.
- Returns
snapshots
- Return type
dict
- list_volume_snapshots(volume)[source]¶
List all snapshot for a given volume.
- Parameters
volume (StorageVolume) – the volume from which to look for snapshots
- Return type
list
of :classVolumeSnapshot
- list_volumes(ex_data: str = '{}')[source]¶
List all volumes. :rtype:
list
ofStorageVolume
- name = 'Outscale API'¶
- reboot_node(node: libcloud.compute.base.Node)[source]¶
Reboot instance.
- Parameters
node (
list
) – VM(s) you want to reboot (required)- Returns
the rebooted instances
- Return type
dict
- start_node(node: libcloud.compute.base.Node)[source]¶
Start a Vm.
- Parameters
node (
Node
) – the VM(s) you want to start (required)- Returns
the rebooted instances
- Return type
bool
- stop_node(node: libcloud.compute.base.Node)[source]¶
Stop a Vm.
- Parameters
node (
Node
) – the VM(s) you want to stop (required)- Returns
the rebooted instances
- Return type
bool
- type = 'outscale'¶
- website = 'http://www.outscale.com'¶
libcloud.compute.drivers.ovh module¶
Ovh driver
- class libcloud.compute.drivers.ovh.OvhNodeDriver(key, secret, ex_project_id, ex_consumer_key=None, region=None)[source]¶
Bases:
libcloud.compute.base.NodeDriver
Libcloud driver for the Ovh API
For more information on the Ovh 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_project_id (
str
) – Your project IDex_consumer_key (
str
) – Your consumer key (required)region (
str
) – The datacenter to connect to (optional)
- Return type
None
- NODE_STATE_MAP = {'ACTIVE': NodeState.RUNNING, 'BUILD': NodeState.PENDING, 'DELETED': NodeState.TERMINATED, 'DELETE_IP': NodeState.PENDING, 'ERROR': NodeState.ERROR, 'HARD_REBOOT': NodeState.REBOOTING, 'PASSWORD': NodeState.PENDING, 'PREP_RESIZE': NodeState.PENDING, 'QUEUE_RESIZE': NodeState.PENDING, 'REBOOT': NodeState.REBOOTING, 'REBUILD': NodeState.PENDING, 'RESCUE': NodeState.PENDING, 'RESIZE': NodeState.RECONFIGURING, 'SHARE_IP': NodeState.PENDING, 'SHARE_IP_NO_CONFIG': NodeState.PENDING, 'SHUTOFF': NodeState.STOPPED, 'SUSPENDED': NodeState.SUSPENDED, 'UNKNOWN': NodeState.UNKNOWN, 'VERIFY_RESIZE': NodeState.RUNNING}¶
- SNAPSHOT_STATE_MAP = {'available': VolumeSnapshotState.AVAILABLE, 'creating': VolumeSnapshotState.CREATING, 'deleting': VolumeSnapshotState.DELETING, 'error': VolumeSnapshotState.ERROR, 'error_restoring': VolumeSnapshotState.ERROR, 'restoring': VolumeSnapshotState.RESTORING}¶
- VOLUME_STATE_MAP = {'attaching': StorageVolumeState.ATTACHING, 'available': StorageVolumeState.AVAILABLE, 'backing-up': StorageVolumeState.BACKUP, 'creating': StorageVolumeState.CREATING, 'deleting': StorageVolumeState.DELETING, 'error': StorageVolumeState.ERROR, 'error_deleting': StorageVolumeState.ERROR, 'error_extending': StorageVolumeState.ERROR, 'error_restoring': StorageVolumeState.ERROR, 'in-use': StorageVolumeState.INUSE, 'restoring-backup': StorageVolumeState.BACKUP}¶
- api_name = 'ovh'¶
- attach_volume(node, volume, device=None)[source]¶
Attach a volume to a node.
- Parameters
node (
Node
) – Node where to attach volumevolume (
StorageVolume
) – The ID of the volumedevice – Unsed parameter
- Returns
True or False representing operation successful
- Return type
bool
- connectionCls¶
alias of
libcloud.common.ovh.OvhConnection
- create_node(name, image, size, location, ex_keyname=None)[source]¶
Create a new node
- Parameters
name (
str
) – Name of created nodeimage (
NodeImage
) – Image used for nodesize (
NodeSize
) – Size (flavor) used for nodelocation (
NodeLocation
) – Location (region) where to create nodeex_keyname (
str
) – Name of SSH key used
- Returns
Created node
:rtype :
Node
- create_volume(size, name, location, snapshot=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 createlocation (
NodeLocation
orNone
) – Location to create the volume insnapshot (
VolumeSnapshot
) – Snapshot from which to create the new volume. (optional)ex_volume_type (
str
) –'classic'
or'high-speed'
ex_description (str) – Optionnal description of volume
- Returns
Storage Volume object
- Return type
StorageVolume
- create_volume_snapshot(volume, name=None, ex_description=None)[source]¶
Create snapshot from volume
- Parameters
volume (StorageVolume) – Instance of StorageVolume
name (str | NoneType) – Name of snapshot (optional)
ex_description (str | NoneType) – Description of the snapshot (optional)
- Return type
VolumeSnapshot
- delete_key_pair(key_pair)[source]¶
Delete an existing key pair.
- Parameters
key_pair (
KeyPair
) – Key pair object.- Return type
bool
- destroy_node(node)[source]¶
Destroy a node.
Depending upon the provider, this may destroy all data associated with the node, including backups.
- Parameters
node (
Node
) – The node to be destroyed- Returns
True if the destroy was successful, False otherwise.
- Return type
bool
- destroy_volume(volume)[source]¶
Destroys a storage volume.
- Parameters
volume (
StorageVolume
) – Volume to be destroyed- Return type
bool
- destroy_volume_snapshot(snapshot)[source]¶
Destroys a snapshot.
- Parameters
snapshot (
VolumeSnapshot
) – The snapshot to delete- Return type
- detach_volume(volume, ex_node=None)[source]¶
Detach a volume to a node.
- Parameters
volume (
StorageVolume
) – The ID of the volumeex_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
- ex_get_node(node_id)[source]¶
Get a individual node.
- Parameters
node_id (
str
) – Node’s ID- Returns
Created node
:rtype :
Node
- ex_get_size(size_id)[source]¶
Get an individual size (flavor).
- Parameters
size_id (
str
) – Size’s ID- Returns
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 volume- Returns
A StorageVolume object for the volume
- Return type
StorageVolume
- ex_get_volume_snapshot(snapshot_id)[source]¶
Returns a single volume snapshot.
- Parameters
snapshot_id (
str
) – Node to run the task on.
:rtype
VolumeSnapshot
: :return: Volume snapshot.
- ex_list_snapshots(location=None)[source]¶
List all snapshots.
- Parameters
location (
NodeLocation
orNone
) – Location used to filter- Return type
list
ofVolumeSnapshot
- features = {'create_node': ['ssh_key']}¶
- List of available features for a driver.
libcloud.compute.base.NodeDriver.create_node()
ssh_key: Supports
NodeAuthSSHKey
as an authentication method for nodes.password: Supports
NodeAuthPassword
as an authentication method for nodes.generates_password: Returns a password attribute on the Node object returned from creation.
- get_image(image_id)[source]¶
Returns a single node image from a provider.
- Parameters
image_id (
str
) – Node to run the task on.
:rtype
NodeImage
: :return: NodeImage instance on success.
- get_key_pair(name, ex_location=None)[source]¶
Get an individual SSH public key by its name and location.
- Parameters
name (
str
) – Name of the key pair to retrieve.ex_location (
NodeLocation
) – Key’s region
- Returns
Public key
- Return type
KeyPair
- import_key_pair_from_string(name, key_material, ex_location)[source]¶
Import a new public key from string.
- Parameters
name (
str
) – Key pair name.key_material (
str
) – Public key material.ex_location (
NodeLocation
) – Location where to store the key
- Returns
Imported key pair object.
- Return type
KeyPair
- list_images(location=None, ex_size=None)[source]¶
List available images
- Parameters
location (
NodeLocation
) – Location (region) used as filterex_size (
NodeImage
) – Exclude images which are uncompatible with given size
- Returns
List of images
:rtype :
list
ofNodeImage
- list_key_pairs(ex_location=None)[source]¶
List available SSH public keys.
- Parameters
ex_location (
NodeLocation
) – Location (region) used as filter- Returns
Public keys
- Return type
``list``of
KeyPair
- list_locations()[source]¶
List data centers for a provider
- Returns
list of node location objects
- Return type
list
ofNodeLocation
- list_nodes(location=None)[source]¶
List all nodes.
- Parameters
location (
NodeLocation
) – Location (region) used as filter- Returns
List of node objects
- Return type
list
ofNode
- list_sizes(location=None)[source]¶
List sizes on a provider
- Parameters
location (
NodeLocation
) – The location at which to list sizes- Returns
list of node size objects
- Return type
list
ofNodeSize
- list_volume_snapshots(volume)[source]¶
List snapshots for a storage volume.
- Return type
list
ofVolumeSnapshot
- list_volumes(ex_location=None)[source]¶
Return a list of volumes.
- Parameters
ex_location (
NodeLocation
orNone
) – Location used to filter- Returns
A list of volume objects.
- Return type
list
ofStorageVolume
- name = 'Ovh'¶
- type = 'ovh'¶
- website = 'https://www.ovh.com/'¶
libcloud.compute.drivers.profitbricks module¶
ProfitBricks Compute driver
- class libcloud.compute.drivers.profitbricks.Datacenter(id, href, 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.href (
str
) – The datacenter href.name (
str
) – The datacenter name.version (
str
) – Datacenter version.driver (
ProfitBricksNodeDriver
) – ProfitBricks Node Driver.extra (
dict
) – Extra properties for the Datacenter.
Note: This class is ProfitBricks specific.
- class libcloud.compute.drivers.profitbricks.ProfitBricksAvailabilityZone(name)[source]¶
Bases:
object
Extension class which stores information about a ProfitBricks availability zone.
- Parameters
name (
str
) – The availability zone name.
Note: This class is ProfitBricks specific.
- class libcloud.compute.drivers.profitbricks.ProfitBricksFirewallRule(id, name, href, state, extra=None)[source]¶
Bases:
object
Extension class which stores information about a ProfitBricks firewall rule.
- Parameters
id (
str
) – The firewall rule ID.name (
str
) – The firewall rule name.href (
str
) – The firewall rule href.state (
int
) – The current state of the firewall rule.extra (
dict
) – Extra properties for the firewall rule.
Note: This class is ProfitBricks specific.
- class libcloud.compute.drivers.profitbricks.ProfitBricksIPBlock(id, name, href, location, size, ips, state, driver, extra=None)[source]¶
Bases:
object
Extension class which stores information about a ProfitBricks IP block.
- Parameters
id – The ID of the IP block.
id –
str
name (
str
) – The name of the IP block.href (
str
) – The IP block href.location (
str
) – The location of the IP block.size (
int
) – Number of IP addresses in the block.ips (
list
) – A collection of IPs associated with the block.state (
int
) – The current state of the IP block.extra (
dict
) – Extra properties for the IP block.
Note: This class is ProfitBricks specific
- class libcloud.compute.drivers.profitbricks.ProfitBricksIPFailover(ip, nic_uuid)[source]¶
Bases:
object
Extension class which stores information about a ProfitBricks LAN’s failover
- Parameters
ip (
str
) – The IP address to fail over.nic_uuid – The ID of the NIC to fail over.
nic_uuid –
str
Note: This class is ProfitBricks specific.
- class libcloud.compute.drivers.profitbricks.ProfitBricksLan(id, name, href, is_public, state, driver, extra=None)[source]¶
Bases:
object
Extension class which stores information about a ProfitBricks LAN
- Parameters
id – The ID of the lan.
id –
str
name (
str
) – The name of the lan.href (
str
) – The lan href.is_public (
bool
) – If public, the lan faces the public internet.state (
int
) – The current state of the lan.extra (
dict
) – Extra properties for the lan.
Note: This class is ProfitBricks specific.
- class libcloud.compute.drivers.profitbricks.ProfitBricksLoadBalancer(id, name, href, state, driver, extra=None)[source]¶
Bases:
object
Extention class which stores information about a ProfitBricks load balancer
- Parameters
id – The ID of the load balancer.
id –
str
name (
str
) – The name of the load balancer.href (
str
) – The load balancer href.state (
int
) – The current state of the load balancer.extra (
dict
) – Extra properties for the load balancer.
Note: This class is ProfitBricks specific
- class libcloud.compute.drivers.profitbricks.ProfitBricksNetworkInterface(id, name, href, 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.href (
str
) – The network interface href.state (
int
) – The network interface name.extra (
dict
) – Extra properties for the network interface.
Note: This class is ProfitBricks specific.
- 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'}, '2': {'name': 'ZONE_1'}, '3': {'name': 'ZONE_2'}}¶
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 = {'AVAILABLE': NodeState.RUNNING, 'BLOCKED': NodeState.STOPPED, 'BUSY': NodeState.PENDING, 'CRASHED': NodeState.ERROR, 'NOSTATE': NodeState.UNKNOWN, 'PAUSE': NodeState.PAUSED, 'RUNNING': NodeState.RUNNING, 'SHUTDOWN': NodeState.STOPPING, 'SHUTOFF': NodeState.STOPPED}¶
- PROFIT_BRICKS_GENERIC_SIZES = {'1': {'cores': 1, 'disk': 50, 'id': '1', 'name': 'Micro', 'ram': 1024}, '2': {'cores': 1, 'disk': 50, 'id': '2', 'name': 'Small Instance', 'ram': 2048}, '3': {'cores': 2, 'disk': 50, 'id': '3', 'name': 'Medium Instance', 'ram': 4096}, '4': {'cores': 4, 'disk': 50, 'id': '4', 'name': 'Large Instance', 'ram': 7168}, '5': {'cores': 8, 'disk': 50, 'id': '5', 'name': 'ExtraLarge Instance', 'ram': 14336}, '6': {'cores': 4, 'disk': 50, 'id': '6', 'name': 'Memory Intensive Instance Medium', 'ram': 28672}, '7': {'cores': 8, 'disk': 50, 'id': '7', 'name': 'Memory Intensive Instance Large', 'ram': 57344}}¶
Core Functions
- PROVISIONING_STATE = {'AVAILABLE': NodeState.RUNNING, 'BUSY': NodeState.PENDING, 'INACTIVE': NodeState.PENDING}¶
- attach_volume(node, volume)[source]¶
Attaches a volume.
- Parameters
node (
Node
) – The node to which you’re attaching the volume.volume (
StorageVolume
) – The volume you’re attaching.
- Returns
Instance of class
StorageVolume
- Return type
StorageVolume
- connectionCls¶
alias of
libcloud.compute.drivers.profitbricks.ProfitBricksConnection
- create_node(name, image=None, size=None, location=None, ex_cpu_family=None, volume=None, ex_datacenter=None, ex_network_interface=True, ex_internet_access=True, ex_exposed_public_ports=[], ex_exposed_private_ports=[22], ex_availability_zone=None, ex_ram=None, ex_cores=None, ex_disk=None, ex_password=None, ex_ssh_keys=None, ex_bus_type=None, ex_disk_type=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
name – The name for the new node.
type –
str
image (
NodeImage
) – The image to create the node with.size – Standard configured size offered by ProfitBricks - containing configuration for the number of cpu cores, amount of ram and disk size.
size –
NodeSize
location (
NodeLocation
) – The location of the new data center if one is not supplied.ex_cpu_family (
str
) – The CPU family to use (AMD_OPTERON, INTEL_XEON)volume (
StorageVolume
) – If the volume already exists then pass this in.ex_datacenter (
Datacenter
) – If you’ve already created the DC then pass it in.ex_network_interface (:
bool
) – Create with a network interface.ex_internet_access (:
bool
) – Configure public Internet access.ex_exposed_public_ports – Ports to be opened for the public nic.
ex_exposed_public_ports –
list
ofint
ex_exposed_private_ports – Ports to be opened for the private nic.
ex_exposed_private_ports –
list
ofint
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.ex_password (
NodeAuthPassword
orstr
) – The password for the volume.ex_ssh_keys (
list
ofNodeAuthSSHKey
orlist
ofstr
) – Optional SSH keys for the volume.ex_bus_type (
str
) – Volume bus type (VIRTIO, IDE).ex_disk_type (
str
) – Volume disk type (SSD, HDD).
- Returns
Instance of class
Node
- Return type
- class
Node
- create_volume(size, ex_datacenter, name=None, image=None, ex_image_alias=None, ex_type=None, ex_bus_type=None, ex_ssh_keys=None, ex_password=None, ex_availability_zone=None)[source]¶
Creates a volume.
- Parameters
size (
int
) – The size of the volume in GB.ex_datacenter (
Datacenter
) – The datacenter you’re placing the storage in. (req)name – The name to be given to the volume.
name –
str
image (
NodeImage
) – The OS image for the volume.ex_image_alias (
str
) – An alias to a ProfitBricks public image. Use instead of ‘image’.ex_type – The type to be given to the volume (SSD or HDD).
ex_type –
str
ex_bus_type (
str
) – Bus type. Either IDE or VIRTIO (default).ex_ssh_keys (
list
ofNodeAuthSSHKey
orlist
ofstr
) – Optional SSH keys.ex_password (
NodeAuthPassword
orstr
) – Optional password for root.ex_availability_zone (
str
) – Volume Availability Zone.
- Returns
Instance of class
StorageVolume
- Return type
StorageVolume
- create_volume_snapshot(volume)[source]¶
Creates a snapshot for a volume
- Parameters
volume (
StorageVolume
) – The volume you’re creating a snapshot for.- Returns
Instance of class
VolumeSnapshot
- Return type
VolumeSnapshot
- 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 destroying.- Return type
:
bool
- destroy_volume_snapshot(snapshot)[source]¶
Delete a snapshot
- Parameters
snapshot – The snapshot you wish to delete.
- Type
snapshot:
VolumeSnapshot
:rtype
bool
- detach_volume(node, volume)[source]¶
Detaches a volume.
- Parameters
node (
Node
) – The node to which you’re detaching the volume.volume (
StorageVolume
) – The volume you’re detaching.
- Return type
:
bool
- ex_attach_nic_to_load_balancer(load_balancer, network_interface)[source]¶
Attaches a network interface to a load balancer
- Parameters
load_balancer – The load balancer you wish to attach the network interface to.
network_interface – The network interface being attached.
- Type
load_balancer:
ProfitBricksLoadBalancer
- Type
network_interface:
ProfitBricksNetworkInterface
:rtype
bool
- ex_create_datacenter(name, location, description=None)[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 datacenter name.location (:
NodeLocation
) – instance of classNodeLocation
.description (:
str
) – The datacenter description.
- Returns
Instance of class
Datacenter
- Return type
- ex_create_firewall_rule(network_interface, protocol, name=None, source_mac=None, source_ip=None, target_ip=None, port_range_start=None, port_range_end=None, icmp_type=None, icmp_code=None)[source]¶
Create a firewall rule for a network interface.
- Parameters
network_interface – The network interface to attach the firewall rule to.
protocol (
str
) – The protocol for the rule (TCP, UDP, ICMP, ANY)name (
str
) – The name for the firewall rulesource_mac (
str
) – Only traffic originating from the respective MAC address is allowed. Valid format: aa:bb:cc:dd:ee:ff. Value null allows all source MAC address.source_ip (
str
) – Only traffic originating from the respective IPv4 address is allowed. Value null allows all source IPs.target_ip (
str
) – In case the target NIC has multiple IP addresses, only traffic directed to the respective IP address of the NIC is allowed. Value null allows all target IPs.port_range_start – Defines the start range of the allowed port (from 1 to 65534) if protocol TCP or UDP is chosen. Leave portRangeStart and portRangeEnd value null to allow all ports.
- Type
network_interface:
ProfitBricksNetworkInterface
type: port_range_start:
int
- Parameters
port_range_end – Defines the end range of the allowed port (from 1 to 65534) if protocol TCP or UDP is chosen. Leave portRangeStart and portRangeEnd value null to allow all ports.
type: port_range_end:
int
- Parameters
icmp_type (
int
) – Defines the allowed type (from 0 to 254) if the protocol ICMP is chosen. Value null allows all types.icmp_code (
int
) – Defines the allowed code (from 0 to 254) if protocol ICMP is chosen. Value null allows all codes.
- Returns
Instance class
ProfitBricksFirewallRule
- Return type
- ex_create_ip_block(location, size, name=None)[source]¶
Create an IP block
- Parameters
location (
NodeLocation
) – The location of the IP block.size (
int
) – The size of the IP block.name (
str
) – The name of the IP block.
- Returns
Instance class
ProfitBricksIPBlock
- Return type
- ex_create_lan(datacenter, name=None, is_public=False, nics=None)[source]¶
Create and attach a Lan to a data center.
- Parameters
datacenter (
Datacenter
) – The parent DC for the LAN..name (
str
) – LAN name.is_public (
bool
) – True if the Lan is to have internet access.nics – Optional network interfaces to attach to the lan.
nics –
list
of classProfitBricksNetworkInterface
- Returns
Instance class
ProfitBricksLan
- Return type
- ex_create_load_balancer(datacenter, name=None, ip=None, dhcp=None, nics=None)[source]¶
Create and attach a load balancer to a data center.
- Parameters
datacenter (
Datacenter
) – The parent DC for the load balancer.name (
str
) – Load balancer name.ip (
str
) – Load balancer IPV4 address.dhcp (
bool
) – If true, the load balancer will reserve an IP address using DHCP.nics – Optional network interfaces taking part in load balancing.
nics –
list
of classProfitBricksNetworkInterface
- Returns
Instance class
ProfitBricksLoadBalancer
- Return type
- ex_create_network_interface(node, lan_id=None, ips=None, nic_name=None, dhcp_active=True)[source]¶
Creates a network interface.
- Parameters
lan_id (:
int
) – The ID for the LAN.ips (
list
) – The IP addresses 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
- ex_delete_firewall_rule(firewall_rule)[source]¶
Delete a firewall rule
- Parameters
firewall_rule – The firewall rule to delete.
- Type
firewall_rule:
ProfitBricksFirewallRule
:rtype
bool
- ex_delete_image(image)[source]¶
Delete a private image
- Parameters
image (
NodeImage
) – The private image you are deleting.- Return type
:
bool
- ex_delete_ip_block(ip_block)[source]¶
Delete an IP block
- Parameters
ip_block – The IP block you wish to delete.
- Type
ip_block:
ProfitBricksIPBlock
:rtype
bool
- ex_delete_lan(lan)[source]¶
Delete a local area network
- Parameters
lan – The lan you wish to delete.
- Type
lan:
ProfitBrickLan
:rtype
bool
- ex_delete_load_balancer(load_balancer)[source]¶
Delete a load balancer
- Parameters
load_balancer – The load balancer you wish to delete.
- Type
load_balancer:
ProfitBricksLoadBalancer
:rtype
bool
- ex_describe_datacenter(ex_href=None, ex_datacenter_id=None)[source]¶
Fetches the details for a data center.
- Parameters
ex_href (
str
) – The href for the data center you are describing.ex_datacenter_id (
str
) – The ID for the data center you are describing.
- Returns
Instance of class
Datacenter
- Return type
- ex_describe_firewall_rule(ex_href=None, ex_datacenter_id=None, ex_server_id=None, ex_nic_id=None, ex_firewall_rule_id=None)[source]¶
Fetch data for a firewall rule.
- Parameters
href (
str
) – The href of the firewall rule you wish to describe.ex_datacenter_id (
str
) – The ID of parent data center of the NIC you wish to describe.ex_server_id (
str
) – The server the NIC is connected to.ex_nic_id (
str
) – The ID of the NIC.ex_firewall_rule_id (
str
) – The ID of the firewall rule.
- Returns
Instance class
ProfitBricksFirewallRule
- Return type
- ex_describe_image(ex_href=None, ex_image_id=None)[source]¶
Describe a ProfitBricks image
- Parameters
ex_href (
str
) – The href for the image you are describingex_image_id (
str
) – The ID for the image you are describing
- Returns
Instance of class
Image
- Return type
Image
- ex_describe_ip_block(ex_href=None, ex_ip_block_id=None)[source]¶
Fetch an IP block
- Parameters
ex_href (
str
) – The href of the IP block.ex_ip_block_id (
str
) – The ID of the IP block.
- Returns
Instance class
ProfitBricksIPBlock
- Return type
- ex_describe_lan(ex_href=None, ex_datacenter_id=None, ex_lan_id=None)[source]¶
Fetch data on a local area network
- Parameters
ex_href (
str
) – The href of the lan you wish to describe.ex_datacenter_id (
str
) – The ID of the parent datacenter for the LAN.ex_lan_id (
str
) – The ID of LAN.
- Returns
Instance class
ProfitBricksLan
- Return type
- ex_describe_load_balanced_nic(ex_href=None, ex_datacenter_id=None, ex_server_id=None, ex_nic_id=None)[source]¶
Fetch information on a load balanced network interface.
- Parameters
ex_href (
str
) – The href of the load balanced NIC you wish to describe.ex_datacenter_id (
str
) – The ID of parent data center of the NIC you wish to describe.ex_server_id (
str
) – The server the NIC is connected to.ex_nic_id (
str
) – The ID of the NIC
- Returns
Instance of class
ProfitBricksNetworkInterface
- Return type
- ex_describe_load_balancer(ex_href=None, ex_datacenter_id=None, ex_load_balancer_id=None)[source]¶
Fetches and returns a load balancer
- Parameters
href (
str
) – The full href (url) of the load balancer.ex_datacenter_id (
str
) – The ID of the parent data center for the load balancer.ex_load_balancer_id (
str
) – The load balancer ID.
- Returns
Instance of class
ProfitBricksLoadBalancer
- Return type
- ex_describe_location(ex_href=None, ex_location_id=None)[source]¶
Fetch details for a ProfitBricks location.
- Parameters
ex_href (
str
) – The href for the location you are describing.ex_location_id (
str
) – The id for the location you are describing (‘de/fra’, ‘de/fkb’, ‘us/las’, ‘us/ewr’)
- Returns
Instance of class
NodeLocation
- Return type
NodeLocation
- ex_describe_network_interface(ex_href=None, ex_datacenter_id=None, ex_server_id=None, ex_nic_id=None)[source]¶
Fetch information on a network interface.
- Parameters
ex_href (
str
) – The href of the NIC you wish to describe.ex_datacenter_id (
str
) – The ID of parent data center of the NIC you wish to describe.ex_server_id (
str
) – The server the NIC is connected to.ex_nic_id (
str
) – The ID of the NIC
- Returns
Instance of class
ProfitBricksNetworkInterface
- Return type
- ex_describe_node(ex_href=None, ex_datacenter_id=None, ex_node_id=None)[source]¶
Fetches a node directly by href or by a combination of the datacenter ID and the server ID.
- Parameters
ex_href (
str
) – The href (url) of the node you wish to describe.ex_datacenter_id (
str
) – The ID for the data center.ex_node_id (
str
) – The ID for the node (server).
- Returns
Instance of class
Node
- Return type
Node
- ex_describe_snapshot(ex_href=None, ex_snapshot_id=None)[source]¶
Fetches and returns a volume snapshot
- Parameters
ex_href (
str
) – The full href (url) of the snapshot.ex_snapshot_id (
str
) – The ID of the snapshot.
- Returns
Instance of class
ProfitBricksSnapshot
- Return type
ProfitBricksSnapshot
- ex_describe_volume(ex_href=None, ex_datacenter_id=None, ex_volume_id=None)[source]¶
Fetches and returns a volume
- Parameters
ex_href (
str
) – The full href (url) of the volume.ex_datacenter_id (
str
) – The ID of the parent datacenter for the volume.ex_volume_id (
str
) – The ID of the volume.
- 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_attached_volumes(node)[source]¶
Returns a list of attached volumes for a server
- Parameters
node (
Node
) – The node with the attached volumes.- Returns
list
ofStorageVolume
- Return type
list
- ex_list_availability_zones()[source]¶
Returns a list of availability zones.
- Returns
list
ofProfitBricksAvailabilityZone
- Return type
list
- ex_list_firewall_rules(network_interface)[source]¶
Fetch firewall rules for a network interface.
- Parameters
network_interface (
ProfitBricksNetworkInterface
) – The network interface.- Returns
list
of classProfitBricksFirewallRule
- Return type
list
- ex_list_ip_blocks()[source]¶
List all IP blocks
- Returns
list
of classProfitBricksIPBlock
- Return type
list
- ex_list_lans(datacenter=None)[source]¶
List local area network on: - a datacenter if one is specified - all datacenters if none specified
- Parameters
datacenter (
Datacenter
) – The parent DC for the LAN.- Returns
list
of classProfitBricksLan
- Return type
list
- ex_list_load_balanced_nics(load_balancer)[source]¶
List balanced network interfaces for a load balancer.
- Parameters
load_balancer – The load balancer you wish to update.
- Type
load_balancer:
ProfitBricksLoadBalancer
- Returns
list
of classProfitBricksNetorkInterface
- Return type
list
- ex_list_load_balancers()[source]¶
Fetches as a list of load balancers
- Returns
list
of classProfitBricksLoadBalancer
- Return type
list
- ex_list_network_interfaces()[source]¶
Fetch a list of all network interfaces from all data centers.
- Returns
list
of classProfitBricksNetworkInterface
- Return type
list
- ex_remove_nic_from_load_balancer(load_balancer, network_interface)[source]¶
Removed a network interface from a load balancer
- Parameters
load_balancer – The load balancer you wish to remove the network interface from.
network_interface – The network interface being removed.
- Type
load_balancer:
ProfitBricksLoadBalancer
- Type
network_interface:
ProfitBricksNetworkInterface
:rtype
bool
- ex_rename_datacenter(datacenter, name)[source]¶
Update a datacenter.
- Parameters
datacenter (
Datacenter
) – The DC you are renaming.name (:
str
) – The DC name.
- Returns
Instance of class
Datacenter
- Return type
- ex_restore_volume_snapshot(volume, snapshot)[source]¶
Restores a snapshot for a volume
- Parameters
volume (
StorageVolume
) – The volume you’re restoring the snapshot to.snapshot (
ProfitBricksSnapshot
) – The snapshot you’re restoring to the volume.
:rtype
bool
- ex_set_inet_access(network_interface, internet_access=True)[source]¶
Add/remove public internet access to an interface.
- Parameters
network_interface (
ProfitBricksNetworkInterface
) – The NIC you wish to update.- Returns
Instance of class
ProfitBricksNetworkInterface
- Return type
- ex_update_firewall_rule(firewall_rule, name=None, source_mac=None, source_ip=None, target_ip=None, port_range_start=None, port_range_end=None, icmp_type=None, icmp_code=None)[source]¶
Update a firewall rule
- Parameters
firewall_rule – The firewall rule to update
name (
str
) – The name for the firewall rulesource_mac (
str
) – Only traffic originating from the respective MAC address is allowed. Valid format: aa:bb:cc:dd:ee:ff. Value null allows all source MAC address.source_ip (
str
) – Only traffic originating from the respective IPv4 address is allowed. Value null allows all source IPs.target_ip (
str
) – In case the target NIC has multiple IP addresses, only traffic directed to the respective IP address of the NIC is allowed. Value null allows all target IPs.port_range_start – Defines the start range of the allowed port (from 1 to 65534) if protocol TCP or UDP is chosen. Leave portRangeStart and portRangeEnd value null to allow all ports.
- Type
firewall_rule:
ProfitBricksFirewallRule
type: port_range_start:
int
- Parameters
port_range_end – Defines the end range of the allowed port (from 1 to 65534) if protocol TCP or UDP is chosen. Leave portRangeStart and portRangeEnd value null to allow all ports.
type: port_range_end:
int
- Parameters
icmp_type (
int
) – Defines the allowed type (from 0 to 254) if the protocol ICMP is chosen. Value null allows all types.icmp_code (
int
) – Defines the allowed code (from 0 to 254) if protocol ICMP is chosen. Value null allows all codes.
- Returns
Instance class
ProfitBricksFirewallRule
- Return type
- ex_update_image(image, name=None, description=None, licence_type=None, cpu_hot_plug=None, cpu_hot_unplug=None, ram_hot_plug=None, ram_hot_unplug=None, nic_hot_plug=None, nic_hot_unplug=None, disc_virtio_hot_plug=None, disc_virtio_hot_unplug=None, disc_scsi_hot_plug=None, disc_scsi_hot_unplug=None)[source]¶
Update a private image
- Parameters
image (
NodeImage
) – The private image you are deleting.- Returns
Instance of class
Image
- Return type
Image
- ex_update_lan(lan, is_public, name=None, ip_failover=None)[source]¶
Update a local area network
- Parameters
lan – The lan you wish to update.
is_public (
bool
) – Boolean indicating if the lan faces the public internet.name (
str
) – The name of the lan.ip_failover (
list
of :class:ProfitBricksIPFailover
) – The IP to fail over.
- Type
lan:
ProfitBricksLan
- Returns
Instance class
ProfitBricksLan
- Return type
- ex_update_load_balancer(load_balancer, name=None, ip=None, dhcp=None)[source]¶
Update a load balancer
- Parameters
load_balancer – The load balancer you wish to update.
name (
str
) – The name of the load balancer.ip (
str
) – The IPV4 address of the load balancer.dhcp (
bool
) – If true, the load balancer will reserve an IP address using DHCP.
- Type
load_balancer:
ProfitBricksLoadBalancer
- Returns
Instance class
ProfitBricksLoadBalancer
- Return type
- ex_update_network_interface(network_interface, name=None, lan_id=None, ips=None, dhcp_active=None)[source]¶
Updates a network interface.
- Parameters
network_interface (
ProfitBricksNetworkInterface
) – The network interface being updated.name (
str
) – The name of the NIC, e.g. PUBLIC.lan_id (:
int
) – The ID for the LAN.ips (
list
) – The IP addresses for the NIC as a list.dhcp_active (
bool
) – Set to false to disable.
- Returns
Instance of class
ProfitBricksNetworkInterface
- Return type
- ex_update_node(node, name=None, cores=None, ram=None, availability_zone=None, ex_licence_type=None, ex_boot_volume=None, ex_boot_cdrom=None, ex_cpu_family=None)[source]¶
Updates a node.
- Parameters
node (
Node
) – The node you wish to update.name (
str
) – The new name for the node.cores (:
int
) – The number of CPUs the node should have.ram (:
int
) – The amount of ram the node should have.availability_zone (
ProfitBricksAvailabilityZone
) – Update the availability zone.ex_licence_type (
str
) – Licence type (WINDOWS, WINDOWS2016, LINUX, OTHER, UNKNOWN).ex_boot_volume (
StorageVolume
) – Setting the new boot (HDD) volume.ex_boot_cdrom (
StorageVolume
) – Setting the new boot (CDROM) volume.ex_cpu_family (
str
) – CPU family (INTEL_XEON, AMD_OPTERON).
- Returns
Instance of class
Node
- Return type
- class
Node
- ex_update_snapshot(snapshot, name=None, description=None, cpu_hot_plug=None, cpu_hot_unplug=None, ram_hot_plug=None, ram_hot_unplug=None, nic_hot_plug=None, nic_hot_unplug=None, disc_virtio_hot_plug=None, disc_virtio_hot_unplug=None, disc_scsi_hot_plug=None, disc_scsi_hot_unplug=None, licence_type=None)[source]¶
Updates a snapshot
- Parameters
snapshot (
VolumeSnapshot
) – The snapshot you’re restoring to the volume.name (str) – The snapshot name
description (str) – The snapshot description
cpu_hot_plug (str) – Snapshot CPU is hot pluggalbe
cpu_hot_unplug (str) – Snapshot CPU is hot unpluggalbe
ram_hot_plug (str) – Snapshot RAM is hot pluggalbe
ram_hot_unplug (str) – Snapshot RAM is hot unpluggalbe
nic_hot_plug (str) – Snapshot Network Interface is hot pluggalbe
nic_hot_unplug (str) – Snapshot Network Interface is hot unpluggalbe
disc_virtio_hot_plug (str) – Snapshot VIRTIO disk is hot pluggalbe
disc_virtio_hot_unplug (str) – Snapshot VIRTIO disk is hot unpluggalbe
disc_scsi_hot_plug (str) – Snapshot SCSI disk is hot pluggalbe
disc_scsi_hot_unplug (str) – Snapshot SCSI disk is hot unpluggalbe
licence_type (str) – The snapshot licence_type
- Returns
Instance of class
VolumeSnapshot
- Return type
VolumeSnapshot
- ex_update_volume(volume, ex_storage_name=None, size=None, ex_bus_type=None)[source]¶
Updates a volume.
- Parameters
volume (
StorageVolume
) – The volume you’re updating.ex_storage_name (
str
) – The name of the volume.size (
int
) – The desired size.ex_bus_type (
str
) – Volume bus type (VIRTIO, IDE).
- Returns
Instance of class
StorageVolume
- Return type
StorageVolume
- list_images(image_type=None, is_public=True)[source]¶
List all images with an optional filter.
- Parameters
image_type (
str
) – The image type (HDD, CDROM)is_public (
bool
) – Image is public
- Returns
list
ofNodeImage
- Return type
list
- list_sizes()[source]¶
Lists all sizes
- Returns
A list of all configurable node sizes.
- Return type
list
ofNodeSize
- list_snapshots()[source]¶
Fetches as a list of all snapshots
- Returns
list
of classVolumeSnapshot
- Return type
list
- list_volumes()[source]¶
List all volumes attached to a data center.
- Returns
list
ofStorageVolume
- Return type
list
- name = 'ProfitBricks'¶
- start_node(node)[source]¶
Starts a node.
- Parameters
node (
Node
) – The node you wish to start.- Return type
bool
- 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
- type = 'profitbricks'¶
- website = 'http://www.profitbricks.com'¶
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.
Initialize user_id and key; set secure to an
int
based on passed value.- 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.
Initialize user_id and key; set secure to an
int
based on passed value.- XML_NAMESPACE = 'http://docs.rackspacecloud.com/servers/api/v1.0'¶
- auth_url = 'https://identity.api.rackspacecloud.com'¶
- cache_busting = True¶
- get_endpoint()[source]¶
Selects the endpoint to use based on provider specific values, or overrides passed in by the user when setting up the driver.
- Returns
url of the relevant endpoint for the driver
- get_service_name()[source]¶
Gets the service name used to look up the endpoint in the service catalog.
- Returns
name of the service in the catalog
- responseCls¶
alias of
libcloud.compute.drivers.openstack.OpenStack_1_0_Response
- class libcloud.compute.drivers.rackspace.RackspaceFirstGenNodeDriver(key, secret=None, secure=True, host=None, port=None, api_version='1.1', **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
libcloud.compute.drivers.rackspace.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, api_version='1.1', **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
libcloud.compute.drivers.rackspace.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
Initialize user_id and key; set secure to an
int
based on passed value.- add_default_headers(headers)[source]¶
Adds default headers (such as Authorization, X-Foo-Bar) to the passed headers
Should return a dictionary.
- api_context = '/r'¶
- host = 'rimuhosting.com'¶
- port = 443¶
- request(action, params=None, data='', headers=None, method='GET')[source]¶
Request a given action.
Basically a wrapper around the connection object’s request that does some helpful pre-processing.
- Parameters
action (
str
) – A path. This can include arguments. If included, any extra parameters are appended to the existing ones.params (
dict
) – Optional mapping of additional parameters to send. If None, leave as an emptydict
.data (
unicode
) – A body of data to send with the request.headers (
dict
) – Extra headers to add to the request None, leave as an emptydict
.method (
str
) – An HTTP method such as “GET” or “POST”.raw (
bool
) – True to perform a “raw” request aka only send the headers and use the rawResponseCls class. This is used with storage API when uploading a file.stream (
bool
) – True to return an iterator in Response.iter_content and allow streaming of the response data (for downloading large files)retry_failed – True if failed requests should be retried. This argument can override module level constant and environment variable value on per-request basis.
- Returns
An
Response
instance.- Return type
Response
instance
- responseCls¶
alias of
libcloud.compute.drivers.rimuhosting.RimuHostingResponse
- exception libcloud.compute.drivers.rimuhosting.RimuHostingException[source]¶
Bases:
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 connectionport (
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
libcloud.compute.drivers.rimuhosting.RimuHostingConnection
- create_node(name, size, image, auth=None, ex_billing_oid=None, ex_host_server_oid=None, ex_vps_order_oid_to_clone=None, ex_num_ips=1, ex_extra_ip_reason=None, ex_memory_mb=None, ex_disk_space_mb=None, ex_disk_space_2_mb=None, ex_control_panel=None)[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.
- destroy_node(node)[source]¶
Destroy a node.
Depending upon the provider, this may destroy all data associated with the node, including backups.
- Parameters
node (
Node
) – The node to be destroyed- Returns
True if the destroy was successful, False otherwise.
- Return type
bool
- features = {'create_node': ['password']}¶
- List of available features for a driver.
libcloud.compute.base.NodeDriver.create_node()
ssh_key: Supports
NodeAuthSSHKey
as an authentication method for nodes.password: Supports
NodeAuthPassword
as an authentication method for nodes.generates_password: Returns a password attribute on the Node object returned from creation.
- list_images(location=None)[source]¶
List images on a provider.
- Parameters
location (
NodeLocation
) – The location at which to list images.- Returns
list of node image objects.
- Return type
list
ofNodeImage
- list_locations()[source]¶
List data centers for a provider
- Returns
list of node location objects
- Return type
list
ofNodeLocation
- list_sizes(location=None)[source]¶
List sizes on a provider
- Parameters
location (
NodeLocation
) – The location at which to list sizes- Returns
list of node size objects
- Return type
list
ofNodeSize
- name = 'RimuHosting'¶
- reboot_node(node)[source]¶
Reboot a node.
- Parameters
node (
Node
) – The node to be rebooted- Returns
True if the reboot was successful, otherwise False
- Return type
bool
- type = 'rimuhosting'¶
- website = 'http://rimuhosting.com/'¶
- 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.
libcloud.compute.drivers.scaleway module¶
Scaleway Driver
- class libcloud.compute.drivers.scaleway.ScalewayConnection(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 Scaleway driver.
Initialize user_id and key; set secure to an
int
based on passed value.- allow_insecure = False¶
- host = 'cp-par1.scaleway.com'¶
- request(action, params=None, data=None, headers=None, method='GET', raw=False, stream=False, region=None)[source]¶
Request a given action.
Basically a wrapper around the connection object’s request that does some helpful pre-processing.
- Parameters
action (
str
) – A path. This can include arguments. If included, any extra parameters are appended to the existing ones.params (
dict
) – Optional mapping of additional parameters to send. If None, leave as an emptydict
.data (
unicode
) – A body of data to send with the request.headers (
dict
) – Extra headers to add to the request None, leave as an emptydict
.method (
str
) – An HTTP method such as “GET” or “POST”.raw (
bool
) – True to perform a “raw” request aka only send the headers and use the rawResponseCls class. This is used with storage API when uploading a file.stream (
bool
) – True to return an iterator in Response.iter_content and allow streaming of the response data (for downloading large files)retry_failed – True if failed requests should be retried. This argument can override module level constant and environment variable value on per-request basis.
- Returns
An
Response
instance.- Return type
Response
instance
- responseCls¶
- class libcloud.compute.drivers.scaleway.ScalewayNodeDriver(key, secret=None, secure=True, host=None, port=None, api_version=None, region=None, **kwargs)[source]¶
Bases:
libcloud.compute.base.NodeDriver
Scaleway Node Driver Class
This is the primary driver for interacting with Scaleway. It contains all of the standard libcloud methods that Scaleway’s API supports.
- 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
- SNAPSHOT_STATE_MAP = {'available': VolumeSnapshotState.AVAILABLE, 'error': VolumeSnapshotState.ERROR, 'snapshotting': VolumeSnapshotState.CREATING}¶
- connectionCls¶
alias of
libcloud.compute.drivers.scaleway.ScalewayConnection
- create_image(node, name, region=None)[source]¶
Create a VM image from an existing node’s root volume.
- Parameters
node (
Node
) – The node from which to create the imagename (
str
) – The name to give the imageregion – The region in which to create the image
(if None, use default region specified in __init__) :type region:
NodeLocation
- Returns
the newly created image object
- Return type
- create_node(name, size, image, ex_volumes=None, ex_tags=None, region=None)[source]¶
Create a new node.
- Parameters
name (
str
) – The name to give the nodesize (
NodeSize
) – The size of node to createimage (
NodeImage
) – The image to create the node withex_volumes (
dict
of :class:`.StorageVolume`s) – Additional volumes to create the node withex_tags (
list
ofstr
) – Tags to assign to the noderegion – The region in which to create the node
(if None, use default region specified in __init__) :type region:
NodeLocation
- Returns
the newly created node object
- Return type
- create_volume(size, name, region=None)[source]¶
Create a new volume.
- Parameters
size (
int
) – Size of volume in gigabytes.name (
str
) – Name of the volume to be created.region – The region in which to create the volume
(if None, use default region specified in __init__) :type region:
NodeLocation
- Returns
The newly created volume.
- Return type
StorageVolume
- create_volume_snapshot(volume, name, region=None)[source]¶
Create snapshot from volume.
- Parameters
volume (:class`StorageVolume`) – The volume to create a snapshot from
name (
str
) – The name to give the snapshotregion – The region in which to create the snapshot
(if None, use default region specified in __init__) :type region:
NodeLocation
- Returns
The newly created snapshot.
- Return type
VolumeSnapshot
- delete_image(node_image, region=None)[source]¶
Delete a VM image.
- Parameters
node_image (
NodeImage
) – The image to deleteregion – The region in which to find/delete the image
(if None, use default region specified in __init__) :type region:
NodeLocation
- Returns
True if the image was deleted, otherwise False
- Return type
bool
- delete_key_pair(key_pair)[source]¶
Delete an existing key pair.
- Parameters
key_pair (
KeyPair
) – Key pair object.- Returns
True of False based on success of Keypair deletion
- Return type
bool
- destroy_node(node)[source]¶
Destroy a node.
- Parameters
node (
Node
) – The node to be destroyed- Returns
True if the destroy was successful, otherwise False
- Return type
bool
- destroy_volume(volume, region=None)[source]¶
Destroys a storage volume.
- Parameters
volume (
StorageVolume
) – Volume to be destroyedregion – The region in which to look for the volume
(if None, use default region specified in __init__) :type region:
NodeLocation
- Returns
True if the destroy was successful, otherwise False
- Return type
bool
- destroy_volume_snapshot(snapshot, region=None)[source]¶
Dostroy a volume snapshot
- Parameters
snapshot (class:VolumeSnapshot) – volume snapshot to destroy
region – The region in which to look for the snapshot
(if None, use default region specified in __init__) :type region:
NodeLocation
- Returns
True if the destroy was successful, otherwise False
- Return type
bool
- get_image(image_id, region=None)[source]¶
Retrieve a specific VM image.
- Parameters
image_id (
int
) – The id of the image to retrieveregion – The region in which to create the image
(if None, use default region specified in __init__) :type region:
NodeLocation
- Returns
the requested image object
- Return type
- 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
KeyPair
- list_images(region=None)[source]¶
List available VM images.
- Parameters
region – The region in which to list images
(if None, use default region specified in __init__) :type region:
NodeLocation
- Returns
list of image objects
- Return type
list
ofNodeImage
- list_key_pairs()[source]¶
List all the available SSH keys.
- Returns
Available SSH keys.
- Return type
list
ofKeyPair
- list_locations()[source]¶
List data centers available.
- Returns
list of node location objects
- Return type
list
ofNodeLocation
- list_nodes(region=None)[source]¶
List all nodes.
- Parameters
region – The region in which to look for nodes
(if None, use default region specified in __init__) :type region:
NodeLocation
- Returns
list of node objects
- Return type
list
ofNode
- list_sizes(region=None)[source]¶
List available VM sizes.
- Parameters
region – The region in which to list sizes
(if None, use default region specified in __init__) :type region:
NodeLocation
- Returns
list of node size objects
- Return type
list
ofNodeSize
- list_volume_snapshots(volume, region=None)[source]¶
List snapshots for a storage volume.
@inherits
NodeDriver.list_volume_snapshots
- Parameters
region – The region in which to look for snapshots
(if None, use default region specified in __init__) :type region:
NodeLocation
- list_volumes(region=None)[source]¶
Return a list of volumes.
- Parameters
region – The region in which to look for volumes
(if None, use default region specified in __init__) :type region:
NodeLocation
- Returns
A list of volume objects.
- Return type
list
ofStorageVolume
- name = 'Scaleway'¶
- reboot_node(node)[source]¶
Reboot a node.
- Parameters
node (
Node
) – The node to be rebooted- Returns
True if the reboot was successful, otherwise False
- Return type
bool
- type = 'scaleway'¶
- website = 'https://www.scaleway.com/'¶
- class libcloud.compute.drivers.scaleway.ScalewayResponse(response, connection)[source]¶
Bases:
libcloud.common.base.JsonResponse
- Parameters
response (
httplib.HTTPResponse
) – HTTP response object. (optional)connection (
Connection
) – Parent connection object.
- parse_error()[source]¶
Parse the error messages.
Override in a provider’s subclass.
- Returns
Parsed error.
- Return type
str
- success()[source]¶
Determine if our request was successful.
The meaning of this can be arbitrary; did we receive OK status? Did the node get created? Were we authenticated?
- Return type
bool
- Returns
True
orFalse
- valid_response_codes = [<HTTPStatus.OK: 200>, <HTTPStatus.ACCEPTED: 202>, <HTTPStatus.CREATED: 201>, <HTTPStatus.NO_CONTENT: 204>]¶
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
Initialize user_id and key; set secure to an
int
based on passed value.- 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
libcloud.compute.drivers.serverlove.ServerLoveConnection
- features = {'create_node': ['generates_password']}¶
- List of available features for a driver.
libcloud.compute.base.NodeDriver.create_node()
ssh_key: Supports
NodeAuthSSHKey
as an authentication method for nodes.password: Supports
NodeAuthPassword
as an authentication method for nodes.generates_password: Returns a password attribute on the Node object returned from creation.
- name = 'ServerLove'¶
- type = 'serverlove'¶
- website = 'http://www.serverlove.com/'¶
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
Initialize user_id and key; set secure to an
int
based on passed value.- 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
libcloud.compute.drivers.skalicloud.SkaliCloudConnection
- features = {'create_node': ['generates_password']}¶
- List of available features for a driver.
libcloud.compute.base.NodeDriver.create_node()
ssh_key: Supports
NodeAuthSSHKey
as an authentication method for nodes.password: Supports
NodeAuthPassword
as an authentication method for nodes.generates_password: Returns a password attribute on the Node object returned from creation.
- name = 'skalicloud'¶
- type = 'skalicloud'¶
- website = 'http://www.skalicloud.com/'¶
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¶
- create_key_pair(name, ex_size=4096)[source]¶
Create a new key pair object.
- Parameters
name (
str
) – Key pair name.- Return type
KeyPair
object
- create_node(name, size=None, image=None, location=None, ex_domain=None, ex_cpus=None, ex_disk=None, ex_ram=None, ex_bandwidth=None, ex_local_disk=None, ex_datacenter=None, ex_os=None, ex_keyname=None, ex_hourly=True)[source]¶
Create a new SoftLayer node
@inherits:
NodeDriver.create_node
- Parameters
ex_domain (
str
) – e.g. libcloud.orgex_cpus (
int
) – e.g. 2ex_disk (
int
) – e.g. 100ex_ram (
int
) – e.g. 2048ex_bandwidth (
int
) – e.g. 100ex_local_disk (
bool
) – e.g. Trueex_datacenter (
str
) – e.g. Dal05ex_os (
str
) – e.g. UBUNTU_LATESTex_keyname (
str
) – The name of the key pair
- delete_key_pair(key_pair)[source]¶
Delete an existing key pair.
- Parameters
key_pair (
KeyPair
) – Key pair object.- Return type
bool
- destroy_node(node)[source]¶
Destroy a node.
Depending upon the provider, this may destroy all data associated with the node, including backups.
- Parameters
node (
Node
) – The node to be destroyed- Returns
True if the destroy was successful, False otherwise.
- Return type
bool
- features = {'create_node': ['generates_password', 'ssh_key']}¶
- List of available features for a driver.
libcloud.compute.base.NodeDriver.create_node()
ssh_key: Supports
NodeAuthSSHKey
as an authentication method for nodes.password: Supports
NodeAuthPassword
as an authentication method for nodes.generates_password: Returns a password attribute on the Node object returned from creation.
- get_image(image_id)[source]¶
Gets an image based on an image_id.
- Parameters
image_id (
str
) – Image identifier- Returns
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
- 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.
- Return type
KeyPair
object
- list_images(location=None)[source]¶
List images on a provider.
- Parameters
location (
NodeLocation
) – The location at which to list images.- Returns
list of node image objects.
- Return type
list
ofNodeImage
- list_key_pairs()[source]¶
List all the available key pair objects.
- Return type
list
ofKeyPair
objects
- list_locations()[source]¶
List data centers for a provider
- Returns
list of node location objects
- Return type
list
ofNodeLocation
- list_sizes(location=None)[source]¶
List sizes on a provider
- Parameters
location (
NodeLocation
) – The location at which to list sizes- Returns
list of node size objects
- Return type
list
ofNodeSize
- name = 'SoftLayer'¶
- reboot_node(node)[source]¶
Reboot a node.
- Parameters
node (
Node
) – The node to be rebooted- Returns
True if the reboot was successful, otherwise False
- Return type
bool
- start_node(node)[source]¶
Start a node.
- Parameters
node (
Node
) – The node to be started- Returns
True if the start was successful, otherwise False
- Return type
bool
- stop_node(node)[source]¶
Stop a node
- Parameters
node (
Node
) – The node to be stopped.- Returns
True if the stop was successful, otherwise False
- Return type
bool
- type = 'softlayer'¶
- website = 'http://www.softlayer.com/'¶
libcloud.compute.drivers.upcloud module¶
Upcloud node driver
- class libcloud.compute.drivers.upcloud.UpcloudConnection(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 UpcloudDriver
Initialize user_id and key; set secure to an
int
based on passed value.- host = 'api.upcloud.com'¶
- responseCls¶
- class libcloud.compute.drivers.upcloud.UpcloudDriver(username, password, **kwargs)[source]¶
Bases:
libcloud.compute.base.NodeDriver
Upcloud node driver
- Parameters
username (
str
) – Username required for authenticationpassword (
str
) – Password required for authenticationkey (
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 = {'error': NodeState.ERROR, 'maintenance': NodeState.RECONFIGURING, 'started': NodeState.RUNNING, 'stopped': NodeState.STOPPED}¶
- connectionCls¶
- create_node(name, size, image, location, auth=None, ex_hostname='localhost', ex_username='root')[source]¶
Creates instance to upcloud.
If auth is not given then password will be generated.
- 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)location (
NodeLocation
) – Which data center to create a node in. If empty, undefined behavior will be selected. (optional)auth (
NodeAuthSSHKey
) – Initial authentication information for the node (optional)ex_hostname (
str
) – Hostname. Default is ‘localhost’. (optional)ex_username (
str
) – User’s username, which is created. Default is ‘root’. (optional)
- Returns
The newly created node.
- Return type
- destroy_node(node)[source]¶
Destroy the given node
The disk resources, attached to node, will not be removed.
- Parameters
node (
Node
) – the node to destroy- Return type
bool
- features = {'create_node': ['ssh_key', 'generates_password']}¶
- List of available features for a driver.
libcloud.compute.base.NodeDriver.create_node()
ssh_key: Supports
NodeAuthSSHKey
as an authentication method for nodes.password: Supports
NodeAuthPassword
as an authentication method for nodes.generates_password: Returns a password attribute on the Node object returned from creation.
- list_sizes(location=None)[source]¶
List available plans
- Parameters
location – Location of the deployement. Price depends on
location. lf location is not given or price not found for location, price will be None (optional) :type location:
NodeLocation
- Return type
list
ofNodeSize
- name = 'Upcloud'¶
- reboot_node(node)[source]¶
Reboot the given node
- Parameters
node (
Node
) – the node to reboot- Return type
bool
- type = 'upcloud'¶
- website = 'https://www.upcloud.com'¶
- class libcloud.compute.drivers.upcloud.UpcloudResponse(response, connection)[source]¶
Bases:
libcloud.common.base.JsonResponse
Response class for UpcloudDriver
- Parameters
response (
httplib.HTTPResponse
) – HTTP response object. (optional)connection (
Connection
) – Parent connection object.
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
Initialize user_id and key; set secure to an
int
based on passed value.- add_default_headers(headers)[source]¶
Adds default headers (such as Authorization, X-Foo-Bar) to the passed headers
Should return a dictionary.
- 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 = {'error': NodeState.UNKNOWN, 'failed': NodeState.TERMINATED, 'future': NodeState.PENDING, 'loading': NodeState.PENDING, 'notavailable': NodeState.TERMINATED, 'notready': NodeState.PENDING, 'ready': NodeState.RUNNING, 'success': NodeState.PENDING, 'time': NodeState.PENDING, 'timedout': NodeState.TERMINATED}¶
- connectionCls¶
- create_node(image, start=None, length='60')[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_imagestart (
str
) – start time as unix timestamplength (
str
) – length of time in minutes
- destroy_node(node)[source]¶
End VCL reservation for the node passed in. Throws error if request fails.
- Parameters
node (
Node
) – The node to be destroyed- Return 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 updateminutes (
str
) – the number of mintes to update
- Returns
true on success, throws error on failure
- Return type
bool
- ex_get_request_end_time(node)[source]¶
Get the ending time of the node reservation.
- Parameters
node (
Node
) – the reservation node to update- Returns
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 updateipaddr (
str
) – the ipaddr used to access the node
- Returns
node with updated information
- Return type
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 used- Return 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/'¶
- 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'>}¶
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
Initialize user_id and key; set secure to an
int
based on passed value.- host = 'vcloud.safesecureweb.com'¶
- class libcloud.compute.drivers.vcloud.HostingComDriver(key, secret=None, secure=True, host=None, port=None, api_version='0.8', **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
libcloud.compute.drivers.vcloud.HostingComConnection
- 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, description=None)[source]¶
Bases:
object
- class libcloud.compute.drivers.vcloud.Lease(lease_id, deployment_lease=None, storage_lease=None, deployment_lease_expiration=None, storage_lease_expiration=None)[source]¶
Bases:
object
Lease information for vApps.
- More info at: ‘https://www.vmware.com/support/vcd/doc/
rest-api-doc-1.5-html/types/LeaseSettingsSectionType.html’
- Parameters
lease_id (
str
) – ID (link) to the lease settings section of a vApp.deployment_lease (
int
orNone
) – Deployment lease time in secondsstorage_lease (
int
orNone
) – Storage lease time in secondsdeployment_lease_expiration (
datetime.datetime
orNone
) – Deployment lease expiration timestorage_lease_expiration (
datetime.datetime
orNone
) – Storage lease expiration time
- 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
Initialize user_id and key; set secure to an
int
based on passed value.- host = 'services.vcloudexpress.terremark.com'¶
- class libcloud.compute.drivers.vcloud.TerremarkDriver(key, secret=None, secure=True, host=None, port=None, api_version='0.8', **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
libcloud.compute.drivers.vcloud.TerremarkConnection
- list_locations()[source]¶
List data centers for a provider
- Returns
list of node location objects
- Return type
list
ofNodeLocation
- 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
Initialize user_id and key; set secure to an
int
based on passed value.- add_default_headers(headers)[source]¶
Adds default headers (such as Authorization, X-Foo-Bar) to the passed headers
Should return a dictionary.
- host = None¶
- request(*args, **kwargs)[source]¶
Request a given action.
Basically a wrapper around the connection object’s request that does some helpful pre-processing.
- Parameters
action (
str
) – A path. This can include arguments. If included, any extra parameters are appended to the existing ones.params (
dict
) – Optional mapping of additional parameters to send. If None, leave as an emptydict
.data (
unicode
) – A body of data to send with the request.headers (
dict
) – Extra headers to add to the request None, leave as an emptydict
.method (
str
) – An HTTP method such as “GET” or “POST”.raw (
bool
) – True to perform a “raw” request aka only send the headers and use the rawResponseCls class. This is used with storage API when uploading a file.stream (
bool
) – True to return an iterator in Response.iter_content and allow streaming of the response data (for downloading large files)retry_failed – True if failed requests should be retried. This argument can override module level constant and environment variable value on per-request basis.
- Returns
An
Response
instance.- Return type
Response
instance
- responseCls¶
- token = None¶
- class libcloud.compute.drivers.vcloud.VCloudNodeDriver(key, secret=None, secure=True, host=None, port=None, api_version='0.8', **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 = {'0': NodeState.PENDING, '1': NodeState.PENDING, '2': NodeState.PENDING, '3': NodeState.PENDING, '4': NodeState.RUNNING}¶
- connectionCls¶
- create_node(name, size, image, auth=None, ex_network=None, ex_vdc=None, ex_cpus=1, ex_row=None, ex_group=None)[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)
- destroy_node(node)[source]¶
Destroy a node.
Depending upon the provider, this may destroy all data associated with the node, including backups.
- Parameters
node (
Node
) – The node to be destroyed- Returns
True if the destroy was successful, False otherwise.
- Return type
bool
- 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']}¶
- List of available features for a driver.
libcloud.compute.base.NodeDriver.create_node()
ssh_key: Supports
NodeAuthSSHKey
as an authentication method for nodes.password: Supports
NodeAuthPassword
as an authentication method for nodes.generates_password: Returns a password attribute on the Node object returned from creation.
- list_images(location=None)[source]¶
List images on a provider.
- Parameters
location (
NodeLocation
) – The location at which to list images.- Returns
list of node image objects.
- Return type
list
ofNodeImage
- list_sizes(location=None)[source]¶
List sizes on a provider
- Parameters
location (
NodeLocation
) – The location at which to list sizes- Returns
list of node size objects
- Return type
list
ofNodeSize
- name = 'vCloud'¶
- property networks¶
- org = None¶
- reboot_node(node)[source]¶
Reboot a node.
- Parameters
node (
Node
) – The node to be rebooted- Returns
True if the reboot was successful, otherwise False
- Return type
bool
- type = 'vcloud'¶
- property vdcs¶
vCloud virtual data centers (vDCs).
- Returns
list of vDC objects
- Return type
list
ofVdc
- website = 'http://www.vmware.com/products/vcloud/'¶
- 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.
- 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]¶
Bases:
libcloud.compute.drivers.vcloud.VCloudConnection
Initialize user_id and key; set secure to an
int
based on passed value.
- class libcloud.compute.drivers.vcloud.VCloud_1_5_NodeDriver(key, secret=None, secure=True, host=None, port=None, api_version='0.8', **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 = {'-1': NodeState.UNKNOWN, '0': NodeState.PENDING, '1': NodeState.PENDING, '10': NodeState.UNKNOWN, '2': NodeState.PENDING, '3': NodeState.PENDING, '4': NodeState.RUNNING, '5': NodeState.RUNNING, '6': NodeState.UNKNOWN, '7': NodeState.UNKNOWN, '8': NodeState.STOPPED, '9': NodeState.UNKNOWN}¶
- connectionCls¶
alias of
libcloud.compute.drivers.vcloud.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_script_text (
str
) – content of guest customisation script for each vApp VM. Overrides ex_vm_script parameter.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 creationex_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_description (
str
) – Set a description for the vApp.
- destroy_node(node, shutdown=True)[source]¶
Destroy a node.
Depending upon the provider, this may destroy all data associated with the node, including backups.
- Parameters
node (
Node
) – The node to be destroyed- Returns
True if the destroy was successful, False otherwise.
- Return type
bool
- 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 modifiedvm_disk_size (
int
) – the disk capacity in GB that will be added to the specified VM or VMs
- Return type
None
- 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 modifiedex_admin_password (
str
) – admin password to be used.
- Return type
None
- ex_deploy_node(node, ex_force_customization=False)[source]¶
Deploys existing node. Equal to vApp “start” operation.
- Parameters
node (
Node
) – The node to be deployedex_force_customization (
bool
) – Used to specify whether to force customization on deployment, if not set default value is False.
- Return type
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 forvdcs (
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
- ex_find_vm_nodes(vm_name, max_results=50)[source]¶
Finds nodes that contain a VM with the specified name.
- Parameters
vm_name (
str
) – The VM name to find nodes formax_results (
int
) – Maximum number of results up to 128
- Returns
List of node instances
- Return type
list of
Node
- ex_get_control_access(node)[source]¶
Returns the control access settings for specified node.
- Parameters
node (
Node
) – node to get the control access for- Return type
- ex_get_metadata(node)[source]¶
- Parameters
node (
Node
) – node- Returns
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 off- Return 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 on- Return 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 numberpage_size (
int
) – page sizesort_asc (
str
) – sort in ascending order by specified fieldsort_desc (
str
) – sort in descending order by specified field
- Return type
list
of dict
- ex_set_control_access(node, control_access)[source]¶
Sets control access for the specified node.
- Parameters
node (
Node
) – nodecontrol_access (
ControlAccess
) – control access settings
- Return type
None
- ex_set_metadata_entry(node, key, value)[source]¶
- Parameters
node (
Node
) – nodekey (
str
) – metadata key to be setvalue (
str
) – metadata value to be set
- Return type
None
- 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 modifiedvm_cpu (
int
) – number of virtual CPUs/cores to allocate for specified VMs
- Return type
None
- 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 modifiedvm_memory (
int
) – virtual memory in MB to allocate for the specified VM or VMs
- Return type
None
- 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 down- Return 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 suspended- Return type
Node
- ex_undeploy_node(node, shutdown=True)[source]¶
Undeploys existing node. Equal to vApp “stop” operation.
- Parameters
node (
Node
) – The node to be deployedshutdown (
bool
) – Whether to shutdown or power off the guest when undeploying
- Return type
Node
- list_locations()[source]¶
List data centers for a provider
- Returns
list of node location objects
- Return type
list
ofNodeLocation
- class libcloud.compute.drivers.vcloud.VCloud_5_1_NodeDriver(key, secret=None, secure=True, host=None, port=None, api_version='0.8', **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
- 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
Initialize user_id and key; set secure to an
int
based on passed value.
- class libcloud.compute.drivers.vcloud.VCloud_5_5_NodeDriver(key, secret=None, secure=True, host=None, port=None, api_version='0.8', **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
libcloud.compute.drivers.vcloud.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
) – node- Return type
Node
- 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
Initialize user_id and key; set secure to an
int
based on passed value.- add_default_params(params)[source]¶
Adds default parameters (such as API key, version, etc.) to the passed params
Should return a dictionary.
- host = 'api.voxel.net'¶
- responseCls¶
- 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¶
- create_node(name, size, image, location, ex_privateip=None, ex_publicip=None, ex_rootpass=None, ex_consolepass=None, ex_sshuser=None, ex_sshpass=None, ex_voxel_access=None)[source]¶
Create Voxel Node
- Parameters
name (
str
) – the name to assign the node (mandatory)image (
NodeImage
) – distribution to deploysize (
NodeSize
) – the plan size to create (mandatory) Requires size.disk (GB) to be set manuallylocation (
NodeLocation
) – which datacenter to create the node inex_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 accessex_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
- destroy_node(node)[source]¶
Destroy a node.
Depending upon the provider, this may destroy all data associated with the node, including backups.
- Parameters
node (
Node
) – The node to be destroyed- Returns
True if the destroy was successful, False otherwise.
- Return type
bool
- features = {'create_node': [], 'list_sizes': ['variable_disk']}¶
- List of available features for a driver.
libcloud.compute.base.NodeDriver.create_node()
ssh_key: Supports
NodeAuthSSHKey
as an authentication method for nodes.password: Supports
NodeAuthPassword
as an authentication method for nodes.generates_password: Returns a password attribute on the Node object returned from creation.
- list_images(location=None)[source]¶
List images on a provider.
- Parameters
location (
NodeLocation
) – The location at which to list images.- Returns
list of node image objects.
- Return type
list
ofNodeImage
- list_locations()[source]¶
List data centers for a provider
- Returns
list of node location objects
- Return type
list
ofNodeLocation
- list_sizes(location=None)[source]¶
List sizes on a provider
- Parameters
location (
NodeLocation
) – The location at which to list sizes- Returns
list of node size objects
- Return type
list
ofNodeSize
- name = 'Voxel VoxCLOUD'¶
- reboot_node(node)[source]¶
Reboot a node.
- Parameters
node (
Node
) – The node to be rebooted- Returns
True if the reboot was successful, otherwise False
- Return type
bool
- type = 'voxel'¶
- website = 'http://www.voxel.net/'¶
- class libcloud.compute.drivers.voxel.VoxelResponse(response, connection)[source]¶
Bases:
libcloud.common.base.XmlResponse
- Parameters
response (
httplib.HTTPResponse
) – HTTP response object. (optional)connection (
Connection
) – Parent connection object.
- parse_body()[source]¶
Parse response body.
Override in a provider’s subclass.
- Returns
Parsed body.
- Return type
str
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
Initialize user_id and key; set secure to an
int
based on passed value.- add_default_headers(headers)[source]¶
Adds default headers (such as Authorization, X-Foo-Bar) to the passed headers
Should return a dictionary.
- allow_insecure = False¶
- host = 'api.vps.net'¶
- responseCls¶
- 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¶
- create_node(name, image, size, ex_backups_enabled=False, ex_fqdn=None)[source]¶
Create a new VPS.net node
@inherits:
NodeDriver.create_node
- Parameters
ex_backups_enabled (
bool
) – Enable automatic backupsex_fqdn (
str
) – Fully Qualified domain of the node
- destroy_node(node)[source]¶
Destroy a node.
Depending upon the provider, this may destroy all data associated with the node, including backups.
- Parameters
node (
Node
) – The node to be destroyed- Returns
True if the destroy was successful, False otherwise.
- Return type
bool
- list_images(location=None)[source]¶
List images on a provider.
- Parameters
location (
NodeLocation
) – The location at which to list images.- Returns
list of node image objects.
- Return type
list
ofNodeImage
- list_locations()[source]¶
List data centers for a provider
- Returns
list of node location objects
- Return type
list
ofNodeLocation
- list_sizes(location=None)[source]¶
List sizes on a provider
- Parameters
location (
NodeLocation
) – The location at which to list sizes- Returns
list of node size objects
- Return type
list
ofNodeSize
- name = 'vps.net'¶
- reboot_node(node)[source]¶
Reboot a node.
- Parameters
node (
Node
) – The node to be rebooted- Returns
True if the reboot was successful, otherwise False
- Return type
bool
- type = 'vpsnet'¶
- website = 'http://vps.net/'¶
- 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.
- parse_body()[source]¶
Parse response body.
Override in a provider’s subclass.
- Returns
Parsed body.
- Return type
str
libcloud.compute.drivers.vsphere module¶
VMware vSphere driver. Uses pyvmomi - https://github.com/vmware/pyvmomi Code inspired by https://github.com/vmware/pyvmomi-community-samples
Authors: Dimitris Moraitis, Alex Tsiliris, Markos Gogoulos
- class libcloud.compute.drivers.vsphere.VSphereConnection(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
Initialize user_id and key; set secure to an
int
based on passed value.- add_default_headers(headers)[source]¶
VSphere needs an initial connection to a specific API endpoint to generate a session-token, which will be used for the purpose of authenticating for the rest of the session.
- responseCls¶
- session_token = None¶
- exception libcloud.compute.drivers.vsphere.VSphereException(code, message)[source]¶
Bases:
Exception
- class libcloud.compute.drivers.vsphere.VSphereNetwork(id, name, extra=None)[source]¶
Bases:
object
Represents information about a VPC (Virtual Private Cloud) network
Note: This class is VSphere specific.
- class libcloud.compute.drivers.vsphere.VSphereNodeDriver(host, username, password, port=443, ca_cert=None)[source]¶
Bases:
libcloud.compute.base.NodeDriver
Initialize a connection by providing a hostname, username and password
- NODE_STATE_MAP = {'poweredOff': NodeState.STOPPED, 'poweredOn': NodeState.RUNNING, 'suspended': NodeState.SUSPENDED}¶
- create_node(name, image, size, location=None, ex_cluster=None, ex_network=None, ex_datacenter=None, ex_folder=None, ex_resource_pool=None, ex_datastore_cluster=None, ex_datastore=None)[source]¶
Creates and returns node.
- Parameters
ex_network (
str
) – Name of a “Network” to connect the VM to “,
- ex_create_snapshot(node, snapshot_name, description='', dump_memory=False, quiesce=False)[source]¶
Create node snapshot
- ex_remove_snapshot(node, snapshot_name=None, remove_children=True)[source]¶
Remove a snapshot from node. If snapshot_name is not defined remove the last one.
- ex_revert_to_snapshot(node, snapshot_name=None)[source]¶
Revert node to a specific snapshot. If snapshot_name is not defined revert to the last one.
- find_by_uuid(node_uuid)[source]¶
Searches VMs for a given uuid returns pyVmomi.VmomiSupport.vim.VirtualMachine
- get_obj(vimtype, name)[source]¶
Return an object by name, if name is None the first found object is returned
- list_images(location=None, folder_ids=None)[source]¶
Lists VM templates as images. If folder is given then it will list images contained in that folder only.
- name = 'VMware vSphere'¶
- type = 'vsphere'¶
- website = 'http://www.vmware.com/products/vsphere/'¶
- class libcloud.compute.drivers.vsphere.VSphereResponse(response, connection)[source]¶
Bases:
libcloud.common.base.JsonResponse
- Parameters
response (
httplib.HTTPResponse
) – HTTP response object. (optional)connection (
Connection
) – Parent connection object.
- class libcloud.compute.drivers.vsphere.VSphere_REST_NodeDriver(key, secret=None, secure=True, host=None, port=443, ca_cert=None)[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
- NODE_STATE_MAP = {'powered_off': NodeState.STOPPED, 'powered_on': NodeState.RUNNING, 'suspended': NodeState.SUSPENDED}¶
- VALID_RESPONSE_CODES = [<HTTPStatus.OK: 200>, <HTTPStatus.ACCEPTED: 202>, <HTTPStatus.CREATED: 201>, <HTTPStatus.NO_CONTENT: 204>]¶
- async_list_nodes()[source]¶
In this case filtering is not possible. Use this method when the cloud has a lot of vms and you want to return them all.
- connectionCls¶
- create_node(name, image, size=None, location=None, ex_datastore=None, ex_disks=None, ex_folder=None, ex_network=None, ex_turned_on=True)[source]¶
Image can be either a vm template , a ovf template or just the guest OS.
ex_folder is necessary if the image is a vm-template, this method will attempt to put the VM in a random folder and a warning about it will be issued in case the value remains None.
- destroy_node(node)[source]¶
Destroy a node.
Depending upon the provider, this may destroy all data associated with the node, including backups.
- Parameters
node (
Node
) – The node to be destroyed- Returns
True if the destroy was successful, False otherwise.
- Return type
bool
- ex_add_nic(node, network)[source]¶
Creates a network adapater that will connect to the specified network for the given node. Returns a boolean indicating success or not.
- ex_create_snapshot(node, snapshot_name, description='', dump_memory=False, quiesce=False)[source]¶
Create node snapshot
- ex_list_clusters(ex_filter_folders=None, ex_filter_names=None, ex_filter_datacenters=None, ex_filter_clusters=None)[source]¶
- ex_list_datacenters(ex_filter_folders=None, ex_filter_names=None, ex_filter_datacenters=None)[source]¶
- ex_list_datastores(ex_filter_folders=None, ex_filter_names=None, ex_filter_datacenters=None, ex_filter_types=None, ex_filter_datastores=None)[source]¶
- ex_list_hosts(ex_filter_folders=None, ex_filter_standalone=None, ex_filter_hosts=None, ex_filter_clusters=None, ex_filter_names=None, ex_filter_datacenters=None, ex_filter_connection_states=None)[source]¶
- ex_remove_snapshot(node, snapshot_name=None, remove_children=True)[source]¶
Remove a snapshot from node. If snapshot_name is not defined remove the last one.
- ex_revert_to_snapshot(node, snapshot_name=None)[source]¶
Revert node to a specific snapshot. If snapshot_name is not defined revert to the last one.
- ex_update_cpu(node, cores)[source]¶
Assuming 1 Core per socket :param cores: Integer or string indicating number of cores :type cores: int or str
- list_images(**kwargs)[source]¶
List images on a provider.
- Parameters
location (
NodeLocation
) – The location at which to list images.- Returns
list of node image objects.
- Return type
list
ofNodeImage
- list_locations(ex_show_hosts_in_drs=True)[source]¶
Location in the general sense means any resource that allows for node creation. In vSphere’s case that usually is a host but if a cluster has rds enabled, a cluster can be assigned to create the VM, thus the clusters with rds enabled will be added to locations.
- Parameters
ex_show_hosts_in_drs (boolean) – A DRS cluster schedules automatically on which host should be placed thus it may not be desired to show the hosts in a DRS enabled cluster. Set False to not show these hosts.
- list_nodes(ex_filter_power_states=None, ex_filter_folders=None, ex_filter_names=None, ex_filter_hosts=None, ex_filter_clusters=None, ex_filter_vms=None, ex_filter_datacenters=None, ex_filter_resource_pools=None, max_properties=20)[source]¶
The ex parameters are search options and must be an array of strings, even ex_filter_power_states which can have at most two items but makes sense to keep only one (“POWERED_ON” or “POWERED_OFF”) Keep in mind that this method will return up to 1000 nodes so if your network has more, do use the provided filters and call it multiple times.
- list_sizes()[source]¶
List sizes on a provider
- Parameters
location (
NodeLocation
) – The location at which to list sizes- Returns
list of node size objects
- Return type
list
ofNodeSize
- name = 'VMware vSphere'¶
- reboot_node(node)[source]¶
Reboot a node.
- Parameters
node (
Node
) – The node to be rebooted- Returns
True if the reboot was successful, otherwise False
- Return type
bool
- session_token = None¶
- start_node(node)[source]¶
Start a node.
- Parameters
node (
Node
) – The node to be started- Returns
True if the start was successful, otherwise False
- Return type
bool
- stop_node(node)[source]¶
Stop a node
- Parameters
node (
Node
) – The node to be stopped.- Returns
True if the stop was successful, otherwise False
- Return type
bool
- type = 'vsphere'¶
- website = 'http://www.vmware.com/products/vsphere/'¶
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_headers(headers)[source]¶
Adds
API-Key
default header.- Returns
Updated headers.
- Return type
- host = 'api.vultr.com'¶
- require_api_key()[source]¶
Check whether this call (method + action) must be authenticated.
- Returns
True if
API-Key
header required, False otherwise.- Return type
- responseCls¶
- unauthenticated_endpoints = {'/v1/app/list': ['GET'], '/v1/os/list': ['GET'], '/v1/plans/list': ['GET'], '/v1/plans/list_vc2': ['GET'], '/v1/plans/list_vdc2': ['GET'], '/v1/regions/availability': ['GET'], '/v1/regions/list': ['GET']}¶
- class libcloud.compute.drivers.vultr.VultrNodeDriver(key, secret=None, secure=True, host=None, port=None, api_version='2', 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 = 'Vultr'¶
- type = 'vultr'¶
- website = 'https://www.vultr.com'¶
- class libcloud.compute.drivers.vultr.VultrNodeDriverHelper[source]¶
Bases:
object
VultrNode helper class.
- class libcloud.compute.drivers.vultr.VultrNodeDriverV1(key, secret=None, secure=True, host=None, port=None, api_version='2', region=None, **kwargs)[source]¶
Bases:
libcloud.compute.drivers.vultr.VultrNodeDriver
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
- EX_CREATE_ATTRIBUTES = ['ipxe_chain_url', 'label', 'userdata', 'reserved_ip_v4', 'hostname', 'tag', 'enable_ipv6', 'enable_private_network', 'auto_backups', 'notify_activate', 'ddos_protection', 'iso_id', 'script_id', 'snapshot_id', 'app_id']¶
- EX_CREATE_ID_ATTRIBUTES = {'app_id': 'APPID', 'iso_id': 'ISOID', 'script_id': 'SCRIPTID', 'snapshot_id': 'SNAPSHOTID'}¶
- EX_CREATE_YES_NO_ATTRIBUTES = ['enable_ipv6', 'enable_private_network', 'auto_backups', 'notify_activate', 'ddos_protection']¶
- NODE_STATE_MAP = {'active': NodeState.RUNNING, 'pending': NodeState.PENDING}¶
- connectionCls¶
- create_key_pair(name, public_key='')[source]¶
Create a new SSH key. :param name: Name of the new SSH key :type name:
str
- Key public_key
Public part of the new SSH key
- Returns
True on success
- Return type
bool
- create_node(name, size, image, location, ex_ssh_key_ids=None, ex_create_attr=None)[source]¶
Create a node
- Parameters
name (
str
) – Name for the new nodesize (
NodeSize
) – Size of the new nodeimage (
NodeImage
) – Image for the new nodelocation (
NodeLocation
) – Location of the new nodeex_ssh_key_ids – IDs of the SSH keys to initialize
ex_create_attr (
dict
) – Extra attributes for node creation
The ex_create_attr parameter can include the following dictionary key and value pairs:
ipxe_chain_url:
str
for specifying URL to boot via IPXEiso_id:
str
the ID of a specific ISO to mount, only meaningful with the Custom NodeImagescript_id:
int
ID of a startup script to execute on boot, only meaningful when the NodeImage is not Custom‘snapshot_id`:
str
Snapshot ID to restore for the initial installation, only meaningful with the Snapshot NodeImageenable_ipv6:
bool
Whether an IPv6 subnet should be assignedenable_private_network:
bool
Whether private networking support should be addedlabel:
str
Text label to be shown in the control panelauto_backups:
bool
Whether automatic backups should be enabledapp_id:
int
App ID to launch if launching an application, only meaningful when the NodeImage is Applicationuserdata:
str
Base64 encoded cloud-init user-datanotify_activate:
bool
Whether an activation email should be sent when the server is readyddos_protection:
bool
Whether DDOS protection should be enabledreserved_ip_v4:
str
IP address of the floating IP to use as the main IP of this serverhostname:
str
The hostname to assign to this servertag:
str
The tag to assign to this server
- Returns
The newly created node.
- Return type
Node
- delete_key_pair(key_pair)[source]¶
Delete an SSH key. :param key_pair: The SSH key to delete :type key_pair:
SSHKey
- Returns
True on success
- Return type
bool
- destroy_node(node)[source]¶
Destroy a node.
Depending upon the provider, this may destroy all data associated with the node, including backups.
- Parameters
node (
Node
) – The node to be destroyed- Returns
True if the destroy was successful, False otherwise.
- Return type
bool
- list_images()[source]¶
List images on a provider.
- Parameters
location (
NodeLocation
) – The location at which to list images.- Returns
list of node image objects.
- Return type
list
ofNodeImage
- list_key_pairs()[source]¶
List all the available SSH keys. :return: Available SSH keys. :rtype:
list
ofSSHKey
- list_locations()[source]¶
List data centers for a provider
- Returns
list of node location objects
- Return type
list
ofNodeLocation
- list_sizes()[source]¶
List sizes on a provider
- Parameters
location (
NodeLocation
) – The location at which to list sizes- Returns
list of node size objects
- Return type
list
ofNodeSize
- class libcloud.compute.drivers.vultr.VultrNodeDriverV2(key, secret=None, secure=True, host=None, port=None, api_version='2', region=None, **kwargs)[source]¶
Bases:
libcloud.compute.drivers.vultr.VultrNodeDriver
Vultr API v2 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 = {'active': NodeState.RUNNING, 'halted': NodeState.STOPPED, 'pending': NodeState.PENDING, 'rebooting': NodeState.REBOOTING, 'resizing': NodeState.RECONFIGURING}¶
- SNAPSHOT_STATE_MAP = {'complete': VolumeSnapshotState.AVAILABLE, 'pending': VolumeSnapshotState.CREATING}¶
- VOLUME_STATE_MAP = {'active': StorageVolumeState.AVAILABLE, 'pending': StorageVolumeState.CREATING}¶
- attach_volume(node: libcloud.compute.base.Node, volume: libcloud.compute.base.StorageVolume, ex_live: bool = True) bool [source]¶
Attaches volume to node.
- Parameters
node (
Node
) – Node to attach volume to.volume (
StorageVolume
) – Volume to attach.ex_live (
bool
) – Attach the volume without restarting the node.
- Rytpe
bool
- connectionCls¶
- create_node(name: str, size: libcloud.compute.base.NodeSize, location: libcloud.compute.base.NodeLocation, image: Optional[libcloud.compute.base.NodeImage] = None, ex_ssh_key_ids: Optional[List[str]] = None, ex_private_network_ids: Optional[List[str]] = None, ex_snapshot: Optional[Union[libcloud.common.vultr.VultrNodeSnapshot, str]] = None, ex_enable_ipv6: bool = False, ex_backups: bool = False, ex_userdata: Optional[str] = None, ex_ddos_protection: bool = False, ex_enable_private_network: bool = False, ex_ipxe_chain_url: Optional[str] = None, ex_iso_id: Optional[str] = None, ex_script_id: Optional[str] = None, ex_image_id: Optional[str] = None, ex_activation_email: bool = False, ex_hostname: Optional[str] = None, ex_tag: Optional[str] = None, ex_firewall_group_id: Optional[str] = None, ex_reserved_ipv4: Optional[str] = None, ex_persistent_pxe: bool = False) libcloud.compute.base.Node [source]¶
Create a new node.
- Parameters
name (
str
) – The new node’s name.size – The size to use to create the node.
location – The location to provision the node.
image – The image to use to provision the node.
ex_ssh_key_ids (
list
ofstr
) – List of SSH keys to install on this node.ex_private_network_ids (
list
ofstr
) – The network ids to attach to node. This parameter takes precedence over ex_enable_private_network (VPS only)ex_snapshot – The snapshot to use when deploying the node. Mutually exclusive with image,
ex_enable_ipv6 (
bool
) – Wheteher to enable IPv6.ex_backups (
bool
) – Enable automatic backups for the node. (VPS only)ex_userdata (
str
) – String containing user dataex_ddos_protection (
bool
) – Enable DDoS protection (VPS only)ex_enable_private_network (
bool
) –Enable private networking. Mutually exclusive with
ex_private_network_ids.
(VPS only)
ex_ipxe_chain_url (
str
) – The URL location of the iPXE chainloader (VPS only)ex_iso_id (
str
) – The ISO id to use when deploying this node. (VPS only)ex_script_id (
str
) – The startup script id to use when deploying this node.ex_image_id (
str
) – The Application image_id to use when deploying this node.ex_activation_email (
bool
) – Notify by email after deployment.ex_hostname (
str
) – The hostname to use when deploying this node.ex_tag (
str
) – The user-supplied tag.ex_firewall_group_id (
str
) – The Firewall Group id to attach to this node. (VPS only)ex_reserved_ipv4 (
str
) – Id of the floating IP to use as the main IP of this node.ex_persistent_pxe (
bool
) – Enable persistent PXE (Bare Metal only)
- create_volume(size: int, name: str, location: Union[libcloud.compute.base.NodeLocation, str]) libcloud.compute.base.StorageVolume [source]¶
Create a new volume.
- Parameters
size (
int
) – Size of the volume in gigabytes. Size may range between 10 and 10000.name (
str
) – Name of the volume to be created.location (
NodeLocation
orstr
) – Which data center to create the volume in.
- Returns
The newly created volume.
- Return type
StorageVolume
- delete_key_pair(key_pair: libcloud.compute.base.KeyPair) bool [source]¶
Delete existing key pair.
- Parameters
key_pair (
KeyPair
) – The key pair object to delete.- Return type
bool
- destroy_node(node: libcloud.compute.base.Node) bool [source]¶
Destroy the given node.
- Parameters
node – The node to be destroyed.
- Return type
bool
- destroy_volume(volume: libcloud.compute.base.StorageVolume) bool [source]¶
Destroys a storage volume.
- Parameters
volume (
StorageVolume
) – Volume to be destroyed- Return type
bool
- detach_volume(volume: libcloud.compute.base.StorageVolume, ex_live: bool = True) bool [source]¶
Detaches a volume from a node.
- Parameters
volume (
StorageVolume
) – Volume to be detachedex_live (
bool
) – Detach the volume without restarting the node.
- Return type
bool
- ex_create_network(cidr_block: str, location: Union[libcloud.compute.base.NodeLocation, str], description: Optional[str] = None) libcloud.common.vultr.VultrNetwork [source]¶
Create a private network.
- Parameters
cidr_block (
str
) – The CIDR block assigned to the network.location – The location to create the network.
description (
str
) – A description of the private network.
- Return type
- class
VultrNetwork
- ex_create_snapshot(node: libcloud.compute.base.Node, description: Optional[str] = None) libcloud.common.vultr.VultrNodeSnapshot [source]¶
Create snapshot from a node.
- Parameters
node – Node to create the snapshot from.
description (
str
) – A description of the snapshot.
- Return type
- class
VultrNodeSnapshot
- ex_delete_snapshot(snapshot: libcloud.common.vultr.VultrNodeSnapshot) bool [source]¶
Delete the given snapshot.
- Parameters
snapshot – The snapshot to delete.
- Return type
bool
- ex_destroy_bare_metal_node(node: libcloud.compute.base.Node) bool [source]¶
Destroy the given bare metal node.
- Parameters
node – The bare metal node to be destroyed.
- Return type
bool
- ex_destroy_network(network: libcloud.common.vultr.VultrNetwork) bool [source]¶
Delete a private network.
- Parameters
network – The network to destroy.
- Return type
bool
- ex_get_network(network_id: str) libcloud.common.vultr.VultrNetwork [source]¶
Retrieve a private network.
- Parameters
network_id (
str
) – ID of the network to retrieve.- Return type
- class
VultrNetwork
- ex_get_node(node_id: str) libcloud.compute.base.Node [source]¶
Retrieve a node object.
- Parameters
node_id – ID of the node to retrieve.
- Return type
- class
Node
- ex_get_snapshot(snapshot_id: str) libcloud.common.vultr.VultrNodeSnapshot [source]¶
Retrieve a snapshot.
- Parameters
snapshot_id (
str
) – ID of the snapshot to retrieve.- Return type
- class
VultrNodeSnapshot
- ex_get_volume(volume_id: str) libcloud.compute.base.StorageVolume [source]¶
Retrieve a single volume.
- Parameters
volume_id (
str
) – The ID of the volume to fetch.- Rtype :class
StorageVolume
- Returns
StorageVolume instance on success.
- ex_list_available_sizes_for_location(location: libcloud.compute.base.NodeLocation) List[str] [source]¶
Get a list of available sizes for the given location.
- Parameters
location – The location to get available sizes for.
- Returns
A list of available size IDs for the given location.
- Return type
list
ofstr
- ex_list_bare_metal_nodes() List[libcloud.compute.base.Node] [source]¶
List all bare metal nodes.
- Returns
list of node objects
- Return type
list
of :class: Node
- ex_list_bare_metal_sizes() List[libcloud.compute.base.NodeSize] [source]¶
List bare metal sizes.
- Return type
list
of :class: NodeSize
- ex_list_networks() List[libcloud.common.vultr.VultrNetwork] [source]¶
List all private networks.
- Return type
list
of :class: VultrNetwork
- ex_list_snapshots() List[libcloud.common.vultr.VultrNodeSnapshot] [source]¶
List node snapshots.
- Return type
list
of :class: VultrNodeSnapshot
- ex_reboot_bare_metal_node(node: libcloud.compute.base.Node) bool [source]¶
Reboot the given bare metal node.
- Parameters
node – The bare metal node to be rebooted.
- Return type
bool
- ex_resize_node(node: libcloud.compute.base.Node, size: libcloud.compute.base.NodeSize) bool [source]¶
Change size for the given node, only applicable for VPS nodes.
- Parameters
node – The node to be resized.
size – The new size.
- ex_resize_volume(volume: libcloud.compute.base.StorageVolume, size: int) bool [source]¶
Resize a volume.
- Parameters
volume (
StorageVolume
) – The volume to resize.size (
int
) – The new volume size in GBs. Size may range between 10 and 10000.
- Return type
bool
- ex_start_bare_metal_node(node: libcloud.compute.base.Node) bool [source]¶
Start the given bare metal node.
- Parameters
node – The bare metal node to be started.
- Return type
bool
- ex_stop_bare_metal_node(node: libcloud.compute.base.Node) bool [source]¶
Stop the given bare metal node.
- Parameters
node – The bare metal node to be stopped.
- Return type
bool
- ex_stop_nodes(nodes: List[libcloud.compute.base.Node]) bool [source]¶
Stops all the nodes given.
: param nodes: A list of the nodes to stop. : type node:
list
of: class Node: rtype:
bool
- get_key_pair(key_id: str) libcloud.compute.base.KeyPair [source]¶
Retrieve a single key pair.
- Parameters
key_id (
str
) – ID of the key pair to retrieve.- Return type
- class
KeyPair
- import_key_pair_from_string(name: str, key_material: str) libcloud.compute.base.KeyPair [source]¶
Import a new public key from string.
- Parameters
name (
str
) – Key pair name.key_material (
str
) – Public key material.
- Return type
- class
KeyPair
- list_images() List[libcloud.compute.base.NodeImage] [source]¶
List available node images.
- Return type
list
of :class: NodeImage
- list_key_pairs() List[libcloud.compute.base.KeyPair] [source]¶
List all the available SSH key pair objects.
- Return type
list
ofKeyPair
- list_locations() List[libcloud.compute.base.NodeLocation] [source]¶
List available node locations.
- Return type
list
of :class: NodeLocation
- list_nodes(ex_list_bare_metals: bool = True) List[libcloud.compute.base.Node] [source]¶
List all nodes.
- Parameters
ex_list_bare_metals (
bool
) – Whether to fetch bare metal nodes.- Returns
list of node objects
- Return type
list
of :class: Node
- list_sizes(ex_list_bare_metals: bool = True) List[libcloud.compute.base.NodeSize] [source]¶
List available node sizes.
- Parameters
ex_list_bare_metals (
bool
) – Whether to fetch bare metal sizes.- Return type
list
of :class: NodeSize
- list_volumes() List[libcloud.compute.base.StorageVolume] [source]¶
List storage volumes.
- Return type
list
ofStorageVolume
- reboot_node(node: libcloud.compute.base.Node) bool [source]¶
Reboot the given node.
- Parameters
node – The node to be rebooted.
- Return type
bool
- start_node(node: libcloud.compute.base.Node) bool [source]¶
Start the given node.
- Parameters
node – The node to be started.
- Return type
bool
- stop_node(node: libcloud.compute.base.Node) bool [source]¶
Stop the given node.
- Parameters
node – The node to be stopped.
- Return type
bool
- 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.
Module contents¶
Drivers for working with different providers