File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/salt/utils/__pycache__/vmware.cpython-310.pyc
Back
o ;jY � @ s� d Z ddlZddlZddlZddlZddlZddlmZ ddlZ ddl Z ddl Z ddl Z ddl Z z ddlmZmZmZmZmZ ddlmZmZmZ dZW n eyW dZY nw zddlmZ dd l m Z dZ W n eys dZ Y nw z ddl Z ddl Z dZ!W n ey� dZ!Y nw e�"e#�Z$d d � Z% d�d d �Z& d�dd�Z' d�dd�Z(dd� Z)dd� Z* d�dd�Z+d�dd�Z,d�d d �Z-d d � Z.d d!� Z/d"d#� Z0d$d%� Z1d&d'� Z2d(d)� Z3d*d+� Z4d,d-� Z5d.d/� Z6d0d1� Z7d2d3� Z8d4d5� Z9d6d7� Z: d�d8d9�Z; : d�d;d<�Z< d�d=d>�Z=d?d@� Z>dAdB� Z?dCdD� Z@dEdF� ZAd�dGdH�ZBdIdJ� ZCd�dKdL�ZDdMdN� ZEdOdP� ZFd�dQdR�ZGdSdT� ZHdUdV� ZIdWdX� ZJdYdZ� ZKd�d[d\�ZLd�d]d^�ZMd_d`� ZNdadb� ZOd�dcdd�ZPd�dedf�ZQ d�dgdh�ZR d�didj�ZSdkdl� ZTd�dmdn�ZUdodp� ZVdqdr� ZWdsdt� ZXdudv� ZYdwdx� ZZdydz� Z[d{d|� Z\d}d~� Z]dd�� Z^ d�d�d��Z_d�d�� Z`d�d�d��Zad�d�� Zbd�d�� Zc d�d�d��Zdd�d�d��Zed�d�� Zf d�d�d��Zg d�d�d��Zhd�d�d��Zid�d�d��Zjd�d�d��Zkd�d�d��Zl d�d�d��Zmd�d�d��Znd�d�� Zod�d�d��Zp d�d�d��Zqd�d�� Zr d�d�d��Zsd�d�� Ztd�d�� Zud�d�� Zvd�d�� Zwd�d�� Zxd�d�� Zyd�d�� Zzd�d�d��Z{ d�d�d��Z|d�d�d��Z}d�d�dZ~d�dĄ Zd�d�dDŽZ� d�d�dɄZ�d�d�d˄Z�d�d̈́ Z�d�dτ Z�d�dф Z�dS )�an 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@g.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. � N)� BadStatusLine)� Disconnect�GetSi�GetStub� SmartConnect�SoapStubAdapter)� VmomiSupport�vim�vmodlTF)�Unauthenticated)�create_vsphere_clientc C s t rdS dS )z, Only load if PyVmomi is installed. T)FzBMissing dependency: The salt.utils.vmware module requires pyVmomi.)� HAS_PYVMOMI� r r �E/opt/saltstack/salt/lib/python3.10/site-packages/salt/utils/vmware.py� __virtual__w s r c C s� t jj�d�}|st�d� dS |du rd}|du r d}|r&|d|� d�7 }|s5|d �| |||||�7 }n |d �| ||||||�7 }t jjj |d d �} | S ) a( Shell out and call the specified esxcli command, 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 �esxclizJMissing dependency: The salt.utils.vmware.esxcli function requires ESXCLI.FN� �httpsz --credstore '�'z5 -s {} -u {} -p '{}' --protocol={} --portnumber={} {}z; -s {} -h {} -u {} -p '{}' --protocol={} --portnumber={} {}�quiet)Zoutput_loglevel) �salt�utils�path�which�log�error�format�modulesZcmdmodZrun_all) �host�user�pwd�cmd�protocol�portZ esxi_hostZ credstoreZesx_cmd�retr r r r � s* � ��r c C sb |s t jjj||d�}d}z t| |||d�}W |S ty0 } z t�|� W Y d}~|S d}~ww )a� Internal helper method to create an instance of the vSphere API client. Please provide username and password to authenticate. :param basestring server: vCenter host name or IP address :param basestring username: Name of the user :param basestring password: Password of the user :param Session session: Request HTTP session instance. If not specified, one is automatically created and used :param boolean verify_ssl: Verify the SSL certificate. Default: True :param basestring ca_bundle: Path to the ca bundle to use when verifying SSL certificates. :returns: Vsphere Client instance :rtype: :class:`vmware.vapi.vmc.client.VsphereClient` )� verify_ssl� ca_bundleN)�server�username�password�session)r r �httpr* r r r �trace)r' r( r) r* r% r& �client�errr r r �get_vsphere_client� s ����r/ c C s� t �d� d} |dkr |du rtj�d��|du r tj�d��n>|dkrT|durI|durIzt|| |�} W n) tyH } ztj�t| ���d} ~ ww d� |�} tj�| ��tj�d|� d ���t �d ||� d � | �} z|rxt | ||||| |d �} W n^ t y� } z d | j v r�t � d| j � t � d� t � d� � W Y d} ~ n:d} ~ w ty� } z*t| tjj�r�d| jv s�dt| �v r�d} nt �| � t| d�r�| jn| } tj�| ��d} ~ ww |�s`zt | ||||t�� | |d�} W nt t�y_ } zgdt| �v �r?t�tj�}tj|_zt | |||||| |d�} W nA t�y> } z t �| � t| d��r*| jnt| �} tj�d| � d| � ���d} ~ ww t| d��rH| jn| } t �| � tj�| ��W Y d} ~ nd} ~ ww t� t | � | S )z| Internal method to authenticate with a vCenter server or ESX/ESXi host and return the service instance object. z Retrieving new service instanceN�userpasszXLogin mechanism userpass was specified but the mandatory parameter 'username' is missingzXLogin mechanism userpass was specified but the mandatory parameter 'password' is missingZsspizKLogin mechanism '{}' was specified but the mandatory parameters are missingzUnsupported mechanism: 'r z7Connecting using the '%s' mechanism, with username '%s'zPCould not connect to host '{}'. Please check the debug log for more information.)r r r r" r# �b64token� mechanismzunexpected keyword argumentz5Initial connect to the VMware endpoint failed with %szOThis may mean that a version of PyVmomi EARLIER than 6.0.0.2016.6 is installed.z/We recommend updating to that version or later.z [SSL: CERTIFICATE_VERIFY_FAILED]z�Could not verify the SSL certificate. You can use verify_ssl: False if you do not want to verify the SSL certificate. This is not recommended as it is considered insecure.�msg)r r r r" r# � sslContextr1 r2 zcertificate verify failedzCould not connect to host 'z': ) r r, r � exceptions�CommandExecutionError�get_gssapi_token� ExceptionZVMwareConnectionError�strr r � TypeError�messager � isinstancer �faultZHostConnectFaultr3 � exception�hasattr�ssl�_create_unverified_context� SSLContext�PROTOCOL_TLSv1� CERT_NONE� verify_mode�atexit�registerr )r r( r) r" r# r2 � principal�domainr% �token�exc�err_msgZ default_msg�service_instance�contextr r r �_get_service_instance� s� ������ ����� �� �� � � �� � � ��� ��� rO c C s | j jj|d�}|S )z� 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 ��name)�contentZcustomizationSpecManagerZGetCustomizationSpec)�siZcustomization_spec_namer r r �get_customizationspec_refe s �rT c C s> t | �}|j�|j|gd�}|jD ] }|j|kr | S qdS )a 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 TN)� get_inventory� viewManager�CreateContainerView� rootFolder�viewrQ )rS �obj_type�obj_name� inventory� container�itemr r r � get_mor_using_container_viewv s � �r_ r0 c C s� |du rd}|du r d}t � } | r1t� } tjj�� s+t| d�r1| jd�| t |�g�kr1t | � d} | s@t | ||||||||d� } t � d� z| �� W | S tjjtjttfy t � d� zt | � W n tyn Y nw t | ||||||||d� } Y | S tjjy� } zt �| � tj�d | j� ���d} ~ w tjj y� } z t �| � tj�| j ��d} ~ w t j y� } z t �| � tj� | j ��d} ~ ww ) ak 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`` verify_ssl Verify the SSL certificate. Default: True Nr r r �:)r% z*Checking connection is still authenticatedz;Cached connection is stale or unauthenticated. Reconnecting�,Not enough permissions. Required privilege: )!r r r r �platformZis_proxyr? r �joinr9 r rO r r, Z CurrentTimer r= ZNotAuthenticatedr@ �SSLError�BrokenPipeError�ConnectionResetErrorr8 � NoPermissionr> r5 �VMwareApiError� privilegeId�VimFaultr3 r � RuntimeFault�VMwareRuntimeError) r r( r) r" r# r2 rH rI r% rM �stubrK r r r �get_service_instance� s� / �� -� � ��� �� � ��rn c C sh t �� }d|_t j|_| j}|j�d�d }|j�d�d }|t � � d< t ||||d|d�}|j|_|S )aT 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. Fr` r �"� ZvcSessionCookie)r �nsr �versionZpoolSizer4 ) r@ �create_default_context�check_hostnamerD rE �_stubr �splitZcookier ZGetRequestContextr ) rM r rq rr rN rm �hostnameZsession_cookieZnew_stubr r r � get_new_service_instance_stub s �rx � <unnamed>c C s, |s| j }t�d|� t�d�}| j|_|S )z� 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. z4[%s] Retrieving service instance from managed object�ServiceInstance)rQ r r, r rz ru )�mo_refrQ rS r r r �(get_service_instance_from_managed_object4 s r| c C s� t �d� zt| � W dS tjjy) } zt �|� tj� d|j � ���d}~w tjj yB } z t �|� tj� |j ��d}~w t jyZ } z t �|� tj�|j ��d}~ww )z� Function that disconnects from the vCenter server or ESXi host service_instance The Service Instance from which to obtain managed object references. Z Disconnectingra N)r r, r r r= rg r> r r5 rh ri rj r3 r rk rl �rM rK r r r � disconnectF s$ �� � ��r~ c C s� z| j jj}W nN tjjy$ } zt�|� tj � d|j � ���d}~w tjj y= } z t�|� tj � |j ��d}~w tjyU } z t�|� tj �|j ��d}~ww t�d|� |dkrbdS |dkrhdS tj � d�|���) z� 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. ra Nz api_type = %sZ VirtualCenterT� HostAgentFzEUnexpected api type '{}' . Supported types: 'VirtualCenter/HostAgent')rR �about�apiTyper r= rg r r> r r5 rh ri rj r3 r rk rl r, r )rM Zapi_typerK r r r �is_connection_to_a_vcenter] s4 �� � �� �r� c C s� z| j jW S tjjy" } zt�|� tj� d|j � ���d}~w tjj y; } z t�|� tj� |j ��d}~w t jyS } z t�|� tj�|j ��d}~ww )z� Returns information of the vCenter or ESXi host service_instance The Service Instance from which to obtain managed object references. ra N)rR r� r r= rg r r> r r5 rh ri rj r3 r rk rl r} r r r �get_service_info~ s" �� � ��r� c C sP t | �}||v r&t| �}|j�|jtjgd�}|jD ] }|j|kr%| S qdS )z� 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 TN) �list_dvsrU rV rW rX r �DistributedVirtualSwitchrY rQ )rM �dvs_nameZswitchesr\ r] r^ r r r �_get_dvs� s � �r� c C � | j jjS )zT Helper function that returns a list of PhysicalNics and their information. )�config�network�pnic�Zhost_referencer r r � _get_pnics� � r� c C r� )zS Helper function that returns a list of VirtualNics and their information. )r� r� �vnicr� r r r � _get_vnics� r� r� c C s | j jS )z_ Helper function that returns a list of Virtual NicManagers and their information. )� configManagerZvirtualNicManagerr� r r r �_get_vnic_manager� s r� c C �" | j D ] }|j|kr| S qdS �z� 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�� portgrouprQ ��dvsZportgroup_namer� r r r �_get_dvs_portgroup� � �r� c C r� r� r� r� r r r �_get_dvs_uplink_portgroup� r� r� c C s� t std��| � d|� d|� �}t�d|� t�|tj�}t�|�}d}|jsG|� |�}|r8t � t j j�|��S |jr<n |sDt j�d��|jr't j�d��)z� Get the gssapi token for Kerberos connection principal The service principal host Host url where we would like to authenticate domain Kerberos user domain z#The gssapi library is not imported.�/�@z%Retrieving gsspi token for service %sNz,Can't receive token, no response from serverz-Context established, but didn't receive token)� HAS_GSSAPI� ImportErrorr �debug�gssapi�NameZC_NT_USER_NAMEZ InitContextZ established�step�base64� b64encoder r Z stringutils�to_bytesr5 r6 )rH r rI ZserviceZ service_name�ctxZin_tokenZ out_tokenr r r r7 � s* �� �r7 c C s\ i }t | �jjdk�r�| jj�| �� jtj gd�}|�r�|j �r�|j d j j j |d< |j d j j j|d< |j d j j jD ] }|jjdkrI|j|d< q<|j d jjjj|d< |j d jjjj |d < |j d jjjj|d < |j d jjjj|d < |j d jjjj|d < |j d jjjj|d < |j d j jd d |d< |j d j jj |d< |j d j jj � � � d�|d< |j d j j d j!|d< |j d jjjj"|d< |j d j j#j$|d< |j d j j#j%|d< |d |d |d< i |d< i |d< i |d< i |d< |j d j&j'j(j)D ]O}g |d |j*< g |d |j*< g |d |j*< |d |j* �+|j,j-j.� |d |j* �+|j,j-j.� |j,j-j/�rE|d |j* �+|j,j-j/j0� |j,j1|d |j*< �q |j d j&j'j2j3|d < |j d j&j'j2j4|d < d �5|j d j&j'j2j3|j d j&j'j2j4�r|d nd |j d j&j'j2j4�|d!< |j d j&j'j6j7D ] }|j1|d |j*< �q�|j d j&j8j9j:j|d"< d#}|S )$z� 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 r Tr Z manufacturerZ productnameZ ServiceTagZ serialnumberZ osfullnameZosmanufacturerZ osreleaseZosbuildZ os_family�os� Z mem_totalZ biosversionz%m/%d/%YZbiosreleasedateZ cpu_modelZkernelZnum_cpu_socketsZ num_cpu_coresZnum_cpusZ ip_interfacesZip4_interfacesZip6_interfacesZhwaddr_interfacesr rI z{}{}{}�.� Zfqdn�timezoneN);rU r� r� rR rV rW �RetrieveContentrX r � HostSystemrY ZhardwareZ systemInfo�vendorZmodelZotherIdentifyingInfoZidentifierType�keyZidentifierValueZsummaryr� �productZfullNamerr �buildrQ Z memorySizeZbiosInfoZ biosVersionZ releaseDate�date�strftimeZcpuPkg� descriptionZ productLineIdZcpuInfoZnumCpuPackagesZ numCpuCoresr� Z networkSystemZ networkConfigr� �device�append�spec�ipZ ipAddressZ ipV6ConfigZ ipV6AddressZmacZ dnsConfigZhostNameZ domainNamer Z networkInfor� ZdateTimeSystemZ dateTimeInfoZtimeZone)rM Z hw_grain_datarY �_dataZ_vnicZ_pnicr r r �get_hardware_grains s� � ������� ������� � �r� c C s | � � S )z� Return the inventory of a Service Instance Object. service_instance The Service Instance Object for which to obtain inventory. )r� �rM r r r rU X s rU c C s� z t �d� | �� jW S tjjy( } zt �|� tj � d|j � ���d}~w tjj yA } z t �|� tj � |j ��d}~w tjyY } z t �|� tj �|j ��d}~ww )z� Returns the root folder of a vCenter. service_instance The Service Instance Object for which to obtain the root folder. zRetrieving root folderra N)r r, r� rX r r= rg r> r r5 rh ri rj r3 r rk rl r} r r r �get_root_folderb s$ �� � ��r� c C s� |st | �}|}d}|sx|sxd}z | jj�||gd�}W nN tjjy9 } zt�|� t j � d|j � ���d}~w tjj yR } z t�|� t j � |j��d}~w tjyj } z t�|� t j �|j��d}~ww tjjjdddtjjd�}tjjj||s�dnd|d�} tjjj||s�dnd|s�|gndd �} tjjj| g| gdd �} z | jj�| g�} W nN tjjy� } zt�|� t j � d|j � ���d}~w tjj y� } z t�|� t j � |j��d}~w tjy� } z t�|� t j �|j��d}~ww |�rZz|� � W | S tjj�y& } zt�|� t j � d|j � ���d}~w tjj �y@ } z t�|� t j � |j��d}~w tj�yY } z t�|� t j �|j��d}~ww | S ) a7 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. FTra NZtraverseEntitiesrY �rQ r �skip�type)r� �allZpathSet)�objr� � selectSet)Z objectSet�propSetZ reportMissingObjectsInResults) r� rR rV rW r r= rg r r> r r5 rh ri rj r3 r rk rl �query�PropertyCollector� TraversalSpecrY Z ContainerViewZ PropertySpecZ ObjectSpecZ FilterSpecZpropertyCollectorZRetrieveContentsZDestroy) rM rZ � property_list� container_ref�traversal_spec�local_propertiesZobj_refZlocal_traversal_specrK Z property_specZobj_specZ filter_specrR r r r � get_contenty s� %� �� � ���� ��� �� � �� � �� � ��r� rQ c C sV t | ||g|d�}|D ] }t|�dd���d�}|| |ks"||kr(|d S q dS )a 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� �objectr� z'"N)�get_mors_with_propertiesr9 �get�strip)rM � object_typeZproperty_valueZ property_namer� � object_listr� Zobj_idr r r �get_mor_by_property� s � �r� c C s� | |g}||||d�}z t |i |��}W n/ ty$ t |i |��}Y n tyC } z| jtjkr2� t |i |��}W Y d} ~ nd} ~ ww g } |D ]} i } | jD ]} | j| | j< qO| j| d< | � | � qHt � dt | �� | S )a� 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. )r� r� r� r� Nr� zRetrieved %s objects) r� r �OSError�errnoZEPIPEr� �valrQ r� r� r r, �len)rM r� r� r� r� r� Z content_argsZcontent_kwargsrR rK r� r� � propertiesZpropr r r r� $ s2 "� �� r� c C s� t | �}t�dt| �j� zt|t| �| dgdd�}|d d }W n tjjy. d}Y nw t�d|t| �j|� t|t| �| |dd�}|sQt j � d|� d ���|d S ) z� 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. zRetrieving name of %srQ T)r� r� r� r ry z%Retrieving properties '%s' of %s '%s'z Properties of managed object 'z' weren't retrieved) r| r r, r� �__name__r� r r� �InvalidPropertyr r5 rh )r{ r� rM �itemsZmo_namer r r � get_properties_of_managed_objecta s@ ���� �r� c C s t | dg�}|�d�S )z� Returns the name of a managed object. If the name wasn't found, it returns None. mo_ref The managed object reference. rQ )r� r� )r{ �propsr r r �get_managed_object_name� s r� c C sl | dkr t jj�� S | dkrt jj�� S | dkr t jj�� S | dkr(t jj�� S | dkr2t jj�� S td��)z� Return the network adapter type. adpater_type The adapter type from which to obtain the network adapter type. �vmxnet�vmxnet2�vmxnet3�e1000�e1000ez,An unknown network adapter object type name.) r �vmr� � VirtualVmxnet�VirtualVmxnet2�VirtualVmxnet3� VirtualE1000� VirtualE1000e� ValueError)Z adapter_typer r r �get_network_adapter_type� s r� c C sl t | tjjj�r dS t | tjjj�rdS t | tjjj�r dS t | tjjj�r(dS t | tjjj�r2dS t d��)z� Returns the network adapter type. adapter_object The adapter object from which to obtain the network adapter type. r� r� r� r� r� z'An unknown network adapter object type.) r< r r� r� r� r� r� r� r� r� )Zadapter_objectr r r � get_network_adapter_object_type� s r� c s� t | �}t�d|� rd�� �nd�� dg}tjjjddtj tjjjddtj d �gd �}t | �}� �fd d �t |tj | ||d �D �}|S )a 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. zCRetrieving DVSs in datacenter '%s', dvs_names='%s', get_all_dvss=%s�,NrQ � networkFolderT� childEntityF�r r� r� �r r� r� r� c �( g | ]}�s� r|d � v r|d �qS �rQ r� r ��.0�i�� dvs_names� get_all_dvssr r � <listcomp>� � � � �z get_dvss.<locals>.<listcomp>�r� r� r� )r� r r, rc r r� r� r� r � Datacenter�Folderr| r� r� )�dc_refr� r� �dc_namer� r� rM r� r r� r �get_dvss� s8 ���� �� r c C sl t | �}t�d|� t| �}tjjjddtj d�}t |tj | dg|d�}|s0t j �d|� d���|d d S ) z6 Retrieves the network folder of a datacenter z,Retrieving network folder in datacenter '%s'r� Fr� rQ r� z Network folder in datacenter 'z' wasn't retrievedr r� )r� r r, r| r r� r� r� r r� r� r� r r5 �VMwareObjectRetrievalError)r� r rM r� �entriesr r r �get_network_folder� s$ �� � r c C s t | �}t�d||� |st�� }|js t�� |_||j_t| �}z|� |�}W nN tj j yE } zt� |� t j�d|j� ���d}~w tj jy^ } z t� |� t j�|j��d}~w tjyv } z t� |� t j�|j��d}~ww t||t|j�� dS )aq 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. z$Creating DVS '%s' in datacenter '%s'ra N)r� r r, r Z DVSCreateSpecZ configSpecZVMwareDVSConfigSpecrQ r ZCreateDVS_Taskr= rg r> r r5 rh ri rj r3 r rk rl � wait_for_taskr9 � __class__)r� r� Zdvs_create_specr Znetw_folder_ref�taskrK r r r � create_dvs s4 �� � ��r c C �� t | �}t�d|� z| �|�}W nN tjjy. } zt�|� tj � d|j � ���d}~w tjj yG } z t�|� tj � |j ��d}~w tjy_ } z t�|� tj �|j ��d}~ww t||t|j�� dS )z� 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. zUpdating dvs '%s'ra N)r� r r, ZReconfigureDvs_Taskr r= rg r> r r5 rh ri rj r3 r rk rl r r9 r )�dvs_refZdvs_config_specr� r rK r r r � update_dvs0 s( �� � ��r c C s� t | �}t�d||� z | j|d� W dS tjjy1 } zt�|� tj � d|j � ���d}~w tjj yJ } z t�|� tj � |j ��d}~w tjyb } z t�|� tj �|j ��d}~ww )z� Sets whether NIOC is enabled on a DVS. dvs_ref The DVS reference. enabled Flag specifying whether NIOC is enabled. z<Setting network resource management enable to %s on dvs '%s')�enablera N)r� r r, Z EnableNetworkResourceManagementr r= rg r> r r5 rh ri rj r3 r rk rl )r �enabledr� rK r r r �+set_dvs_network_resource_management_enabledM s. � �� � ��r c s� t | tjtjf�stj�d��t| �}t� dt | �j |�r"d� ��nd� � dg}t | tj�rFt jjjddtjt jjjdd tjd �gd �}n t jjjd d tjd �}t| �}� �fd d�t|tj| ||d�D �}|S )az 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. zEParent has to be either a datacenter, or a distributed virtual switchzMRetrieving portgroup in %s '%s', portgroups_names='%s', get_all_portgroups=%sr� NrQ r� Tr� Fr� r� r� c �( g | ]}� s�r|d �v r|d �qS r� r r� ��get_all_portgroups�portgroup_namesr r r� � r� z$get_dvportgroups.<locals>.<listcomp>r� )r< r r� r� r r5 �ArgumentValueErrorr� r r, r� r� rc r r� r� r� r� r| r� �DistributedVirtualPortgroup)� parent_refr r � parent_namer� r� rM r� r r r �get_dvportgroupsl sJ �� ��� � �� r c C sr t | �}t�d|� tjjjddtjd�}t | �}dd� t |tj | dg|d�D �}|s5t j �d |� d ���|d S ) z� Returns the uplink distributed virtual portgroup of a distributed virtual switch (dvs) dvs_ref The dvs reference z'Retrieving uplink portgroup of dvs '%s'r� Fr� c S s. g | ]}|d rdd� |d D �r|d �qS )�tagc S � g | ] }|j d kr|�qS )zSYSTEM/DVS.UPLINKPG�r� )r� �tr r r r� � � z5get_uplink_dvportgroup.<locals>.<listcomp>.<listcomp>r� r )r� �entryr r r r� � s � ��z*get_uplink_dvportgroup.<locals>.<listcomp>r r� zUplink portgroup of DVS 'z' wasn't foundr )r� r r, r r� r� r� r r� r| r� r r r5 r )r r� r� rM r� r r r �get_uplink_dvportgroup� s( ��� �r c C s� t | �}t�d|j|� t�d|� z| �|�}W nN tjjy6 } zt�|� t j � d|j � ���d}~w tjj yO } z t�|� t j � |j��d}~w tjyg } z t�|� t j �|j��d}~ww t||t|j�� dS )z� Creates a distributed virtual portgroup on a distributed virtual switch (dvs) dvs_ref The dvs reference spec Portgroup spec (vim.DVPortgroupConfigSpec) z Adding portgroup %s to dvs '%s'z spec = %sra N)r� r r, rQ ZCreateDVPortgroup_Taskr r= rg r> r r5 rh ri rj r3 r rk rl r r9 r )r r� r� r rK r r r �create_dvportgroup� s* �� � ��r c C r )z� Updates a distributed virtual portgroup portgroup_ref The portgroup reference spec Portgroup spec (vim.DVPortgroupConfigSpec) zUpdating portgrouo %sra N)r� r r, ZReconfigureDVPortgroup_Taskr r= rg r> r r5 rh ri rj r3 r rk rl r r9 r )� portgroup_refr� �pg_namer rK r r r �update_dvportgroup� s( �� � ��r" c C s� t | �}t�d|� z| �� }W nN tjjy- } zt�|� tj � d|j � ���d}~w tjj yF } z t�|� tj � |j ��d}~w tjy^ } z t�|� tj �|j ��d}~ww t||t|j�� dS )zd Removes a distributed virtual portgroup portgroup_ref The portgroup reference zRemoving portgroup %sra N)r� r r, � Destroy_Taskr r= rg r> r r5 rh ri rj r3 r rk rl r r9 r )r r! r rK r r r �remove_dvportgroup s( �� � ��r$ c s� t | tj�s tj�d��t| �}t�dt | �j |�r d� ��nd� � dg}t | �}t jjjddtjt jjjdd tjd �gd �}� �fd d �t|tj| ||d�D �}|S )as 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. z Parent has to be a datacenter.zHRetrieving network from %s '%s', network_names='%s', get_all_networks=%sr� NrQ r� Tr� Fr� r� c r r� r r� ��get_all_networks� network_namesr r r� ? r� z get_networks.<locals>.<listcomp>r� )r< r r� r r5 r r� r r, r� r� rc r| r r� r� r� r� r� �Network)r r' r& r r� rM r� r� r r% r � get_networks s> ���� �� r) c C s: |du rdg}g }t | ||�}|D ] }|�|d � q|S )a� 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``. NrQ )r� r� )rM Z vim_objectr� r� Z item_listr^ r r r � list_objectsM s r* c C s� t �d� z| jj}W |S tjjy) } zt �|� tj � d|j � ���d}~w tjj yB } z t �|� tj � |j ��d}~w tjyZ } z t �|� tj �|j ��d}~ww )z� Returns the license manager. service_instance The Service Instance Object from which to obrain the license manager. zRetrieving license managerra N)r r� rR �licenseManagerr r= rg r> r r5 rh ri rj r3 r rk rl )rM Z lic_managerrK r r r �get_license_managere s& � �� � ��r, c C s� t �d� z| jjj}W nN tjjy) } zt �|� t j � d|j � ���d}~w tjj yB } z t �|� t j � |j��d}~w tjyZ } z t �|� t j �|j��d}~ww |sct j �d��|S )z� Returns the license assignment manager. service_instance The Service Instance Object from which to obrain the license manager. z%Retrieving license assignment managerra Nz,License assignment manager was not retrieved)r r� rR r+ ZlicenseAssignmentManagerr r= rg r> r r5 rh ri rj r3 r rk rl r )rM Zlic_assignment_managerrK r r r � get_license_assignment_manager~ s0 � �� � ���r- c C s� |st | �}t�d� z|jW S tjjy, } zt�|� tj � d|j � ���d}~w tjj yE } z t�|� tj � |j ��d}~w tjy] } z t�|� tj �|j ��d}~ww )a 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. zRetrieving licensesra N)r, r r� Zlicensesr r= rg r> r r5 rh ri rj r3 r rk rl )rM �license_managerrK r r r � get_licenses� s( �� � ��r/ c C s� |st | �}t�� }d|_||_t�d|� z |�||g�}W |S tjj y= } zt� |� t j � d|j� ���d}~w tjjyV } z t� |� t j � |j��d}~w tjyn } z t� |� t j �|j��d}~ww )aC 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. ZVpxClientLicenseLabelzAdding license '%s'ra N)r, r ZKeyValuer� �valuer r� Z AddLicenser= rg r> r r5 rh ri rj r3 r rk rl )rM r� r� r. Zlabel�vmware_licenserK r r r � add_license� s0 � �� � ��r2 c C s |st | �}|stj�d��d}d}d}|sr|rd}d}z| jjj}W nQ tjj y@ } zt � |� tj� d|j � ���d}~w tjjyY } z t � |� tj� |j��d}~w tjyq } z t � |� tj�|j��d}~ww |j}t �d|� z|�|�}W nN tjj y� } zt � |� tj� d|j � ���d}~w tjjy� } z t � |� tj� |j��d}~w tjy� } z t � |� tj�|j��d}~ww |dkr�t|�d kr�t �d � tj�d ��|r�||d jkr�t �d ||d j� tj�d��dd� |D �S )a� 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. zNo entity_name passedNZmoidFT�uuidra z$Retrieving licenses assigned to '%s'rp zCUnexpectectedly retrieved more than one VCenter license assignment.z2Unexpected return. Expect only a single assignmentr z0Getting license info for wrong vcenter: %s != %sz3Got license assignment info for a different vcenterc S � g | ]}|j �qS r )ZassignedLicense)r� �ar r r r� 7 � z)get_assigned_licenses.<locals>.<listcomp>)r- r r5 r rR r� � instanceUuidr r= rg r r> rh ri rj r3 r rk rl �_moIdr, ZQueryAssignedLicensesr� r ZentityDisplayName) rM � entity_ref� entity_name�license_assignment_manager� entity_idZ entity_typeZ check_namerK Z assignmentsr r r �get_assigned_licenses� s~ �� � �� �� � �� ���r= c C sz |st | �}d}|s[z| jjj}W nD tjjy. } zt�|� t j � d|j � ���d}~w tjj yB } zt j � |j��d}~w tjyU } zt j �|j��d}~ww |sZd}n|j}t�d|� z |�|||�}W |S tjjy� } zt�|� t j � d|j � ���d}~w tjj y� } z t�|� t j � |j��d}~w tjy� } z t�|� t j �|j��d}~ww )a� 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. Nra ZvCenterzAssigning license to '%s')r- rR r� r7 r r= rg r r> r r5 rh ri rj r3 r rk rl r8 r, ZUpdateAssignedLicense) rM Z license_keyZ license_namer9 r: r; r< rK r1 r r r �assign_license: sX " ������ �� �� � ��r> c C � t | tj�S )z� Returns a list of datacenters associated with a given service instance. service_instance The Service Instance Object from which to obtain datacenters. )r* r r� r� r r r �list_datacenters� � r@ c s& � �fdd�t | tjdgd�D �}|S )aX 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. c r� r� r r� ��datacenter_names�get_all_datacentersr r r� � s �� �z#get_datacenters.<locals>.<listcomp>rQ )r� )r� r r� )rM rC rD r� r rB r �get_datacenters� s ��rE c C s. t | |gd�}|stj�d|� d���|d S )z� Returns a vim.Datacenter managed object. service_instance The Service Instance Object from which to obtain datacenter. datacenter_name The datacenter name )rC z Datacenter 'z' was not foundr )rE r r5 r )rM �datacenter_namer� r r r �get_datacenter� s �rG c C s� t | �}t�d|� z|�|�}W |S tjjy/ } zt�|� tj � d|j � ���d}~w tjj yH } z t�|� tj � |j ��d}~w tjy` } z t�|� tj �|j ��d}~ww )z� Creates a datacenter. .. versionadded:: 2017.7.0 service_instance The Service Instance Object datacenter_name The datacenter name zCreating datacenter '%s'ra N)r� r r, ZCreateDatacenterr r= rg r> r r5 rh ri rj r3 r rk rl )rM rF Z root_folderZdc_objrK r r r �create_datacenter� s( � �� � ��rH c s� t | �}t�d� |� t| |d�}tjjjddtj tjjjddtj d�gd�}� fd d �t |tj | d g|d �D �}|sHt j�d � � d|� d���|d S )z� Returns a cluster in a datacenter. dc_ref The datacenter reference cluster The cluster to be retrieved z,Retrieving cluster '%s' from datacenter '%s'rP � hostFolderTr� Fr� r� c s g | ] }|d � kr|d �qS r� r r� ��clusterr r r� � s �z get_cluster.<locals>.<listcomp>rQ r� z Cluster 'z ' was not found in datacenter 'r r )r� r r, r| r r� r� r� r r� r� r� �ClusterComputeResourcer r5 r )r� rK r rS r� r� r rJ r � get_cluster� s4 ��� �� �rM c C s� t | �}t�d||� z | j�||� W dS tjjy2 } zt�|� t j � d|j � ���d}~w tjj yK } z t�|� t j � |j��d}~w tjyc } z t�|� t j �|j��d}~ww )z� 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. z(Creating cluster '%s' in datacenter '%s'ra N)r� r r, rI ZCreateClusterExr r= rg r> r r5 rh ri rj r3 r rk rl )r� � cluster_name� cluster_specr rK r r r �create_cluster s& �� � ��rP c C s� t | �}t�d|� z | j|dd�}W nN tjjy0 } zt�|� tj � d|j � ���d}~w tjj yI } z t�|� tj � |j ��d}~w tjya } z t�|� tj �|j ��d}~ww t||d� dS )z� Updates a cluster in a datacenter. cluster_ref The cluster reference. cluster_spec The cluster spec (vim.ClusterConfigSpecEx). Defaults to None. zUpdating cluster '%s'T)�modifyra NZClusterUpdateTask)r� r r, Z ReconfigureComputeResource_Taskr r= rg r> r r5 rh ri rj r3 r rk rl r )Z cluster_refrO rN r rK r r r �update_cluster s( �� � ��rR c C r? )z� Returns a list of clusters associated with a given service instance. service_instance The Service Instance Object from which to obtain clusters. )r* r rL r� r r r � list_clusters= rA rS c C r? )z� Returns a list of datastore clusters associated with a given service instance. service_instance The Service Instance Object from which to obtain datastore clusters. )r* r � StoragePodr� r r r �list_datastore_clustersG rA rU c C r? )z� Returns a list of datastores associated with a given service instance. service_instance The Service Instance Object from which to obtain datastores. )r* r � Datastorer� r r r �list_datastoresQ rA rW c C s g }t | ||d�}|D ]{}z|jjd|j� d|� �|d�}W nN tjjy; } zt�| � t j � d| j � ���d} ~ w tjj yT } z t�| � t j � | j��d} ~ w tjyl } z t�| � t j �| j��d} ~ ww z|�t jj�||d�� W q t j jy� Y q w |S )a� 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 )�datastore_names�[z] )Z datastorePathZ searchSpecra Nzquery virtual machine files)�get_datastoresZbrowserZSearchDatastore_TaskrQ r r= rg r r> r r5 rh ri rj r3 r rk rl r� r �vmwarer �VMwareFileNotFoundError) rM � directoryZ datastoresZcontainer_objectZ browser_spec�filesZdatastore_objectsZdatobjr rK r r r �get_datastore_files[ sF � � �� � �����r_ c s� t |�}�r t�d|� nt�d|�� � � r(t|tj�s(tj�d� |j j ����s�� r�t�d� � t | ||�}tj j�|dg�}|�dg �}g } dd� |D �D ]!} � fdd�| jD �s]qPt�d | jd d� | jD �� | �| j� qPt�d | � �r���| � n| ��s��s�t�d � � g S t�d �� t|tj�r�tjjjdddtjd�} njt|tj�r�tjjjdddtjd�} nWt|tj�r�tjjjdddtjd�} nDt|tj�r�tjjjdddtjd�} n1t|tj ��rt |�dk�rtjjjdtjjjddtjd�gdtj d�} n tj�d|j j � d���t | tj dg|| d �} t�d t | �� ��fd d�| D �} t�d d d� | D �� d!d� | D �S )"a 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. z)Retrieving all datastores visible to '%s'zLRetrieving datastores visible to '%s': names = (%s); backing disk ids = (%s)z?Unsupported reference type '{}' when backing disk filter is setz.Filtering datastores with backing disk ids: %sz fileSystemVolumeInfo.mountInfoc S s g | ] }t |jtj�r|j�qS r )r< Zvolumer ZHostVmfsVolumer� r r r r� � s ��z"get_datastores.<locals>.<listcomp>c s g | ] }|j � v r|�qS r ��diskName�r� �e)�backing_disk_idsr r r� � r z(Found datastore '%s' for disk id(s) '%s'c S r4 r r` rb r r r r� � r6 z#Datastore found for disk filter: %szYNo datastore to be filtered after retrieving the datastores backed by the disk id(s) '%s'zdatastore_names = %sZhost_datastore_traversal� datastoreFr� Zcluster_datastore_traversalZ datacenter_datastore_traversalZdatastore_cluster_traversalr� Z Datacentersr� )r r� r� r� z Unsupported reference type 'r rQ )r� r� r� r� zRetrieved %s datastoresc s g | ] }�s |d � v r|�qS rP r r� )rX �get_all_datastoresr r r� ) � zFiltered datastores: %sc S � g | ]}|d �qS rP r r� r r r r� * � c S rh )r� r r� r r r r� + ri ) r� r r, r< r r� r r5 r r r r� �get_storage_systemr r[ r� r� �extentrQ r� �extendr r� r� r� rL r� rT r� r� rV r� ) rM Z referencerX rd rf r[ �storage_systemr� Z mount_infosZdisk_datastoresZvolr� r� r )rd rX rf r rZ � s� � � � �� � � � � � ���� ��rZ c C s� t | �}t�d||� z| �|� W dS tjjy0 } zt�|� tj � d|j � ���d}~w tjj yI } z t�|� tj � |j ��d}~w tjya } z t�|� tj �|j ��d}~ww )z� Renames a datastore datastore_ref vim.Datastore reference to the datastore object to be changed new_datastore_name New datastore name z Renaming datastore '%s' to '%s'ra N)r� r r, ZRenameDatastorer r= rg r> r r5 rh ri rj r3 r rk rl )� datastore_refZnew_datastore_name�ds_namerK r r r �rename_datastore. s& �� � ��rp c C sh |st |�}tjjjdtjdd�}t| tjdg||d�}|s(t j � d|� d���t � d|� |d d S ) z) Returns a host's storage system �configManager.storageSystemF�r r� r� Z systemFile�r� r� r� �Host's '�"' storage system was not retrievedz [%s] Retrieved storage systemr r� )r� r r� r� r� r r� r� �HostStorageSystemr r5 r r r, )rM �host_refrw r� �objsr r r rj I s$ �� � rj c C s� z | j |gd�}W nN tjjy& } zt�|� tj�d|j � ���d}~w tjj y? } z t�|� tj�|j ��d}~w t j yW } z t�|� tj�|j ��d}~ww t�d|d � |d S )z` Returns partition information for a device path, of type vim.HostDiskPartitionInfo )� devicePathra N�partition_info = %sr )ZRetrieveDiskPartitionInfor r= rg r r> r r5 rh ri rj r3 r rk rl r, )rm � device_pathZpartition_infosrK r r r �_get_partition_infoc s* � �� � ��r| c sp t �d� dd� |jjD �}|stj�d�|j���|d � t j |jj |jjd�}d� _ z | j |t jj|d�}W nN t jjyU } zt �|� tj�d |j� ���d }~w t jjyn } z t �|� tj�|j��d }~w tjy� } z t �|� tj�|j��d }~ww t �d |� t �d � � fd d�|jjD �}|s�tj�d�|j���t �d|d � |d |jfS )z� 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 zUAdding a partition at the end of the disk and getting the new computed partition specc S r )�none)r� �r� �pr r r r� � r z4_get_new_computed_partition_spec.<locals>.<listcomp>z+Free partition was not found on device '{}'r )�total� partition�vmfs)ry ZpartitionFormat�layoutra Nz computed partition info = {0}z Retrieving new partition numberc sT g | ]&}|j j� j jks� j jd kr(|j jdkr(|jj� jjkr(|jdkr|j�qS )r rp r� )�start�block�endr� r� r~ �Zfree_partitionr r r� � s � zANew partition was not found in computed partitions of device '{}'znew partition number = %s) r r, r� r� r r5 ZVMwareObjectNotFoundErrorr Z deviceNamer ZHostDiskPartitionLayoutr� r� ZComputeDiskPartitionInfoZ$HostDiskPartitionInfoPartitionFormatZgptr= rg r> rh ri rj r3 r rk rl ZVMwareNotFoundErrorr� )rm r{ �partition_infoZfree_partitionsr� Zcomputed_partition_inforK Zpartition_numbersr r� r � _get_new_computed_partition_spec{ sb ��� � � �� � �� ���r� c C sT t | �}|j}t�d||||� |s t| |d�}t|| |�}|}t||j�} t�d| � t ||j| �\} } t j t j ||t j || d�d�|j| d�} z | jj�| �} W nN t jjyo } zt�|� tj�d|j� ���d}~w t jjy� } z t�|� tj�|j��d}~w tj y� } z t�|� tj� |j��d}~ww t�d ||� | S ) aA 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 z>Creating datastore '%s' on host '%s', scsi disk '%s', vmfs v%srP rz )ra r� )Z majorVersionZ volumeNamerk )r� ZdiskUuidr� ra Nz#Created datastore '%s' on host '%s') r� � canonicalNamer r� r| rj r| ry r, r� r ZVmfsDatastoreCreateSpecZ HostVmfsSpecZHostScsiDiskPartitionr3 r� ZdatastoreSystemZCreateVmfsDatastorer= rg r> r r5 rh ri rj r3 r rk rl )rw Zdatastore_nameZdisk_refZvmfs_major_versionrm rw �disk_idrS Z target_diskr� Znew_partition_numberZpartition_specr� Zds_refrK r r r �create_vmfs_datastore� s` � ���� �� � ��r� c C sp |st | �}t| �}tjjjdtjdd�}t|tj dg| |d�}|s,t j � d|� d���t �d|� |d d S ) z� Returns a host's datastore system host_ref Reference to the ESXi host hostname Name of the host. This argument is optional. z configManager.datastoreSystemFrr re rs rt z$' datastore system was not retrievedz [%s] Retrieved datastore systemr r� )r� r| r r� r� r� r r� r� ZHostDatastoreSystemr r5 r r r, )rw rw rM r� rx r r r �get_host_datastore_system s& �� � r� c C s" t |g d��}|d }t�d|� |�d�}|s"tj�d|� d���t|d j�}t |d j|d�}z|� |� W nN t j j yV } zt�|� tj�d |j� ���d }~w t j jyo } z t�|� tj�|j��d }~w tjy� } z t�|� tj�|j��d }~ww t�d ||� d S ) z� 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 )r �inforQ rQ zRemoving datastore '%s'r z Datastore 'z+' can't be removed. No attached hosts foundr )rw ra Nz[%s] Removed datastore '%s')r� r r� r� r r5 rh r� r� r� ZRemoveDatastorer r= rg r> ri rj r3 r rk rl r, )rM rn Zds_propsro Zds_hostsrw Zhost_ds_systemrK r r r �remove_datastore$ s8 � �� � ��r� c C s� dg}|r |s t j�d��|sg }|st| �}n t| |�}|r$|�d� t| tj||d�}t � ddd� |D �� g }|D ]/} |rTt | d tj �sIq<t | d �} | |krTq<|r^|�| d � q<| d |v rk|�| d � q<|S ) a� 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. rQ z7Must specify the datacenter when specifying the cluster�parent�r� r� zRetrieved hosts: %sc S rh rP r )r� �hr r r r� | ri z get_hosts.<locals>.<listcomp>r� )r r5 r r� rG r� r� r r� r r, r< rL r� ) rM rF � host_namesrN Z get_all_hostsr� Z start_point�hostsZfiltered_hostsr� r r r r � get_hostsH sD � � �r� c sT |st |�}|st| ||�}z|j}W nN tjjy0 } zt�|� tj � d|j � ���d}~w tjj yI } z t�|� tj � |j ��d}~w tjya } z t�|� tj �|j ��d}~ww |sntj �d|� d���|j}|s}tj �d|� d���|jdu r�tj �d|� d���i }|jD ]� |�� fdd �� jD �� q�t�d ||� |S ) a� 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. ra Nrt �'' storage device info was not retrievedz"' multipath info was not retrievedz"No luns were retrieved from host 'r c s i | ] }|j �d �d � j�qS )r� r )rQ rv �lunr~ ��lr r � <dictcomp>� rg z4_get_scsi_address_to_lun_key_map.<locals>.<dictcomp>z+Scsi address to lun id map on host '%s': %s)r� rj �storageDeviceInfor r= rg r r> r r5 rh ri rj r3 r rk rl r Z multipathInfor� �updater r, )rM rw rm rw � device_inforK Zmultipath_info�lun_key_by_scsi_addrr r� r � _get_scsi_address_to_lun_key_map� sR �� � �� � � � �r� c C s6 |st | �}|s t| |d�}t|| |�}|s tj�d|� d���z|j}W nN tjj yB } zt � |� tj� d|j � ���d}~w tjjy[ } z t � |� tj� |j��d}~w tjys } z t � |� tj�|j��d}~ww |s�tj�d|� d���|j}|r�t �d|dd � |D �� |S t �d |� g S ) a> 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. rP rt ru ra Nr� z$Retrieved scsi luns in host '%s': %sc S r4 r �r� �r� r� r r r r� � r6 z get_all_luns.<locals>.<listcomp>z#Retrieved no scsi_luns in host '%s')r� r| rj r r5 r r� r r= rg r r> rh ri rj r3 r rk rl ZscsiLunr, )rw rm rw rS r� rK � scsi_lunsr r r � get_all_luns� sP � �� � �� � � r� c sb |st | �}t| |d�}|st|| |�}t|| ||�}dd� t| ||�D �� � fdd�|�� D �S )a] 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. rP c S s i | ]}|j |�qS r r �r� �dr r r r� s �z/get_scsi_address_to_lun_map.<locals>.<dictcomp>c s i | ] \}}|� | �qS r r )r� � scsi_addrZlun_key�Zluns_to_key_mapr r r� s ��)r� r| rj r� r� r� )rw rm rw rS Zlun_ids_to_scsi_addr_mapr r� r �get_scsi_address_to_lun_map s � � �r� c s� t | �}�r t�d|� nt�d|� �� � s�sg S t| |d�}t|| |�}g ��rCt|| ||�}�fdd�|�� D ��t�d�� t| |�}� ��fdd�|D �} t�d|d d� | D �� | S ) aS 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. z!Retrieving all disks in host '%s'z@Retrieving disks in host '%s': ids = (%s); scsi addresses = (%s)rP c s g | ] \}}|� v r|�qS r r )r� r� r� )�scsi_addressesr r r� N s �z get_disks.<locals>.<listcomp>z&disk_keys based on scsi_addresses = %sc s8 g | ]}t |tj�r�s� r|j� v s|j�v r|�qS r )r< r � HostScsiDiskr� r� )r� Zdisk)�disk_ids� disk_keys� get_all_disksr r r� V s ��� � z Retrieved disks in host '%s': %sc S r4 r r� r� r r r r� g r6 )r� r r, r| rj r� r� r� ) rw r� r� r� rw rS rm r� r� Z scsi_disksr )r� r� r� r� r � get_disks% s@ � � � � �r� c s� t | �}t| �}|st|| |�}t|dg�}|�d�s%tj�d|� d���t� d|t |d �d� dd� |d D ��� � fdd�|d D �}|sUtj�d � � d |� d���t� d ||d j � t ||d j �}t� d |t |jj�� � |S )a 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. �storageDeviceInfo.scsiLunz#No devices were retrieved in host 'r � [%s] Retrieved %s devices: %s�, c S r4 r r� r� r r r r� � r6 z+get_disk_partition_info.<locals>.<listcomp>c �& g | ]}t |tj�r|j� kr|�qS r �r< r r� r� r� �r� r r r� � � � ��Disk '�' was not found in host '�[%s] device_path = %sr z+[%s] Retrieved %s partition(s) on disk '%s')r� r| rj r� r� r r5 r r r, r� rc ry r| r� r� )rw r� rm rw rM r� �disksr� r r� r �get_disk_partition_infol sB � � � �� �r� c s� |st |�}|st| ||�}tjjjdtjdd�}t| tj dg||d�}|s0t j � d|� d���t �d|t|d �dg ��d �d d � |d �dg �D ��� � fd d �|d �dg �D �}|slt j � d� � d|� d���t �d||d j� z |�|d jt�� � W nN tjjy� } zt �|� t j �d|j� ���d}~w tjjy� } z t �|� t j �|j��d}~w tj y� } z t �|� t j � |j��d}~ww t �d|� � dS )a� 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. rq Frr r� �r� r� rt z ' devices were not retrievedr� r r� c S r4 r r� r� r r r r� � r6 z)erase_disk_partitions.<locals>.<listcomp>c r� r r� r� r� r r r� � r� r� r� r r� ra Nz#[%s] Erased partitions on disk '%s') r� rj r r� r� r� r r� r� rv r r5 r r r, r� r� rc ry ZUpdateDiskPartitionsZHostDiskPartitionSpecr= rg r> rh ri rj r3 rk rl ) rM rw r� rw rm r� �resultsr� rK r r� r �erase_disk_partitions� sl �� ��� ��� �� � ��r� c sN t | �}�r t�d|� n t�d|� � � sg S z| jj}W nN tjjy; } zt�|� t j � d|j � ���d}~w tjj yT } z t�|� t j � |j��d}~w tjyl } z t�|� t j �|j��d}~ww |syt j �d|� d���|j}|s�t j �d|� d���|j}|s�g S � �fdd �|D �}t�d |d d � |D �� |S ) a� 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. z'Retrieving all disk groups on host '%s'zARetrieving disk groups from host '%s', with cache disk ids : (%s)ra Nz No host config found on host 'r z$No vsan storage info found on host 'c s g | ] }�s |j j� v r|�qS r ��ssdr� )r� Zdm��cache_disk_ids�get_all_disk_groupsr r r� & s � �z"get_diskgroups.<locals>.<listcomp>z<Retrieved disk groups on host '%s', with cache disk ids : %sc S s g | ]}|j j�qS r r� r� r r r r� . ri )r� r r, r� ZvsanHostConfigr r= rg r> r r5 rh ri rj r3 r rk rl r Z storageInfoZ diskMapping) rw r� r� rw Zvsan_host_configrK Zvsan_storage_infoZvsan_disk_mappingsZ disk_groupsr r� r �get_diskgroups� s` � �� � �� � � � �r� c C sp | j j|kstj�d�| j j|���dd� | jD �}t|�t|�kr0tj�d�t|�t|����t� d|� dS )zw Checks that the disks in a disk group are as expected and raises CheckError exceptions if the check fails z?Incorrect diskgroup cache disk; got id: '{}'; expected id: '{}'c S r4 r r� r� r r r r� > r6 z-_check_disks_in_diskgroup.<locals>.<listcomp>z;Incorrect capacity disks; got ids: '{}'; expected ids: '{}'z2Checked disks in diskgroup with cache disk id '%s'T) r� r� r r5 r r ZnonSsd�sortedr r, )Z disk_groupZ cache_disk_idZcapacity_disk_idsZ non_ssd_disksr r r �_check_disks_in_diskgroup3 s �� �� r� c C s� t | �}t| �}t�d|� |s?tjjjdtj dd�}t |tj dg| |d�}|r/|d � d�s7t�d|� d S |d d d S t |dg�}|sOt�d|� d S |d d S ) a� 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 z&Retrieving the host cache on host '%s'�'configManager.cacheConfigurationManagerFrr ZcacheConfigurationInfor� r zHost '%s' has no host cacheN)r� r| r r, r r� r� r� r r� r� Z HostCacheConfigurationManagerr� r� )rw �host_cache_managerrw rM r� r� r r r �get_host_cacheJ s6 �� � r� c C s2 t | �}|s t| dg�}|�d�stj�d|� d���|d }t�d||j|� t j ||d�}t�d|� z|� |�}W nN t j j yY } zt�|� tj�d|j� ���d}~w t j jyr } z t�|� tj�|j��d}~w tjy� } z t�|� tj�|j��d}~ww t||d � t�d |� d S ) aB 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 r� zHost 'z' has no host cachezIConfiguring the host cache on host '%s', datastore '%s', swap size=%s MiB)re ZswapSizezhost_cache_spec=%sra NZHostCacheConfigurationTaskz"Configured host cache on host '%s'T)r� r� r� r r5 r r r, rQ r ZHostCacheConfigurationSpecZConfigureHostCache_Taskr= rg r> rh ri rj r3 r rk rl r ) rw rn Z swap_size_MiBr� rw r� r� r rK r r r �configure_host_cachew sP � ��� �� � �� r� c C r? )z� Returns a list of hosts associated with a given service instance. service_instance The Service Instance Object from which to obtain hosts. )r* r r� r� r r r � list_hosts� rA r� c C s� dg}|sg }|rt | |�}nt| �}t| tj||d�}g }|D ]}|s*|d |v r1|�|d � q |s>tj�d� ||���|S )al 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 rQ r� r� zIThe resource pools with properties names={} get_all={} could not be found) rG r� r� r � ResourcePoolr� r r5 r r ) rM Zresource_pool_namesrF Zget_all_resource_poolsr� r� Zresource_poolsZselected_pools�poolr r r �get_resource_pools� s2 ����r� c C r? )z� Returns a list of resource pools associated with a given service instance. service_instance The Service Instance Object from which to obtain resource pools. )r* r r� r� r r r �list_resourcepools� rA r� c C r? )z� Returns a list of networks associated with a given service instance. service_instance The Service Instance Object from which to obtain networks. )r* r r( r� r r r � list_networks� rA r� c C r? )z� Returns a list of VMs associated with a given service instance. service_instance The Service Instance Object from which to obtain VMs. )r* r �VirtualMachiner� r r r �list_vms rA r� c C r? )z� Returns a list of folders associated with a given service instance. service_instance The Service Instance Object from which to obtain folders. )r* r r� r� r r r � list_folders rA r� c C r? )z� 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. )r* r r� r� r r r r� rA r� c C r? )z� Returns a list of vApps associated with a given service instance. service_instance The Service Instance Object from which to obtain vApps. )r* r Z VirtualAppr� r r r � list_vapps' rA r� c C s t | tjj�S )z� 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. )r* r r� r r� r r r �list_portgroups1 s r� rp r� c C s� d}t � � }t�d| | jj� z| j}W ng tjjy1 } zt� |� t j � d|j � ���d}~w tjjyJ } z t� |� t j �|j��d}~w tjjyc } z t� |� t j � |j��d}~w tjy{ } z t� |� t j �|j��d}~ww |jdks�|jdk�r-|| dkr�d�|||�} |dkr�t�| � nt�| � t �d t � � | d � |d 7 }z| j}W ni tjjy� } zt� |� t j � d|j � ���d}~w tjjy� } z t� |� t j �|j��d}~w tjj�y } z t� |� t j � |j��d}~w tj�y" } z t� |� t j �|j��d}~ww |jdks�|jdks�|jd k�rOd �|||�} |dk�rGt�| � |jS t�| � |jS z|j� tjj�yp } zt� |� t j � d|j � ���d}~w tjj�y� } z t� |� t j �|j��d}~w tjj�y� } z t� |� t j � |j��d}~w tjj�y� } z t� |� t j � |j��d}~w tjj �y� } z t� |� |j} |j �r�| � d |j d j � d�} t j � | ��d}~ww )a3 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. r ztask = %s, task_type = %sra NZrunningZqueuedz+[ {} ] Waiting for {} task to finish [{} s]r� g �?rp �successz3[ {} ] Successfully completed {} task in {} secondsz (�)) �timer r, r r� r� r r= rg r> r r5 rh ri Z FileNotFoundr\ r3 rj r rk rl �stater r� �sleep�resultr � SystemErrorZVMwareSystemErrorZInvalidArgumentZ faultMessager; ) r Z instance_nameZ task_typeZ sleep_secondsZ log_levelZ time_counterZ start_timeZ task_inforK r3 Z exc_messager r r r ; s� �� � � �� � �� � � ��� � � �� � � � ��r c s� |r |s t jj�| |�}|sg d�}t jjj| tj|||d�}� fdd�|D �}|s0t j�d��t |�dkr@t j� d� dg���|d S ) a� 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. )rQ zconfig.hardware.devicezsummary.storage.committedzsummary.storage.uncommittedzsummary.storage.unsharedz layoutEx.filezconfig.guestFullNamezconfig.guestIdz guest.netzconfig.hardware.memoryMBzconfig.hardware.numCPUzconfig.files.vmPathNamezsummary.runtime.powerStatezguest.toolsStatusr� c s g | ] }|d � kr|�qS rP r )r� r� rP r r r� � s z&get_vm_by_property.<locals>.<listcomp>z"The virtual machine was not found.rp � zSMultiple virtual machines were found with thesame name, please specify a container.r ) r r r[ rG r� r r� r5 r r� �VMwareMultipleObjectsErrorrc )rM rQ � datacenter� vm_propertiesr� r Zvm_listZ vm_formattedr rP r �get_vm_by_property� s0 �� ���r� c C s t �d� |r.t| |dgd�}tjjj|dgd�}d|v r#|d }|S tj�d� ddg���d |v rZtjj� | |d g|�}t |�d krTtj� d� d d � |d �g���|d }|S |r~tjj�| |�}tjjj|dgd�} d| v rx| d }|S tj�d��|S )z� 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) z Retrieving folder informationrQ )r� r� �r� r� zThe virtual machine parent�object is not definedZfolderrp �'Multiple instances are available of thezspecified folder {}r �vmFolderz.The datacenter vm folder object is not defined)r r, r� r r r[ r� r5 r rc Z get_foldersr� r� r rG ) rM r� � placementZ base_vm_name� vm_objectZvm_props� folder_objectZfolder_objects�datacenter_objectZdc_propsr r r � get_folder� sT �� � � � ��������r� c C s t �d� d\}}d|v r�t| ||d gd�}|s)tj�d�dd�|d �g���zt|d d gd �}|d }W nB t j j yz t j j j d d tjt j j j d d tjd�gd�}t| tj|d dg|d�}|rm|d d }n tj�d�|d ���Y nw |d }||fS d|v r�t| |d g|d�} t| �dkr�tj�d�dd�|d �g���| d }t|d gd �} d | v r�| d }||fS tj�d�ddg���d|v r�t| |�} t| |d �} t| d gd �} d | v r�| d }n tj�d�d dg���| }||fS tj�d�d g���) aP 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 z Retrieving placement information�NNr )rF r� r� zThe specified hostz{} cannot be found.r Z resourcePoolr� r� TFr� r� rQ r� r� z-The resource pool of host {} cannot be found.Z resourcepool)rF rp r� zspecified host {}.zThe resource pool's parentr� rK zThe cluster's resource poolzPlacement is not defined.)r r, r� r r5 r rc r r� r r� r� r� r� r r� rL r� r� r� r� r� rG rM )rM r� r� �resourcepool_objectZplacement_objectZ host_objectsZ host_propsr� Z resourcepoolsZresourcepool_objectsZ res_propsr� Zcluster_objectZ clus_propsr r r � get_placement( s� � ��� � ��� �����*� � ����� � � �� �r� c C sd | � � dkrt|d d �}n | � � dkr t|d �}n| � � dkr't|�}ntj�d��|dd�S )z� 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 Zgbr� ZmbZkbzThe unit is not specifiedZKB)�size�unit)�lower�intr r5 r )r� r� Z target_sizer r r � convert_to_kb� s r� �onc C s� |dkr[z| � � }d}W n� tjjy) } zt�|� tj�d|j � ���d}~w tjj yB } z t�|� tj�|j ��d}~w t j yZ } z t�|� tj�|j ��d}~ww |dkr�z| �� }d}W nT tjjy� } zt�|� tj�d|j � ���d}~w tjj y� } z t�|� tj�|j ��d}~w t j y� } z t�|� tj�|j ��d}~ww tj�d��z t|t| �|� W | S tjjy� } ztj�d�d d |� �g���d}~ww ) z� Powers on/off a virtual machine specified by its name. virtual_machine vim.VirtualMachine object to power on/off virtual machine action Operation option to power on/off the machine r� zpower onra NZoffz power offz!The given action is not supportedr� z An error occurred during powerz!operation, a file was not found: )ZPowerOnr r= rg r r> r r5 rh ri rj r3 r rk rl ZPowerOffr r r� r\ ZVMwarePowerOnErrorrc )Zvirtual_machine�actionr Z task_namerK r r r �power_cycle_vm� sh �� � �� �� � �� ������r� c C s� z|rt |tj�r|j|||d�}n|j||d�}W nN tjjy7 } zt�|� tj � d|j � ���d}~w tjj yP } z t�|� tj � |j ��d}~w tjyh } z t�|� tj �|j ��d}~ww t|| ddd�}|S )a� 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 )r� r )r� ra Nz CreateVM Task� r� )r< r r� Z CreateVM_Taskr= rg r r> r r5 rh ri rj r3 r rk rl r )�vm_name�vm_config_specr� r� � host_objectr rK r� r r r � create_vm� s0 �� �� � ��r� c C s z|r| j j||d||d�}n | j j||d|d�}W nN tjjy7 } zt�|� tj� d|j � ���d}~w tjj yP } z t�|� tj� |j ��d}~w t jyh } z t�|� tj�|j ��d}~ww z t||d�}W |S tjjy� } z tj�d�|���d}~ww )a$ 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 F)r rQ � asTemplater r� )r rQ r� r� ra NzRegisterVM TaskzYAn error occurred during registration operation, the configuration file was not found: {})r� ZRegisterVM_Taskr r= rg r r> r r5 rh ri rj r3 r rk rl r r\ ZVMwareVmRegisterErrorr )r� rQ Zvmx_pathr� r� r rK �vm_refr r r � register_vm sL ��� �� � ������r� c C s� t | �}t�d|� z| �|�}W nN tjjy. } zt�|� tj � d|j � ���d}~w tjj yG } z t�|� tj � |j ��d}~w tjy_ } z t�|� tj �|j ��d}~ww t||d�} | S )z� 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 zUpdating vm '%s'ra NzReconfigureVM Task)r� r r, ZReconfigVM_Taskr r= rg r> r r5 rh ri rj r3 r rk rl r )r� r� r� r rK r r r � update_vmA s* �� � �� r� c C s� t | �}t�d|� z| �� }W nN tjjy- } zt�|� tj � d|j � ���d}~w tjj yF } z t�|� tj � |j ��d}~w tjy^ } z t�|� tj �|j ��d}~ww t||d� dS )�o Destroys the virtual machine vm_ref Managed object reference of a virtual machine object �Destroying vm '%s'ra Nz Destroy Task)r� r r, r# r r= rg r> r r5 rh ri rj r3 r rk rl r )r� r� r rK r r r � delete_vm^ s( �� � ��r c C s� t | �}t�d|� z| �� W dS tjjy. } zt�|� tj � d|j � ���d}~w tjj yB } ztj � |j ��d}~w tjyU } ztj �|j ��d}~ww )r� r� ra N)r� r r, Z UnregisterVMr r= rg r> r r5 rh ri rj r3 r rk rl )r� r� rK r r r � unregister_vmw s" �����r )NNNN)NTN)T)NNNNr0 NNTr� )ry )NNNF)rQ N)NF)N)NNN)NNF)rp r� )r� )��__doc__rF r� �loggingr@ r� � http.clientr Zsalt.exceptionsr Zsalt.modules.cmdmodZsalt.utils.pathZsalt.utils.platformZsalt.utils.stringutilsZ pyVim.connectr r r r r ZpyVmomir r r r r� Z!com.vmware.vapi.std.errors_clientr Zvmware.vapi.vsphere.clientr ZHAS_VSPHERE_SDKr� r� r� � getLoggerr� r r r r/ rO rT r_ rn rx r| r~ r� r� r� r� r� r� r� r� r7 r� rU r� r� r� r� r� r� r� r� r r r r r r r r r" r$ r) r* r, r- r/ r2 r= r> r@ rE rG rH rM rP rR rS rU rW r_ rZ rp rj 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� r� r� r� r r r r r r �<module> sd J � � � �5 �0 � � %!#X � �. �=, . ' : 4 ( �\ �L ) < � H � B & �K � > 5 G4 � PD . �= �7 k � I <h 9 � .6
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings