Vh=eZddlZddlmcmcmZddlZddl Z ddl Z ddl Z ddl Z ddl Z ddlZddlZddlZddlmZddlmZddlmZmZddlmZdZ ddlZdZdZ ddl m!Z!dd l"m#Z#m$Z$m%Z%dZ&dd l'm(Z(m)Z)dd l*m+Z+m,Z,m-Z-m.Z.dd l/m0Z0dd l1m2Z2ddl3m4Z4Gdde5Z6dZ7dZ8dZ9d@dZ:dAdZ;dBdZdCdZ?dDdZ@dZAdZBdDdZCdZDdEdZEdDd ZFdDd!ZGd"ZHdFd#ZIdDd$ZJdDd%ZK dGd&ZLdCd'ZMd(ZNd)ZOd*ZPd+ZQd,ZRd-ZSd.ZTd/ZUd0ZVd1ZWd2ZX dHd3ZYdCd4ZZd5Z[d6Z\dId7Z]dAd8Z^dJd9Z_d:Z`d;ZadKd<ZbdDd=ZcGd>d?eZdy#e$rej<ZdZYwxYw#e$rej<ZdZ&YwxYw)LN) OrderedDict) StrictVersion) PyvmomiClientApiAccessError)randintTF)connect)vimvmodl VmomiSupport)to_text to_native) integer_types iteritems string_types raise_from)missing_required_lib)unquotebase_argument_specceZdZfdZxZS) TaskErrorc,tt| |i|yN)superr__init__)selfargskwargs __class__s p/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/community/vmware/plugins/module_utils/vmware.pyrzTaskError.__init__6s i'88)__name__ __module__ __qualname__r __classcell__rs@r rr5s 99r!rcJt|dr|jjryy)zxCheck whether locked a virtual machine. Args: vm: Virtual machine management object Returns: bool runtimeTF)hasattrr(question)vms r check_answer_question_statusr,:s r9"**"5"5 r!ci}|jjjD]t}i||j<|jjjj D]6}||jj |j|ji8vg} |D]@}|j|jjj||d|ddB |S#t$rtddd|ddwxYw)zMake the response contents to answer against locked a virtual machine. Args: vm: Virtual machine management object answers: Answer contents Returns: Dict with answer id and number Raises: TaskError on failure r*response)id response_numz not found z or z or both in the response list) r(r*messager/choice choiceInfoupdatelabelkeyappend Exceptionr)r+answers response_listr1r2 responsesanswers r make_answer_responser=HsM::&&..$& gjj!jj))00;; F '** % , , fjj.  Iv F   jj)),, -fZ.@ A&BT U    vVT^M_aghrastuuvs AC%%"Dc|D]} |j|d|dy#t$r}tdt|zd}~wwxYw)zAnswer against the question for unlocking a virtual machine. Args: vm: Virtual machine management object responses: Answer contents to unlock a virtual machine r/r0zanswer failed: %sN)AnswerVMr8rr )r+r;r.es r answer_questionrAgsV> > KK(@ A> >/'!*<= = >s" AAAcd}tj} t|rP|rt||}t||n5t dt |j jjztj|z |k\r t d|jjtjjjk(rd|jjfS|jjtjjj k(r|jj }d} |j"}t%|jj dr |jj j&} t+t || |jj |jjtjjj,tjjj.fvr9t1d|zt3dd d z z|} tj4| |dz }6#t($rYwxYw#t+t || |jj wxYw) a<Wait for given task using exponential back-off algorithm. Args: task: VMware task object max_backoff: Maximum amount of sleep time in seconds timeout: Timeout for the given task in seconds Returns: Tuple with True and result for successful task Raises: TaskError on failure rT%sTimeoutN thumbprinti)timer,r=rArr r(r*textinfostater TaskInfoStatesuccessresulterrormsgr)rEAttributeErrorrrunningqueuedminrsleep) task max_backofftimeoutr+r9failure_counter start_timer; error_msghost_thumbprint sleep_times r wait_for_taskr_usOJ  ' +0W= I.wrzz/B/B/G/G'H HII 99; #w .I& & 99??cll0088 8))) ) 99??cll0066 6 I"O S%MM 499??L9&*iioo&@&@O9Y@$))//R 99??s||11993<<;M;M;T;TU UQ/1GAt4Dt4KK[YJ JJz " q O3 $"  9Y@$))//Rs%?A I IIII,J ct}d}|dkDr;t||}|ds|dr|} |Stj|||z}|dkDr;|S)Nripv4ipv6)dictgather_vm_factsrHrV)contentr+rYfactsinterval_factss r wait_for_vm_iprjse FEH A+ "- &>VF^E  L 88 A+ Lr!c :|jj|xs |jd|}|jDcgc]:}|r4t t |j t t |k(s9|<}}|j|r|r|dSy|Scc}w)NT) recursivetyper) viewManagerCreateContainerView rootFolderviewr rnameDestroy)rfvimtyperrfirstfolder containerobjobj_lists r find_objrzs##778T'BTBT`dkr7sI(~~rTWWSXXEV=W[bcjkocp[q=qrHr  A;  Oss :B6Bcft|}|j}|D]}|j|k(s|cSyr)quote_obj_name portgrouprr) dv_switchportgroup_name portgroupspgs r find_dvspg_by_namers<#N3N$$J 77n $I r!ct|ts|g}|j}t||||}|D]} t |j |k(r|cS!y#t jj$rYBwxYwN)rvrecurse) isinstanceliststrip get_all_objsrrrr faultManagedObjectNotFound)rfrrobj_typervrobjectsrxs r find_object_by_namers h %: ::> *J   r!c<t||tjg|Sr)rr Datastore)rfdatastore_namers r find_datastore_by_namers w YYr!c:t||tjgSr)rr Folder)rf folder_names r find_folder_by_namer s w cjj\ BBr!cd|jd}|jdjd}t|dkDr |s|d}||dk(r|jdt ||}|syt|dkDr |s|d}||dk(r|jd|dvrt |d|j z}nyt|dkDr`|D]Y}d} |jD]B} | j|k(sd| jvstj| jvs>| } | }n| rYy S|} | S)z Find the folder by its given fully qualified path name. The Fully Qualified Path Name is I(datacenter)/I(folder type)/folder name/ for example - Lab/vm/someparent/myfolder is a vm folder in the Lab datacenter. /rN)r+host datastorenetworkz%sFolderr) rsplitlenpoprgetattrlower childEntityrr childTyper r) rfrr folder_typerv folder_partsr parent_objpart folder_objpart_objs r find_folder_by_fqpnrs_  s #F<<$**3/L <1*1oO l1o -   Q (/BJ  <1&q/K ,q/ )   Q <<Zk6G6G6I)IJ  <1  DJ&22 ==D(h(:L:L.LPSPZPZ^f^p^pPp!)J!)J      r!c>t||tjg|SNr)rr DistributedVirtualSwitch)rf switch_namervs r find_dvs_by_namer=s w c6R6R5S\b ccr!c|rt|dr |j}n |j}t||tj g|Sr)r)rrprr HostSystem)rfhostnamerrvs r find_hostsystem_by_namerAs<gj,7&&## w3>>2B6 RRr!c:t||tjgSrrr ResourcePool)rfresource_pool_names r find_resource_pool_by_namerIs w(:S=M=Mt||tjg|Srr)rfrclusters r find_resource_pool_by_clusterrMs w(:S=M=M[[((22 >>  . 0  r!cg}t|tjr|j|j|}t |dr`|j } |j}|dvrnBt|tjr|j|jt |dr`|jddj|zS#t$rd}YxwxYw)z7 make a /vm/foo/bar/baz like folder path for an object rN)zgroup-d1zha-folder-rootr) rr rr7rrr)r_moIdrRreversejoin)vobjpathsthisobjmoids r compile_folder_path_for_objectrs E$ # TYYG '8 $.. ==D 1 1  gszz * LL & '8 $ MMO %   D s C CCc^|}|D]} t||}|S#ttf$rYywxYw)z$Safely get a property or return NoneN)rrR IndexError)r+ attributesrO attributes r _get_vm_proprsG F  VY/F M +  s ,,ciddd|jjd|jjjd|jj j d|jj jd|jjd|jjjd |jjjd |jjjd gd gd gddddd|jjddd|jj|jjt!|dt!|dt#j$t#j&|jjj(t*j,dd|jjj.dd|jj0igdi|j2d|j2zid}|jjj4r |jjj4}|jjj|d<|j6r:t9|j6t:j<r|j6jnd|d<|jjjBr-|jjjBjD|d<|jF}|D]*}|d jI|jJj, |jjL}|jN}|rL|jPg|d <|jRD],}|jTD]} d| vs|d jI| .|jVD][}|d jItXjZj]tXjZj_|jP|]|jNj`D]>}|d jItXjZj]|jb|@|jNjdD]'}|jfD]} |d jI| )tjjm|||d<|jn} |jjpD]f} | jr} | D| jtr8| jtD])}|jr| jrk(s|j} n| jv|d| <h|jjxD]}|jv|d|jr< i}t!|d}|r9|D]4}|jzdkDst}|j~||j<6|j j~rKd|j j~vr|j j~|d <n|j j~|d!<d}|jjjD]s}t|d"s|jr|j}|jdd#}ndx}}t|d$rt|jd%rt|jjd&rat|jjd'rA|jjj}|jjj}nd}d}d(t|z}|j|jj||j|jd||jj||d)||<|d jId*t|z|d+z }vt|}d,|vr|d,|d,<|d-|d-<t||d.<t|jjd/r |jjjnd|jjr*|jjjjndd0|d1<|S#t:j>j@$rYwxYw#th$rYwxYw)2z. Gather facts from vim.VirtualMachine object. module_hwThw_namehw_power_statushw_guest_full_name hw_guest_idhw_product_uuidhw_processor_counthw_cores_per_sockethw_memtotal_mb hw_interfaces hw_datastoreshw_files hw_esxi_hostNhw_guest_ha_statehw_is_template hw_folder hw_version)guesttoolsRunningStatus)r toolsVersioncls sort_keys strip_dynamiczvim.VirtualMachine:%s)rguest_tools_statusguest_tools_versionguest_questionguest_consolidation_neededrbrc annotation customvalues snapshotscurrent_snapshotvncrvimrefadvanced_settings hw_clustervmsnr!r&)rnetr:rcrb macAddress-backingportportKey portgroupKeyhw_eth) addresstyper5 macaddress ipaddressesmacaddress_dashsummaryportgroup_portkey portgroup_keyethrGr"r#r$ tpmPresent) tpm_present provider_idtpm_info)Srrrr6r( powerStater guestFullNameguestIdrhardwarenumCPUnumCoresPerSocketmemoryMBtemplateversionrrjsonloadsdumpsr*r VmomiJSONEncoderconsolidationNeededr rrrrr rr NoPermissiondasVmProtection dasProtectedrr7rJfileslayout vmPathNamesnapshot snapshotFile configFileospathrdirnamelogFile logDirectorydiskdiskFiler8PyVmomi get_vm_pathcustomFieldsManager customValuer6fieldvalue extraConfigdeviceConfigIdr ipAddressr+devicer)replacer-r.r0r/str addressType deviceInfor5getlist_snapshotsget_vnc_extraconfigr:keyId providerIdr/)rfr+rgr datastoresdsrOrPitemsnaprZcfm value_objknfadvanced_settingnet_dictvmnetre ethernet_idxentrymac_addr mac_addr_dashport_group_keyport_keyfactnamesnapshot_factss r reres" T" 299>>"  2::--88"  bjj..<< "  rzz''// "  299>> "  bii0077"  ryy11CC"  ")),,55"  "  "  B"  "  T"  ")),,"  T!" " bii''#" $//*2/NO+B0IJ**TZZ 0B0B0K0KQ]QnQn:>d&TU&(jj&8&8&L&Lii** )BHH4C" EJ zz ::%%**D$(LL$7$7$<$L'006OF(11$7OG!*!3!3D!9OI(1(:(:4(@O$%$-$6$6t$Nq>Q%R!" M&*V!" Mr!ci}|jjD]9}dD]2}|jjd|zk(s$|j||<4;|S)N)enabledrr.passwordzremotedisplay.vnc.)rrbr6rra)r+rOopts optkeynames r rlrls] F %%0? 0Jxx~~#7*#DD%)ZZz" 00 Mr!ctSrrr!r vmware_argument_specrs  r!c r|sjd}|sjd}|sjd}|sjjd}| sjjd} |sjjdd}|sjd}fd } |s | d |s | d |s | d |rttds | d n|rPtjtj } tj | _d| _| jnRttdr@tjtj } tj| _d| _nd} d} t||}  r| j| d} |rzd|| fz}| j|| tjd&i| }tj|tjj!||}t#j$d|} n(| j||tj&d&i| } | d%|d|}| ||z |r$t=j>tj@| |r| | jCfS| jCS#t"j(j*$r1}d|d|d}| |d|d|j,|z Yd}~d}~wt"j(j.$r)}| d|d|d|d |j, Yd}~d}~wt0j2tj4f$r}| d!|d"|d| Yd}~+d}~wt6j(j8$r/}d#|d|d}| |d$|j,|z Yd}~ud}~wt:$r$}d%|d||z}| |d | Yd}~d}~wwxYw)'Nrusernamer proxy_host proxy_portr.ivalidate_certscBj|t|)NrQ) fail_jsonr)rQmodules r _raise_or_failz&connect_to_api.._raise_or_fails%       %S!!r!zHostname parameter is missing. Please specify this parameter in task or export environment variable like 'export VMWARE_HOST=ESXI_HOSTNAME'rzUsername parameter is missing. Please specify this parameter in task or export environment variable like 'export VMWARE_USER=ESXI_USERNAME'zPassword parameter is missing. Please specify this parameter in task or export environment variable like 'export VMWARE_PASSWORD=ESXI_PASSWORD' SSLContextzxpyVim does not support changing verification mode with python < 2.7.9. Either update python or use validate_certs=false.TF)rr.) sslContextz [proxy: %s:%d]) httpProxyHost httpProxyPortServiceInstance)userpwdz+Unable to log on to vCenter or ESXi API at r* z as z: zUser zG does not have required permission to log on to vCenter or ESXi API at z : z,Unable to connect to vCenter or ESXi API at z on TCP/z%Failed to get a response from server z as request is malformed: z9Unknown error while connecting to vCenter or ESXi API at r)"paramsrjr)sslrPROTOCOL_SSLv23 CERT_REQUIRED verify_modecheck_hostnameload_default_certs CERT_NONErdr4rSmartStubAdapterVimSessionOrientedStubmakeUserLoginMethodr r SmartConnectr InvalidLoginrQrLrequestsConnectionErrorSSLErrorr InvalidRequestr8atexitregister DisconnectRetrieveContent)rdisconnect_atexit return_sirrrr.rrrr ssl_contextservice_instance connect_args msg_suffix smart_stub session_stub invalid_loginrQ no_permissiongeneric_req_excinvalid_request generic_excs` r connect_to_apirs }}Z0H}}Z0H}}Z0H"MM--l;M"MM--l;M==$$VS1D#]]+;,C,CD E J{{00   sAA?>A?cTi}t|}|Dcgc]}|jdr|}}|D]}t||}t|rt |}|d||</t |t jjrt|||<bt |t jjrt|||<t |t jjjrt|||<t |t jjjjrt|||<t |t j rXt|j"t|j$t|j&t|j(d||<t+|dr)t|dzt|j,z||<t |t jj.rt1|t2r+g||<|D]}||j5t|!"t1|t6t8zt:t<fzr0t1|t8rt?|||<ft|||<vt1|t<r|||<t1|t@rDi|t|<|jCD]!\}}t|}t||||<#tE|||<|Scc}w)z*Serialize a clonespec or a relocation spec_N)dynamicProperty dynamicTyper5r6rrr*)#dir startswithrcallablermrr r+ ConfigSpecserialize_spec RelocateSpecre VirtualDiskVirtualDeviceSpec FileOperationr Descriptionrrr5r6r)rr ProfileSpec issubclassrr7rrfloatboolintrditemsrg) clonespecdataattrsxxoxtxekvs r rrs} D  NE 71Q\\#%6Q 7E 7 + Y " B<  "X :DG CFF-- .$R(DG CFF// 0$R(DG CFFMM55 6$R(DG CFFMM;;II JbkDG COO ,#1"2D2D#E-bnn='1)"**5 DG R bkC''"''*::DG CFF.. /  D !DG 3Q~b12 3 L=8E4=H I"m,b'Q!"+Q D !DG D !!D   /1AJ+A.Q  /"gDGW+Z K] 8s L%L%ct||}||jd|zt|||}||jd|z|jD]}|j|k(s||fcSd|fS)Nz&Unable to find datacenter with name %srrz#Unable to find cluster with name %s)rrrrrr)rrfrr host_namedcrrs r find_host_by_cluster_datacenterrNs / :B zEWX"7LRHGB\QR ! 99 != ! =r!c~t||}|dk(rd}|jddjddj}|dj}tdd} |s"|d vrd | d <d |z| d <t||| d<| S||k7rd} |dk(r|j } n|dk(r|j } n|dk(r#|dvr|j } nd | d <d|z| d <n|dk(r#|dvr|j} nd | d <d|z| d <n|dvr|dk(rp|jjdk(rL|dk(r1|j} |dkDr,| jt||n|j} d | d<n;d | d <d| d <n0|dk(rd| d<n%d | d <d|jz| d <n d | d <d|z| d <| rW t#| ||| j&j(d k(r)d | d <| j&j*j,| d <nd | d< t||| d<| S#t$r} d | d <t!| | d <Yd} ~ d} ~ wwxYw#t$$r} d | d <t!| | d <Yd} ~ d} ~ wwxYw#| j&j(d k(r)d | d <| j&j*j,| d <wd | d<wxYw)!zm Set the power status for a VM determined by the current and requested states. force is forceful present poweredonrrr,rF)changedfailed)r poweredoffTrz8Virtual Machine is in %s power state. Force is required!rQinstanceNr restarted)r poweringon resettingrz6Cannot restart virtual machine in the current state %s suspended)rrz6Cannot suspend virtual machine in the current state %s) shutdownguest rebootguestguestToolsRunningrrrz:VMware tools should be installed for guest shutdown/rebootz>Virtual machine %s must be in poweredon state for guest rebootz'Unsupported expected state provided: %s)r+r9rP)rerfrrdPowerOffPowerOnResetSuspendrr ShutdownGuestr4wait_for_poweroff RebootGuestrrr8r r_rrJrKrPrQ) rfr+rKforcerYr9rgexpected_state current_staterOrWr@s r set_vm_power_stater*]s  GR (E ]]3+33C<BBDN+,224M F ]*EExRUbbu ,Wb9z &0 '-{{};.zz|;. $ZZ88:D'+F8$$\_l$lF5M;. $??::>#3D-1y)+/x((du "l2(-F9%'+F8$$dgigngn$nF5M$(x IN Zu  -dr7; 99??g-'+F8$$(IIOO$7$7F5M(,F9%)"5F: M) '#F8 #AJF5M ' +#'x ' u  +99??g-'+F8$$(IIOO$7$7F5M(,F9%sDD&H!:I ! I*II I0I+&I3+I00I33A J<ct}d}|dkDrJ|jjjdk(r |St j |||z}|dkDrJd|d<d|d<|S)NrarrTrz'Timeout while waiting for VM power off.rQ)rdr(r>rrHrV)r+rYrOrhs r r%r%su VFH A+ :: & & (L 8  M 88 A+  xAu Mr!c` tj||y#ttf$rYywxYw)NTF)r vmodlTypes TypeError ValueError)ratype_ofs r is_integerr1s4(/ z "s --c<t|jdvryy)N)trueonyesfalseoffnoTFrgrras r is_booleanr;s 5zHH r!c<t|jdvryy)N)r3r4r5TFr9r:s r is_truthyr=s 5z22 r!cJi}|D]}|j||j<g}|jD]\}}|r-t|r"t j dt |}nzt|trt j d|}nQt|trt j d|}n(t|trt j d|}||vs |||k7s|jtjj|||S)Nrrrstring)r6ra)rar6rr;r r-r=rrrrgr7r option OptionValue)optionscurrent_optionstruthy_strings_as_boolcurrent_options_dictr@change_option_list option_key option_values r option_diffrIs!8+1<<VZZ(8$+MMO b L !j&>'226:9\;RSL  c *'2259,GL  e ,'227;LIL  c *'228<\JL 1 15I*5UYe5e  % %cjj&<&<S_&<&` a b r!c|sytdddd}|jD]}||vs|j|||}|S)zU Replace special characters in object name with urllib quote equivalent Nz%25z%2fz%5c)%r\)rkeysrf) object_name SPECIAL_CHARSr6s r r|r|se   !M !!#G + %--c=3EFKG r!c.eZdZfdZdZd&dZd'dZd&dZdZdZ e dZ d&d Z d&d Z d Zd&d Zd'd Zd(dZe dZdZd&dZd&dZdZd&dZd&dZdZd'dZd'dZd&dZd)dZd)dZdZdZ dZ!dZ"d Z#d!Z$d"Z%d&d#Z&d$Z'd%Z(xZ)S)*r\c ||_ts |jtdtt s |jtdt  t|!|jd|jd|jd|jd|jd|jd |jd  |j|_ d|_ g|_ |jjr&|jjj |_ yy#t$r%}|jt| Yd}~d}~wwxYw) Nr)rQ exceptionr\rrrr.rrr)rrrr.rhttp_proxy_hosthttp_proxy_portr)r HAS_REQUESTSrrREQUESTS_IMP_ERR HAS_PYVMOMIPYVMOMI_IMP_ERRrrrrrgcurrent_vm_objcustom_field_mgrrfr^r`)rraaers r rzPyVmomi.__init__ s+    !5j!A'7  9   !5i!@'6  8 + G fmmJ&?&,mmJ&?&,mmJ&?"(--"7,2MM:J,K-3]]<-H-3]]<-H  Jmm " " << + +$(LL$D$D$J$JD ! ,  +   S  * * +sA1D## E,E  Ec(d} |jjj}|dk(ry|dk(ryy#tjt j jf$r3}|jjd|jzYd}~hd}~wwxYw)z Check if given hostname is vCenter or ESXi host Returns: True if given connection is with vCenter server False if given connection is with ESXi server Nz+Failed to get status of vCenter server : %sr VirtualCenterT HostAgentF) rfaboutapiTyper RuntimeFaultr rVimFaultrrrQ)rapi_typeexcs r is_vcenterzPyVmomi.is_vcenter's _||))11H  &  $% ""CII$6$67 _ KK ! !&SVYV]V]&] ! ^ ^ _s 1-B)B  Bc |rT|jjj}t|tdj t t |k\S|jjd|zy)z Check that the vCenter server is at least a specific version number Args: version (tuple): a version tuple, for example (6, 7, 0) Returns: bool .z'The passed vCenter version: %s is None.rN) rfr_rFrrmaprgrr)rrF vc_versions r vcenter_version_at_leastz PyVmomi.vcenter_version_at_least9s] ++33J , chhs3PWGX>Y0ZZ Z "Kg"UVr!c |r0tjtjtj}|jd|j ||fd||fz}|j |j |jdj}|jddk7r|jjdtj}d|_tj|_|j#||j%d } |j'n- tj(||f} tj, } | rZt/t1j2| j5} d j7d t9| ddd | ddd DS|jjd|y#t*$r"|jjd |YwxYw)NrGzCONNECT %s:%d HTTP/1.0 i 200zFailed to connect to the proxyrF)server_hostnameTzCannot connect to host: r*c3,K|] \}}||zywrr).0abs r z/PyVmomi.get_cert_fingerprint..^sMdaAEMsrFz3Unable to obtain certificate fingerprint for host: )socketAF_INET SOCK_STREAM settimeoutrsendencoderecvdecoderrrrcreate_default_contextrrr wrap_socket getpeercertcloseget_server_certificater8PEM_cert_to_DER_certrghashlibsha1 hexdigestrzip) rfqdnr.rrsockcommandbufctx der_cert_binpemr?s r get_cert_fingerprintzPyVmomi.get_cert_fingerprintEs ==1C1CDD OOA  LL 7$EG IIgnn& '))D/((*Cyy{1~& %%*J%K,,.C!&C !mmCO??4?FRRSWXL JJL M00$>33C8L l3==?@F88Mc&1+vadd|.LMM M KK ! !([\`[a&b ! c M %%,DTF*K%L Ms5G(HHcl|jj}|dg}|jjj||gd}tj j jdddtjj}tj j j|d|}tj j j|d|g}tj j j|g|gd }|jjj|gS) a Look up a Managed Object Reference in vCenter / ESXi Environment :param vim_type: Type of vim object e.g, for datacenter - vim.Datacenter :param properties: List of properties related to vim object e.g. Name :return: local content object rrTtraversal_specrqF)rrrVskiprm)rmallpathSet)rxr selectSet) objectSetpropSetreportMissingObjectsInResults)rfrprnror queryPropertyCollector TraversalSpecr rq ContainerView PropertySpec ObjectSpec FilterSpecpropertyCollectorRetrieveContents) rvim_type properties root_foldermorr property_spec object_spec filter_specs r get_managed_objects_propertiesz&PyVmomi.get_managed_objects_propertiesbs ll--   Jll&&::; TXY66DD!'' E  55BBC kk33>>%&? kk33>>"m"O*/? ||-->> }MMr!cd}d}|jjdxsd}d|jvrb|jdrS|s't|j|jdd}n|rt|j|jdd}nd|jvrI|jdr9|j t j dg}g}|D]i}t|jd k(st|jd j|jdk(sO|j|jkt|d kDr>|jd |jd -|jjd |jdzd|jd }|jd }t|j|jd } t!| } | j#ds| dz } |dvr-|jjd|jdzn|j%dr | ||}n|}|D]=} |j'|j| } | j%| |s6|| vs;| }nn|r|j'|j|d } |jjd |d }n~|jd | vrm|d }ngd|jvrY|jdrJt)j*d|jd|j,j.} t1|d|r||_|S#t2j4j6$rd}Y,wxYw)z Find unique virtual machine either by UUID, MoID or Name. Returns: virtual machine object if found, else None. Nuse_instance_uuidFrrrrrrrrrGrrvrzMultiple virtual machines with same name [%s] found, try to specify folder and / or datacenter to ensure uniqueness of the virtual machinezIPlease see documentation of the vmware_guest module for folder parameter.)rQdetails)rr)Nrrztvmware_guest found multiple virtual machines with same name [%s], please specify folder path other than blank or '/'rz/vm/)rfrrr)rrjrrfrr rrrrvalr7rxrrrrendswithrr]r templateOfr_stubrr rrrY) rvm_objuser_desired_pathrrvmstemp_vm_object user_folderuser_defined_dcdatacenter_objdcpathr+actual_vm_folder_paths r get_vmzPyVmomi.get_vmse   KKOO,?@IE T[[ T[[%8$&t||4;;v;N[ab"&t||-1[[-@2ACt{{ "t{{6':993CUCUcibj9kGC") 3../14 6 6q 9 = =>$++fBUUJJ~112  33x!|;;x(0DKK 4M4UKK))/CEI[[QWEX/Y3B*C#kk(3 "&++l";!8t{{S_G`!a7^Ls+cMF/1KK))/359[[5H/I)J!++F34:O[(Y%)4%B,0,<,\,,-=>t{{6?RTXT[T[TaTabF ' "(D  ;;44  s MN?Nc.t|j|S)z Gather facts of virtual machine. Args: vm: Name of virtual machine. Returns: Facts dictionary of the given virtual machine. )rerf)rr+s r gather_factszPyVmomi.gather_factsst||R00r!c2d}|j}|rw|j}|j}|X|jL||jk7r=|jdz|z} |j}||j||jk7r=d|z}|S#t$rYwxYw)z Find the path of virtual machine. Args: content: VMware content object vm_name: virtual machine managed object Returns: Folder of virtual machine if exists, else None Nr)rrrrpr8)rfrrrvfps r r]zPyVmomi.get_vm_paths   ++KB.RWW%8R7CUCU=U ggmk9 B.RWW%8R7CUCU=U  +K!s B BBczd}|s|Sd|vr]tjj|}tjj|}t |j |d|}|r|S|St |j |d}|r|S|j tjdg}g}|D]X}t|jd k7r|jD].}|j|k(s|j|jXZt|d kDr!|jjd |z |S|r|d }|S) a Find the virtual machine or virtual machine template using name used for cloning purpose. Args: template_name: Name of virtual machine or virtual machine template Returns: virtual machine or virtual machine template object Nrr)rrvrrrrrrGzAMultiple virtual machines or templates with same name [%s] found.rr)rUrVrWbasenamerrfrr rrrrr7rxrr) r template_name template_obj vm_obj_path vm_obj_namer templatesrtemp_vm_object_propertys r get_vm_or_templatezPyVmomi.get_vm_or_templatesO   - ''//-8K''**=9K({O_hstL##.+)]W]^L##993CUCUcibj9kGI") ~--.!3/=/E/E+.22mC!((););< 9~! %%*mp}*}%~(| r!c2t|j||S)z Find Cluster by name in given datacenter Args: cluster_name: Name of cluster name to find datacenter_name: (optional) Name of datacenter Returns: True if found r)rrf)rrrs r rzPyVmomi.find_cluster_by_nameEs$DLL,?[[r!cX|j|}|rt|jSgS)z Get all hosts from cluster by cluster name Args: cluster_name: Name of cluster Returns: List of hosts r)rrr)rr cluster_objs r get_all_hosts_by_clusterz PyVmomi.get_all_hosts_by_clusterQs0//\/J  (() )Ir!c2t|j||S)z Find Host by name Args: host_name: Name of ESXi host datacenter: (optional) Datacenter of ESXi resides Returns: True if found )rr)rrf)rrrs r rzPyVmomi.find_hostsystem_by_nameas't||iT^__r!c4g}|jsTt|jtjgj }|r|j t|d|S|rM|j|}|rt|j}|S|jjdd|z|S|r`t|tr|g}|D]H}|j|}|r|j |)|jjdd|zJ|S)z Get all host system managed object Args: cluster_name: Name of Cluster esxi_host_name: Name of ESXi server Returns: A list of all host system managed objects, else empty list rrFzCluster '%s' not found)rrQrzESXi '%s' not found)rerrfr rrMr7rrrrrrrgr)rresxi_host_name host_obj_listhostsrr esxi_host_objs r get_all_host_objszPyVmomi.get_all_host_objsms!   /?@EEGE$$T%[^4&#"77\7R $()9)9$:MKK))%=UXd=d)e nc2&4%5N*_D$($@$@4$@$PM$%,,]; --eAVY]A]-^ _r!c |r!|jjj}n1|r|j|}n|jj dr`|r^|jj jj}t|tdjtt|k\S|jj d|d|d|dy ) a5 Check that the ESXi Host is at least a specific version number Args: vm_obj: virtual machine object, required one of vm_obj, host_name host_name (string): ESXi host name version (tuple): a version tuple, for example (6, 7, 0) Returns: bool rz,VM object or ESXi host name must be set one.rrgz%Unable to get the ESXi host from vm: z, or hostname z,or the passed ESXi version: z is None.N) r6r(rrrrrproductrFrrrhrg)rrFrr host_system host_versions r host_version_at_leastzPyVmomi.host_version_at_leasts  ..0055K 666KK KK ! !&T ! U 7&..55==EEL .-SRYIZ@[2\\ \ KK ! !SY[dfm'o ! pr!c|jjjD]}|jj|k(s|cSy)z Find Portgroup on given host Args: host: Host config object portgroup_name: Name of portgroup Returns: True if found else False Frrs r rz#PyVmomi.find_host_portgroup_by_names@,,66 !I~~""n4   !r!cvg}|jjjD]}|j||S)z Get all Port Group by host Args: host_system: Name of Host System Returns: List of Port Group Spec )rrr}r7)rrpgs_listrs r get_all_port_groups_by_hostz#PyVmomi.get_all_port_groups_by_hosts;$$,,66 B OOB  r!cg}|s|S|jtjdg}|D]X}t|jdk7r|jD].}|j |k(s|j |jXZ|S)z Get network specified by name Args: network_name: Name of network Returns: List of network managed objects rrrrG)rr rrrrr7rx)rrnetworksrrrs r rzPyVmomi.find_network_by_namesO55s{{X^W_5`% N>))*a/+9+A+A '*..,>OON$6$67  r!cBd}|s|S|j|rd}|Sd}|S)z Check if network with a specified name exists or not Args: network_name: Name of network Returns: True if network exists else False F)rT)r)rrrets r network_exists_by_namezPyVmomi.network_exists_by_names9J//\/Jd QV r!c0t|j|S)z Get datacenter managed object by name Args: datacenter_name: Name of datacenter Returns: datacenter managed object if found else None )r)rrf)rrs r rzPyVmomi.find_datacenter_by_names't||_UUr!ch|r/|jjdk7s|jjsyy)z Check if datastore selected is valid or not Args: datastore_obj: datastore managed object Returns: True if datastore is valid, False if not normalFT)r6maintenanceMode accessible)r datastore_objs r is_datastore_validzPyVmomi.is_datastore_valids0##33x?''22r!c2t|j||S)a Get datastore managed object by name Args: datastore_name: Name of datastore datacenter_name: Name of datacenter where the datastore resides. This is needed because Datastores can be shared across Datacenters, so we need to specify the datacenter to assure we get the correct Managed Object Reference Returns: datastore managed object if found else None )rr)rrf)rrrs r rzPyVmomi.find_datastore_by_names&dll>crssr!c0t|j|S)z Get vm folder managed object by name Args: folder_name: Name of the vm folder Returns: vm folder managed object if found else None )r)rrf)rrs r rzPyVmomi.find_folder_by_names#4<<[IIr!c4t|j|||S)a Get a unique folder managed object by specifying its Fully Qualified Path Name as datacenter/folder_type/sub1/sub2 Args: folder_name: Fully Qualified Path Name folder name datacenter_name: Name of the datacenter, taken from Fully Qualified Path Name if not defined folder_type: Type of folder, vm, host, datastore or network, taken from Fully Qualified Path Name if not defined Returns: folder managed object if found, else None )rrr)rrf)rrrrs r rzPyVmomi.find_folder_by_fqpns%#4<<[ZixCD Dr!c|rt|dr |j}|s|jj}t |jt j g|}|D]}|j|k(s|cSy)aQ Get datastore cluster managed object by name Args: datastore_cluster_name: Name of datastore cluster datacenter: Managed object of the datacenter folder: Managed object of the folder which holds datastore Returns: Datastore cluster managed object if found else None datastoreFolderrN)r)rrfrprr StoragePodrr)rdatastore_cluster_namerrvdata_store_clustersdscs r find_datastore_cluster_by_namez&PyVmomi.find_datastore_cluster_by_name.so '*.?@//F\\,,F*4<<#..9IRXY& Cxx11  r!c|y|jjjj}|rtj j }||_tj j}||_ d|_ |jjj|}|jdjd}|j j"Sd}d}|j&D]b} t)| tj*s| j,j.|kDs8|j1| sK| }| j,j.}d|r |j"Sy#t$$rYwxYw)z Return Storage DRS recommended datastore from datastore cluster Args: datastore_cluster_obj: datastore cluster managed object Returns: Name of recommended datastore from the given datastore cluster Ncreate) storageSpecr)r)podStorageDrsEntrystorageDrsConfig podConfigrr storageDrsPodSelectionSpec storagePodStoragePlacementSpecpodSelectionSpecrmrfstorageResourceManagerRecommendDatastoresrecommendationsaction destinationrrr8rrrr6 freeSpacer) rdatastore_cluster_obj sdrs_status pod_sel_spec storage_specrec rec_actionrdatastore_freespacerps r get_recommended_datastorez!PyVmomi.get_recommended_datastoreDsJ ! (+>>OOYYaa >>::>>>@L,8L ) (L  ll99MMZfMg 003::1= !--222 '33 ;B"cmm,1E1EH[1[..R.@ &(jj&:&:# ; >> !  sAE E*)E*c|s|jj}t|jtjg|}|D]}|j |k(s|cSy)z Get resource pool managed object by name Args: resource_pool_name: Name of resource pool Returns: Resource pool managed object if found else None rN)rfrprr rrr)rrrvresource_poolsrps r rz"PyVmomi.find_resource_pool_by_nameosW\\,,F%dllS5E5E4FvV  Bww,,  r!cd}|s|S|dk7r5|jj}|r|D]}|j|k(s|}|S|S|j}|S)z Get resource pool managed object by cluster object Args: resource_pool_name: Name of resource pool cluster: Managed object of cluster Returns: Resource pool managed object if found else None N Resources) resourcePoolrr)rrr desired_rpr rs r rz%PyVmomi.find_resource_pool_by_clustersu    ,$11>>N(Bww"44%' !--Jr!c  tjd|tjjd}tjd|jd}tj j |}tj j|}||||fS#ttf$r5}|jjd|dt|Yd}~yd}~wwxYw)a Takes a string in the format [datastore_name] path/to/vm_name.vmdk Returns a tuple with multiple strings: 1. datastore_name: The name of the datastore (without brackets) 2. vmdk_fullpath: The "path/to/vm_name.vmdk" portion 3. vmdk_filename: The "vm_name.vmdk" portion of the string (os.path.basename equivalent) 4. vmdk_folder: The "path/to/" portion of the string (os.path.dirname equivalent) z ^\[(.*?)\]rz \[.*?\] (.*)$z Bad path 'z ' for filename disk vmdk image: rN) rematchDOTALLgroupsrUrVrrWrrRrrr )r vmdk_pathr vmdk_fullpath vmdk_filename vmdk_folderr@s r vmdk_disk_path_splitzPyVmomi.vmdk_disk_path_splits tXXmY JQQSTUVNHH%5yAHHJ1MMGG,,];M''//-8K!=-L LN+ t KK ! !Zcenopeq&r ! s s tsB B##C'2+C""C'cb|j}|j}d|zdz}||jjd|ztj j jjdddd}tj j j||gd} |j|| } d } |d z|z} t| \} } | s|jjd | z|d z|zd z|d z|zg}| jjD]7}t!|dD]&}|j"|k(s|j$|vs"|ccS9|jjd| zy#t$r/}|jjt|Yd}~d}~wwxYw)aF Return vSphere file object or fail_json Args: datastore_obj: Managed object of datastore vmdk_fullpath: Path of VMDK file e.g., path/to/vm/vmdk_filename.vmdk vmdk_filename: Name of vmdk e.g., VM0001_1.vmdk vmdk_folder: Base dir of VMDK e.g, path/to/vm []Nz)Unable to access browser for datastore %srT) fileOwnerfileSizefileType modification)r matchPatternsearchCaseInsensitive) datastorePath searchSpecFrz*No valid disk vmdk image found for path %srfilez*No vmdk file found for path specified [%s])browserrrrrr rDatastoreBrowserFileInfoDetails SearchSpecSearchSubFoldersr_rr rJrOrrV folderPath)rrrrrr)rdatastore_name_sq detail_query search_spec search_resrrrOtask_etarget_folder_paths file_resultrvs r find_vmdk_filezPyVmomi.find_vmdk_files ''&++.036 ? KK ! !&QTb&b ! cxx0099AA B hh//:: '"&; --+". %+m;  9+J7OGV KK ! !&RU^&^ ! _  #k 1C 7  #k 1  &??11 K[&1 66]*{/E/EI\/\H   "NQZ"Z[! 9 KK ! !i&7 ! 8 8 9sE66 F.?%F))F.c|jrn|jjj|D]E}|jjj ||}|j j |k(sC|cSy|jjj|D]E}|jjj||}|j j |k(sC|cSy)z Get first-class disk managed object by name Args: disk_name: Name of the first-class disk datastore_obj: Managed object of datastore Returns: First-class disk managed object if found else None N) rerfvStorageObjectManagerListVStorageObjectRetrieveVStorageObjectrrrHostListVStorageObjectHostRetrieveVStorageObject)r disk_namerr/rZs r find_first_class_disk_by_namez%PyVmomi.find_first_class_disk_by_names ?? ll88KKMZ ||99PPQSUbc;;##y0K  ll88OOP]^ ||99TTUWYfg;;##y0K r!cg}|jr`|jjj|D]7}|j |jjj ||9n_|jjj |D]7}|j |jjj||9|gk(ry|S)z Get first-class disks managed object Args: datastore_obj: Managed object of datastore Returns: First-class disks managed object if found else None N)rerfr9r:r7r;r<r=)rrdisksr/s r find_first_class_diskszPyVmomi.find_first_class_diskss ?? ll88KKMZ k T\\??VVWY[hij kll88OOP]^ o T\\??ZZ[]_lmn o B;Lr!ct|D]J\}}t|tjr&|j |j |i|||<F|||<L|S)a Deep merges u into d. Credit: https://bit.ly/2EDOs1B (stackoverflow question 3232943) License: cc-by-sa 3.0 (https://creativecommons.org/licenses/by-sa/3.0/) Changes: using collections_compat for compatibility Args: - d (dict): dict to merge into - u (dict): dict to merge into d Returns: dict, with u merged into d )rrcollections_compatMapping _deepmergerj)rdur r s r rFzPyVmomi._deepmergesZ$aL DAq!/778quuQ|Q7!!   r!cBt}d|vr ||||<|S|jdd\}}t|trIg}t t |D])}|j |j||||+|||<|S|j|||||<|S)z This is used to break down dotted properties for extraction. Args: - data (dict): result of _jsonify on a property - remainder: the remainder of the dotted property to select Return: dict rgrG)rdrrrrangerr7_extract)rr remainderrOr6temp_dsis r rKzPyVmomi._extract7s i  $YF9 M"a0Y dD !G3t9% Gt}}T!WS\9EF G!F3K --S 9=F3K r!cvtjtj|tjddS)z Convert an object from pyVmomi into JSON. Args: - obj (object): vim object Return: dict Tr)rGrHrIr rJ)rrxs r _jsonifyzPyVmomi._jsonifyPs2zz$**Sl.K.K/34IJ Jr!c Dt}|r|D]} d|vr`|jdd\}}t}|j|jt |||||<|j ||nS|jt ||||<|}|j dk(rd}n|j dk(rd}||||<|S|j|}|S#ttf$r/|jjdj|YwxYw) a| Convert a vSphere (pyVmomi) Object into JSON. This is a deep transformation. The list of properties is optional - if not provided then all properties are deeply converted. The resulting JSON is sorted to improve human readability. Args: - obj (object): vim object - properties (list, optional): list of properties following the property collector specification, for example: ["config.hardware.memoryMB", "name", "overallStatus"] default is a complete object dump, which can be large Return: dict rgrG_moidr_vimrefr%zProperty '{0}' not found.r) rdrrKrPrrFrrRKeyErrorrrformat) rrxrrOpropr6rLtmp prop_names r to_jsonzPyVmomi.to_json]s#" " XXd{)-C);Y"f#'==wsC?P1QS\#]C4'+}}WS$5G'Ht $( ::<72(.I!ZZ\Y6(0I,24Ly) X( ]]3'F '1XKK)).I.P.PQU.V)WXsB7C!!:DDcd|jz}t|dri|jr]|j|jjk(r |S|j}d|jz|z}t|dr |jr]|S)Nrr)rrr)rrfrp)rcur full_paths r get_folder_pathzPyVmomi.get_folder_pathsw#((N c8$zzT\\444**Cchh2I c8$ r!ctj|||jj} t |d|S#t j j$rd}Y|SwxYw)aG Get Managed Object based on an object type and moid. If you'd like to search for a virtual machine, recommended you use get_vm method. Args: - object_type: Managed Object type It is possible to specify types the following. ["Datacenter", "ClusterComputeResource", "ResourcePool", "Folder", "HostSystem", "VirtualMachine", "DistributedVirtualSwitch", "DistributedVirtualPortgroup", "Datastore"] - moid: moid of Managed Object :return: Managed Object if it exists else None rrN)r rrrrr rr)r object_typerrxs r find_obj_by_moidzPyVmomi.find_obj_by_moids`3l%%k24G  C  {{00 C  s AA#"A#rNN)NNNrN)*r"r#r$rrerjrrrr staticmethodr]rrrrrrrrrrrrrrrrr rrrr7r?rBrFrKrPrYr]r`r%r&s@r r\r\ sK4$ Wd:-N`_B 12*Z \  `"Hp.   0  V  t J D ,(V$8t,5\n0822 J'Rr!r\)@iNN)i,)TN)NTrrarb)rNNNF) TFNNNNNNN)rN)r)T)erm __metaclass__r/ansible.module_utils.common._collections_compat module_utilscommon_collections_compatrDrGrUrrsrrrH tracebackr collectionsr#ansible.module_utils.compat.versionrIansible_collections.community.vmware.plugins.module_utils.clients._vmwarerrrandomrrVrrU ImportError format_excrXpyVimrpyVmomir r r rWansible.module_utils._textr r ansible.module_utils.sixrrrransible.module_utils.basicr+ansible.module_utils.six.moves.urllib.parserHansible_collections.community.vmware.plugins.module_utils._argument_specrr8rr,r=rAr_rjrzrrrrrrrrrrrrrrrrrrrrrerrrrrkrlrrrrrr*r%r1r;r=rIr|r\rr!r rxs LL  #=sL 00K :WW;?g9 9 > >'!T   ""cK ZC,^dSP`V[DH9>$Ng!,]@<&$ LP59d.N 2j [|  ,*WmWW+y++-L*i**,OKs$E E, E)(E),FF