Current File : //usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyo
�
���^c @@ s� d Z d d l m Z m Z m Z d d l Z d d l Z d d l Z d d l Z d d l j
Z
d d l m Z m
Z
m Z m Z m Z d d l Z d d l Z d d l m Z y& d d l Z d d l m Z e Z Wn e k
r� e Z n Xe j e � Z d Z d � Z! d � Z" d
� Z# d d � Z% d d � Z& d d
� Z' d d � Z( d d � Z) d d � Z* d d � Z+ d d � Z, d d � Z- d d � Z. d d � Z/ d d � Z0 d d � Z1 d d � Z2 d d � Z3 d d d � Z4 d d d � Z5 d d d � Z6 d d d � Z7 d � Z8 d d d � Z9 d � Z: d d d! � Z; d d d" � Z< d d d# � Z= d$ � Z> d d d% � Z? d d d& � Z@ d d' � ZA d( � ZB d d) � ZC d d d* � ZD d d d+ � ZE d d d, � ZF d d d- � ZG d d d. � ZH d d d/ � ZI d d d0 � ZJ d d d1 � ZK d d d2 � ZL d d3 � ZM d d d4 � ZN d d d5 � ZO d d d6 � ZP d d d7 � ZQ d d d8 � ZR d d d9 � ZS d d d: � ZT d d d; � ZU d d d< � ZV d d d= � ZW d d d> � ZX d d d? � ZY d d d@ � ZZ d d dA � Z[ d d dB � Z\ d d dC � Z] d d dD � Z^ d d dE � Z_ d d dF � Z` d d dG � Za d d dH � Zb d dI � Zc d d dJ � Zd d dK � Ze d d dL � Zf d d dM � Zg d d dN � Zh d d dO � Zi d d dP � Zj d d dQ � Zk d d dR � Zl d d dS � Zm d d dT � Zn d d dU � Zo d d dV � Zp d d dW � Zq d d dX � Zr dY � Zs dZ � Zt d[ � Zu e d\ � Zv d] � Zw d S(^ ub
OpenNebula Cloud Module
=======================
The OpenNebula cloud module is used to control access to an OpenNebula cloud.
.. versionadded:: 2014.7.0
:depends: lxml
:depends: OpenNebula installation running version ``4.14`` or later.
Use of this module requires the ``xml_rpc``, ``user``, and ``password``
parameters to be set.
Set up the cloud configuration at ``/etc/salt/cloud.providers`` or
``/etc/salt/cloud.providers.d/opennebula.conf``:
.. code-block:: yaml
my-opennebula-config:
xml_rpc: http://localhost:2633/RPC2
user: oneadmin
password: JHGhgsayu32jsa
driver: opennebula
This driver supports accessing new VM instances via DNS entry instead
of IP address. To enable this feature, in the provider or profile file
add `fqdn_base` with a value matching the base of your fully-qualified
domain name. Example:
.. code-block:: yaml
my-opennebula-config:
[...]
fqdn_base: <my.basedomain.com>
[...]
The driver will prepend the hostname to the fqdn_base and do a DNS lookup
to find the IP of the new VM.
.. note:
Whenever ``data`` is provided as a kwarg to a function and the
attribute=value syntax is used, the entire ``data`` value must be
wrapped in single or double quotes. If the value given in the
attribute=value data string contains multiple words, double quotes
*must* be used for the value while the entire data string should
be encapsulated in single quotes. Failing to do so will result in
an error. Example:
.. code-block:: bash
salt-cloud -f image_allocate opennebula datastore_name=default \
data='NAME="My New Image" DESCRIPTION="Description of the image." \
PATH=/home/one_user/images/image_name.img'
salt-cloud -f secgroup_allocate opennebula \
data="Name = test RULE = [PROTOCOL = TCP, RULE_TYPE = inbound, \
RANGE = 1000:2000]"
i ( t absolute_importt print_functiont unicode_literalsN( t SaltCloudConfigErrort SaltCloudExecutionFailuret SaltCloudExecutionTimeoutt SaltCloudNotFoundt SaltCloudSystemExit( t six( t etreeu
opennebulac C@ s* t � t k r t St � t k r& t St S( u'
Check for OpenNebula configs.
( t get_configured_providert Falset get_dependenciest __virtualname__( ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt __virtual__b s
c C@ s t j t t p t d � S( u/
Return the first configured instance.
u xml_rpcu useru password( u xml_rpcu useru password( t configt is_provider_configuredt __opts__t __active_provider_name__R
( ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyR
o s c C@ s t j t i t d 6� S( u*
Warn if dependencies aren't met.
u lmxl( R t check_driver_dependenciesR
t HAS_XML_LIBS( ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyR z s c C@ s� | d k r t d � � n t � \ } } } d j | | g � } | j j j | d d d � d } i } x0 t | � D]" } t | � | | j d � j <qw W| S( u�
Return available OpenNebula images.
CLI Example:
.. code-block:: bash
salt-cloud --list-images opennebula
salt-cloud --function avail_images opennebula
salt-cloud -f avail_images opennebula
u actionu` The avail_images function must be called with -f or --function, or with the --list-images optionu :i����i����i u NAME(
R t _get_xml_rpct joint onet imagepoolt infot _get_xmlt _xml_to_dictt findt text( t callt servert usert passwordt autht
image_poolt imagest image( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt avail_images� s
" c C@ s� | d k r t d � � n t � \ } } } d j | | g � } | j j j | � d } i } x0 t | � D]" } t | � | | j d � j <qn W| S( u�
Return available OpenNebula locations.
CLI Example:
.. code-block:: bash
salt-cloud --list-locations opennebula
salt-cloud --function avail_locations opennebula
salt-cloud -f avail_locations opennebula
u actionug The avail_locations function must be called with -f or --function, or with the --list-locations option.u :i u NAME(
R R R R t hostpoolR R R R R ( R R R R! R" t host_poolt locationst host( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt avail_locations� s
c C@ s, | d k r t d � � n t j d � i S( ul
Because sizes are built into templates with OpenNebula, there will be no sizes to
return here.
u actionu_ The avail_sizes function must be called with -f or --function, or with the --list-sizes option.uU Because sizes are built into templates with OpenNebula, there are no sizes to return.( R t logt warning( R ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt avail_sizes� s c C@ s� | d k r t d � � n t � \ } } } d j | | g � } | j j j | � d } i } x0 t | � D]" } t | � | | j d � j <qn W| S( u�
Returns a list of clusters in OpenNebula.
.. versionadded:: 2016.3.0
CLI Example:
.. code-block:: bash
salt-cloud -f list_clusters opennebula
u actionu@ The list_clusters function must be called with -f or --function.u :i u NAME(
R R R R t clusterpoolR R R R R ( R R R R! R" t cluster_poolt clusterst cluster( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt
list_clusters� s c C@ s� | d k r t d � � n t � \ } } } d j | | g � } | j j j | � d } i } x0 t | � D]" } t | � | | j d � j <qn W| S( u�
Returns a list of data stores on OpenNebula.
.. versionadded:: 2016.3.0
CLI Example:
.. code-block:: bash
salt-cloud -f list_datastores opennebula
u actionuB The list_datastores function must be called with -f or --function.u :i u NAME(
R R R R t
datastorepoolR R R R R ( R R R R! R" t datastore_poolt
datastorest datastore( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt list_datastores� s c C@ s" | d k r t d � � n t � S( u�
Returns a list of hosts on OpenNebula.
.. versionadded:: 2016.3.0
CLI Example:
.. code-block:: bash
salt-cloud -f list_hosts opennebula
u actionu= The list_hosts function must be called with -f or --function.( R R+ ( R ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt
list_hosts s c C@ s( | d k r t d � � n t d t � S( u�
Return a list of VMs on OpenNebula.
CLI Example:
.. code-block:: bash
salt-cloud -Q
salt-cloud --query
salt-cloud --function list_nodes opennebula
salt-cloud -f list_nodes opennebula
u actionu= The list_nodes function must be called with -f or --function.t full( R t _list_nodesR ( R ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt
list_nodes s c C@ s( | d k r t d � � n t d t � S( u�
Return a list of the VMs on OpenNebula.
CLI Example:
.. code-block:: bash
salt-cloud -F
salt-cloud --full-query
salt-cloud --function list_nodes_full opennebula
salt-cloud -f list_nodes_full opennebula
u actionuB The list_nodes_full function must be called with -f or --function.R: ( R R; t True( R ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt list_nodes_full6 s c C@ s9 | d k r t d � � n t d t d � t d | � S( uP
Return a list of the VMs that are on the provider, with select fields.
u actionuB The list_nodes_full function must be called with -f or --function.u cloud.list_nodes_selectu functionu query.selection( R t __utils__R> R ( R ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt list_nodes_selectL s
c C@ s� | d k r t d � � n t � \ } } } d j | | g � } | j j j | d d d � d } i } x0 t | � D]" } t | � | | j d � j <qw W| S( u�
Lists all security groups available to the user and the user's groups.
.. versionadded:: 2016.3.0
CLI Example:
.. code-block:: bash
salt-cloud -f list_security_groups opennebula
u actionuG The list_security_groups function must be called with -f or --function.u :i����i����i u NAME(
R R R R t secgrouppoolR R R R R ( R R R R! R" t
secgroup_poolt groupst group( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt list_security_groupsZ s " c C@ s� | d k r t d � � n t � \ } } } d j | | g � } | j j j | d d d � d } i } x0 t | � D]" } t | � | | j d � j <qw W| S( u�
Lists all templates available to the user and the user's groups.
.. versionadded:: 2016.3.0
CLI Example:
.. code-block:: bash
salt-cloud -f list_templates opennebula
u actionuA The list_templates function must be called with -f or --function.u :i����i����i u NAME(
R R R R t templatepoolR R R R R ( R R R R! R" t
template_poolt templatest template( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt list_templatesv s " c C@ s� | d k r t d � � n t � \ } } } d j | | g � } | j j j | d d d � d } i } x0 t | � D]" } t | � | | j d � j <qw W| S( u�
Lists all virtual networks available to the user and the user's groups.
.. versionadded:: 2016.3.0
CLI Example:
.. code-block:: bash
salt-cloud -f list_vns opennebula
u actionu; The list_vns function must be called with -f or --function.u :i����i����i u NAME(
R R R R t vnpoolR R R R R ( R R R R! R" t vn_poolt vnst v_network( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt list_vns� s " c C@ sH | d k r t d � � n t j d | � t | d i d d 6d | �S( u�
Reboot a VM.
.. versionadded:: 2016.3.0
name
The name of the VM to reboot.
CLI Example:
.. code-block:: bash
salt-cloud -a reboot my-vm
u actionu4 The start action must be called with -a or --action.u Rebooting node %st kwargsu rebootR ( R R, R t vm_action( t nameR ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt reboot� s
c C@ sH | d k r t d � � n t j d | � t | d i d d 6d | �S( u�
Start a VM.
.. versionadded:: 2016.3.0
name
The name of the VM to start.
CLI Example:
.. code-block:: bash
salt-cloud -a start my-vm
u actionu4 The start action must be called with -a or --action.u Starting node %sRP u resumeR ( R R, R RQ ( RR R ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt start� s
c C@ sH | d k r t d � � n t j d | � t | d i d d 6d | �S( u�
Stop a VM.
.. versionadded:: 2016.3.0
name
The name of the VM to stop.
CLI Example:
.. code-block:: bash
salt-cloud -a stop my-vm
u actionu4 The start action must be called with -a or --action.u Stopping node %sRP u stopR ( R R, R RQ ( RR R ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt stop� s
c C@ sn | d k r t d � � n | d k r0 i } n t � \ } } } d j | | g � } | j j j | � d S( u�
Returns the OpenNebula version.
.. versionadded:: 2016.3.5
CLI Example:
.. code-block:: bash
salt-cloud -f get_one_version one_provider_name
u actionuA The get_cluster_id function must be called with -f or --function.u :i N( R t NoneR R R t systemt version( RP R R R R! R" ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt get_one_version� s
c C@ s� | d k r t d � � n | d k r0 i } n | j d d � } | d k r] t d � � n y t � | d } Wn& t k
r� t d j | � � � n X| S( u�
Returns a cluster's ID from the given cluster name.
.. versionadded:: 2016.3.0
CLI Example:
.. code-block:: bash
salt-cloud -f get_cluster_id opennebula name=my-cluster-name
u actionuA The get_cluster_id function must be called with -f or --function.u nameu, The get_cluster_id function requires a name.u idu$ The cluster '{0}' could not be foundN( R RV t getR3 t KeyErrort format( RP R RR t ret( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt get_cluster_id s
c C@ s� | d k r t d � � n | d k r0 i } n | j d d � } | d k r] t d � � n y t � | d } Wn& t k
r� t d j | � � � n X| S( u�
Returns a data store's ID from the given data store name.
.. versionadded:: 2016.3.0
CLI Example:
.. code-block:: bash
salt-cloud -f get_datastore_id opennebula name=my-datastore-name
u actionuC The get_datastore_id function must be called with -f or --function.u nameu. The get_datastore_id function requires a name.u idu' The datastore '{0}' could not be found.N( R RV RZ R8 R[ R\ ( RP R RR R] ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt get_datastore_id8 s
c C@ s� | d k r t d � � n | d k r0 i } n | j d d � } | d k r] t d � � n y t � | d } Wn& t k
r� t d j | � � � n X| S( u�
Returns a host's ID from the given host name.
.. versionadded:: 2016.3.0
CLI Example:
.. code-block:: bash
salt-cloud -f get_host_id opennebula name=my-host-name
u actionu> The get_host_id function must be called with -f or --function.u nameu) The get_host_id function requires a name.u idu! The host '{0}' could not be foundN( R RV RZ R+ R[ R\ ( RP R RR R] ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt get_host_id\ s
c C@ s� t � } t j t j d | t d t �� } x< | D]4 } | | | d | | d f k r4 | | d Sq4 Wt d j | � � � d S( uk
Return the image object to use.
vm\_
The VM dictionary for which to obtain an image.
u imaget
search_globalu nameu idu/ The specified image, '{0}', could not be found.N( R& R t text_typeR t get_cloud_config_valueR R R R\ ( t vm_R$ t vm_imageR% ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt get_image� s
"c C@ s� | d k r t d � � n | d k r0 i } n | j d d � } | d k r] t d � � n y t � | d } Wn& t k
r� t d j | � � � n X| S( u�
Returns an image's ID from the given image name.
.. versionadded:: 2016.3.0
CLI Example:
.. code-block:: bash
salt-cloud -f get_image_id opennebula name=my-image-name
u actionu? The get_image_id function must be called with -f or --function.u nameu* The get_image_id function requires a name.u idu" The image '{0}' could not be foundN( R RV RZ R& R[ R\ ( RP R RR R] ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt get_image_id� s
c C@ s� t � } t j t j d | t d t �� } | d k r= d Sx< | D]4 } | | | d | | d f k rD | | d SqD Wt d j | � � � d S( ug
Return the VM's location.
vm\_
The VM dictionary for which to obtain a location.
u locationRa u Noneu nameu idu2 The specified location, '{0}', could not be found.N(
R+ R Rb R Rc R R RV R R\ ( Rd R) t vm_locationt location( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt get_location� s
c C@ s� | d k r t d � � n | d k r0 i } n | j d d � } | d k r] t d � � n y t � | d } Wn& t k
r� t d j | � � � n X| S( u�
Returns a security group's ID from the given security group name.
.. versionadded:: 2016.3.0
CLI Example:
.. code-block:: bash
salt-cloud -f get_secgroup_id opennebula name=my-secgroup-name
u actionuB The get_secgroup_id function must be called with -f or --function.u nameu/ The get_secgroup_id function requires a 'name'.u idu, The security group '{0}' could not be found.N( R RV RZ RE R[ R\ ( RP R RR R] ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt get_secgroup_id� s
c C@ s� | d k r t d � � n | d k r0 i } n | j d d � } | d k r] t d � � n y t � | d d d } Wn& t k
r� t d j | � � � n X| S(
u�
Returns a template's image from the given template name.
.. versionadded:: 2018.3.0
.. code-block:: bash
salt-cloud -f get_template_image opennebula name=my-template-name
u actionuE The get_template_image function must be called with -f or --function.u nameu2 The get_template_image function requires a 'name'.u templateu disku imageu0 The image for template '{0}' could not be found.N( R RV RZ RJ R[ R\ ( RP R RR R] ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt get_template_image� s
c C@ s� | d k r t d � � n | d k r0 i } n | j d d � } | d k r] t d � � n y t � | d } Wn& t k
r� t d j | � � � n X| S( u�
Returns a template's ID from the given template name.
.. versionadded:: 2016.3.0
CLI Example:
.. code-block:: bash
salt-cloud -f get_template_id opennebula name=my-template-name
u actionuB The get_template_id function must be called with -f or --function.u nameu/ The get_template_id function requires a 'name'.u idu& The template '{0}' could not be found.N( R RV RZ RJ R[ R\ ( RP R RR R] ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt get_template_id s
c C@ sd t j t j d | t d t �� } y t � | d SWn& t k
r_ t d j | � � � n Xd S( u�
Return the template id for a VM.
.. versionadded:: 2016.11.0
vm\_
The VM dictionary for which to obtain a template.
u templateRa u idu2 The specified template, '{0}', could not be found.N(
R Rb R Rc R R RJ R[ R R\ ( Rd t vm_template( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt get_template; s
c C@ s� | d k r t d � � n | d k r0 i } n | j d d � } | d k r] t d � � n y t � | d } Wn& t k
r� t d j | � � � n X| S( u�
Returns a virtual machine's ID from the given virtual machine's name.
.. versionadded:: 2016.3.0
CLI Example:
.. code-block:: bash
salt-cloud -f get_vm_id opennebula name=my-vm
u actionu< The get_vm_id function must be called with -f or --function.u nameu' The get_vm_id function requires a name.u idu The VM '{0}' could not be found.N( R RV RZ R< R[ R\ ( RP R RR R] ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt get_vm_idP s
c C@ s� | d k r t d � � n | d k r0 i } n | j d d � } | d k r] t d � � n y t � | d } Wn& t k
r� t d j | � � � n X| S( u�
Returns a virtual network's ID from the given virtual network's name.
.. versionadded:: 2016.3.0
CLI Example:
.. code-block:: bash
salt-cloud -f get_vn_id opennebula name=my-vn-name
u actionu< The get_vn_id function must be called with -f or --function.u nameu' The get_vn_id function requires a name.u idu The VN '{0}' could not be found.N( R RV RZ RO R[ R\ ( RP R RR R] ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt get_vn_idt s
c @ s � � f d � } | d d � � d } � d } | d k r� d � k rX � d } n t d i | d 6� } t d i | d 6� } d j | | | � } | S| d k r | d
� � d
} d j | | � } | d k r| d
� � d
}
d j | | |
� } n | Sd S( uf
Returns the template format to create a disk in open nebula
.. versionadded:: 2018.3.0
c @ s< x5 | D]- } | � k r t d j � | � � � q q Wd S( Nu7 The disk {0} requires a {1} argument( R R\ ( t argst arg( t diskt disk_info( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt _require_disk_opts� s
u disk_typeu sizeu cloneu imageRP u nameuJ DISK=[IMAGE={0}, IMAGE_ID={1}, CLONE=YES, SIZE={2}]u volatileu typeu DISK=[TYPE={0}, SIZE={1}]u fsu formatu% DISK=[TYPE={0}, SIZE={1}, FORMAT={2}]N( Rl Rg R\ ( Rt Ru RI Rv t sizet disk_typet clone_imaget clone_image_idt tempt v_typeR\ ( ( Rt Ru s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt _get_device_template� s.
c C@ s� y7 | d r6 t j t t p d | d � t k r6 t SWn t k
rJ n Xt d d d d j | d � d t d d
| d d d d g � d
t d d t d �t j d | d � i | d d 6t
| � d 6t | � d 6} d | k r t i | d d 6� | d <n t j
d | t d t d d> �} | r8d n d | d <t d d d d j | d � d i t d d | t | � � d 6d
t d �g } | j d � r�| j d j | j d � � � n | j d � r�| j d! j | j d � � � n | j d" � r)| j d# j | j d" � � � n | j d$ � rZ| j d% j | j d$ � � � n | j d& � r�| j d& � } | d' } x. | D]& } | j t | | | d( | �� q�Wd) t j | � k r�t d* � � q�n d+ j | � } y� t � \ } } }
d, j | |
g � } | j j j | t | d � | d t | � } | d- stt j d. | d | d/ d0 t j �t SWn4 t k
r�}
t j d1 | d |
d0 t j �t SX| j d2 � } | d> k r�d3 j | d | � } n d4 � } yW t d5 | d6 | d f d7 t j
d8 | t d dU �d; t j
d< | t d d= ��} Wn\ t t! f k
r�}
z* y t" | d � Wn t k
r�n XWd> t t j |
� � � Xn Xt j
d? | t d t d d> �} | d> k r�t# j$ j% | � r�t& d@ j | � � � n | r| | dA <dB } nl y | dC d- } WnW t' k
r{y | d dD dE } Wn# t' k
rm| d dD dF } n X| | dA <n Xt j
dG | t d dH �} | | dI <| | dJ <t dK | t � } | dL | dL <| d' | d' <| d | d <| d d | dM <| dN | dN <| | dC <g | dO <t j dP | d � t j( dQ | d t) j* | � � t d d dR dS j | d � d t d dT | d d d d g � d
t d �| S(V u#
Create a single VM from a data dict.
vm\_
The dictionary use to create a VM.
Optional vm\_ dict options for overwriting template:
region_id
Optional - OpenNebula Zone ID
memory
Optional - In MB
cpu
Optional - Percent of host CPU to allocate
vcpu
Optional - Amount of vCPUs to allocate
CLI Example:
.. code-block:: bash
salt-cloud -p my-opennebula-profile vm_name
salt-cloud -p my-opennebula-profile vm_name memory=16384 cpu=2.5 vcpu=16
u profileu
opennebulau cloud.fire_eventu eventu starting createu salt/cloud/{0}/creatingu nameRr u cloud.filter_eventu creatingu provideru drivert sock_diru sock_dirt transportu transportu Creating Cloud VM %su template_idu region_idu templateu image_idu private_networkingRa t defaultu trueu falseu requesting instanceu salt/cloud/{0}/requestingu
requestingu kwargsu SCHED_REQUIREMENTS="ID={0}"u memoryu
MEMORY={0}u cpuu CPU={0}u vcpuu VCPU={0}u disku imageRI u CLONEu^ Missing an image disk to clone. Must define a clone disk alongside all other disk definitions.u
u :i um Error creating %s on OpenNebula
The following error was returned when trying to instantiate the template: %si t exc_info_on_logleveluq Error creating %s on OpenNebula
The following exception was thrown when trying to run the initial deployment: %su fqdn_baseu {0}.{1}c S@ sH t | d d �} | s t S| d d k r0 t S| d d k rD | Sd S( NR u actionu stateu 7u lcm_stateu 3( t
show_instanceR ( t vm_namet node_data( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt __query_node_dataF s u cloud.wait_for_ipt update_argst timeoutu wait_for_ip_timeouti
i< t intervalu wait_for_ip_intervali Nu private_keyu- The defined key_filename '{0}' does not existu ssh_hostu 0.0.0.0u private_ipsu nicu ipu
ip6_globalu ssh_usernameu rootu usernameu key_filenameu cloud.bootstrapu idu sizeu stateu
public_ipsu Created Cloud VM '%s'u '%s' VM creation details:
%su created instanceu salt/cloud/{0}/createdu creatediX (+ R t is_profile_configuredR R R t AttributeErrorR? R\ R, R Ro Rj Rm Rc RV t listRZ t appendR} R Rb R R R R RI t instantiatet intt errort loggingt DEBUGt ExceptionR R t destroyt ost patht isfileR R[ t debugt pprintt pformat( Rd RP t private_networkingRI t get_diskst
template_nameRt t
template_argsR R R! R" t crett exct fqdnR� t datat key_filenamet
private_ipt ssh_usernameR] ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt create� s
"
""""
" c C@ sO | d k r t d � � n t d d d d j | � d i | d 6d t d
�t � \ } } } d j | | g � } t | d d
�} | j j j | d t
| d � � } t d d d d j | � d i | d 6d t d
�t j d t � t
k r t d | t j d � d t � n i d d
6| d d 6| d d 6| d d 6} | S( uI
Destroy a node. Will check termination protection and warn if enabled.
name
The name of the vm to be destroyed.
CLI Example:
.. code-block:: bash
salt-cloud --destroy vm_name
salt-cloud -d vm_name
salt-cloud --action destroy vm_name
salt-cloud -a destroy vm_name
u functionuE The destroy action must be called with -d, --destroy, -a or --action.u cloud.fire_eventu eventu destroying instanceu salt/cloud/{0}/destroyingRr u nameR~ u sock_diru :R u actionu deleteu idu destroyed instanceu salt/cloud/{0}/destroyedu update_cachediru cloud.delete_minion_cachediri u vm.deleteu deletedi u node_idi u
error_code( R R? R\ R R R R� R t vmt actionR� RZ R R= R t split( RR R R R R! R" R� t node( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyR� � s<
%
c
C@ s� | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | j d d � } | j d d � } | r� | r� t j d � q� n+ | r� t d i | d 6� } n t d
� � | r� | r&t j d � q&nE | rt j j j | d d
�� } | j
� } Wd QXn t d � � t � \ } } } d j | | g � }
| j
j j |
| t | � � } i d d 6| d d 6| d d 6| d d 6} | S( u)
Allocates a new image in OpenNebula.
.. versionadded:: 2016.3.0
path
The path to a file containing the template of the image to allocate.
Syntax within the file can be the usual attribute=value or XML. Can be
used instead of ``data``.
data
The data containing the template of the image to allocate. Syntax can be the
usual attribute=value or XML. Can be used instead of ``path``.
datastore_id
The ID of the data-store to be used for the new image. Can be used instead
of ``datastore_name``.
datastore_name
The name of the data-store to be used for the new image. Can be used instead of
``datastore_id``.
CLI Example:
.. code-block:: bash
salt-cloud -f image_allocate opennebula path=/path/to/image_file.txt datastore_id=1
salt-cloud -f image_allocate opennebula datastore_name=default \
data='NAME="Ubuntu 14.04" PATH="/home/one_user/images/ubuntu_desktop.img" \
DESCRIPTION="Ubuntu 14.04 for development."'
u functionuA The image_allocate function must be called with -f or --function.u pathu datau datastore_idu datastore_nameu` Both a 'datastore_id' and a 'datastore_name' were provided. 'datastore_id' will take precedence.RP u nameub The image_allocate function requires either a 'datastore_id' or a 'datastore_name' to be provided.uP Both the 'data' and 'path' arguments were provided. 'data' will take precedence.t modeu rNuS The image_allocate function requires either a file 'path' or 'data' to be provided.u :u image.allocateu actioni u allocatedi u image_idi u
error_code( R RV RZ R, R- R_ t saltt utilst filest fopent readR R R R% t allocateR� (
R RP R� R� t datastore_idt datastore_namet rfhR R R! R" t responseR] ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt image_allocate� sF
! c C@ sL | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | j d d � } | d k r� t d � � n | r� | r� t j d � q� n+ | r� t d i | d 6� } n t d � � t � \ } } } d
j | | g � } | j j j
| t | � | � } i d d 6| d
d 6| d d 6| d 6| d d 6}
|
S( u
Clones an existing image.
.. versionadded:: 2016.3.0
name
The name of the new image.
image_id
The ID of the image to be cloned. Can be used instead of ``image_name``.
image_name
The name of the image to be cloned. Can be used instead of ``image_id``.
CLI Example:
.. code-block:: bash
salt-cloud -f image_clone opennebula name=my-new-image image_id=10
salt-cloud -f image_clone opennebula name=my-new-image image_name=my-image-to-clone
u functionu> The image_clone function must be called with -f or --function.u nameu image_idu
image_nameu: The image_clone function requires a 'name' to be provided.u^ Both the 'image_id' and 'image_name' arguments were provided. 'image_id' will take precedence.RP uY The image_clone function requires either an 'image_id' or an 'image_name' to be provided.u :u image.cloneu actioni u clonedi u cloned_image_idu cloned_image_namei u
error_codeN( R RV RZ R, R- Rg R R R R% t cloneR� ( R RP RR t image_idt
image_nameR R R! R" R� R� ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt image_clone4 s:
! c
C@ s | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | rs | r� t j d � q� n+ | r� t d i | d 6� } n t d � � t � \ } } } d j | | g � } | j j j
| t | � � } i d d
6| d d 6| d
d 6| d d 6} | S( u�
Deletes the given image from OpenNebula. Either a name or an image_id must
be supplied.
.. versionadded:: 2016.3.0
name
The name of the image to delete. Can be used instead of ``image_id``.
image_id
The ID of the image to delete. Can be used instead of ``name``.
CLI Example:
.. code-block:: bash
salt-cloud -f image_delete opennebula name=my-image
salt-cloud --function image_delete opennebula image_id=100
u functionu? The image_delete function must be called with -f or --function.u nameu image_iduX Both the 'image_id' and 'name' arguments were provided. 'image_id' will take precedence.RP uS The image_delete function requires either an 'image_id' or a 'name' to be provided.u :u image.deleteu actioni u deletedi i u
error_codeN( R RV RZ R, R- Rg R R R R% t deleteR� (
R RP RR R� R R R! R" R� R� ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt image_deletex s0
c C@ s | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | rs | r� t j d � q� n+ | r� t d i | d 6� } n t d � � t � \ } } } d j | | g � } i } | j j j
| t | � � d } t | � }
t
|
� | |
j d
� j <| S( u
Retrieves information for a given image. Either a name or an image_id must be
supplied.
.. versionadded:: 2016.3.0
name
The name of the image for which to gather information. Can be used instead
of ``image_id``.
image_id
The ID of the image for which to gather information. Can be used instead of
``name``.
CLI Example:
.. code-block:: bash
salt-cloud -f image_info opennebula name=my-image
salt-cloud --function image_info opennebula image_id=5
u functionu= The image_info function must be called with -f or --function.u nameu image_iduX Both the 'image_id' and 'name' arguments were provided. 'image_id' will take precedence.RP uP The image_info function requires either a 'name or an 'image_id' to be provided.u :i u NAMEN( R RV RZ R, R- Rg R R R R% R R� R R R R ( R RP RR R� R R R! R" R R� t tree( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt
image_info� s,
" c C@ sT | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | j d d � } | d k r� t d � � n | r� | r� t j d � q� n+ | r� t d i | d 6� } n t d � � t � \ } } } d
j | | g � } | j j j
| t | � t j
j j | � � } i d d 6| d
d 6| d d 6| d d 6}
|
S( uX
Sets the Image as persistent or not persistent.
.. versionadded:: 2016.3.0
name
The name of the image to set. Can be used instead of ``image_id``.
image_id
The ID of the image to set. Can be used instead of ``name``.
persist
A boolean value to set the image as persistent or not. Set to true
for persistent, false for non-persistent.
CLI Example:
.. code-block:: bash
salt-cloud -f image_persistent opennebula name=my-image persist=True
salt-cloud --function image_persistent opennebula image_id=5 persist=False
u functionuC The image_persistent function must be called with -f or --function.u nameu persistu image_iduP The image_persistent function requires 'persist' to be set to 'True' or 'False'.uX Both the 'image_id' and 'name' arguments were provided. 'image_id' will take precedence.RP uW The image_persistent function requires either a 'name' or an 'image_id' to be provided.u :u image.persistentu actioni u responsei i u
error_codeN( R RV RZ R, R- Rg R R R R% t
persistentR� R� R� R� t is_true( R RP RR t persistR� R R R! R" R� R� ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt image_persistent� s8
0 c C@ sK | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | j d d � } | d k r� t d � � n | r� | r� t j d � q� n+ | r� t d i | d 6� } n t d
� � t � \ } } } d j | | g � } | j j j
| t | � t | � � } i d d
6| d d 6| d d 6| d d 6}
|
S( u=
Deletes a snapshot from the image.
.. versionadded:: 2016.3.0
image_id
The ID of the image from which to delete the snapshot. Can be used instead of
``image_name``.
image_name
The name of the image from which to delete the snapshot. Can be used instead
of ``image_id``.
snapshot_id
The ID of the snapshot to delete.
CLI Example:
.. code-block:: bash
salt-cloud -f image_snapshot_delete vm_id=106 snapshot_id=45
salt-cloud -f image_snapshot_delete vm_name=my-vm snapshot_id=111
u functionuH The image_snapshot_delete function must be called with -f or --function.u image_idu
image_nameu snapshot_iduK The image_snapshot_delete function requires a 'snapshot_id' to be provided.u^ Both the 'image_id' and 'image_name' arguments were provided. 'image_id' will take precedence.RP u nameub The image_snapshot_delete function requires either an 'image_id' or a 'image_name' to be provided.u :u image.snapshotdeleteu actioni u deletedi i u
error_codeN( R RV RZ R, R- Rg R R R R% t snapshotdeleteR� ( R RP R� R� t snapshot_idR R R! R" R� R� ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt image_snapshot_delete2 s8
' c C@ sK | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | j d d � } | d k r� t d � � n | r� | r� t j d � q� n+ | r� t d i | d 6� } n t d
� � t � \ } } } d j | | g � } | j j j
| t | � t | � � } i d d
6| d d 6| d d 6| d d 6}
|
S( u#
Reverts an image state to a previous snapshot.
.. versionadded:: 2016.3.0
image_id
The ID of the image to revert. Can be used instead of ``image_name``.
image_name
The name of the image to revert. Can be used instead of ``image_id``.
snapshot_id
The ID of the snapshot to which the image will be reverted.
CLI Example:
.. code-block:: bash
salt-cloud -f image_snapshot_revert vm_id=106 snapshot_id=45
salt-cloud -f image_snapshot_revert vm_name=my-vm snapshot_id=120
u functionuH The image_snapshot_revert function must be called with -f or --function.u image_idu
image_nameu snapshot_iduK The image_snapshot_revert function requires a 'snapshot_id' to be provided.u^ Both the 'image_id' and 'image_name' arguments were provided. 'image_id' will take precedence.RP u nameuc The image_snapshot_revert function requires either an 'image_id' or an 'image_name' to be provided.u :u image.snapshotrevertu actioni u revertedi i u
error_codeN( R RV RZ R, R- Rg R R R R% t snapshotrevertR� ( R RP R� R� R� R R R! R" R� R� ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt image_snapshot_revertw s8
' c C@ sK | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | j d d � } | d k r� t d � � n | r� | r� t j d � q� n+ | r� t d i | d 6� } n t d
� � t � \ } } } d j | | g � } | j j j
| t | � t | � � } i d d
6| d d 6| d d 6| d d 6}
|
S( u�
Flattens the snapshot of an image and discards others.
.. versionadded:: 2016.3.0
image_id
The ID of the image. Can be used instead of ``image_name``.
image_name
The name of the image. Can be used instead of ``image_id``.
snapshot_id
The ID of the snapshot to flatten.
CLI Example:
.. code-block:: bash
salt-cloud -f image_snapshot_flatten vm_id=106 snapshot_id=45
salt-cloud -f image_snapshot_flatten vm_name=my-vm snapshot_id=45
u functionuI The image_snapshot_flatten function must be called with -f or --function.u image_idu
image_nameu snapshot_iduM The image_stanpshot_flatten function requires a 'snapshot_id' to be provided.u^ Both the 'image_id' and 'image_name' arguments were provided. 'image_id' will take precedence.RP u nameud The image_snapshot_flatten function requires either an 'image_id' or an 'image_name' to be provided.u :u image.snapshotflattenu actioni u flattenedi i u
error_codeN( R RV RZ R, R- Rg R R R R% t snapshotflattenR� ( R RP R� R� R� R R R! R" R� R� ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt image_snapshot_flatten� s8
' c C@ s4 | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | j d d � } | j d d � } | j d d � } d d g } | d k r� t d
� � n | | d k r� d } n9 | | d k r� d } n t d
j | d | d � � � | r"| rMt j d � qMn+ | rAt d i | d 6� } n t d � � | rl| r�t j d � q�nE | r�t j j j
| d d �� } | j � } Wd QXn t d � � t � \ }
} } d j
| | g � }
|
j j j |
t | � | t | � � } i d d 6| d d 6| d d 6| d d 6} | S( us
Replaces the image template contents.
.. versionadded:: 2016.3.0
image_id
The ID of the image to update. Can be used instead of ``image_name``.
image_name
The name of the image to update. Can be used instead of ``image_id``.
path
The path to a file containing the template of the image. Syntax within the
file can be the usual attribute=value or XML. Can be used instead of ``data``.
data
Contains the template of the image. Syntax can be the usual attribute=value
or XML. Can be used instead of ``path``.
update_type
There are two ways to update an image: ``replace`` the whole template
or ``merge`` the new template with the existing one.
CLI Example:
.. code-block:: bash
salt-cloud -f image_update opennebula image_id=0 file=/path/to/image_update_file.txt update_type=replace
salt-cloud -f image_update opennebula image_name="Ubuntu 14.04" update_type=merge \
data='NAME="Ubuntu Dev" PATH="/home/one_user/images/ubuntu_desktop.img" \
DESCRIPTION = "Ubuntu 14.04 for development."'
u functionuA The image_allocate function must be called with -f or --function.u image_idu
image_nameu pathu datau update_typeu replaceu mergeuC The image_update function requires an 'update_type' to be provided.i i u3 The update_type argument must be either {0} or {1}.u^ Both the 'image_id' and 'image_name' arguments were provided. 'image_id' will take precedence.RP u nameuZ The image_update function requires either an 'image_id' or an 'image_name' to be provided.uP Both the 'data' and 'path' arguments were provided. 'data' will take precedence.R� u rNuQ The image_update function requires either 'data' or a file 'path' to be provided.u :u image.updateu actionu updatedi u
error_code( R RV RZ R\ R, R- Rg R� R� R� R� R� R R R R% t updateR� ( R RP R� R� R� R� t update_typeR� t
update_numberR� R R R! R" R� R] ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt image_update� s` !
* c C@ s? | d k r t d � � n t | � } t d | t t � | S( u_
Show the details from OpenNebula concerning a named VM.
name
The name of the VM for which to display details.
call
Type of call to use with this function such as ``function``.
CLI Example:
.. code-block:: bash
salt-cloud --action show_instance vm_name
salt-cloud -a show_instance vm_name
u actionu< The show_instance action must be called with -a or --action.u cloud.cache_node( R t _get_nodeR? R R ( RR R R� ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyR� j s c C@ s) | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | rs | r� t j d � q� nE | r� t j j j | d d �� } | j � } Wd QXn t d � � t
� \ } } } d
j | | g � } | j j
j | | � } i d d 6| d
d 6| d d 6| d d 6}
|
S( u�
Allocates a new security group in OpenNebula.
.. versionadded:: 2016.3.0
path
The path to a file containing the template of the security group. Syntax
within the file can be the usual attribute=value or XML. Can be used
instead of ``data``.
data
The template data of the security group. Syntax can be the usual
attribute=value or XML. Can be used instead of ``path``.
CLI Example:
.. code-block:: bash
salt-cloud -f secgroup_allocate opennebula path=/path/to/secgroup_file.txt
salt-cloud -f secgroup_allocate opennebula \
data="NAME = test RULE = [PROTOCOL = TCP, RULE_TYPE = inbound, \
RANGE = 1000:2000]"
u functionuD The secgroup_allocate function must be called with -f or --function.u pathu datauP Both the 'data' and 'path' arguments were provided. 'data' will take precedence.R� u rNuV The secgroup_allocate function requires either 'data' or a file 'path' to be provided.u :u secgroup.allocateu actioni u allocatedi u secgroup_idi u
error_code( R RV RZ R, R- R� R� R� R� R� R R R t secgroupR� ( R RP R� R� R� R R R! R" R� R] ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt secgroup_allocate� s2
c C@ sL | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | j d d � } | d k r� t d � � n | r� | r� t j d � q� n+ | r� t d i | d 6� } n t d � � t � \ } } } d
j | | g � } | j j j
| t | � | � } i d d 6| d
d 6| d d 6| d 6| d d 6}
|
S( uO
Clones an existing security group.
.. versionadded:: 2016.3.0
name
The name of the new template.
secgroup_id
The ID of the security group to be cloned. Can be used instead of
``secgroup_name``.
secgroup_name
The name of the security group to be cloned. Can be used instead of
``secgroup_id``.
CLI Example:
.. code-block:: bash
salt-cloud -f secgroup_clone opennebula name=my-cloned-secgroup secgroup_id=0
salt-cloud -f secgroup_clone opennebula name=my-cloned-secgroup secgroup_name=my-secgroup
u functionuA The secgroup_clone function must be called with -f or --function.u nameu secgroup_idu
secgroup_nameu= The secgroup_clone function requires a 'name' to be provided.ug Both the 'secgroup_id' and 'secgroup_name' arguments were provided. 'secgroup_id' will take precedence.RP u` The secgroup_clone function requires either a 'secgroup_id' or a 'secgroup_name' to be provided.u :u secgroup.cloneu actioni u clonedi u cloned_secgroup_idu cloned_secgroup_namei u
error_codeN( R RV RZ R, R- Rk R R R R� R� R� ( R RP RR t secgroup_idt
secgroup_nameR R R! R" R� R� ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt secgroup_clone� s:
! c
C@ s | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | rs | r� t j d � q� n+ | r� t d i | d 6� } n t d � � t � \ } } } d j | | g � } | j j j
| t | � � } i d d
6| d d 6| d
d 6| d d 6} | S( u
Deletes the given security group from OpenNebula. Either a name or a secgroup_id
must be supplied.
.. versionadded:: 2016.3.0
name
The name of the security group to delete. Can be used instead of
``secgroup_id``.
secgroup_id
The ID of the security group to delete. Can be used instead of ``name``.
CLI Example:
.. code-block:: bash
salt-cloud -f secgroup_delete opennebula name=my-secgroup
salt-cloud --function secgroup_delete opennebula secgroup_id=100
u functionuB The secgroup_delete function must be called with -f or --function.u nameu secgroup_idu^ Both the 'secgroup_id' and 'name' arguments were provided. 'secgroup_id' will take precedence.RP uX The secgroup_delete function requires either a 'name' or a 'secgroup_id' to be provided.u :u secgroup.deleteu actioni u deletedi i u
error_codeN( R RV RZ R, R- Rk R R R R� R� R� (
R RP RR R� R R R! R" R� R� ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt secgroup_delete
s0
c C@ s | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | rs | r� t j d � q� n+ | r� t d i | d 6� } n t d � � t � \ } } } d j | | g � } i } | j j j
| t | � � d } t | � }
t
|
� | |
j d
� j <| S( uF
Retrieves information for the given security group. Either a name or a
secgroup_id must be supplied.
.. versionadded:: 2016.3.0
name
The name of the security group for which to gather information. Can be
used instead of ``secgroup_id``.
secgroup_id
The ID of the security group for which to gather information. Can be
used instead of ``name``.
CLI Example:
.. code-block:: bash
salt-cloud -f secgroup_info opennebula name=my-secgroup
salt-cloud --function secgroup_info opennebula secgroup_id=5
u functionu@ The secgroup_info function must be called with -f or --function.u nameu secgroup_idu^ Both the 'secgroup_id' and 'name' arguments were provided. 'secgroup_id' will take precedence.RP uR The secgroup_info function requires either a name or a secgroup_id to be provided.u :i u NAMEN( R RV RZ R, R- Rk R R R R� R R� R R R R ( R RP RR R� R R R! R" R R� R� ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt
secgroup_infoI s,
" c C@ s4 | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | j d d � } | j d d � } | j d d � } d d g } | d k r� t d
� � n | | d k r� d } n9 | | d k r� d } n t d
j | d | d � � � | r"| rMt j d � qMn+ | rAt d i | d 6� } n t d � � | rl| r�t j d � q�nE | r�t j j j
| d d �� } | j � } Wd QXn t d � � t � \ }
} } d j
| | g � }
|
j j j |
t | � | t | � � } i d d 6| d d 6| d d 6| d d 6} | S( u�
Replaces the security group template contents.
.. versionadded:: 2016.3.0
secgroup_id
The ID of the security group to update. Can be used instead of
``secgroup_name``.
secgroup_name
The name of the security group to update. Can be used instead of
``secgroup_id``.
path
The path to a file containing the template of the security group. Syntax
within the file can be the usual attribute=value or XML. Can be used instead
of ``data``.
data
The template data of the security group. Syntax can be the usual attribute=value
or XML. Can be used instead of ``path``.
update_type
There are two ways to update a security group: ``replace`` the whole template
or ``merge`` the new template with the existing one.
CLI Example:
.. code-block:: bash
salt-cloud --function secgroup_update opennebula secgroup_id=100 \
path=/path/to/secgroup_update_file.txt \
update_type=replace
salt-cloud -f secgroup_update opennebula secgroup_name=my-secgroup update_type=merge \
data="Name = test RULE = [PROTOCOL = TCP, RULE_TYPE = inbound, RANGE = 1000:2000]"
u functionuD The secgroup_allocate function must be called with -f or --function.u secgroup_idu
secgroup_nameu pathu datau update_typeu replaceu mergeuF The secgroup_update function requires an 'update_type' to be provided.i i u3 The update_type argument must be either {0} or {1}.ug Both the 'secgroup_id' and 'secgroup_name' arguments were provided. 'secgroup_id' will take precedence.RP u nameua The secgroup_update function requires either a 'secgroup_id' or a 'secgroup_name' to be provided.uP Both the 'data' and 'path' arguments were provided. 'data' will take precedence.R� u rNuT The secgroup_update function requires either 'data' or a file 'path' to be provided.u :u secgroup.updateu actionu updatedi u
error_code( R RV RZ R\ R, R- Rk R� R� R� R� R� R R R R� R� R� ( R RP R� R� R� R� R� R� R� R� R R R! R" R� R] ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt secgroup_update� s` %
* c C@ s) | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | rs | r� t j d � q� nE | r� t j j j | d d �� } | j � } Wd QXn t d � � t
� \ } } } d
j | | g � } | j j
j | | � } i d d 6| d
d 6| d d 6| d d 6}
|
S( u�
Allocates a new template in OpenNebula.
.. versionadded:: 2016.3.0
path
The path to a file containing the elements of the template to be allocated.
Syntax within the file can be the usual attribute=value or XML. Can be used
instead of ``data``.
data
Contains the elements of the template to be allocated. Syntax can be the usual
attribute=value or XML. Can be used instead of ``path``.
CLI Example:
.. code-block:: bash
salt-cloud -f template_allocate opennebula path=/path/to/template_file.txt
salt-cloud -f template_allocate opennebula \
data='CPU="1.0" DISK=[IMAGE="Ubuntu-14.04"] GRAPHICS=[LISTEN="0.0.0.0",TYPE="vnc"] \
MEMORY="1024" NETWORK="yes" NIC=[NETWORK="192net",NETWORK_UNAME="oneadmin"] \
OS=[ARCH="x86_64"] SUNSTONE_CAPACITY_SELECT="YES" SUNSTONE_NETWORK_SELECT="YES" \
VCPU="1"'
u functionuD The template_allocate function must be called with -f or --function.u pathu datauP Both the 'data' and 'path' arguments were provided. 'data' will take precedence.R� u rNuV The template_allocate function requires either 'data' or a file 'path' to be provided.u :u template.allocateu actioni u allocatedi u template_idi u
error_code( R RV RZ R, R- R� R� R� R� R� R R R RI R� ( R RP R� R� R� R R R! R" R� R] ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt template_allocate� s2
c C@ sa | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | j d d � } | j d t � } | d k r� t d � � n | r� | r� t j d � q� n+ | r� t d i | d 6� } n t d
� � t � \ } } } d j | | g � } | j j
j | t | � | | � }
i d d
6|
d d 6|
d d 6| d 6|
d d 6} | S( u�
Clones an existing virtual machine template.
.. versionadded:: 2016.3.0
name
The name of the new template.
template_id
The ID of the template to be cloned. Can be used instead of ``template_name``.
template_name
The name of the template to be cloned. Can be used instead of ``template_id``.
clone_images
Optional, defaults to False. Indicates if the images attached to the template should be cloned as well.
CLI Example:
.. code-block:: bash
salt-cloud -f template_clone opennebula name=my-new-template template_id=0
salt-cloud -f template_clone opennebula name=my-new-template template_name=my-template
u functionuA The template_clone function must be called with -f or --function.u nameu template_idu
template_nameu clone_imagesu; The template_clone function requires a name to be provided.ug Both the 'template_id' and 'template_name' arguments were provided. 'template_id' will take precedence.RP u` The template_clone function requires either a 'template_id' or a 'template_name' to be provided.u :u template.cloneu actioni u clonedi u cloned_template_idu cloned_template_namei u
error_codeN(
R RV RZ R R, R- Rm R R R RI R� R� ( R RP RR t template_idR� t clone_imagesR R R! R" R� R� ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt template_clone5 s<
$ c
C@ s | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | rs | r� t j d � q� n+ | r� t d i | d 6� } n t d � � t � \ } } } d j | | g � } | j j j
| t | � � } i d d
6| d d 6| d
d 6| d d 6} | S( u�
Deletes the given template from OpenNebula. Either a name or a template_id must
be supplied.
.. versionadded:: 2016.3.0
name
The name of the template to delete. Can be used instead of ``template_id``.
template_id
The ID of the template to delete. Can be used instead of ``name``.
CLI Example:
.. code-block:: bash
salt-cloud -f template_delete opennebula name=my-template
salt-cloud --function template_delete opennebula template_id=5
u functionuB The template_delete function must be called with -f or --function.u nameu template_idu^ Both the 'template_id' and 'name' arguments were provided. 'template_id' will take precedence.RP uX The template_delete function requires either a 'name' or a 'template_id' to be provided.u :u template.deleteu actioni u deletedi i u
error_codeN( R RV RZ R, R- Rm R R R RI R� R� (
R RP RR R� R R R! R" R� R� ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt template_delete~ s0
c C@ sL | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | j d d � } | d k r� t d � � n | r� | r� t j d � q� n+ | r� t d i | d 6� } n t d
� � t � \ } } } d j | | g � } | j j j
| t | � | � } i d d
6| d d 6| d d 6| d 6| d d 6}
|
S( u
Instantiates a new virtual machine from a template.
.. versionadded:: 2016.3.0
.. note::
``template_instantiate`` creates a VM on OpenNebula from a template, but it
does not install Salt on the new VM. Use the ``create`` function for that
functionality: ``salt-cloud -p opennebula-profile vm-name``.
vm_name
Name for the new VM instance.
template_id
The ID of the template from which the VM will be created. Can be used instead
of ``template_name``.
template_name
The name of the template from which the VM will be created. Can be used instead
of ``template_id``.
CLI Example:
.. code-block:: bash
salt-cloud -f template_instantiate opennebula vm_name=my-new-vm template_id=0
u functionuG The template_instantiate function must be called with -f or --function.u vm_nameu template_idu
template_nameuF The template_instantiate function requires a 'vm_name' to be provided.ug Both the 'template_id' and 'template_name' arguments were provided. 'template_id' will take precedence.RP u nameuf The template_instantiate function requires either a 'template_id' or a 'template_name' to be provided.u :u template.instantiateu actioni u instantiatedi u instantiated_vm_idi u
error_codeN( R RV RZ R, R- Rm R R R RI R� R� ( R RP R� R� R� R R R! R" R� R� ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt template_instantiate� s:
! c C@ s4 | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | j d d � } | j d d � } | j d d � } d d g } | d k r� t d
� � n | | d k r� d } n9 | | d k r� d } n t d
j | d | d � � � | r"| rMt j d � qMn+ | rAt d i | d 6� } n t d � � | rl| r�t j d � q�nE | r�t j j j
| d d �� } | j � } Wd QXn t d � � t � \ }
} } d j
| | g � }
|
j j j |
t | � | t | � � } i d d 6| d d 6| d d 6| d d 6} | S( uk
Replaces the template contents.
.. versionadded:: 2016.3.0
template_id
The ID of the template to update. Can be used instead of ``template_name``.
template_name
The name of the template to update. Can be used instead of ``template_id``.
path
The path to a file containing the elements of the template to be updated.
Syntax within the file can be the usual attribute=value or XML. Can be
used instead of ``data``.
data
Contains the elements of the template to be updated. Syntax can be the
usual attribute=value or XML. Can be used instead of ``path``.
update_type
There are two ways to update a template: ``replace`` the whole template
or ``merge`` the new template with the existing one.
CLI Example:
.. code-block:: bash
salt-cloud --function template_update opennebula template_id=1 update_type=replace \
path=/path/to/template_update_file.txt
salt-cloud -f template_update opennebula template_name=my-template update_type=merge \
data='CPU="1.0" DISK=[IMAGE="Ubuntu-14.04"] GRAPHICS=[LISTEN="0.0.0.0",TYPE="vnc"] \
MEMORY="1024" NETWORK="yes" NIC=[NETWORK="192net",NETWORK_UNAME="oneadmin"] \
OS=[ARCH="x86_64"] SUNSTONE_CAPACITY_SELECT="YES" SUNSTONE_NETWORK_SELECT="YES" \
VCPU="1"'
u functionuB The template_update function must be called with -f or --function.u template_idu
template_nameu pathu datau update_typeu replaceu mergeuF The template_update function requires an 'update_type' to be provided.i i u3 The update_type argument must be either {0} or {1}.ug Both the 'template_id' and 'template_name' arguments were provided. 'template_id' will take precedence.RP u nameua The template_update function requires either a 'template_id' or a 'template_name' to be provided.uP Both the 'data' and 'path' arguments were provided. 'data' will take precedence.R� u rNuT The template_update function requires either 'data' or a file 'path' to be provided.u :u template.updateu actionu updatedi u
error_code( R RV RZ R\ R, R- Rm R� R� R� R� R� R R R RI R� R� ( R RP R� R� R� R� R� R� R� R� R R R! R" R� R] ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt template_update
s` %
* c C@ s� | d k r t d � � n | d k r0 i } n | j d d � } | d k r] t d � � n t � \ } } } d j | | g � } t t d i | d 6� � } | j j j | | | � } i d t
j | � d 6| d d 6| d
d 6| d d
6}
|
S( u�
Submits an action to be performed on a given virtual machine.
.. versionadded:: 2016.3.0
name
The name of the VM to action.
action
The action to be performed on the VM. Available options include:
- boot
- delete
- delete-recreate
- hold
- poweroff
- poweroff-hard
- reboot
- reboot-hard
- release
- resched
- resume
- shutdown
- shutdown-hard
- stop
- suspend
- undeploy
- undeploy-hard
- unresched
CLI Example:
.. code-block:: bash
salt-cloud -a vm_action my-vm action='release'
u actionu: The vm_action function must be called with -a or --action.u6 The vm_action function must have an 'action' provided.u :RP u nameu
vm.action.i u actionedi u vm_idi u
error_codeN( R RV RZ R R R� Rp R R� R� R Rb ( RR RP R R� R R R! R" t vm_idR� R� ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyRQ t
s& $ c C@ sM | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | j d t � } | r� | r� t j d � q� nE | r� t j j j | d d �� } | j
� } Wd QXn t d
� � t � \ } } } d j | | g � } | j
j j | | t j j j | � � }
i d d
6|
d d 6|
d d 6|
d d 6} | S( uB
Allocates a new virtual machine in OpenNebula.
.. versionadded:: 2016.3.0
path
The path to a file defining the template of the VM to allocate.
Syntax within the file can be the usual attribute=value or XML.
Can be used instead of ``data``.
data
Contains the template definitions of the VM to allocate. Syntax can
be the usual attribute=value or XML. Can be used instead of ``path``.
hold
If this parameter is set to ``True``, the VM will be created in
the ``HOLD`` state. If not set, the VM is created in the ``PENDING``
state. Default is ``False``.
CLI Example:
.. code-block:: bash
salt-cloud -f vm_allocate path=/path/to/vm_template.txt
salt-cloud --function vm_allocate path=/path/to/vm_template.txt hold=True
u functionu> The vm_allocate function must be called with -f or --function.u pathu datau holduP Both the 'data' and 'path' arguments were provided. 'data' will take precedence.R� u rNuP The vm_allocate function requires either 'data' or a file 'path' to be provided.u :u vm.allocateu actioni u allocatedi u vm_idi u
error_code( R RV RZ R R, R- R� R� R� R� R� R R R R� R� R� R� ( R RP R� R� t holdR� R R R! R" R� R] ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt vm_allocate�
s4
* c
C@ sH | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | rs | r� t j d � q� nE | r� t j j j | d d �� } | j � } Wd QXn t d � � t
� \ } } } d
j | | g � } t t
d i | d 6� � }
| j j j | |
| � } i d
d 6| d d 6| d d 6| d d 6} | S( u�
Attaches a new disk to the given virtual machine.
.. versionadded:: 2016.3.0
name
The name of the VM for which to attach the new disk.
path
The path to a file containing a single disk vector attribute.
Syntax within the file can be the usual attribute=value or XML.
Can be used instead of ``data``.
data
Contains the data needed to attach a single disk vector attribute.
Syntax can be the usual attribute=value or XML. Can be used instead
of ``path``.
CLI Example:
.. code-block:: bash
salt-cloud -a vm_attach my-vm path=/path/to/disk_file.txt
salt-cloud -a vm_attach my-vm data="DISK=[DISK_ID=1]"
u actionu8 The vm_attach action must be called with -a or --action.u pathu datauP Both the 'data' and 'path' arguments were provided. 'data' will take precedence.R� u rNuN The vm_attach function requires either 'data' or a file 'path' to be provided.u :RP u nameu vm.attachi u attachedi u vm_idi u
error_code( R RV RZ R, R- R� R� R� R� R� R R R� Rp R R� t attach(
RR RP R R� R� R� R R R! R" R� R� R] ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt vm_attach�
s4
c
C@ sH | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | rs | r� t j d � q� nE | r� t j j j | d d �� } | j � } Wd QXn t d � � t
� \ } } } d
j | | g � } t t
d i | d 6� � }
| j j j | |
| � } i d
d 6| d d 6| d d 6| d d 6} | S( u�
Attaches a new network interface to the given virtual machine.
.. versionadded:: 2016.3.0
name
The name of the VM for which to attach the new network interface.
path
The path to a file containing a single NIC vector attribute.
Syntax within the file can be the usual attribute=value or XML. Can
be used instead of ``data``.
data
Contains the single NIC vector attribute to attach to the VM.
Syntax can be the usual attribute=value or XML. Can be used instead
of ``path``.
CLI Example:
.. code-block:: bash
salt-cloud -a vm_attach_nic my-vm path=/path/to/nic_file.txt
salt-cloud -a vm_attach_nic my-vm data="NIC=[NETWORK_ID=1]"
u actionu< The vm_attach_nic action must be called with -a or --action.u pathu datauP Both the 'data' and 'path' arguments were provided. 'data' will take precedence.R� u rNuR The vm_attach_nic function requires either 'data' or a file 'path' to be provided.u :RP u nameu vm.attachnici u nic_attachedi u vm_idi u
error_code( R RV RZ R, R- R� R� R� R� R� R R R� Rp R R� t attachnic(
RR RP R R� R� R� R R R! R" R� R� R] ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt
vm_attach_nic< s4
c C@ s� | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | j d t � } | j d d � } | j d d � } | r� | r� t j d � q� n+ | r� t d i | d
6� } n t d � � | r� | rt j d � qn% | rt d i | d
6� } n d
} t � \ } } }
d j | |
g � } t
d i | d
6� } | j j j
| t | � t | � t j j j | � t | � � }
i d d 6|
d d 6|
d d 6|
d d 6} | S( u�
Initiates the instance of the given VM on the target host.
.. versionadded:: 2016.3.0
name
The name of the VM to deploy.
host_id
The ID of the target host where the VM will be deployed. Can be used instead
of ``host_name``.
host_name
The name of the target host where the VM will be deployed. Can be used instead
of ``host_id``.
capacity_maintained
True to enforce the Host capacity is not over-committed. This parameter is only
acknowledged for users in the ``oneadmin`` group. Host capacity will be always
enforced for regular users.
datastore_id
The ID of the target system data-store where the VM will be deployed. Optional
and can be used instead of ``datastore_name``. If neither ``datastore_id`` nor
``datastore_name`` are set, OpenNebula will choose the data-store.
datastore_name
The name of the target system data-store where the VM will be deployed. Optional,
and can be used instead of ``datastore_id``. If neither ``datastore_id`` nor
``datastore_name`` are set, OpenNebula will choose the data-store.
CLI Example:
.. code-block:: bash
salt-cloud -a vm_deploy my-vm host_id=0
salt-cloud -a vm_deploy my-vm host_id=1 capacity_maintained=False
salt-cloud -a vm_deploy my-vm host_name=host01 datastore_id=1
salt-cloud -a vm_deploy my-vm host_name=host01 datastore_name=default
u actionu8 The vm_deploy action must be called with -a or --action.u host_idu host_nameu capacity_maintainedu datastore_idu datastore_nameu[ Both the 'host_id' and 'host_name' arguments were provided. 'host_id' will take precedence.RP u nameuL The vm_deploy function requires a 'host_id' or a 'host_name' to be provided.uj Both the 'datastore_id' and 'datastore_name' arguments were provided. 'datastore_id' will take precedence.u -1u :u vm.deployi u deployedi u vm_idi u
error_codeN( R RV RZ R= R, R- R` R_ R R Rp R R� t deployR� R� R� R� R� ( RR RP R t host_idt host_namet capacity_maintainedR� R� R R R! R" R� R� R� ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt vm_deploy sN )
c C@ s� | d k r t d � � n | d k r0 i } n | j d d � } | d k r] t d � � n t � \ } } } d j | | g � } t t d i | d 6� � } | j j j | | t | � � } i d d 6| d d
6| d d 6| d
d 6}
|
S( u%
Detaches a disk from a virtual machine.
.. versionadded:: 2016.3.0
name
The name of the VM from which to detach the disk.
disk_id
The ID of the disk to detach.
CLI Example:
.. code-block:: bash
salt-cloud -a vm_detach my-vm disk_id=1
u actionu8 The vm_detach action must be called with -a or --action.u disk_idu; The vm_detach function requires a 'disk_id' to be provided.u :RP u nameu vm.detachi u detachedi u vm_idi u
error_codeN(
R RV RZ R R R� Rp R R� t detach( RR RP R t disk_idR R R! R" R� R� R� ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt vm_detach� s& ! c C@ s� | d k r t d � � n | d k r0 i } n | j d d � } | d k r] t d � � n t � \ } } } d j | | g � } t t d i | d 6� � } | j j j | | t | � � } i d d 6| d d
6| d d 6| d
d 6}
|
S( u3
Detaches a disk from a virtual machine.
.. versionadded:: 2016.3.0
name
The name of the VM from which to detach the network interface.
nic_id
The ID of the nic to detach.
CLI Example:
.. code-block:: bash
salt-cloud -a vm_detach_nic my-vm nic_id=1
u actionu< The vm_detach_nic action must be called with -a or --action.u nic_idu> The vm_detach_nic function requires a 'nic_id' to be provided.u :RP u nameu vm.detachnici u nic_detachedi u vm_idi u
error_codeN(
R RV RZ R R R� Rp R R� t detachnic( RR RP R t nic_idR R R! R" R� R� R� ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt
vm_detach_nic s& ! c C@ sD | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | j d d � } t | j d d � � } | d k s� | d k r� t d � � n t � \ } } } d
j | | g � }
t t d i | d 6� � } | j j j |
| t | � | | | � } i d
d 6| d d 6| d d 6| d d 6}
|
S( uI
Sets the disk to be saved in the given image.
.. versionadded:: 2016.3.0
name
The name of the VM containing the disk to save.
disk_id
The ID of the disk to save.
image_name
The name of the new image where the disk will be saved.
image_type
The type for the new image. If not set, then the default ``ONED`` Configuration
will be used. Other valid types include: OS, CDROM, DATABLOCK, KERNEL, RAMDISK,
and CONTEXT.
snapshot_id
The ID of the snapshot to export. If not set, the current image state will be
used.
CLI Example:
.. code-block:: bash
salt-cloud -a vm_disk_save my-vm disk_id=1 image_name=my-new-image
salt-cloud -a vm_disk_save my-vm disk_id=1 image_name=my-new-image image_type=CONTEXT snapshot_id=10
u actionu; The vm_disk_save action must be called with -a or --action.u disk_idu
image_nameu
image_typeu u snapshot_idu -1uR The vm_disk_save function requires a 'disk_id' and an 'image_name' to be provided.u :RP u nameu vm.disksavei u savedi u image_idi u
error_codeN(
R RV RZ R� R R Rp R R� t disksave( RR RP R R� R� t
image_typeR� R R R! R" R� R� R� ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt vm_disk_save@ s6 c C@ s | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | d k sl | d k r{ t d � � n t � \ } } } d j | | g � } t t d i | d 6� � } | j j j | | t | � | � }
i d d 6|
d
d 6|
d d
6|
d d 6} | S( u�
Takes a new snapshot of the disk image.
.. versionadded:: 2016.3.0
name
The name of the VM of which to take the snapshot.
disk_id
The ID of the disk to save.
description
The description for the snapshot.
CLI Example:
.. code-block:: bash
salt-cloud -a vm_disk_snapshot_create my-vm disk_id=0 description="My Snapshot Description"
u actionuF The vm_disk_snapshot_create action must be called with -a or --action.u disk_idu descriptionu] The vm_disk_snapshot_create function requires a 'disk_id' and a 'description' to be provided.u :RP u nameu vm.disksnapshotcreatei u createdi u snapshot_idi u
error_codeN(
R RV RZ R R R� Rp R R� t disksnapshotcreate( RR RP R R� t descriptionR R R! R" R� R� R� ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt vm_disk_snapshot_create� s. c C@ s | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | d k sl | d k r{ t d � � n t � \ } } } d j | | g � } t t d i | d 6� � } | j j j | | t | � t | � � }
i d d 6|
d
d 6|
d d 6|
d
d 6} | S( u�
Deletes a disk snapshot based on the given VM and the disk_id.
.. versionadded:: 2016.3.0
name
The name of the VM containing the snapshot to delete.
disk_id
The ID of the disk to save.
snapshot_id
The ID of the snapshot to be deleted.
CLI Example:
.. code-block:: bash
salt-cloud -a vm_disk_snapshot_delete my-vm disk_id=0 snapshot_id=6
u actionuF The vm_disk_snapshot_delete action must be called with -a or --action.u disk_idu snapshot_idu] The vm_disk_snapshot_create function requires a 'disk_id' and a 'snapshot_id' to be provided.u :RP u nameu vm.disksnapshotdeletei u deletedi i u
error_codeN(
R RV RZ R R R� Rp R R� t disksnapshotdelete( RR RP R R� R� R R R! R" R� R� R� ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt vm_disk_snapshot_delete� s. c C@ s | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | d k sl | d k r{ t d � � n t � \ } } } d j | | g � } t t d i | d 6� � } | j j j | | t | � t | � � }
i d d 6|
d
d 6|
d d 6|
d
d 6} | S( u�
Reverts a disk state to a previously taken snapshot.
.. versionadded:: 2016.3.0
name
The name of the VM containing the snapshot.
disk_id
The ID of the disk to revert its state.
snapshot_id
The ID of the snapshot to which the snapshot should be reverted.
CLI Example:
.. code-block:: bash
salt-cloud -a vm_disk_snapshot_revert my-vm disk_id=0 snapshot_id=6
u actionuF The vm_disk_snapshot_revert action must be called with -a or --action.u disk_idu snapshot_idu] The vm_disk_snapshot_revert function requires a 'disk_id' and a 'snapshot_id' to be provided.u :RP u nameu vm.disksnapshotreverti u deletedi i u
error_codeN(
R RV RZ R R R� Rp R R� t disksnapshotrevert( RR RP R R� R� R R R! R" R� R� R� ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt vm_disk_snapshot_revert� s. c
C@ s� | d k r t d � � n t � \ } } } d j | | g � } t t d i | d 6� � } | j j j | | � } | d t k r� | d Si } t | d � } t
| � | | j d � j <| Sd S(
u
Retrieves information for a given virtual machine. A VM name must be supplied.
.. versionadded:: 2016.3.0
name
The name of the VM for which to gather information.
CLI Example:
.. code-block:: bash
salt-cloud -a vm_info my-vm
u actionu6 The vm_info action must be called with -a or --action.u :RP u namei i u NAMEN(
R R R R� Rp R R� R R R R R R (
RR R R R R! R" R� R� R R� ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt vm_info.
s c C@ s� | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | j d t � } | j d t � } | j d d � } | j d d � } | r� | r� t j d � q� n+ | r� t d
i | d 6� } n t d � � | r| r0t j d
� q0n+ | r$t d
i | d 6� } n t d � � t � \ } }
} d j
|
| g � } t t d
i | d 6� � }
| j
j j | |
t | � t j j j | � t j j j | � t | � � } i d d 6| d d 6| d d 6| d d 6} | S( u
Migrates the specified virtual machine to the specified target host.
.. versionadded:: 2016.3.0
name
The name of the VM to migrate.
host_id
The ID of the host to which the VM will be migrated. Can be used instead
of ``host_name``.
host_name
The name of the host to which the VM will be migrated. Can be used instead
of ``host_id``.
live_migration
If set to ``True``, a live-migration will be performed. Default is ``False``.
capacity_maintained
True to enforce the Host capacity is not over-committed. This parameter is only
acknowledged for users in the ``oneadmin`` group. Host capacity will be always
enforced for regular users.
datastore_id
The target system data-store ID where the VM will be migrated. Can be used
instead of ``datastore_name``.
datastore_name
The name of the data-store target system where the VM will be migrated. Can be
used instead of ``datastore_id``.
CLI Example:
.. code-block:: bash
salt-cloud -a vm_migrate my-vm host_id=0 datastore_id=1
salt-cloud -a vm_migrate my-vm host_id=0 datastore_id=1 live_migration=True
salt-cloud -a vm_migrate my-vm host_name=host01 datastore_name=default
u actionu9 The vm_migrate action must be called with -a or --action.u host_idu host_nameu live_migrationu capacity_maintainedu datastore_idu datastore_nameuj Both the 'datastore_id' and 'datastore_name' arguments were provided. 'datastore_id' will take precedence.RP u nameu^ The vm_migrate function requires either a 'datastore_id' or a 'datastore_name' to be provided.u[ Both the 'host_id' and 'host_name' arguments were provided. 'host_id' will take precedence.uT The vm_migrate function requires either a 'host_id' or a 'host_name' to be provided.u :u
vm.migratei u migratedi u vm_idi u
error_codeN( R RV RZ R R= R, R- R_ R` R R R� Rp R R� t migrateR� R� R� R� ( RR RP R R� R� t live_migrationR� R� R� R R R! R" R� R� R� ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt
vm_migrateP
sT )
c
C@ s� | d k r t d � � n t � \ } } } d j | | g � } t t d i | d 6� � } | j j j | | � } | d t k r� t j
d � i Si } x4 t | d � D]" } t | � | | j
d � j <q� W| Sd
S( u�
Returns the monitoring records for a given virtual machine. A VM name must be
supplied.
The monitoring information returned is a list of VM elements. Each VM element
contains the complete dictionary of the VM with the updated information returned
by the poll action.
.. versionadded:: 2016.3.0
name
The name of the VM for which to gather monitoring records.
CLI Example:
.. code-block:: bash
salt-cloud -a vm_monitoring my-vm
u actionu< The vm_monitoring action must be called with -a or --action.u :RP u namei uH There was an error retrieving the specified VM's monitoring information.i u IDN( R R R R� Rp R R� t
monitoringR R, R� R R R R (
RR R R R R! R" R� R� R Rd ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt
vm_monitoring�
s c C@ sl | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | j d t � } | r� | r� t j d � q� nE | r� t j j j | d d �� } | j
� } Wd QXn t d
� � t � \ } } } d j | | g � }
t
t d i | d
6� � } | j j j |
| | t j j j | � � } i d d 6| d d 6| d d 6| d d 6}
|
S( u�
Changes the capacity of the virtual machine.
.. versionadded:: 2016.3.0
name
The name of the VM to resize.
path
The path to a file containing new capacity elements CPU, VCPU, MEMORY. If one
of them is not present, or its value is 0, the VM will not be re-sized. Syntax
within the file can be the usual attribute=value or XML. Can be used instead
of ``data``.
data
Contains the new capacity elements CPU, VCPU, and MEMORY. If one of them is not
present, or its value is 0, the VM will not be re-sized. Can be used instead of
``path``.
capacity_maintained
True to enforce the Host capacity is not over-committed. This parameter is only
acknowledged for users in the ``oneadmin`` group. Host capacity will be always
enforced for regular users.
CLI Example:
.. code-block:: bash
salt-cloud -a vm_resize my-vm path=/path/to/capacity_template.txt
salt-cloud -a vm_resize my-vm path=/path/to/capacity_template.txt capacity_maintained=False
salt-cloud -a vm_resize my-vm data="CPU=1 VCPU=1 MEMORY=1024"
u actionu8 The vm_resize action must be called with -a or --action.u pathu datau capacity_maintaineduP Both the 'data' and 'path' arguments were provided. 'data' will take precedence.R� u rNuN The vm_resize function requires either 'data' or a file 'path' to be provided.u :RP u nameu vm.resizei u resizedi u vm_idi u
error_code( R RV RZ R= R, R- R� R� R� R� R� R R R� Rp R R� t resizeR� R� ( RR RP R R� R� R� R� R R R! R" R� R� R] ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt vm_resize�
s6 !
- c C@ s� | d k r t d � � n | d k r0 i } n | j d d � } | d k r] t d � � n t � \ } } } d j | | g � } t t d i | d 6� � } | j j j | | | � } i d d 6| d d
6| d d 6| d
d 6}
|
S( un
Creates a new virtual machine snapshot from the provided VM.
.. versionadded:: 2016.3.0
vm_name
The name of the VM from which to create the snapshot.
snapshot_name
The name of the snapshot to be created.
CLI Example:
.. code-block:: bash
salt-cloud -a vm_snapshot_create my-vm snapshot_name=my-new-snapshot
u actionuA The vm_snapshot_create action must be called with -a or --action.u
snapshot_nameuJ The vm_snapshot_create function requires a 'snapshot_name' to be provided.u :RP u nameu vm.snapshotcreatei u snapshot_createdi u snapshot_idi u
error_codeN(
R RV RZ R R R� Rp R R� t snapshotcreate( R� RP R t
snapshot_nameR R R! R" R� R� R� ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt vm_snapshot_create. s& c C@ s� | d k r t d � � n | d k r0 i } n | j d d � } | d k r] t d � � n t � \ } } } d j | | g � } t t d i | d 6� � } | j j j | | t | � � } i d d 6| d d
6| d d 6| d
d 6}
|
S( uV
Deletes a virtual machine snapshot from the provided VM.
.. versionadded:: 2016.3.0
vm_name
The name of the VM from which to delete the snapshot.
snapshot_id
The ID of the snapshot to be deleted.
CLI Example:
.. code-block:: bash
salt-cloud -a vm_snapshot_delete my-vm snapshot_id=8
u actionuA The vm_snapshot_delete action must be called with -a or --action.u snapshot_iduH The vm_snapshot_delete function requires a 'snapshot_id' to be provided.u :RP u nameu vm.snapshotdeletei u snapshot_deletedi u vm_idi u
error_codeN(
R RV RZ R R R� Rp R R� R� ( R� RP R R� R R R! R" R� R� R� ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt vm_snapshot_delete] s& ! c C@ s� | d k r t d � � n | d k r0 i } n | j d d � } | d k r] t d � � n t � \ } } } d j | | g � } t t d i | d 6� � } | j j j | | t | � � } i d d 6| d d
6| d d 6| d
d 6}
|
S( u
Reverts a virtual machine to a snapshot
.. versionadded:: 2016.3.0
vm_name
The name of the VM to revert.
snapshot_id
The snapshot ID.
CLI Example:
.. code-block:: bash
salt-cloud -a vm_snapshot_revert my-vm snapshot_id=42
u actionuA The vm_snapshot_revert action must be called with -a or --action.u snapshot_iduH The vm_snapshot_revert function requires a 'snapshot_id' to be provided.u :RP u nameu vm.snapshotreverti u snapshot_revertedi u vm_idi u
error_codeN(
R RV RZ R R R� Rp R R� R� ( R� RP R R� R R R! R" R� R� R� ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt vm_snapshot_revert� s& ! c C@ s� | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | j d d � } d d g } | d k r� t d � � n | | d k r� d } n9 | | d
k r� d
} n t d j | d | d
� � � | r� | rCt j d � qCnE | r7t j j j | d
d �� } | j
� } Wd QXn t d � � t � \ } }
} d j |
| g � } t
t d i | d 6� � }
| j j j | |
| t
| � � } i d d 6| d d 6| d
d 6| d d 6} | S( u�
Replaces the user template contents.
.. versionadded:: 2016.3.0
name
The name of the VM to update.
path
The path to a file containing new user template contents. Syntax within the
file can be the usual attribute=value or XML. Can be used instead of ``data``.
data
Contains the new user template contents. Syntax can be the usual attribute=value
or XML. Can be used instead of ``path``.
update_type
There are two ways to update a VM: ``replace`` the whole template
or ``merge`` the new template with the existing one.
CLI Example:
.. code-block:: bash
salt-cloud -a vm_update my-vm path=/path/to/user_template_file.txt update_type='replace'
u actionu8 The vm_update action must be called with -a or --action.u pathu datau update_typeu replaceu mergeu@ The vm_update function requires an 'update_type' to be provided.i i u3 The update_type argument must be either {0} or {1}.uP Both the 'data' and 'path' arguments were provided. 'data' will take precedence.R� u rNuN The vm_update function requires either 'data' or a file 'path' to be provided.u :RP u nameu vm.updateu updatedu resource_idi u
error_code( R RV RZ R\ R, R- R� R� R� R� R� R R R� Rp R R� R� ( RR RP R R� R� R� R� R� R� R R R! R" R� R� R] ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt vm_update� sN
$ c
C@ s� | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | j d d � } | j d d � } | r� | r� t j d � q� n+ | r� t d i | d 6� } n t d
� � | r� | r&t j d � q&nE | rt j j j | d d
�� } | j
� } Wd QXn t d � � t � \ } } } d j | | g � }
| j
j j |
t | � | � } i d d 6| d d 6| d d 6| d d 6} | S( u�
Adds address ranges to a given virtual network.
.. versionadded:: 2016.3.0
vn_id
The ID of the virtual network to add the address range. Can be used
instead of ``vn_name``.
vn_name
The name of the virtual network to add the address range. Can be used
instead of ``vn_id``.
path
The path to a file containing the template of the address range to add.
Syntax within the file can be the usual attribute=value or XML. Can be
used instead of ``data``.
data
Contains the template of the address range to add. Syntax can be the
usual attribute=value or XML. Can be used instead of ``path``.
CLI Example:
.. code-block:: bash
salt-cloud -f vn_add_ar opennebula vn_id=3 path=/path/to/address_range.txt
salt-cloud -f vn_add_ar opennebula vn_name=my-vn \
data="AR=[TYPE=IP4, IP=192.168.0.5, SIZE=10]"
u functionu< The vn_add_ar function must be called with -f or --function.u vn_idu vn_nameu pathu datauU Both the 'vn_id' and 'vn_name' arguments were provided. 'vn_id' will take precedence.RP u nameuI The vn_add_ar function requires a 'vn_id' and a 'vn_name' to be provided.uP Both the 'data' and 'path' arguments were provided. 'data' will take precedence.R� u rNuN The vn_add_ar function requires either 'data' or a file 'path' to be provided.u :u vn.add_aru actioni u address_range_addedi u resource_idi u
error_code( R RV RZ R, R- Rq R� R� R� R� R� R R R t vnt add_arR� (
R RP t vn_idt vn_nameR� R� R� R R R! R" R� R] ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt vn_add_ar sF
! c
C@ s� | d k r t d � � n | d
k r0 i } n | j d d
� } | j d d
� } | j d d
� } | j d d
� } | r� | r� t j d � q� nE | r� t j j j | d d �� } | j � } Wd
QXn t d � � | r� | r t j d � q n% | rt
d
i | d 6� } n d } t � \ } } } d j | | g � }
| j
j j |
| t | � � } i d d 6| d d 6| d d 6| d d 6} | S( uI
Allocates a new virtual network in OpenNebula.
.. versionadded:: 2016.3.0
path
The path to a file containing the template of the virtual network to allocate.
Syntax within the file can be the usual attribute=value or XML. Can be used
instead of ``data``.
data
Contains the template of the virtual network to allocate. Syntax can be the
usual attribute=value or XML. Can be used instead of ``path``.
cluster_id
The ID of the cluster for which to add the new virtual network. Can be used
instead of ``cluster_name``. If neither ``cluster_id`` nor ``cluster_name``
are provided, the virtual network won’t be added to any cluster.
cluster_name
The name of the cluster for which to add the new virtual network. Can be used
instead of ``cluster_id``. If neither ``cluster_name`` nor ``cluster_id`` are
provided, the virtual network won't be added to any cluster.
CLI Example:
.. code-block:: bash
salt-cloud -f vn_allocate opennebula path=/path/to/vn_file.txt
u functionu> The vn_allocate function must be called with -f or --function.u
cluster_idu cluster_nameu pathu datauP Both the 'data' and 'path' arguments were provided. 'data' will take precedence.R� u rNuP The vn_allocate function requires either 'data' or a file 'path' to be provided.ud Both the 'cluster_id' and 'cluster_name' arguments were provided. 'cluster_id' will take precedence.RP u nameu -1u :u vn.allocateu actioni u allocatedi u vn_idi u
error_code( R RV RZ R, R- R� R� R� R� R� R^ R R R R R� R� (
R RP t
cluster_idt cluster_nameR� R� R� R R R! R" R� R] ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt vn_allocatei sD
! c
C@ s | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | rs | r� t j d � q� n+ | r� t d i | d 6� } n t d � � t � \ } } } d j | | g � } | j j j
| t | � � } i d d
6| d d 6| d
d 6| d d 6} | S( u�
Deletes the given virtual network from OpenNebula. Either a name or a vn_id must
be supplied.
.. versionadded:: 2016.3.0
name
The name of the virtual network to delete. Can be used instead of ``vn_id``.
vn_id
The ID of the virtual network to delete. Can be used instead of ``name``.
CLI Example:
.. code-block:: bash
salt-cloud -f vn_delete opennebula name=my-virtual-network
salt-cloud --function vn_delete opennebula vn_id=3
u functionu< The vn_delete function must be called with -f or --function.u nameu vn_iduR Both the 'vn_id' and 'name' arguments were provided. 'vn_id' will take precedence.RP uE The vn_delete function requires a 'name' or a 'vn_id' to be provided.u :u vn.deleteu actioni u deletedi i u
error_codeN( R RV RZ R, R- Rq R R R R R� R� (
R RP RR R R R R! R" R� R� ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt vn_delete� s0
c C@ sK | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | j d d � } | d k r� t d � � n | r� | r� t j d � q� n+ | r� t d i | d 6� } n t d
� � t � \ } } } d j | | g � } | j j j
| t | � t | � � } i d d
6| d d 6| d d 6| d d 6}
|
S( uI
Frees a reserved address range from a virtual network.
.. versionadded:: 2016.3.0
vn_id
The ID of the virtual network from which to free an address range.
Can be used instead of ``vn_name``.
vn_name
The name of the virtual network from which to free an address range.
Can be used instead of ``vn_id``.
ar_id
The ID of the address range to free.
CLI Example:
.. code-block:: bash
salt-cloud -f vn_free_ar opennebula vn_id=3 ar_id=1
salt-cloud -f vn_free_ar opennebula vn_name=my-vn ar_id=1
u functionu= The vn_free_ar function must be called with -f or --function.u vn_idu vn_nameu ar_idu; The vn_free_ar function requires an 'rn_id' to be provided.uU Both the 'vn_id' and 'vn_name' arguments were provided. 'vn_id' will take precedence.RP u nameuI The vn_free_ar function requires a 'vn_id' or a 'vn_name' to be provided.u :u
vn.free_aru actioni u ar_freedi u resource_idi u
error_codeN( R RV RZ R, R- Rq R R R R t free_arR� ( R RP R R
t ar_idR R R! R" R� R� ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt
vn_free_ar� s8
' c
C@ s� | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | j d d � } | j d d � } | r� | r� t j d � q� n+ | r� t d i | d 6� } n t d
� � | r� | r&t j d � q&nE | rt j j j | d d
�� } | j
� } Wd QXn t d � � t � \ } } } d j | | g � }
| j
j j |
t | � | � } i d d 6| d d 6| d d 6| d d 6} | S( ut
Holds a virtual network lease as used.
.. versionadded:: 2016.3.0
vn_id
The ID of the virtual network from which to hold the lease. Can be used
instead of ``vn_name``.
vn_name
The name of the virtual network from which to hold the lease. Can be used
instead of ``vn_id``.
path
The path to a file defining the template of the lease to hold.
Syntax within the file can be the usual attribute=value or XML. Can be
used instead of ``data``.
data
Contains the template of the lease to hold. Syntax can be the usual
attribute=value or XML. Can be used instead of ``path``.
CLI Example:
.. code-block:: bash
salt-cloud -f vn_hold opennebula vn_id=3 path=/path/to/vn_hold_file.txt
salt-cloud -f vn_hold opennebula vn_name=my-vn data="LEASES=[IP=192.168.0.5]"
u functionu: The vn_hold function must be called with -f or --function.u vn_idu vn_nameu pathu datauU Both the 'vn_id' and 'vn_name' arguments were provided. 'vn_id' will take precedence.RP u nameuF The vn_hold function requires a 'vn_id' or a 'vn_name' to be provided.uP Both the 'data' and 'path' arguments were provided. 'data' will take precedence.R� u rNuG The vn_hold function requires either 'data' or a 'path' to be provided.u :u vn.holdu actioni u heldi u resource_idi u
error_code( R RV RZ R, R- Rq R� R� R� R� R� R R R R R� R� (
R RP R R
R� R� R� R R R! R" R� R] ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt vn_hold= sF
! c C@ s5 | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | rs | r� t j d � q� n+ | r� t d i | d 6� } n t d � � t � \ } } } d j | | g � } | j j j
| t | � � } | d t k r� | d
Si } t
| d
� }
t |
� | |
j d � j <| Sd S(
u�
Retrieves information for the virtual network.
.. versionadded:: 2016.3.0
name
The name of the virtual network for which to gather information. Can be
used instead of ``vn_id``.
vn_id
The ID of the virtual network for which to gather information. Can be
used instead of ``name``.
CLI Example:
.. code-block:: bash
salt-cloud -f vn_info opennebula vn_id=3
salt-cloud --function vn_info opennebula name=public
u functionu: The vn_info function must be called with -f or --function.u nameu vn_iduR Both the 'vn_id' and 'name' arguments were provided. 'vn_id' will take precedence.RP uJ The vn_info function requires either a 'name' or a 'vn_id' to be provided.u :i i u NAMEN( R RV RZ R, R- Rq R R R R R R� R R R R R ( R RP RR R R R R! R" R� R R� ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt vn_info� s0
c
C@ s� | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | j d d � } | j d d � } | r� | r� t j d � q� n+ | r� t d i | d 6� } n t d
� � | r� | r&t j d � q&nE | rt j j j | d d
�� } | j
� } Wd QXn t d � � t � \ } } } d j | | g � }
| j
j j |
t | � | � } i d d 6| d d 6| d d 6| d d 6} | S( u�
Releases a virtual network lease that was previously on hold.
.. versionadded:: 2016.3.0
vn_id
The ID of the virtual network from which to release the lease. Can be
used instead of ``vn_name``.
vn_name
The name of the virtual network from which to release the lease.
Can be used instead of ``vn_id``.
path
The path to a file defining the template of the lease to release.
Syntax within the file can be the usual attribute=value or XML. Can be
used instead of ``data``.
data
Contains the template defining the lease to release. Syntax can be the
usual attribute=value or XML. Can be used instead of ``path``.
CLI Example:
.. code-block:: bash
salt-cloud -f vn_release opennebula vn_id=3 path=/path/to/vn_release_file.txt
salt-cloud =f vn_release opennebula vn_name=my-vn data="LEASES=[IP=192.168.0.5]"
u functionu= The vn_reserve function must be called with -f or --function.u vn_idu vn_nameu pathu datauU Both the 'vn_id' and 'vn_name' arguments were provided. 'vn_id' will take precedence.RP u nameuI The vn_release function requires a 'vn_id' or a 'vn_name' to be provided.uP Both the 'data' and 'path' arguments were provided. 'data' will take precedence.R� u rNuJ The vn_release function requires either 'data' or a 'path' to be provided.u :u
vn.releaseu actioni u releasedi u resource_idi u
error_code( R RV RZ R, R- Rq R� R� R� R� R� R R R R t releaseR� (
R RP R R
R� R� R� R R R! R" R� R] ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt
vn_release� sF
! c
C@ s� | d k r t d � � n | d k r0 i } n | j d d � } | j d d � } | j d d � } | j d d � } | r� | r� t j d � q� n+ | r� t d i | d 6� } n t d
� � | r� | r&t j d � q&nE | rt j j j | d d
�� } | j
� } Wd QXn t d � � t � \ } } } d j | | g � }
| j
j j |
t | � | � } i d d 6| d d 6| d d 6| d d 6} | S( u�
Reserve network addresses.
.. versionadded:: 2016.3.0
vn_id
The ID of the virtual network from which to reserve addresses. Can be used
instead of vn_name.
vn_name
The name of the virtual network from which to reserve addresses. Can be
used instead of vn_id.
path
The path to a file defining the template of the address reservation.
Syntax within the file can be the usual attribute=value or XML. Can be used
instead of ``data``.
data
Contains the template defining the address reservation. Syntax can be the
usual attribute=value or XML. Data provided must be wrapped in double
quotes. Can be used instead of ``path``.
CLI Example:
.. code-block:: bash
salt-cloud -f vn_reserve opennebula vn_id=3 path=/path/to/vn_reserve_file.txt
salt-cloud -f vn_reserve opennebula vn_name=my-vn data="SIZE=10 AR_ID=8 NETWORK_ID=1"
u functionu= The vn_reserve function must be called with -f or --function.u vn_idu vn_nameu pathu datauU Both the 'vn_id' and 'vn_name' arguments were provided. 'vn_id' will take precedence.RP u nameuI The vn_reserve function requires a 'vn_id' or a 'vn_name' to be provided.uP Both the 'data' and 'path' arguments were provided. 'data' will take precedence.R� u rNu9 The vn_reserve function requires a 'path' to be provided.u :u
vn.reserveu actioni u reservedi u resource_idi u
error_code( R RV RZ R, R- Rq R� R� R� R� R� R R R R t reserveR� (
R RP R R
R� R� R� R R R! R" R� R] ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt
vn_reserve$ sF
! c C@ sj d } x] | d k re y t � | SWq t k
ra | d 8} t j d | | � t j d � q Xq Wi S( u�
Helper function that returns all information about a named node.
name
The name of the node for which to get information.
i
i i u< Failed to get the data for node '%s'. Remaining attempts: %sg �?( R> R[ R, R� t timet sleep( RR t attempts( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyR� | s
c C@ sE y t j | � } Wn+ t j k
r@ } t d j | � � � n X| S( uN
Intrepret the data coming from opennebula and raise if it's not XML.
u opennebula returned: {0}( R t XMLt XMLSyntaxErrorR R\ ( t xml_strt xml_datat err( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyR � s
c C@ s� t � } t j d | t d t �} t j d | t d t �} t j d | t d t �} t j j j j j
| � } | | | f S( u�
Uses the OpenNebula cloud provider configurations to connect to the
OpenNebula API.
Returns the server connection created as well as the user and password
values from the cloud provider config file used to make the connection.
u xml_rpcRa u useru password( R
R Rc R R R� t extR t movest
xmlrpc_clientt ServerProxy( Rd t xml_rpcR R! R ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyR � s c
C@ s� t � \ } } } d j | | g � } | j j j | d d d d � d } i } x�t | � D]�} | j d � j } i | | <| j d � j d � j } | j d � j d � j }
g } xQ | j d � j d � D]7 } y | j | j d
� j � Wq� t
k
r q� Xq� W| j d � j | | d <d
| j d � k rf| j d � j d
� j | | d <n | | | d <i | d 6|
d 6| | d <| j d � j | | d <| | | d <g | | d <| r_ t | � | | j d � j <q_ q_ W| S( u�
Helper function for the list_* query functions - Constructs the
appropriate dictionaries to return from the API query.
full
If performing a full query, such as in list_nodes_full, change
this parameter to ``True``.
u :i����i����i u NAMEu TEMPLATEu CPUu MEMORYu NICu IPu IDu idu TEMPLATE_IDu imageu nameu cpuu memoryu sizeu STATEu stateu private_ipsu
public_ips( R R R t vmpoolR R R R t findallR� R� R (
R: R R R! R" t vm_poolt vmsR� RR t cpu_sizet memory_sizet private_ipst nic( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyR; � s4 %
& #c C@ s� i } x� | D]z } | j j � } d } x- | | k rW | t j | � 7} | d 7} q+ W| j d k rz t | � | | <q
| j | | <q
W| S( ui
Helper function to covert xml into a data dictionary.
xml
The xml data to convert.
i N( t tagt lowerR Rb R RV R ( t xmlt dictst itemt keyt idx( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyR � s
(x t __doc__t
__future__R R R R� R� R� R t salt.configR t salt.exceptionsR R R R R t salt.utils.dataR� t salt.utils.filest salt.extR t salt.ext.six.moves.xmlrpc_clientt lxmlR R= R t ImportErrorR t getLoggert __name__R, R
R R
R RV R& R+ R. R3 R8 R9 R< R> R@ RE RJ RO RS RT RU RY R^ R_ R` Rf Rg Rj Rk Rl Rm Ro Rp Rq R} R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� R� RQ R� R� R� R� R� R� R� R� R� R� R� R� R� R R R R R R R R R R R R R R� R R R; R ( ( ( s@ /usr/lib/python2.7/site-packages/salt/cloud/clouds/opennebula.pyt <module>= s� (
$$$ $ $"$ $$ / � >XD;:EECDl @F<:pBI;KpADCCc//F888 "h +K///WWT;EV;VX ,
Mini Shell