Current File : //usr/lib/python2.7/site-packages/salt/utils/vmware.pyc
�
���^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 Z d d l
Z
d d l Z d d l
Z d d l Z d d l Z d d l Z d d l m Z d d l m Z yN d d l m Z m Z m Z m Z m Z d d l m Z m Z m Z e Z Wn e! k
r-e" Z n Xy" d d l# Z# d d l$ Z$ e Z% Wn e! k
rie" Z% n Xe j& e' � Z( d � Z) d d d d d � Z+ d
� Z, d � Z- d � Z. d d d d d
d d d � Z/ d d d � Z0 d d � Z1 d � Z2 d � Z3 d � Z4 d � Z5 d � Z6 d � Z7 d � Z8 d � Z9 d � Z: d � Z; d � Z< d � Z= d � Z> d d d e" d � Z? d d d! � Z@ d d d e" d" � ZA d# � ZB d$ � ZC d% � ZD d& � ZE d e" d' � ZF d( � ZG d d) � ZH d* � ZI d+ � ZJ d e" d, � ZK d- � ZL d. � ZM d/ � ZN d0 � ZO d e" d1 � ZP d d2 � ZQ d3 � ZR d4 � ZS d d5 � ZT d d6 � ZU d d d d7 � ZV d d d d8 � ZW d9 � ZX d e" d: � ZY d; � ZZ d< � Z[ d= � Z\ d> � Z] d? � Z^ d@ � Z_ dA � Z` dB � Za dC � Zb d d e" dD � Zc dE � Zd d dF � Ze dG � Zf dH � Zg d dI � Zh d dJ � Zi dK � Zj d d d e" dL � Zk d d dM � Zl d d dN � Zm d d dO � Zn d d e" dP � Zo d dQ � Zp d d dR � Zq d e" dS � Zr dT � Zs d dU � Zt d dV � Zu dW � Zv d e" dX � Zw dY � Zx dZ � Zy d[ � Zz d\ � Z{ d] � Z| d^ � Z} d_ � Z~ d` da db � Z d d d d dc � Z� d dd � Z� d de � Z� df � Z� dg dh � Z� d di � Z� d dj � Z� dk � Z� dl � Z� dm � Z� d S(n ul
Connection library for VMware
.. versionadded:: 2015.8.2
This is a base library used by a number of VMware services such as VMware
ESX, ESXi, and vCenter servers.
:codeauthor: Nitin Madhok <nmadhok@clemson.edu>
:codeauthor: Alexandru Bleotu <alexandru.bleotu@morganstanley.com>
Dependencies
~~~~~~~~~~~~
- pyVmomi Python Module
- ESXCLI: This dependency is only needed to use the ``esxcli`` function. No other
functions in this module rely on ESXCLI.
pyVmomi
-------
PyVmomi can be installed via pip:
.. code-block:: bash
pip install pyVmomi
.. note::
Version 6.0 of pyVmomi has some problems with SSL error handling on certain
versions of Python. If using version 6.0 of pyVmomi, Python 2.6,
Python 2.7.9, or newer must be present. This is due to an upstream dependency
in pyVmomi 6.0 that is not supported in Python versions 2.7 to 2.7.8. If the
version of Python is not in the supported range, you will need to install an
earlier version of pyVmomi. See `Issue #29537`_ for more information.
.. _Issue #29537: https://github.com/saltstack/salt/issues/29537
Based on the note above, to install an earlier version of pyVmomi than the
version currently listed in PyPi, run the following:
.. code-block:: bash
pip install pyVmomi==5.5.0.2014.1.1
The 5.5.0.2014.1.1 is a known stable version that this original VMware utils file
was developed against.
ESXCLI
------
This dependency is only needed to use the ``esxcli`` function. At the time of this
writing, no other functions in this module rely on ESXCLI.
The ESXCLI package is also referred to as the VMware vSphere CLI, or vCLI. VMware
provides vCLI package installation instructions for `vSphere 5.5`_ and
`vSphere 6.0`_.
.. _vSphere 5.5: http://pubs.vmware.com/vsphere-55/index.jsp#com.vmware.vcli.getstart.doc/cli_install.4.2.html
.. _vSphere 6.0: http://pubs.vmware.com/vsphere-60/index.jsp#com.vmware.vcli.getstart.doc/cli_install.4.2.html
Once all of the required dependencies are in place and the vCLI package is
installed, you can check to see if you can connect to your ESXi host or vCenter
server by running the following command:
.. code-block:: bash
esxcli -s <host-location> -u <username> -p <password> system syslog config get
If the connection was successful, ESXCLI was successfully installed on your system.
You should see output related to the ESXi host's syslog configuration.
i ( t absolute_importt print_functiont unicode_literalsN( t six( t
BadStatusLine( t GetSit SmartConnectt
Disconnectt GetStubt SoapStubAdapter( t vimt vmodlt VmomiSupportc C@ s t r
t St d f S( u,
Only load if PyVmomi is installed.
uB Missing dependency: The salt.utils.vmware module requires pyVmomi.( t HAS_PYVMOMIt Truet False( ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt __virtual__s s c
C@ s� t j j j d � } | s, t j d � t S| d
k rA d } n | d
k rV d } n | rr | d j | � 7} n | s� | d j | | | | | | � 7} n% | d j | | | | | | | � 7} t j j
j | d d �} | S( u)
Shell out and call the specified esxcli commmand, parse the result
and return something sane.
:param host: ESXi or vCenter host to connect to
:param user: User to connect as, usually root
:param pwd: Password to connect with
:param port: TCP port
:param cmd: esxcli command and arguments
:param esxi_host: If `host` is a vCenter host, then esxi_host is the
ESXi machine on which to execute this command
:param credstore: Optional path to the credential store file
:return: Dictionary
u esxcliuJ Missing dependency: The salt.utils.vmware.esxcli function requires ESXCLI.i� u httpsu --credstore '{0}'u; -s {0} -u {1} -p '{2}' --protocol={3} --portnumber={4} {5}uB -s {0} -h {1} -u {2} -p '{3}' --protocol={4} --portnumber={5} {6}t output_loglevelu quietN( t saltt utilst patht whicht logt errorR t Nonet formatt modulest cmdmodt run_all(
t hostt usert pwdt cmdt protocolt portt esxi_hostt credstoret esx_cmdt ret( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt esxcli} s8
c C@ s� t j d � d } | d k rd | d k r@ t j j d � � n | d k rt j j d � � qn� | d k r� | d k r� | d k r� y t | | | � } Wq� t k
r� } t j j t j
| � � � q� Xqd j | � }
t j j |
� � n t j j d j | � � � yJ t j d | | � t d | d
| d | d | d
| d | d | � } Wnrt
k
r�} d | j k r�t j d | j � t j d � t j d � � q�n t k
r�} d j | � } y� t | t j j � r�d | j k s d t j
| � k r`t d | d
| d | d | d
| d t t d t t d � � � d | d | � } n= t j | � t | d � r�| j n | }
t j j |
� � Wq�t k
r�} d t j
| � k r�t j t j � }
t j |
_ y= t d | d
| d | d | d
| d |
d | d | � } Wq�t k
r�} t j | � t | d � rW| j n t j
| � }
t j j d j | |
� � � q�Xq�t | d � r�| j n | }
t j | � t j j |
� � q�Xn Xt j t | � | S( u|
Internal method to authenticate with a vCenter server or ESX/ESXi host
and return the service instance object.
u Retrieving new service instanceu userpassuX Login mechanism userpass was specified but the mandatory parameter 'username' is missinguX Login mechanism userpass was specified but the mandatory parameter 'password' is missingu sspiuL Login mechanism '{0}' was specified but the mandatory parameters are missingu Unsupported mechanism: '{0}'u7 Connecting using the '%s' mechanism, with username '%s'R R R R! R" t b64tokent mechanismu unexpected keyword argumentu5 Initial connect to the VMware endpoint failed with %suO This may mean that a version of PyVmomi EARLIER than 6.0.0.2016.6 is installed.u/ We recommend updating to that version or later.uQ Could not connect to host '{0}'. Please check the debug log for more information.u [SSL: CERTIFICATE_VERIFY_FAILED]t
sslContextu _create_unverified_contextu _create_stdlib_contextu msgu certificate verify failedu$ Could not connect to host '{0}': {1}N( R t traceR R t
exceptionst CommandExecutionErrort get_gssapi_tokent Exceptiont VMwareConnectionErrorR t text_typeR R t TypeErrort messageR t
isinstanceR
t faultt HostConnectFaultt msgt getattrt sslt exceptiont hasattrt
SSLContextt PROTOCOL_TLSv1t CERT_NONEt verify_modet atexitt registerR ( R t usernamet passwordR! R" R) t principalt domaint tokent exct err_msgt service_instancet default_msgt context( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt _get_service_instance� s�
"
'
c C@ s | j j j d | � } | S( u�
Get a reference to a VMware customization spec for the purposes of customizing a clone
si
ServiceInstance for the vSphere or ESXi server (see get_service_instance)
customization_spec_name
Name of the customization spec
t name( t contentt customizationSpecManagert GetCustomizationSpec( t sit customization_spec_name( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt get_customizationspec_ref s c C@ sU t | � } | j j | j | g t � } x$ | j D] } | j | k r4 | Sq4 Wd S( u
Get reference to an object of specified object type and name
si
ServiceInstance for the vSphere or ESXi server (see get_service_instance)
obj_type
Type of the object (vim.StoragePod, vim.Datastore, etc)
obj_name
Name of the object
N( t
get_inventoryt viewManagert CreateContainerViewt
rootFolderR t viewRM R ( RQ t obj_typet obj_namet inventoryt containert item( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt get_mor_using_container_view( s u userpassc C@ s� | d k r d } n | d k r* d } n t � } | r� t � } t j j j � s� t | d � r� | j d j | t
j | � g � k r� t | � d } q� | Sn | s� t
| | | | | | | | � } n t j d � y | j � Wnt j j k
r:t j d � t | � t
| | | | | | | | � } n� t j j k
r}}
t j |
� t j j d j |
j � � � nr t j j k
r�}
t j |
� t j j |
j � � n8 t j k
r�}
t j |
� t j j |
j � � n X| S( u)
Authenticate with a vCenter server or ESX/ESXi host and return the service instance object.
host
The location of the vCenter server or ESX/ESXi host.
username
The username used to login to the vCenter server or ESX/ESXi host.
Required if mechanism is ``userpass``
password
The password used to login to the vCenter server or ESX/ESXi host.
Required if mechanism is ``userpass``
protocol
Optionally set to alternate protocol if the vCenter server or ESX/ESXi host is not
using the default protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the vCenter server or ESX/ESXi host is not
using the default port. Default port is ``443``.
mechanism
pyVmomi connection mechanism. Can either be ``userpass`` or ``sspi``.
Default mechanism is ``userpass``.
principal
Kerberos service principal. Required if mechanism is ``sspi``
domain
Kerberos user domain. Required if mechanism is ``sspi``
u httpsi� u hostu :u* Checking connection is still authenticatedu. Session no longer authenticating. Reconnectingu. Not enough permissions. Required privilege: {}N( R R R R R t platformt is_proxyR; R t joinR R1 R RL R R+ t CurrentTimeR
R5 t NotAuthenticatedt NoPermissionR: R, t VMwareApiErrorR t privilegeIdt VimFaultR7 R t RuntimeFaultt VMwareRuntimeError( R RB RC R! R" R) RD RE RI t stubRG ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt get_service_instance> s` $ '
c
C@ s� d } t j d d k r= t j � } t | _ t j | _ n | j } | j
j d � d } | j j d � d } | t
j � d <t d
| d | d | d
| d d d | � } | j | _ | S( uT
Returns a stub that points to a different path,
created from an existing connection.
service_instance
The Service Instance.
path
Path of the new stub.
ns
Namespace of the new stub.
Default value is None
version
Version of the new stub.
Default value is None.
i i i i u :i u "i u vcSessionCookieR t nsR t versiont poolSizeR* N( i i i ( R t syst version_infoR9 t create_default_contextR t check_hostnameR> R? t _stubR t splitt cookieR t GetRequestContextR ( RI R Rl Rm RK Rj t hostnamet session_cookiet new_stub( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt get_new_service_instance_stub� s" u <unnamed>c C@ sA | s | j } n t j d | � t j d � } | j | _ | S( u�
Retrieves the service instance from a managed object.
me_ref
Reference to a managed object (of type vim.ManagedEntity).
name
Name of managed object. This field is optional.
u4 [%s] Retrieving service instance from managed objectu ServiceInstance( RM R R+ R
t ServiceInstanceRs ( t mo_refRM RQ ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt( get_service_instance_from_managed_object� s
c C@ s� t j d � y t | � Wn� t j j k
ra } t j | � t j j d j
| j � � � nr t j j k
r� } t j | � t j j | j
� � n8 t j k
r� } t j | � t j j | j
� � n Xd S( u�
Function that disconnects from the vCenter server or ESXi host
service_instance
The Service Instance from which to obtain managed object references.
u
Disconnectingu. Not enough permissions. Required privilege: {}N( R R+ R R
R5 Rd R: R R, Re R Rf Rg R7 R Rh Ri ( RI RG ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt
disconnect� s
c C@ s y | j j j } Wn� t j j k
rY } t j | � t j j
d j | j � � � nr t j j
k
r� } t j | � t j j
| j � � n8 t j k
r� } t j | � t j j | j � � n Xt j d | � | d k r� t S| d k r� t St j j
d j | � � � d S( u�
Function that returns True if the connection is made to a vCenter Server and
False if the connection is made to an ESXi host
service_instance
The Service Instance from which to obtain managed object references.
u. Not enough permissions. Required privilege: {}u
api_type = %su
VirtualCenteru HostAgentuF Unexpected api type '{0}' . Supported types: 'VirtualCenter/HostAgent'N( RN t aboutt apiTypeR
R5 Rd R R: R R, Re R Rf Rg R7 R Rh Ri R+ R R ( RI t api_typeRG ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt is_connection_to_a_vcenter� s*
c C@ s� y | j j SWn� t j j k
rT } t j | � t j j d j
| j � � � nr t j j k
r� } t j | � t j j | j
� � n8 t j k
r� } t j | � t j j | j
� � n Xd S( u�
Returns information of the vCenter or ESXi host
service_instance
The Service Instance from which to obtain managed object references.
u/ Not enough permissions. Required privilege: {0}N( RN R R
R5 Rd R R: R R, Re R Rf Rg R7 R Rh Ri ( RI RG ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt get_service_info s
c C@ ss t | � } | | k ro t | � } | j j | j t j g t � } x' | j D] } | j | k rO | SqO Wn d S( u�
Return a reference to a Distributed Virtual Switch object.
:param service_instance: PyVmomi service instance
:param dvs_name: Name of DVS to return
:return: A PyVmomi DVS object
N( t list_dvsRT RU RV RW R
t DistributedVirtualSwitchR RX RM R ( RI t dvs_namet switchesR[ R\ R] ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt _get_dvs( s ! c C@ s
| j j j S( uT
Helper function that returns a list of PhysicalNics and their information.
( t configt networkt pnic( t host_reference( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt
_get_pnics; s c C@ s
| j j j S( uS
Helper function that returns a list of VirtualNics and their information.
( R� R� t vnic( R� ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt
_get_vnicsB s c C@ s
| j j S( u_
Helper function that returns a list of Virtual NicManagers
and their information.
( t
configManagert virtualNicManager( R� ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt _get_vnic_managerI s c C@ s+ x$ | j D] } | j | k r
| Sq
Wd S( u�
Return a portgroup object corresponding to the portgroup name on the dvs
:param dvs: DVS object
:param portgroup_name: Name of portgroup to return
:return: Portgroup object
N( t portgroupRM R ( t dvst portgroup_nameR� ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt _get_dvs_portgroupQ s c C@ s+ x$ | j D] } | j | k r
| Sq
Wd S( u�
Return a portgroup object corresponding to the portgroup name on the dvs
:param dvs: DVS object
:param portgroup_name: Name of portgroup to return
:return: Portgroup object
N( R� RM R ( R� R� R� ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt _get_dvs_uplink_portgroup` s c C@ s� t s t d � � n d j | | | � } t j d | � t j | t j � } t j | � } d } x| | j
s� | j | � } | r� t j
r� t j | � St j t j j j | � � S| j
r� Pn | sg t j j d � � qg qg Wt j j d � � d S( u�
Get the gssapi token for Kerberos connection
principal
The service principal
host
Host url where we would like to authenticate
domain
Kerberos user domain
u# The gssapi library is not imported.u {0}/{1}@{2}u% Retrieving gsspi token for service %su, Can't receive token, no response from serveru- Context established, but didn't receive tokenN( t
HAS_GSSAPIt ImportErrorR R t debugt gssapit Namet C_NT_USER_NAMEt InitContextR t establishedt stepR t PY2t base64t b64encodeR R t stringutilst to_bytesR, R- ( RD R RE t servicet service_namet ctxt in_tokent out_token( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyR. o s(
c C@ sq i } t | � j j d k rm| j j j | j � j t j g t
� } | rd| j rd| j d j j
j | d <| j d j j
j | d <x@ | j d j j
j D]( } | j j d k r� | j | d <q� q� W| j d j j j j | d <| j d j j j j | d <| j d j j j j | d <| j d j j j j | d
<| j d j j j j | d <| j d j j j j | d <| j d j j d
d
| d <| j d j j j | d <| j d j j j j � j d � | d <| j d j j! d j" | d <| j d j j j j# | d <| j d j j$ j% | d <| j d j j$ j& | d <| d | d | d <i | d <i | d <i | d <i | d <x� | j d j' j( j) j* D]� } g | d | j+ <g | d | j+ <g | d | j+ <| d | j+ j, | j- j. j/ � | d | j+ j, | j- j. j/ � | j- j. j0 rV| d | j+ j, | j- j. j0 j1 � n | j- j2 | d | j+ <q�W| j d j' j( j3 j4 | d <| j d j' j( j3 j5 | d <d j6 | j d j' j( j3 j4 | j d j' j( j3 j5 r�d n d | j d j' j( j3 j5 � | d <x5 | j d j' j( j7 j8 D] } | j2 | d | j+ <q#W| j d j' j9 j: j; j | d! <n d" } n | S(# u�
Return hardware info for standard minion grains if the service_instance is a HostAgent type
service_instance
The service instance object to get hardware info for
.. versionadded:: 2016.11.0
u HostAgenti u manufactureru productnameu
ServiceTagu serialnumberu
osfullnameu osmanufactureru osreleaseu osbuildu os_familyu osi u mem_totalu biosversionu %m/%d/%Yu biosreleasedateu cpu_modelu kernelu num_cpu_socketsu
num_cpu_coresu num_cpusu
ip_interfacesu ip4_interfacesu ip6_interfacesu hwaddr_interfacesu hostu domainu {0}{1}{2}u .u u fqdnu timezoneN(= RT R R� RN RU RV t RetrieveContentRW R
t
HostSystemR RX t hardwaret
systemInfot vendort modelt otherIdentifyingInfot identifierTypet keyt identifierValuet summaryR� t productt fullNameRm t buildRM t
memorySizet biosInfot biosVersiont releaseDatet datet strftimet cpuPkgt descriptiont
productLineIdt cpuInfot numCpuPackagest numCpuCoresR� t
networkSystemt
networkConfigR� t devicet appendt spect ipt ipAddresst
ipV6Configt ipV6Addresst mact dnsConfigt hostNamet
domainNameR t networkInfoR� t dateTimeSystemt dateTimeInfot timeZoneR ( RI t
hw_grain_dataRX t _datat _vnict _pnic( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt get_hardware_grains� s` )
!!' " # c C@ s
| j � S( u�
Return the inventory of a Service Instance Object.
service_instance
The Service Instance Object for which to obtain inventory.
( R� ( RI ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyRT � s c C@ s� y t j d � | j � j SWn� t j j k
rd } t j | � t j j
d j | j � � � nr t j j
k
r� } t j | � t j j
| j � � n8 t j k
r� } t j | � t j j | j � � n Xd S( u�
Returns the root folder of a vCenter.
service_instance
The Service Instance Object for which to obtain the root folder.
u Retrieving root folderu. Not enough permissions. Required privilege: {}N( R R+ R� RW R
R5 Rd R: R R, Re R Rf Rg R7 R Rh Ri ( RI RG ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt get_root_folder� s
c
C@ s� | s t | � } n | } t } | rB| rBt } y" | j j j | | g t � } Wn� t j j k
r� } t j
| � t j j
d j | j � � � nr t j j k
r� } t j
| � t j j
| j � � n8 t j k
r} t j
| � t j j | j � � n Xt j j j d d d d d t d t j j � } n t j j j d | d | sct n t d | � } t j j j d
| d | s�t n t d | s�| g n d � }
t j j j d |
g d
| g d t � } y | j j j | g � } Wn� t j j k
r=} t j
| � t j j
d j | j � � � nr t j j k
rw} t j
| � t j j
| j � � n8 t j k
r�} t j
| � t j j | j � � n X| r~y | j � Wq~t j j k
r } t j
| � t j j
d j | j � � � q~t j j k
rC} t j
| � t j j
| j � � q~t j k
rz} t j
| � t j j | j � � q~Xn | S( u7
Returns the content of the specified type of object for a Service Instance.
For more information, please see:
http://pubs.vmware.com/vsphere-50/index.jsp?topic=%2Fcom.vmware.wssdk.pg.doc_50%2FPG_Ch5_PropertyCollector.7.6.html
service_instance
The Service Instance from which to obtain content.
obj_type
The type of content to obtain.
property_list
An optional list of object properties to used to return even more filtered content results.
container_ref
An optional reference to the managed object to search under. Can either be an object of type Folder, Datacenter,
ComputeResource, Resource Pool or HostSystem. If not specified, default behaviour is to search under the inventory
rootFolder.
traversal_spec
An optional TraversalSpec to be used instead of the standard
``Traverse All`` spec.
local_properties
Flag specifying whether the properties to be retrieved are local to the
container. If that is the case, the traversal spec needs to be None.
u. Not enough permissions. Required privilege: {}RM u traverseEntitiesR u viewt skipt typet allt pathSett objt selectSett objectSett propSett reportMissingObjectsInResultsN(! R� R R RN RU RV R
R5 Rd R R: R R, Re R Rf Rg R7 R Rh Ri t queryt PropertyCollectort
TraversalSpecRX t
ContainerViewt PropertySpect
ObjectSpecR t
FilterSpect propertyCollectort RetrieveContentst Destroy(
RI RY t
property_listt
container_reft traversal_spect local_propertiest obj_reft local_traversal_specRG t
property_spect obj_spect filter_specRN ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt get_content� s�
u namec C@ s{ t | | d | g d | �} xV | D]N } t j | j d d � � j d � } | | | k sk | | k r% | d Sq% Wd S( u
Returns the first managed object reference having the specified property value.
service_instance
The Service Instance from which to obtain managed object references.
object_type
The type of content for which to obtain managed object references.
property_value
The name of the property for which to obtain the managed object reference.
property_name
An object property used to return the specified object reference results. Defaults to ``name``.
container_ref
An optional reference to the managed object to search under. Can either be an object of type Folder, Datacenter,
ComputeResource, Resource Pool or HostSystem. If not specified, default behaviour is to search under the inventory
rootFolder.
R� R� u objectu u '"N( t get_mors_with_propertiesR R1 t gett stripR ( RI t object_typet property_valuet
property_nameR� t object_listR� t obj_id( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt get_mor_by_propertym s
$ c C@ s | | g } i | d 6| d 6| d 6| d 6} y t | | � } Wn\ t k
rc t | | � } n= t k
r� } | j t j k r� | � n t | | � } n Xg }
xR | D]J } i } x! | j D] }
|
j | |
j <q� W| j | d <|
j | � q� Wt
j d t |
� � |
S( u�
Returns a list containing properties and managed object references for the managed object.
service_instance
The Service Instance from which to obtain managed object references.
object_type
The type of content for which to obtain managed object references.
property_list
An optional list of object properties used to return even more filtered managed object reference results.
container_ref
An optional reference to the managed object to search under. Can either be an object of type Folder, Datacenter,
ComputeResource, Resource Pool or HostSystem. If not specified, default behaviour is to search under the inventory
rootFolder.
traversal_spec
An optional TraversalSpec to be used instead of the standard
``Traverse All`` spec
local_properties
Flag specigying whether the properties to be retrieved are local to the
container. If that is the case, the traversal spec needs to be None.
u
property_listu
container_refu traversal_specu local_propertiesu objectu Retrieved %s objects(
R� R t IOErrort errnot EPIPER� t valRM R� R� R R+ t len( RI R� R� R� R� R� t content_argst content_kwargsRN RG R� R� t
propertiest prop( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyR� � s,
c C@ s� t | � } t j d t | � j � y< t | t | � d | d d g d t �} | d d } Wn t j j k
r� d } n Xt j d | t | � j | � t | t | � d | d | d t �} | s� t
j j d j
| � � � n | d S(
u�
Returns specific properties of a managed object, retrieved in an
optimally.
mo_ref
The managed object reference.
properties
List of properties of the managed object to retrieve.
u Retrieving name of %sR� R� u nameR� i u <unnamed>u% Retrieving properties '%s' of %s '%s'u4 Properties of managed object '{0}' weren't retrieved( R} R R+ R� t __name__R� R R R� t InvalidPropertyR R, Re R ( R| R RI t itemst mo_name( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt get_properties_of_managed_object� s.
c C@ s t | d g � } | j d � S( u�
Returns the name of a managed object.
If the name wasn't found, it returns None.
mo_ref
The managed object reference.
u name( R R� ( R| t props( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt get_managed_object_name� s c C@ s� | d k r t j j j � S| d k r8 t j j j � S| d k rT t j j j � S| d k rp t j j j � S| d k r� t j j j � St d � � d S( u�
Return the network adapter type.
adpater_type
The adapter type from which to obtain the network adapter type.
u vmxnetu vmxnet2u vmxnet3u e1000u e1000eu, An unknown network adapter object type name.N( R
t vmR� t
VirtualVmxnett VirtualVmxnet2t VirtualVmxnet3t VirtualE1000t
VirtualE1000et
ValueError( t adapter_type( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt get_network_adapter_type� s c C@ s� t | t j j j � r d St | t j j j � r8 d St | t j j j � rT d St | t j j j � rp d St | t j j j � r� d St d � � d S( u�
Returns the network adapter type.
adapter_object
The adapter object from which to obtain the network adapter type.
u vmxnet2u vmxnet3u vmxnetu e1000eu e1000u' An unknown network adapter object type.N(
R4 R
R R� R R R R R R ( t adapter_object( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt get_network_adapter_object_type s c C@ s� t | � } t j d | | r- d j | � n d | � d g } t j j j d d d t d t
j d t j j j d d d t d t
j
� g � } t | � } g t | t
j d
| d | d | �D], } | s� | r� | d | k r� | d
^ q� } | S( u
Returns distributed virtual switches (DVSs) in a datacenter.
dc_ref
The parent datacenter reference.
dvs_names
The names of the DVSs to return. Default is None.
get_all_dvss
Return all DVSs in the datacenter. Default is False.
uC Retrieving DVSs in datacenter '%s', dvs_names='%s', get_all_dvss=%su ,u nameR u
networkFolderR� R� R� u childEntityR� R� R� u objectN( R R R+ Ra R R R� R� R� R R
t
DatacenterR t FolderR} R� R� ( t dc_reft dvs_namest get_all_dvsst dc_nameR R� RI t iR
( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt get_dvss s0
,c C@ s� t | � } t j d | � t | � } t j j j d d d t d t j
� } t | t j d | d d g d | �} | s� t
j j d
j | � � � n | d d S(
u6
Retrieves the network folder of a datacenter
u, Retrieving network folder in datacenter '%s'R u
networkFolderR� R� R� R� u nameR� u3 Network folder in datacenter '{0}' wasn't retrievedi u object( R R R+ R} R R� R� R� R R
R R� R R R, t VMwareObjectRetrievalErrorR ( R R" RI R� t entries( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt get_network_folderE s" c C@ sR t | � } t j d | | � | s4 t j � } n | j s[ t j � | _ | | j _ n t | � } y | j | � } Wn� t j
j k
r� } t j | � t
j j d j | j � � � nr t j
j k
r� } t j | � t
j j | j � � n8 t j k
r1} t j | � t
j j | j � � n Xt | | t j | j � � d S( uq
Creates a distributed virtual switches (DVS) in a datacenter.
Returns the reference to the newly created distributed virtual switch.
dc_ref
The parent datacenter reference.
dvs_name
The name of the DVS to create.
dvs_create_spec
The DVS spec (vim.DVSCreateSpec) to use when creating the DVS.
Default is None.
u$ Creating DVS '%s' in datacenter '%s'u/ Not enough permissions. Required privilege: {0}N( R R R+ R
t
DVSCreateSpect
configSpect VMwareDVSConfigSpecRM R' t CreateDVS_TaskR5 Rd R: R R, Re R Rf Rg R7 R Rh Ri t
wait_for_taskR R1 t __class__( R R� t dvs_create_specR" t netw_folder_reft taskRG ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt
create_dvs\ s,
c C@ s t | � } t j d | � y | j | � } Wn� t j j k
ru } t j | � t j j
d j | j � � � nr t j j
k
r� } t j | � t j j
| j � � n8 t j k
r� } t j | � t j j | j � � n Xt | | t j | j � � d S( u�
Updates a distributed virtual switch with the config_spec.
dvs_ref
The DVS reference.
dvs_config_spec
The updated config spec (vim.VMwareDVSConfigSpec) to be applied to
the DVS.
u Updating dvs '%s'u/ Not enough permissions. Required privilege: {0}N( R R R+ t ReconfigureDvs_TaskR
R5 Rd R: R R, Re R Rf Rg R7 R Rh Ri R, R R1 R- ( t dvs_reft dvs_config_specR� R0 RG ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt
update_dvs� s
c C@ s� t | � } t j d | | � y | j d | � Wn� t j j k
ry } t j | � t j j
d j | j � � � nr t j j
k
r� } t j | � t j j
| j � � n8 t j k
r� } t j | � t j j | j � � n Xd S( u�
Sets whether NIOC is enabled on a DVS.
dvs_ref
The DVS reference.
enabled
Flag specifying whether NIOC is enabled.
u< Setting network resource management enable to %s on dvs '%s't enableu/ Not enough permissions. Required privilege: {0}N( R R R+ t EnableNetworkResourceManagementR
R5 Rd R: R R, Re R Rf Rg R7 R Rh Ri ( R3 t enabledR� RG ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt+ set_dvs_network_resource_management_enabled� s
c C@ sp t | t j t j f � s0 t j j d � � n t | � } t j d t
| � j | | ri d j | � n d | � d g } t | t j � r� t j j j d d d t d t j d t j j j d d
d t d t j � g � } n' t j j j d d d t d t j � } t | � } g t | t j d | d
| d | �D], } | s\| r:| d | k r:| d ^ q:} | S( uz
Returns distributed virtual porgroups (dvportgroups).
The parent object can be either a datacenter or a dvs.
parent_ref
The parent object reference. Can be either a datacenter or a dvs.
portgroup_names
The names of the dvss to return. Default is None.
get_all_portgroups
Return all portgroups in the parent. Default is False.
uE Parent has to be either a datacenter, or a distributed virtual switchuM Retrieving portgroup in %s '%s', portgroups_names='%s', get_all_portgroups=%su ,u nameR u
networkFolderR� R� R� u childEntityu portgroupR� R� R� u objectN( R4 R
R R� R R, t ArgumentValueErrorR R R+ R� R Ra R R R� R� R� R R R R} R� t DistributedVirtualPortgroup( t
parent_reft portgroup_namest get_all_portgroupst parent_nameR R� RI R# R
( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt get_dvportgroups� sD
&c
C@ s� t | � } t j d | � t j j j d d d t d t j � } t
| � } g t | t j d | d d g d | �D]F } | d rw g | d D] } | j
d
k r� | ^ q� rw | d ^ qw } | s� t j j d j | � � � n | d
S( u�
Returns the uplink distributed virtual portgroup of a distributed virtual
switch (dvs)
dvs_ref
The dvs reference
u' Retrieving uplink portgroup of dvs '%s'R u portgroupR� R� R� R� u tagR� u SYSTEM/DVS.UPLINKPGu objectu* Uplink portgroup of DVS '{0}' wasn't foundi ( R R R+ R R� R� R� R R
R� R} R� R; R� R R, R% R ( R3 R� R� RI t entryt tR
( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt get_uplink_dvportgroup� s&
< c C@ s t | � } t j d | j | � t j d | � y | j | � } Wn� t j j k
r� } t j | � t j
j d j | j
� � � nr t j j k
r� } t j | � t j
j | j � � n8 t j k
r� } t j | � t j
j | j � � n Xt | | t j | j � � d S( u�
Creates a distributed virtual portgroup on a distributed virtual switch
(dvs)
dvs_ref
The dvs reference
spec
Portgroup spec (vim.DVPortgroupConfigSpec)
u Adding portgroup %s to dvs '%s'u spec = %su/ Not enough permissions. Required privilege: {0}N( R R R+ RM t CreateDVPortgroup_TaskR
R5 Rd R: R R, Re R Rf Rg R7 R Rh Ri R, R R1 R- ( R3 R� R� R0 RG ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt create_dvportgroup s"
c C@ s t | � } t j d | � y | j | � } Wn� t j j k
ru } t j | � t j j
d j | j � � � nr t j j
k
r� } t j | � t j j
| j � � n8 t j k
r� } t j | � t j j | j � � n Xt | | t j | j � � d S( u�
Updates a distributed virtual portgroup
portgroup_ref
The portgroup reference
spec
Portgroup spec (vim.DVPortgroupConfigSpec)
u Updating portgrouo %su/ Not enough permissions. Required privilege: {0}N( R R R+ t ReconfigureDVPortgroup_TaskR
R5 Rd R: R R, Re R Rf Rg R7 R Rh Ri R, R R1 R- ( t
portgroup_refR� t pg_nameR0 RG ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt update_dvportgroup. s
c C@ s t | � } t j d | � y | j � } Wn� t j j k
rr } t j | � t j j
d j | j � � � nr t j j
k
r� } t j | � t j j
| j � � n8 t j k
r� } t j | � t j j | j � � n Xt | | t j | j � � d S( ud
Removes a distributed virtual portgroup
portgroup_ref
The portgroup reference
u Removing portgroup %su/ Not enough permissions. Required privilege: {0}N( R R R+ t Destroy_TaskR
R5 Rd R: R R, Re R Rf Rg R7 R Rh Ri R, R R1 R- ( RG RH R0 RG ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt remove_dvportgroupJ s
c C@ s+ t | t j � s' t j j d � � n t | � } t j d t | � j
| | r` d j | � n d | � d g } t
| � } t j j j d d d t d t j d t j j j d d
d t d t j � g � } g t | t j d | d | d
| �D], } | s| r� | d | k r� | d ^ q� } | S( us
Returns networks of standard switches.
The parent object can be a datacenter.
parent_ref
The parent object reference. A datacenter object.
network_names
The name of the standard switch networks. Default is None.
get_all_networks
Boolean indicates whether to return all networks in the parent.
Default is False.
u Parent has to be a datacenter.uH Retrieving network from %s '%s', network_names='%s', get_all_networks=%su ,u nameR u
networkFolderR� R� R� u childEntityR� R� R� u objectN( R4 R
R R R, R: R R R+ R� R Ra R R} R R� R� R� R R R R� t Network( R< t
network_namest get_all_networksR? R RI R� R# R
( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt get_networksc s8
&c C@ sV | d k r d g } n g } t | | | � } x | D] } | j | d � q7 W| S( u�
Returns a simple list of objects from a given service instance.
service_instance
The Service Instance for which to obtain a list of objects.
object_type
The type of content for which to obtain information.
properties
An optional list of object properties used to return reference results.
If not provided, defaults to ``name``.
u nameN( R R� R� ( RI t
vim_objectR R
t item_listR] ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt list_objects� s
c C@ s� t j d � y | j j } Wn� t j j k
rc } t j | � t j j
d j | j � � � nr t j j
k
r� } t j | � t j j
| j � � n8 t j k
r� } t j | � t j j | j � � n X| S( u�
Returns the license manager.
service_instance
The Service Instance Object from which to obrain the license manager.
u Retrieving license manageru/ Not enough permissions. Required privilege: {0}( R R� RN t licenseManagerR
R5 Rd R: R R, Re R Rf Rg R7 R Rh Ri ( RI t lic_managerRG ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt get_license_manager� s
c C@ s� t j d � y | j j j } Wn� t j j k
rf } t j | � t j
j d j | j
� � � nr t j j k
r� } t j | � t j
j | j � � n8 t j k
r� } t j | � t j
j | j � � n X| s� t j
j d � � n | S( u�
Returns the license assignment manager.
service_instance
The Service Instance Object from which to obrain the license manager.
u% Retrieving license assignment manageru/ Not enough permissions. Required privilege: {0}u, License assignment manager was not retrieved( R R� RN RS t licenseAssignmentManagerR
R5 Rd R: R R, Re R Rf Rg R7 R Rh Ri R% ( RI t lic_assignment_managerRG ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt get_license_assignment_manager� s$
c C@ s� | s t | � } n t j d � y | j SWn� t j j k
rs } t j | � t j j
d j | j � � � nr t j j
k
r� } t j | � t j j
| j � � n8 t j k
r� } t j | � t j j | j � � n Xd S( u
Returns the licenses on a specific instance.
service_instance
The Service Instance Object from which to obrain the licenses.
license_manager
The License Manager object of the service instance. If not provided it
will be retrieved.
u Retrieving licensesu/ Not enough permissions. Required privilege: {0}N( RU R R� t licensesR
R5 Rd R: R R, Re R Rf Rg R7 R Rh Ri ( RI t license_managerRG ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt get_licenses� s
c C@ s | s t | � } n t j � } d | _ | | _ t j d | � y | j | | g � } Wn� t j j k
r� } t j
| � t j j
d j | j � � � nr t j j k
r� } t j
| � t j j
| j � � n8 t j k
r} t j
| � t j j | j � � n X| S( uC
Adds a license.
service_instance
The Service Instance Object.
key
The key of the license to add.
description
The description of the license to add.
license_manager
The License Manager object of the service instance. If not provided it
will be retrieved.
u VpxClientLicenseLabelu Adding license '%s'u/ Not enough permissions. Required privilege: {0}( RU R
t KeyValueR� t valueR R� t
AddLicenseR5 Rd R: R R, Re R Rf Rg R7 R Rh Ri ( RI R� R� RZ t labelt vmware_licenseRG ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt add_license� s(
c
C@ s� | s t | � } n | s0 t j j d � � n d } d } t } | s+| rW t } n d } y | j j j } Wq4t
j j k
r� } t
j | � t j j d j | j � � � q4t
j j k
r� } t
j | � t j j | j � � q4t j k
r'} t
j | � t j j | j � � q4Xn | j } t
j d | � y | j | � } Wn� t
j j k
r�} t
j | � t j j d j | j � � � nr t
j j k
r�} t
j | � t j j | j � � n8 t j k
r} t
j | � t j j | j � � n X| d k rOt | � d k rOt
j d � t j j d � � n | r�| | d j k r�t
j d
| | d j � t j j d � � q�n g | D] } | j ^ q�S(
u�
Returns the licenses assigned to an entity. If entity ref is not provided,
then entity_name is assumed to be the vcenter. This is later checked if
the entity name is provided.
service_instance
The Service Instance Object from which to obtain the licenses.
entity_ref
VMware entity to get the assigned licenses for.
If None, the entity is the vCenter itself.
Default is None.
entity_name
Entity name used in logging.
Default is None.
license_assignment_manager
The LicenseAssignmentManager object of the service instance.
If not provided it will be retrieved.
Default is None.
u No entity_name passedu moidu uuidu/ Not enough permissions. Required privilege: {0}u$ Retrieving licenses assigned to '%s'i uC Unexpectectedly retrieved more than one VCenter license assignment.u2 Unexpected return. Expect only a single assignmenti u0 Getting license info for wrong vcenter: %s != %su3 Got license assignment info for a different vcenterN( RX R R, R: R R R RN R t instanceUuidR
R5 Rd R R: Re R Rf Rg R7 R Rh Ri t _moIdR+ t QueryAssignedLicensesR R% t entityDisplayNamet assignedLicense(
RI t
entity_reft entity_namet license_assignment_managert entity_idt entity_typet
check_nameRG t assignmentst a( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt get_assigned_licenses% sd
c C@ s� | s t | � } n d } | s� y | j j j } Wn� t j j k
rz } t j | � t
j j d j
| j � � � nX t j j k
r� } t
j j | j � � n+ t j k
r� } t
j j | j � � n X| s� d } q� n | j } t j d | � y | j | | | � } Wn� t j j k
r\} t j | � t
j j d j
| j � � � nr t j j k
r�} t j | � t
j j | j � � n8 t j k
r�} t j | � t
j j | j � � n X| S( u�
Assigns a license to an entity.
service_instance
The Service Instance Object from which to obrain the licenses.
license_key
The key of the license to add.
license_name
The description of the license to add.
entity_ref
VMware entity to assign the license to.
If None, the entity is the vCenter itself.
Default is None.
entity_name
Entity name used in logging.
Default is None.
license_assignment_manager
The LicenseAssignmentManager object of the service instance.
If not provided it will be retrieved
Default is None.
u/ Not enough permissions. Required privilege: {0}u vCenteru Assigning license to '%s'N( RX R RN R Rb R
R5 Rd R R: R R, Re R Rf Rg R7 R Rh Ri Rc R+ t UpdateAssignedLicense( RI t license_keyt license_nameRg Rh Ri Rj RG R` ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt assign_licensez sH
c C@ s t | t j � S( u�
Returns a list of datacenters associated with a given service instance.
service_instance
The Service Instance Object from which to obtain datacenters.
( RR R
R ( RI ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt list_datacenters� s c C@ sR g t | t j d d g �D], } | s> | r | d | k r | d ^ q } | S( uX
Returns all datacenters in a vCenter.
service_instance
The Service Instance Object from which to obtain cluster.
datacenter_names
List of datacenter names to filter by. Default value is None.
get_all_datacenters
Flag specifying whether to retrieve all datacenters.
Default value is None.
R� u nameu object( R� R
R ( RI t datacenter_namest get_all_datacentersR# R
( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt get_datacenters� s &c C@ sA t | d | g �} | s9 t j j d j | � � � n | d S( u�
Returns a vim.Datacenter managed object.
service_instance
The Service Instance Object from which to obtain datacenter.
datacenter_name
The datacenter name
Ru u Datacenter '{0}' was not foundi ( Rw R R, R% R ( RI t datacenter_nameR
( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt get_datacenter� s
c C@ s� t | � } t j d | � y | j | � } Wn� t j j k
ru } t j | � t j j
d j | j � � � nr t j j
k
r� } t j | � t j j
| j � � n8 t j k
r� } t j | � t j j | j � � n X| S( u�
Creates a datacenter.
.. versionadded:: 2017.7.0
service_instance
The Service Instance Object
datacenter_name
The datacenter name
u Creating datacenter '%s'u. Not enough permissions. Required privilege: {}( R� R R+ t CreateDatacenterR
R5 Rd R: R R, Re R Rf Rg R7 R Rh Ri ( RI Rx t root_foldert dc_objRG ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt create_datacenter� s
c C@ s� t | � } t j d | | � t | d | �} t j j j d d d t d t j
d t j j j d d d t d t j � g � } g t
| t j d | d
d g d | �D] } | d | k r� | d
^ q� } | s� t j j d j | | � � � n | d S( u�
Returns a cluster in a datacenter.
dc_ref
The datacenter reference
cluster
The cluster to be retrieved
u, Retrieving cluster '%s' from datacenter '%s'RM R u
hostFolderR� R� R� u childEntityR� R� u nameR� u objectu/ Cluster '{0}' was not found in datacenter '{1}'i ( R R R+ R} R R� R� R� R R
R R R R� t ClusterComputeResourceR R, R% R ( R t clusterR" RQ R� R# R
( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt get_cluster s0
c C@ s� t | � } t j d | | � y | j j | | � Wn� t j j k
r| } t j | � t j
j d j | j
� � � nr t j j k
r� } t j | � t j
j | j � � n8 t j k
r� } t j | � t j
j | j � � n Xd S( u�
Creates a cluster in a datacenter.
dc_ref
The parent datacenter reference.
cluster_name
The cluster name.
cluster_spec
The cluster spec (vim.ClusterConfigSpecEx).
Defaults to None.
u( Creating cluster '%s' in datacenter '%s'u. Not enough permissions. Required privilege: {}N( R R R+ t
hostFoldert CreateClusterExR
R5 Rd R: R R, Re R Rf Rg R7 R Rh Ri ( R t cluster_namet cluster_specR" RG ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt create_cluster9 s
c C@ s t | � } t j d | � y | j | d t �} Wn� t j j k
r{ } t j | � t j
j d j | j
� � � nr t j j k
r� } t j | � t j
j | j � � n8 t j k
r� } t j | � t j
j | j � � n Xt | | d � d S( u�
Updates a cluster in a datacenter.
cluster_ref
The cluster reference.
cluster_spec
The cluster spec (vim.ClusterConfigSpecEx).
Defaults to None.
u Updating cluster '%s't modifyu. Not enough permissions. Required privilege: {}u ClusterUpdateTaskN( R R R+ t ReconfigureComputeResource_TaskR R
R5 Rd R: R R, Re R Rf Rg R7 R Rh Ri R, ( t cluster_refR� R� R0 RG ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt update_clusterY s"
c C@ s t | t j � S( u�
Returns a list of clusters associated with a given service instance.
service_instance
The Service Instance Object from which to obtain clusters.
( RR R
R~ ( RI ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt
list_clustersw s c C@ s t | t j � S( u�
Returns a list of datastore clusters associated with a given service instance.
service_instance
The Service Instance Object from which to obtain datastore clusters.
( RR R
t
StoragePod( RI ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt list_datastore_clusters� s c C@ s t | t j � S( u�
Returns a list of datastores associated with a given service instance.
service_instance
The Service Instance Object from which to obtain datastores.
( RR R
t Datastore( RI ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt list_datastores� s c
C@ sV g } t | | d | �} x4| D],} y. | j j d d j | j | � d | � } Wn� t j j k
r� } t j | � t
j j d j | j
� � � nr t j j k
r� } t j | � t
j j | j � � n8 t j k
r
} t j | � t
j j | j � � n Xy& | j t
j j j | | d � � Wq" t
j j k
rMq" Xq" W| S( u�
Get the files with a given browser specification from the datastore.
service_instance
The Service Instance Object from which to obtain datastores.
directory
The name of the directory where we would like to search
datastores
Name of the datastores
container_object
The base object for searches
browser_spec
BrowserSpec object which defines the search criteria
return
list of vim.host.DatastoreBrowser.SearchResults objects
t datastore_namest
datastorePathu [{}] {}t
searchSpecu. Not enough permissions. Required privilege: {}u query virtual machine files( t get_datastorest browsert SearchDatastore_TaskR RM R
R5 Rd R R: R R, Re Rf Rg R7 R Rh Ri R� R t vmwareR, t VMwareFileNotFoundError(
RI t directoryt
datastorest container_objectt browser_spect filest datastore_objectst datobjR0 RG ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt get_datastore_files� s,
!
&c C@ s9 t | � } | r% t j d | � nS t j d | | | � | rx t | t j � rx t j j d j | j
j � � � n | r�| r�t j d | � t | | | � } t j
j j | d g � } | j d g � } g } x� g | D]$ }
t |
j t j � r� |
j ^ q� D]v } g | j D] } | j | k r | ^ q sCq n t j d | j g | j D] } | j ^ q\� | j | j � q Wt j d | � | r�| j | � q�| } n | r�| r�t j d | � g St j d | � t | t j � r)t j j j d
d d d
d t d t j � }
n_t | t j � rkt j j j d
d d d
d t d t j � }
n t | t j � r�t j j j d
d d d
d t d t j � }
n� t | t j � r�t j j j d
d d d d t d t j � }
n� t | t j � rgt | � d k rgt j j j d d d t j j j d d
d t d t j � g d t d t j � }
n! t j j d j | j
j � � � t! | d t j" d d g d | d |
�} t j d t# | � � g | D]" }
| s�|
d | k r�|
^ q�} t j d g | D] }
|
d ^ q� g | D] }
|
d ^ q%S( u
Returns a list of vim.Datastore objects representing the datastores visible
from a VMware object, filtered by their names, or the backing disk
cannonical name or scsi_addresses
service_instance
The Service Instance Object from which to obtain datastores.
reference
The VMware object from which the datastores are visible.
datastore_names
The list of datastore names to be retrieved. Default value is None.
backing_disk_ids
The list of canonical names of the disks backing the datastores
to be retrieved. Only supported if reference is a vim.HostSystem.
Default value is None
get_all_datastores
Specifies whether to retrieve all disks in the host.
Default value is False.
u) Retrieving all datastores visible to '%s'uL Retrieving datastores visible to '%s': names = (%s); backing disk ids = (%s)u@ Unsupported reference type '{0}' when backing disk filter is setu. Filtering datastores with backing disk ids: %su fileSystemVolumeInfo.mountInfou( Found datastore '%s' for disk id(s) '%s'u# Datastore found for disk filter: %suY No datastore to be filtered after retrieving the datastores backed by the disk id(s) '%s'u datastore_names = %sRM u host_datastore_traversalR u datastoreR� R� u cluster_datastore_traversalu datacenter_datastore_traversalu datastore_cluster_traversalu childEntityu DatacentersR� u Unsupported reference type '{0}'R� R� u nameR� R� u Retrieved %s datastoresu Filtered datastores: %su object($ R R R+ R4 R
R� R R, R: R R- R t get_storage_systemR R� R R� t volumet HostVmfsVolumet extentt diskNameRM R� t extendR R� R� R� R R~ R R� R R� R� R ( RI t referenceR� t backing_disk_idst get_all_datastoresRZ t storage_systemR t mount_infost disk_datastoresR# t volt eR� R
( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyR� � s�
(+ & 'c C@ s� t | � } t j d | | � y | j | � Wn� t j j k
rv } t j | � t j j
d j | j � � � nr t j j
k
r� } t j | � t j j
| j � � n8 t j k
r� } t j | � t j j | j � � n Xd S( u�
Renames a datastore
datastore_ref
vim.Datastore reference to the datastore object to be changed
new_datastore_name
New datastore name
u Renaming datastore '%s' to '%s'u. Not enough permissions. Required privilege: {}N( R R R+ t RenameDatastoreR
R5 Rd R: R R, Re R Rf Rg R7 R Rh Ri ( t
datastore_reft new_datastore_namet ds_nameRG ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt rename_datastoreF s
c C@ s� | s t | � } n t j j j d d d t j d t � } t | t j d d g d | d | �} | s� t
j j d j
| � � � n t j d
| � | d d S(
u)
Returns a host's storage system
R u configManager.storageSystemR� R� R� u
systemFileR� R� u- Host's '{0}' storage system was not retrievedu [%s] Retrieved storage systemi u object( R R R� R� R� R
R� R R� t HostStorageSystemR R, R% R R R+ ( RI t host_refRw R� t objs( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyR� a s" c C@ s� y | j d | g � } Wn� t j j k
r_ } t j | � t j j d j | j
� � � nr t j j k
r� } t j | � t j j | j � � n8 t
j k
r� } t j | � t j j | j � � n Xt j d | d � | d S( ua
Returns partition informations for a device path, of type
vim.HostDiskPartitionInfo
t
devicePathu/ Not enough permissions. Required privilege: {0}u partition_info = %si ( t RetrieveDiskPartitionInfoR
R5 Rd R R: R R, Re R Rf Rg R7 R Rh Ri R+ ( R� t device_patht partition_infosRG ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt _get_partition_infoz s
c
C@ sg t j d � g | j j D] } | j d k r | ^ q } | sb t j j d j | j � � � n | d } t
j d | j j d | j j � } d | _ y( | j
d | d t
j j d
| � } Wn� t
j j k
r} t j | � t j j d j | j � � � nr t
j j k
rA} t j | � t j j | j � � n8 t j k
rx} t j | � t j j | j � � n Xt j d | � t j d
� g | j j D]r } | j j | j j k s�| j j d k r�| j j d k r�| j j | j j k r�| j d k r�| j ^ q�} | sBt j j d j | j � � � n t j d | d � | d | j f S( u�
Computes the new disk partition info when adding a new vmfs partition that
uses up the remainder of the disk; returns a tuple
(new_partition_number, vim.HostDiskPartitionSpec
uU Adding a partition at the end of the disk and getting the new computed partition specu noneu, Free partition was not found on device '{0}'i t totalt partitionu vmfsR� t partitionFormatt layoutu/ Not enough permissions. Required privilege: {0}u computed partition info = {0}u Retrieving new partition numberi uB New partition was not found in computed partitions of device '{0}'u new partition number = %s( R R+ R� R� R� R R, t VMwareObjectNotFoundErrorR t
deviceNameR
t HostDiskPartitionLayoutR� t ComputeDiskPartitionInfot$ HostDiskPartitionInfoPartitionFormatt gptR5 Rd R: Re Rf Rg R7 R Rh Ri t startt blockt endt VMwareNotFoundErrorR� (
R� R� t partition_infot pt free_partitionst free_partitionR� t computed_partition_infoRG t partition_numbers( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt _get_new_computed_partition_spec� sV
c
C@ s� t | � } | j } t j d | | | | � | s[ t | d | �} t | | | � } n | } t | | j � } t j d | � t | | j | � \ }
} t
j d t
j d | d | d t
j
d | d |
� � d
| j d | � } y | j j j | � }
Wn� t
j j k
rH} t j | � t j j d j | j � � � nr t
j j k
r�} t j | � t j j | j � � n8 t j k
r�} t j | � t j j | j � � n Xt j d | | � |
S(
uA
Creates a VMFS datastore from a disk_id
host_ref
vim.HostSystem object referencing a host to create the datastore on
datastore_name
Name of the datastore
disk_ref
vim.HostScsiDislk on which the datastore is created
vmfs_major_version
VMFS major version to use
u> Creating datastore '%s' on host '%s', scsi disk '%s', vmfs v%sRM u partition_info = %st vmfst majorVersiont
volumeNameR� R� R� t diskUuidu/ Not enough permissions. Required privilege: {0}u# Created datastore '%s' on host '%s'( R t
canonicalNameR R� R} R� R� R� R+ R� R
t VmfsDatastoreCreateSpect HostVmfsSpect HostScsiDiskPartitiont uuidR� t datastoreSystemt CreateVmfsDatastoreR5 Rd R: R R, Re R Rf Rg R7 R Rh Ri ( R� t datastore_namet disk_reft vmfs_major_versionR� Rw t disk_idRQ t target_diskR� t new_partition_numbert partition_specR� t ds_refRG ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt create_vmfs_datastore� sN
c C@ s� | s t | � } n t | � } t j j j d d d t j d t � } t | t j
d d g d | d | �} | s� t j j
d j | � � � n t j d
| � | d d S(
u�
Returns a host's datastore system
host_ref
Reference to the ESXi host
hostname
Name of the host. This argument is optional.
R u configManager.datastoreSystemR� R� R� u datastoreR� R� u/ Host's '{0}' datastore system was not retrievedu [%s] Retrieved datastore systemi u object( R R} R R� R� R� R
R� R R� t HostDatastoreSystemR R, R% R R R+ ( R� Rw RI R� R� ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt get_host_datastore_system s$ c C@ sq t | d d d g � } | d } t j d | � | j d � } | se t j j d j | � � � n t | d j � } t
| d j d | �} y | j | � Wn� t j
j k
r� } t j | � t j j d j | j � � � nr t j
j k
r"} t j | � t j j | j � � n8 t j k
rY} t j | � t j j | j � � n Xt j d | | � d
S( u�
Creates a VMFS datastore from a disk_id
service_instance
The Service Instance Object containing the datastore
datastore_ref
The reference to the datastore to remove
u hostu infou nameu Removing datastore '%s'u9 Datastore '{0}' can't be removed. No attached hosts foundi Rw u/ Not enough permissions. Required privilege: {0}u [%s] Removed datastore '%s'N( R R R� R� R R, Re R R R� R� t RemoveDatastoreR
R5 Rd R: Rf Rg R7 R Rh Ri R+ ( RI R� t ds_propsR� t ds_hostsRw t host_ds_systemRG ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt remove_datastore. s4
c C@ s\ d g } | r+ | r+ t j j d � � n | s: g } n | sO t | � } n% t | | � } | rt | j d � n t | t j d | d | �} t j
d g | D] } | d ^ q� � g } x� | D]� } | rt | d t j � s� q� n t
| d � }
|
| k rq� qn | r0| j | d � q� n | d | k r� | j | d � q� q� W| S( u�
Returns a list of vim.HostSystem objects representing ESXi hosts
in a vcenter filtered by their names and/or datacenter, cluster membership.
service_instance
The Service Instance Object from which to obtain the hosts.
datacenter_name
The datacenter name. Default is None.
host_names
The host_names to be retrieved. Default is None.
cluster_name
The cluster name - used to restrict the hosts retrieved. Only used if
the datacenter is set. This argument is optional.
get_all_hosts
Specifies whether to retrieve all hosts in the container.
Default value is False.
u nameu7 Must specify the datacenter when specifying the clusteru parentR� R� u Retrieved hosts: %su object( R R, R: R� Ry R� R� R
R� R R+ R4 R~ R ( RI Rx t
host_namesR� t
get_all_hostsR t start_pointt hostst ht filtered_hostsR? ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt get_hostsT s<
'
c @ s� | s t | � } n | s0 t | | | � } n y
| j } Wn� t j j k
r� } t j | � t j j
d j | j � � � nr t j j
k
r� } t j | � t j j
| j � � n8 t j k
r� } t j | � t j j | j � � n X| st j j d j | � � � n | j } | sFt j j d j | � � � n | j d k rst j j d j | � � � n i } x1 | j D]& � | j � f d � � j D� � q�Wt j d | | � | S( u�
Returns a map between the scsi addresses and the keys of all luns on an ESXi
host.
map[<scsi_address>] = <lun key>
service_instance
The Service Instance Object from which to obtain the hosts
host_ref
The vim.HostSystem object representing the host that contains the
requested disks.
storage_system
The host's storage system. Default is None.
hostname
Name of the host. Default is None.
u/ Not enough permissions. Required privilege: {0}u2 Host's '{0}' storage device info was not retrievedu- Host's '{0}' multipath info was not retrievedu& No luns were retrieved from host '{0}'c @ s, i | ]" } � j | j j d � d � q S( u ,i ( t lunRM Rt ( t .0R� ( t l( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pys
<dictcomp>� s u+ Scsi address to lun id map on host '%s': %sN( R R� t storageDeviceInfoR
R5 Rd R R: R R, Re R Rf Rg R7 R Rh Ri R% t
multipathInfoR� R t updateR R+ ( RI R� R� Rw t device_infoRG t multipath_infot lun_key_by_scsi_addr( ( R� s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt _get_scsi_address_to_lun_key_map� sJ
c C@ s� | s t | � } n | sf t | d | �} t | | | � } | sf t j j d j | � � � qf n y
| j } Wn� t j j
k
r� } t j | � t j j
d j | j � � � nr t j j k
r� } t j | � t j j
| j � � n8 t j k
r*} t j | � t j j | j � � n X| sOt j j d j | � � � n | j } | r�t j d | g | D] } | j ^ qq� | St j d | � g S( u>
Returns a list of all vim.HostScsiDisk objects in a disk
host_ref
The vim.HostSystem object representing the host that contains the
requested disks.
storage_system
The host's storage system. Default is None.
hostname
Name of the host. This argument is optional.
RM u- Host's '{0}' storage system was not retrievedu/ Not enough permissions. Required privilege: {0}u2 Host's '{0}' storage device info was not retrievedu$ Retrieved scsi luns in host '%s': %su# Retrieved no scsi_luns in host '%s'( R R} R� R R, R% R R� R
R5 Rd R R: Re Rf Rg R7 R Rh Ri t scsiLunR+ R� ( R� R� Rw RQ R� RG t scsi_lunsR� ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt get_all_luns� sB
c @ s� | s t | � } n t | d | �} | sB t | | | � } n t | | | | � } d � t | | | � D� � � f d � t j | � D� S( u]
Returns a map of all vim.ScsiLun objects on a ESXi host keyed by their
scsi address
host_ref
The vim.HostSystem object representing the host that contains the
requested disks.
storage_system
The host's storage system. Default is None.
hostname
Name of the host. This argument is optional.
RM c S@ s i | ] } | | j � q S( ( R� ( R� t d( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pys
<dictcomp>
s c @ s# i | ] \ } } � | | � q S( ( ( R� t scsi_addrt lun_key( t luns_to_key_map( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pys
<dictcomp>
s ( R R} R� R� R� R t iteritems( R� R� Rw RQ t lun_ids_to_scsi_addr_map( ( R s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt get_scsi_address_to_lun_map
s c C@ sh t | � } | r% t j d | � n& t j d | | | � | pD | sK g St | d | �} t | | | � } g } | r� t | | | | � } g t j | � D] \ } }
| | k r� |
^ q� } t j d | � n t | | � } g | D]H } t | t
j � r� | s/| r | j | k s/| j
| k r� | ^ q� }
t j d | g |
D] } | j ^ qN� |
S( uS
Returns a list of vim.HostScsiDisk objects representing disks
in a ESXi host, filtered by their cannonical names and scsi_addresses
host_ref
The vim.HostSystem object representing the host that contains the
requested disks.
disk_ids
The list of canonical names of the disks to be retrieved. Default value
is None
scsi_addresses
The list of scsi addresses of the disks to be retrieved. Default value
is None
get_all_disks
Specifies whether to retrieve all disks in the host.
Default value is False.
u! Retrieving all disks in host '%s'u@ Retrieving disks in host '%s': ids = (%s); scsi addresses = (%s)RM u& disk_keys based on scsi_addresses = %su Retrieved disks in host '%s': %s( R R R+ R} R� R� R R R� R4 R
t HostScsiDiskR� R� ( R� t disk_idst scsi_addressest
get_all_disksRw RQ R� t disk_keysR� R� R� R� t diskt
scsi_disksR� ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt get_disks$
s6
c C@ sp t | � } t | � } | s3 t | | | � } n t | d g � } | j d � sr t j j d j | � � � n t j
d | t | d � d j g | d D] } | j
^ q� � � g | d D]- } t | t j � r� | j
| k r� | ^ q� } | st j j d j | | � � � n t j
d | | d j � t | | d j � } t j
d | t | j j � | � | S( u
Returns all partitions on a disk
host_ref
The reference of the ESXi host containing the disk
disk_id
The canonical name of the disk whose partitions are to be removed
storage_system
The ESXi host's storage system. Default is None.
u storageDeviceInfo.scsiLunu' No devices were retrieved in host '{0}'u [%s] Retrieved %s devices: %su , u& Disk '{0}' was not found in host '{1}'u [%s] device_path = %si u+ [%s] Retrieved %s partition(s) on disk '%s'( R R} R� R R� R R, R% R R R+ R Ra R� R4 R
R R� R� R� R� ( R� R� R� Rw RI R R� t disksR� ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt get_disk_partition_info\
s8
! c
C@ su | s t | � } n | s0 t | | | � } n t j j j d d d t j d t � } t | t j
d g d | d | �} | s� t j j
d j | � � � n t j d | t | d
j d g � � d j g | d
j d g � D] } | j ^ q� � � g | d
j d g � D]- } t | t j � r| j | k r| ^ q} | skt j j
d j | | � � � n t j d
| | d
j � y! | j | d
j t j � � Wn� t j j k
r�} t j | � t j j d j | j � � � nr t j j k
r&} t j | � t j j | j � � n8 t j! k
r]} t j | � t j j" | j � � n Xt j d | | � d S( u�
Erases all partitions on a disk
in a vcenter filtered by their names and/or datacenter, cluster membership
service_instance
The Service Instance Object from which to obtain all information
host_ref
The reference of the ESXi host containing the disk
disk_id
The canonical name of the disk whose partitions are to be removed
hostname
The ESXi hostname. Default is None.
storage_system
The ESXi host's storage system. Default is None.
R u configManager.storageSystemR� R� u storageDeviceInfo.scsiLunR� R� u' Host's '{0}' devices were not retrievedu [%s] Retrieved %s devices: %si u , u& Disk '{0}' was not found in host '{1}'u [%s] device_path = %su/ Not enough permissions. Required privilege: {0}u# [%s] Erased partitions on disk '%s'N(# R R� R R� R� R� R
R� R R� R� R R, R% R R R+ R R� Ra R� R4 R R� t UpdateDiskPartitionst HostDiskPartitionSpecR5 Rd R: Re Rf Rg R7 Rh Ri (
RI R� R� Rw R� R� t resultsR� R
RG ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt erase_disk_partitions�
s\ -
c C@ s� t | � } | r% t j d | � n t j d | | � | sB g Sy | j j } Wn� t j j k
r� } t j | � t j
j d j | j
� � � nr t j j k
r� } t j | � t j
j | j � � n8 t j k
r } t j | � t j
j | j � � n X| s.t j
j d j | � � � n | j } | s[t j
j d j | � � � n | j } | sng Sg | D]$ } | s�| j j | k ru| ^ qu} t j d | g | D] }
|
j j ^ q�� | S( u�
Returns a list of vim.VsanHostDiskMapping objects representing disks
in a ESXi host, filtered by their cannonical names.
host_ref
The vim.HostSystem object representing the host that contains the
requested disks.
cache_disk_ids
The list of cannonical names of the cache disks to be retrieved. The
canonical name of the cache disk is enough to identify the disk group
because it is guaranteed to have one and only one cache disk.
Default is None.
get_all_disk_groups
Specifies whether to retrieve all disks groups in the host.
Default value is False.
u' Retrieving all disk groups on host '%s'uA Retrieving disk groups from host '%s', with cache disk ids : (%s)u/ Not enough permissions. Required privilege: {0}u" No host config found on host '{0}'u( No vsan storage info found on host '{0}'u< Retrieved disk groups on host '%s', with cache disk ids : %s( R R R+ R� t vsanHostConfigR
R5 Rd R: R R, Re R Rf Rg R7 R Rh Ri R% t storageInfot diskMappingt ssdR� ( R� t cache_disk_idst get_all_disk_groupsRw t vsan_host_configRG t vsan_storage_infot vsan_disk_mappingst dmt disk_groupsR� ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt get_diskgroups�
sJ
#c C@ s� | j j | k s9 t j j d j | j j | � � � n g | j D] } | j ^ qC } t | � t | � k r� t j j d j t | � t | � � � � n t j d | � t
S( uw
Checks that the disks in a disk group are as expected and raises
CheckError exceptions if the check fails
uA Incorrect diskgroup cache disk; got id: '{0}'; expected id: '{1}'u= Incorrect capacity disks; got ids: '{0}'; expected ids: '{1}'u2 Checked disks in diskgroup with cache disk id '%s'( R R� R R, R: R t nonSsdt sortedR R+ R ( t
disk_groupt
cache_disk_idt capacity_disk_idsR� t
non_ssd_disks( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt _check_disks_in_diskgroup s c C@ s� t | � } t | � } t j d | � | s� t j j j d d d t j d t
� } t | t j d g d | d | �} | s� | d j
d � r� t j d
| � d S| d d d St | d g � } | s� t j d
| � d S| d d Sd S( u�
Returns a vim.HostScsiDisk if the host cache is configured on the specified
host, other wise returns None
host_ref
The vim.HostSystem object representing the host that contains the
requested disks.
host_cache_manager
The vim.HostCacheConfigurationManager object representing the cache
configuration manager on the specified host. Default is None. If None,
it will be retrieved in the method
u& Retrieving the host cache on host '%s'R u' configManager.cacheConfigurationManagerR� R� u cacheConfigurationInfoR� R� i u Host '%s' has no host cacheN( R R} R R+ R R� R� R� R
R� R R� t HostCacheConfigurationManagerR� R R ( R� t host_cache_managerRw RI R� R ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt get_host_cache$ s. c C@ s� t | � } | s^ t | d g � } | j d � sQ t j j d j | � � � n | d } n t j d | | j | � t
j d | d | � } t j d | � y | j | � } Wn� t
j
j k
r� } t j | � t j j d j | j � � � nr t
j
j k
r2} t j | � t j j | j � � n8 t j k
ri} t j | � t j j | j � � n Xt | | d � t j d | � t S(
uB
Configures the host cahe of the specified host
host_ref
The vim.HostSystem object representing the host that contains the
requested disks.
datastore_ref
The vim.Datastore opject representing the datastore the host cache will
be configured on.
swap_size_MiB
The size in Mibibytes of the swap.
host_cache_manager
The vim.HostCacheConfigurationManager object representing the cache
configuration manager on the specified host. Default is None. If None,
it will be retrieved in the method
u' configManager.cacheConfigurationManageru Host '{0}' has no host cacheuI Configuring the host cache on host '%s', datastore '%s', swap size=%s MiBt datastoret swapSizeu host_cache_spec=%su/ Not enough permissions. Required privilege: {0}u HostCacheConfigurationTasku" Configured host cache on host '%s'( R R R� R R, R% R R R+ RM R
t HostCacheConfigurationSpect ConfigureHostCache_TaskR5 Rd R: Re Rf Rg R7 R Rh Ri R, R ( R� R� t
swap_size_MiBR' Rw R R� R0 RG ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt configure_host_cacheM s<
c C@ s t | t j � S( u�
Returns a list of hosts associated with a given service instance.
service_instance
The Service Instance Object from which to obtain hosts.
( RR R
R� ( RI ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt
list_hosts� s c C@ s� d g } | s g } n | r0 t | | � } n t | � } t | t j d | d | �} g } x8 | D]0 } | s� | d | k rg | j | d � qg qg W| s� t j j d j | | � � � n | S( ul
Retrieves resource pool objects
service_instance
The service instance object to query the vCenter
resource_pool_names
Resource pool names
datacenter_name
Name of the datacenter where the resource pool is available
get_all_resource_pools
Boolean
return
Resourcepool managed object reference
u nameR� R� u objectuI The resource pools with properties names={} get_all={} could not be found(
Ry R� R� R
t ResourcePoolR� R R, R% R ( RI t resource_pool_namesRx t get_all_resource_poolsR R� t resource_poolst selected_poolst pool( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt get_resource_pools� s(
c C@ s t | t j � S( u�
Returns a list of resource pools associated with a given service instance.
service_instance
The Service Instance Object from which to obtain resource pools.
( RR R
R0 ( RI ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt list_resourcepools� s c C@ s t | t j � S( u�
Returns a list of networks associated with a given service instance.
service_instance
The Service Instance Object from which to obtain networks.
( RR R
RL ( RI ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt
list_networks� s c C@ s t | t j � S( u�
Returns a list of VMs associated with a given service instance.
service_instance
The Service Instance Object from which to obtain VMs.
( RR R
t VirtualMachine( RI ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt list_vms� s c C@ s t | t j � S( u�
Returns a list of folders associated with a given service instance.
service_instance
The Service Instance Object from which to obtain folders.
( RR R
R ( RI ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt list_folders� s c C@ s t | t j � S( u�
Returns a list of distributed virtual switches associated with a given service instance.
service_instance
The Service Instance Object from which to obtain distributed virtual switches.
( RR R
R� ( RI ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyR� � s c C@ s t | t j � S( u�
Returns a list of vApps associated with a given service instance.
service_instance
The Service Instance Object from which to obtain vApps.
( RR R
t
VirtualApp( RI ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt
list_vapps� s c C@ s t | t j j � S( u�
Returns a list of distributed virtual portgroups associated with a given service instance.
service_instance
The Service Instance Object from which to obtain distributed virtual switches.
( RR R
R� R; ( RI ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt list_portgroups� s i u debugc C@ s� d } t j � } t j d | | j j � y
| j } Wn� t j j k
r~ } t j | � t
j j d j
| j � � � n� t j j k
r� } t j | � t
j j | j � � nr t j j k
r� } t j | � t
j j | j � � n8 t j k
r)} t j | � t
j j | j � � n Xx�| j d k sK| j d k r�| | d k r�d j
| | | � } | d k r�t j | � q�t j | � n t j d t j � | d � | d 7} y
| j } Wq-t j j k
r} t j | � t
j j d j
| j � � � q-t j j k
rR} t j | � t
j j | j � � q-t j j k
r�} t j | � t
j j | j � � q-t j k
r�} t j | � t
j j | j � � q-Xq-W| j d
k r d j
| | | � } | d k rt j | � n
t j | � | j Sy
| j � WnZt j j k
ro} t j | � t
j j d j
| j � � � nt j j k
r�} t j | � t
j j | j � � n� t j j k
r�} t j | � t
j j | j � � n� t j j k
r } t j | � t
j j | j � � ni t j j k
r�} t j | � | j }
| j rpd j
|
| j d j � }
n t
j j |
� � n Xd
S( u3
Waits for a task to be completed.
task
The task to wait for.
instance_name
The name of the ESXi host, vCenter Server, or Virtual Machine that
the task is being run on.
task_type
The type of task being performed. Useful information for debugging purposes.
sleep_seconds
The number of seconds to wait before querying the task again.
Defaults to ``1`` second.
log_level
The level at which to log task information. Default is ``debug``,
but ``info`` is also supported.
i u task = %s, task_type = %su. Not enough permissions. Required privilege: {}u runningu queuedu. [ {0} ] Waiting for {1} task to finish [{2} s]u infog �?i u successu6 [ {0} ] Successfully completed {1} task in {2} secondsu {0} ({1})N( t timeR R+ R- R t infoR
R5 Rd R: R R, Re R Rf t FileNotFoundR� R7 Rg R Rh Ri t stateR� t sleept resultR t SystemErrort VMwareSystemErrort InvalidArgumentt faultMessageR3 ( R0 t
instance_namet task_typet
sleep_secondst log_levelt time_countert
start_timet task_infoRG R7 t exc_message( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyR, s�
!
c C@ s
| r( | r( t j j j | | � } n | sa d d d d d d d d d d
d d d
d g } n t j j j | t j | d | d | �} g | D] } | d | k r� | ^ q� } | s� t j j d � � n3 t | � d k rt j j
d j d g � � � n | d S( u�
Get virtual machine properties based on the traversal specs and properties list,
returns Virtual Machine object with properties.
service_instance
Service instance object to access vCenter
name
Name of the virtual machine.
datacenter
Datacenter name
vm_properties
List of vm properties.
traversal_spec
Traversal Spec object(s) for searching.
parent_ref
Container Reference object for searching under a given object.
u nameu config.hardware.deviceu summary.storage.committedu summary.storage.uncommittedu summary.storage.unsharedu
layoutEx.fileu config.guestFullNameu config.guestIdu guest.netu config.hardware.memoryMBu config.hardware.numCPUu config.files.vmPathNameu summary.runtime.powerStateu guest.toolsStatusR� R� u" The virtual machine was not found.i u uS Multiple virtual machines were found with thesame name, please specify a container.i ( R R R� Ry R� R
R9 R, R% R t VMwareMultipleObjectsErrorRa ( RI RM t
datacentert
vm_propertiesR� R< t vm_listR t vm_formatted( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt get_vm_by_propertyi s:
)c
C@ sr t j d � | r� t | | d d g �} t j j j | d d g �} d | k rb | d } qnt j j d j d d g � � � n� d | k rt j j j
| | d g | � } t | � d
k r� t j j d j d d j
| d � g � � � n | d
} nj | rnt j j j | | � } t j j j | d d g �} d | k rY| d } qnt j j d � � n | S( u�
Returns a Folder Object
service_instance
Service instance object
datacenter
Name of the datacenter
placement
Placement dictionary
base_vm_name
Existing virtual machine name (for cloning)
u Retrieving folder informationRS u nameR u parentu u The virtual machine parentu object is not definedu folderi u' Multiple instances are available of theu specified folder {0}i u vmFolderu. The datacenter vm folder object is not defined( R R+ RV R R R� R R, R% Ra t get_foldersR RQ R Ry (
RI RR t placementt base_vm_namet vm_objectt vm_propst
folder_objectt folder_objectst datacenter_objectt dc_props( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt
get_folder� s.
"
c C@ s� t j d � d \ } } d | k r{t | d | d | d g �} | s{ t j j d j d d j | d � g � � � n y' t | d d d
g �} | d
} Wn� t
j j k
rmt
j j
j d d d
t d t j d t
j j
j d d
d
t d t j � g � } t | t j d | d d d g d | �} | rK| d d } qnt j j d j | d � � � n X| d } nkd | k rBt | | d g d | �} t | � d k r�t j j d j d d j | d � g � � � n | d } t | d d g �}
d |
k r |
d } q�t j j d j d d g � � � n� d | k r�t | | � } t | | d � } t | d d
g �}
d
|
k r�|
d
} n! t j j d j d d g � � � | } n t j j d j d g � � � | | f S(! uP
To create a virtual machine a resource pool needs to be supplied, we would like to use the strictest as possible.
datacenter
Name of the datacenter
placement
Dictionary with the placement info, cluster, host resource pool name
return
Resource pool, cluster and host object if any applies
u Retrieving placement informationu hostRx R� u u The specified hostu {0} cannot be found.i R u resourcePoolR u parentR� R� R� R� R� u nameR� u objectu. The resource pool of host {0} cannot be found.u resourcepooli u' Multiple instances are available of theu specified host {}.u The resource pool's parentu object is not definedu clusteru The cluster's resource poolu Placement is not defined.N( NN( R R+ R R� R R, R% Ra R R R R� R R� R� R R
R� R R~ R� R0 R6 R RQ Ry R� ( RI RR RX t resourcepool_objectt placement_objectt host_objectst
host_propsR� t
resourcepoolst resourcepool_objectst res_propsR^ t cluster_objectt
clus_props( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt
get_placement� sz
c C@ s� | j � d k r) t | d d � } nX | j � d k rN t | d � } n3 | j � d k ro t | � } n t j j d � � i | d 6d d 6S( u�
Converts the given size to KB based on the unit, returns a long integer.
unit
Unit of the size eg. GB; Note: to VMware a GB is the same as GiB = 1024MiB
size
Number which represents the size
u gbi u mbu kbu The unit is not specifiedu sizeu KBu unit( t lowert intR R, R: ( t unitt sizet target_size( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt
convert_to_kb
s u onc C@ s0 | d k r� y | j � } d } Wq�t j j k
rh } t j | � t j j d j | j
� � � q�t j j k
r� } t j | � t j j | j � � q�t
j k
r� } t j | � t j j | j � � q�Xn� | d k r�y | j � } d } Wq�t j j k
rE} t j | � t j j d j | j
� � � q�t j j k
r} t j | � t j j | j � � q�t
j k
r�} t j | � t j j | j � � q�Xn t j j d � � y t | t | � | � WnC t j j k
r+} t j j d j d d j | � g � � � n X| S(
u�
Powers on/off a virtual machine specified by it's name.
virtual_machine
vim.VirtualMachine object to power on/off virtual machine
action
Operation option to power on/off the machine
u onu power onu. Not enough permissions. Required privilege: {}u offu power offu! The given action is not supportedu u An error occurred during poweru$ operation, a file was not found: {0}( t PowerOnR
R5 Rd R R: R R, Re R Rf Rg R7 R Rh Ri t PowerOffR: R, R R� t VMwarePowerOnErrorRa ( t virtual_machinet actionR0 t task_nameRG ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt power_cycle_vm3
sL
c C@ s# yO | r9 t | t j � r9 | j | d | d | �} n | j | d | �} Wn� t j j k
r� } t j | � t j j
d j | j � � � nr t j j
k
r� } t j | � t j j
| j � � n8 t j k
r} t j | � t j j | j � � n Xt | | d d d � } | S( u�
Creates virtual machine from config spec
vm_name
Virtual machine name to be created
vm_config_spec
Virtual Machine Config Spec object
folder_object
vm Folder managed object reference
resourcepool_object
Resource pool object where the machine will be created
host_object
Host object where the machine will ne placed (optional)
return
Virtual Machine managed object reference
R5 R u. Not enough permissions. Required privilege: {}u
CreateVM Taski
u info( R4 R
R� t
CreateVM_TaskR5 Rd R R: R R, Re R Rf Rg R7 R Rh Ri R, ( t vm_namet vm_config_specR\ Ra t host_objectR0 RG RZ ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt create_vmf
s(
c C@ sj ya | r9 | j j d | d | d t d | d | � } n' | j j d | d | d t d | � } Wn� t j j k
r� } t j | � t j j
d j | j � � � nr t j j
k
r� } t j | � t j j
| j � � n8 t j k
r} t j | � t j j | j � � n Xy t | | d � } Wn4 t j j k
re} t j j d j | � � � n X| S( u$
Registers a virtual machine to the inventory with the given vmx file, on success
it returns the vim.VirtualMachine managed object reference
datacenter
Datacenter object of the virtual machine, vim.Datacenter object
name
Name of the virtual machine
vmx_path:
Full path to the vmx file, datastore name should be included
resourcepool
Placement resource pool of the virtual machine, vim.ResourcePool object
host
Placement host of the virtual machine, vim.HostSystem object
R RM t
asTemplateR R5 u. Not enough permissions. Required privilege: {}u RegisterVM TaskuZ An error occurred during registration operation, the configuration file was not found: {0}( t vmFoldert RegisterVM_TaskR R
R5 Rd R R: R R, Re R Rf Rg R7 R Rh Ri R, R� t VMwareVmRegisterError( RR RM t vmx_pathRa R{ R0 RG t vm_ref( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt register_vm�
s6
c C@ s� t | � } t j d | � y | j | � } Wn� t j j k
ru } t j | � t j j
d j | j � � � nr t j j
k
r� } t j | � t j j
| j � � n8 t j k
r� } t j | � t j j | j � � n Xt | | d � } | S( u�
Updates the virtual machine configuration with the given object
vm_ref
Virtual machine managed object reference
vm_config_spec
Virtual machine config spec object to update
u Updating vm '%s'u. Not enough permissions. Required privilege: {}u ReconfigureVM Task( R R R+ t ReconfigVM_TaskR
R5 Rd R: R R, Re R Rf Rg R7 R Rh Ri R, ( R� Rz Ry R0 RG ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt update_vm�
s"
c C@ s� t | � } t j d | � y | j � } Wn� t j j k
rr } t j | � t j j
d j | j � � � nr t j j
k
r� } t j | � t j j
| j � � n8 t j k
r� } t j | � t j j | j � � n Xt | | d � d S( uo
Destroys the virtual machine
vm_ref
Managed object reference of a virtual machine object
u Destroying vm '%s'u. Not enough permissions. Required privilege: {}u Destroy TaskN( R R R+ RJ R
R5 Rd R: R R, Re R Rf Rg R7 R Rh Ri R, ( R� Ry R0 RG ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt delete_vm�
s
c C@ s� t | � } t j d | � y | j � Wn� t j j k
rp } t j | � t j j
d j | j � � � nX t j j
k
r� } t j j
| j � � n+ t j k
r� } t j j | j � � n Xd S( uo
Destroys the virtual machine
vm_ref
Managed object reference of a virtual machine object
u Destroying vm '%s'u. Not enough permissions. Required privilege: {}N( R R R+ t UnregisterVMR
R5 Rd R: R R, Re R Rf Rg R7 R Rh Ri ( R� Ry RG ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt
unregister_vm�
s
(� t __doc__t
__future__R R R R@ R t loggingR? Ro R9 t salt.exceptionsR t salt.modules.cmdmodt salt.utils.patht salt.utils.platformt salt.utils.stringutilst salt.extR t salt.ext.six.moves.http_clientR t
pyVim.connectR R R R R t pyVmomiR
R R R R
R� R R� R� R� t getLoggerR R R R R' RL RS R^ Rk Rz R} R~ R� R� R� R� R� R� R� R� R. R� RT R� R� R R� R R R R R$ R' R1 R5 R9 R@ RC RE RI RK RO RR RU RX R[ Ra Ro Rs Rt Rw Ry 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/ R6 R7 R8 R: R; R� R= R> R, RV R` Rj Rp Rw R| R� R� R� R� ( ( ( s5 /usr/lib/python2.7/site-packages/salt/utils/vmware.pyt <module>J s (
9 c ^ * # @
x 4 $ ( ' 6 / ' U G
$
/� @ = &C <2 7 .I< * 5
.
g7 + R 3 - 2
Mini Shell