VhPddlmZmZmZeZdZdZdZ ddl m Z m Z ddl mZddlmZddlmZdd lmZGd d eZd Zed k(reyy#e $rY;wxYw))absolute_importdivisionprint_functiona --- module: vmware_vswitch short_description: Manage a VMware Standard Switch to an ESXi host. description: - This module can be used to add, remove and update a VMware Standard Switch to an ESXi host. author: - Joseph Callen (@jcpowermac) - Russell Teague (@mtnbikenc) - Abhijeet Kasurde (@Akasurde) options: switch: description: - vSwitch name to add. required: true aliases: [ switch_name ] type: str nics: description: - A list of vmnic names or vmnic name to attach to vSwitch. aliases: [ nic_name ] default: [] type: list elements: str number_of_ports: description: - Number of port to configure on vSwitch. default: 128 type: int mtu: description: - MTU to configure on vSwitch. default: 1500 type: int state: description: - Add or remove the switch. default: present choices: [ absent, present ] type: str esxi_hostname: description: - Manage the vSwitch using this ESXi host system. aliases: [ 'host' ] type: str security: description: - Network policy specifies layer 2 security settings for a portgroup such as promiscuous mode, where guest adapter listens to all the packets, MAC address changes and forged transmits. - Dict which configures the different security values for portgroup. suboptions: promiscuous_mode: type: bool description: Indicates whether promiscuous mode is allowed. forged_transmits: type: bool description: Indicates whether forged transmits are allowed. mac_changes: type: bool description: Indicates whether mac changes are allowed. required: false aliases: [ 'security_policy', 'network_policy' ] type: dict teaming: description: - Dictionary which configures the different teaming values for portgroup. suboptions: load_balancing: type: str description: - Network adapter teaming policy. choices: [ loadbalance_ip, loadbalance_srcmac, loadbalance_srcid, failover_explicit ] aliases: [ 'load_balance_policy' ] network_failure_detection: type: str description: Network failure detection. choices: [ link_status_only, beacon_probing ] notify_switches: type: bool description: Indicate whether or not to notify the physical switch if a link fails. failback: type: bool description: Indicate whether or not to use a failback when restoring links. active_adapters: type: list description: - List of active adapters used for load balancing. - All vmnics are used as active adapters if O(teaming.active_adapters) and O(teaming.standby_adapters) are not defined. elements: str standby_adapters: type: list description: - List of standby adapters used for failover. - All vmnics are used as active adapters if O(teaming.active_adapters) and O(teaming.standby_adapters) are not defined. elements: str required: false aliases: [ 'teaming_policy' ] type: dict traffic_shaping: description: - Dictionary which configures traffic shaping for the switch. suboptions: enabled: type: bool description: Status of Traffic Shaping Policy. average_bandwidth: type: int description: Average bandwidth (kbit/s). peak_bandwidth: type: int description: Peak bandwidth (kbit/s). burst_size: type: int description: Burst size (KB). required: false type: dict extends_documentation_fragment: - community.vmware.vmware.documentation a - name: Add a VMware vSwitch community.vmware.vmware_vswitch: hostname: '{{ esxi_hostname }}' username: '{{ esxi_username }}' password: '{{ esxi_password }}' switch: vswitch_name nics: vmnic_name mtu: 9000 delegate_to: localhost - name: Add a VMware vSwitch without any physical NIC attached community.vmware.vmware_vswitch: hostname: '{{ esxi_hostname }}' username: '{{ esxi_username }}' password: '{{ esxi_password }}' switch: vswitch_0001 mtu: 9000 delegate_to: localhost - name: Add a VMware vSwitch with multiple NICs community.vmware.vmware_vswitch: hostname: '{{ esxi_hostname }}' username: '{{ esxi_username }}' password: '{{ esxi_password }}' switch: vmware_vswitch_0004 nics: - vmnic1 - vmnic2 mtu: 9000 delegate_to: localhost - name: Add a VMware vSwitch to a specific host system community.vmware.vmware_vswitch: hostname: '{{ esxi_hostname }}' username: '{{ esxi_username }}' password: '{{ esxi_password }}' esxi_hostname: DC0_H0 switch_name: vswitch_001 nic_name: vmnic0 mtu: 9000 delegate_to: localhost - name: Add a VMware vSwitch to a specific host system with Promiscuous Mode Enabled community.vmware.vmware_vswitch: hostname: '{{ esxi_hostname }}' username: '{{ esxi_username }}' password: '{{ esxi_password }}' esxi_hostname: DC0_H0 switch_name: vswitch_001 nic_name: vmnic0 mtu: 9000 security: promiscuous_mode: true delegate_to: localhost - name: Add a VMware vSwitch to a specific host system with active/standby teaming community.vmware.vmware_vswitch: hostname: '{{ esxi_hostname }}' username: '{{ esxi_username }}' password: '{{ esxi_password }}' esxi_hostname: DC0_H0 switch_name: vswitch_001 nic_name: - vmnic0 - vmnic1 teaming: active_adapters: - vmnic0 standby_adapters: - vmnic1 delegate_to: localhost - name: Add a VMware vSwitch to a specific host system with traffic shaping community.vmware.vmware_vswitch: hostname: '{{ esxi_hostname }}' username: '{{ esxi_username }}' password: '{{ esxi_password }}' esxi_hostname: DC0_H0 switch_name: vswitch_001 nic_name: - vmnic0 - vmnic1 traffic_shaping: enabled: true average_bandwidth: 100000 peak_bandwidth: 100000 burst_size: 102400 delegate_to: localhost - name: Delete a VMware vSwitch in a specific host system community.vmware.vmware_vswitch: hostname: '{{ esxi_hostname }}' username: '{{ esxi_username }}' password: '{{ esxi_password }}' esxi_hostname: DC0_H0 switch_name: vswitch_001 state: absent delegate_to: localhost z result: description: information about performed operation returned: always type: str sample: "vSwitch 'vSwitch_1002' is created successfully" )vimvmodl) AnsibleModule)PyVmomi)base_argument_spec) to_nativecdeZdZfdZdZdZdZdZdZdZ e dZ d Z d Z d ZxZS) VMwareHostVirtualSwitchc tt| |d|_d|_|j d|_|j d|_|j d|_|j d|_ |j d|_ |j d}|j|}|r |d|_n|jjd |jjj|_|j s|jjd |j j#dd k(r|j j$j&Dcgc]}|j(}}t+|_|j j$j.D]~}g}|j&D](}|j1d dd}|j3|*t+||j|j4j6|j,|j8<|jD]} | |vr7|jjd| d|jj8d |j,D]J} | |j,| dvs| |j k7s(|jjd| d| d Lyycc}w)Nswitchnumber_of_portsnicsmtustate esxi_hostname)esxi_host_namerzCFailed to get details of ESXi server. Please specify esxi_hostname.msgz/Failed to find network manager for ESXi system.present-)pnicr num_portszSpecified Physical NIC 'z!' does not exists on given ESXi 'z'.rz' is already used by vSwitch ')superr __init__ host_systemvssparamsrrrrrget_all_host_objsmodule fail_json configManager networkSystem network_mgrget networkInfordevicedictavailable_vswitchesvswitchsplitappendspecnumPortsname) selfr$rhostsravailable_pnicavailable_vswitch used_pnicm_pnic desired_pnicr. __class__s s/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/community/vmware/plugins/modules/vmware_vswitch.pyrz VMwareHostVirtualSwitch.__init__s %t5f=mmH- %}}->?MM&) ==']]7+  o6 &&m&D $QxD  KK ! !'G ! H ++99GG KK ! !&W ! X ;;??7 #y 06:6F6F6R6R6W6WXddkkXNX'+vD $%)%5%5%A%A%I%I J! -22-D!ZZQ/3F$$V,-DHYL]LaLaRcRhRhRqRqDJ(():)?)?@ J!% a ~5KK))O[OSO_O_OdOd/f)g $77aG#t'?'?'H'PPU\`d`k`kUk --IUW^3`-aa a 1XsK cT|j|jd|j|jdd} ||j|j y#t j$r9}|jjt|jYd}~yd}~wt j$r9}|jjt|jYd}~yd}~wt$r/}|jjt|Yd}~yd}~wwxYw)z2 Manage internal state of vSwitch )rabsent)r>rrN)state_destroy_vswitchstate_exit_unchangedstate_update_vswitchstate_create_vswitchrcheck_vswitch_configurationr RuntimeFaultr$r%r r MethodFault Exception)r4vswitch_states runtime_fault method_faultes r< process_statez%VMwareHostVirtualSwitch.process_state1s  5533  4433   4 JN4:: &t'G'G'I J L!! D KK ! !i 0A0A&B ! C C   C KK ! !i 0@0@&A ! B B 4 KK ! !il ! 3 3 4s/%AD'./B""D'8/C,, D'8%D""D'c tdd}tjjj }|j |_|j|_|jr9tjjj|j|_ |jjrd|jz|d<n |jj|j|d}|j!|j"|jj$}|j'||rd}|j)||rd}|j+||rd}|r'|jj-|j|d |jz|d <d|d<|jjDdi|y #tj.j0$r2}d |jd t3|j4|d <Yd }~ld }~wtj.j6$rI}|jj9d|jdt3|j4Yd }~d }~wtj.j:$rJ}|jj9d|jdt3|j4Yd }~5d }~wt<j.j>$rJ}|jj9d|jdt3|j4Yd }~d }~wt<j.j@$rJ} |jj9d|jdt3| j4Yd } ~ d } ~ wtB$r@} |jj9d|jdt3| Yd } ~ Fd } ~ wwxYw)z Create a virtual switch Source from https://github.com/rreubenur/pyvmomi-community-samples/blob/patch-1/samples/create_vswitch.py Fchangedresult nicDevicezvSwitch '%s' would be createdr vswitchNamer1Tz$vSwitch '%s' is created successfullyrPzvSwitch with name z already exists: NzFailed to add vSwitch '?' as physical network adapter being bridged is already in use: r$' due to host configuration fault : ', this can be due to either of following : 1. vSwitch Name exceeds the maximum allowed length, 2. Number of ports specified falls out of valid range, 3. Network policy is invalid, 4. Beacon configuration is invalid : ' due to : ' due to generic exception : rO)#r,rhost VirtualSwitch Specificationrr2rr BondBridgebridger$ check_moderr(AddVirtualSwitchfind_vswitch_by_namer r1update_security_policyupdate_teaming_policyupdate_traffic_shaping_policyUpdateVirtualSwitchfault AlreadyExistsr r ResourceInUser%HostConfigFaultrInvalidArgument SystemErrorrF exit_json) r4resultsvss_specrOr1already_exists resource_usedhost_config_faultinvalid_argument system_error generic_excs r<rBz,VMwareHostVirtualSwitch.state_create_vswitchIs?uR088))779 00xx 99!hh44??$))?THO ;; ! !B9D%KT[[$X!6"  ((999** pQUQ\Q\QZ[i[m[mQn%p!99** s %%TXT_T_T]^k^o^oTp+r%ss99,, l %%IMIRSdShShIi+k%ll;;.. z %%Y]XcXcXabrbvbvXw +y%zz ;;** t %%VZVaVaV_`l`p`pVq+s%tt ` %%GK{{GPQ\G]+_%`` `sUCF99O"(H O"#?I'' O"?K  O",?L11 O"?N O""5OO"c<|jjdy)z0 Declare exit without unchanged F)rON)r$rmr4s r<r@z,VMwareHostVirtualSwitch.state_exit_unchangeds e,c Jtdd}|jjrd|jjz|d<n` |j j jj|jjd|jjz|d<d|d<|jj&di|y #tjj$r2}d|jd t|j|d<Yd }~ld }~wtjj$rI}|jj!d |jd t|j Yd }~d }~wtjj"$rJ}|jj!d |jdt|j Yd }~5d }~wt$$r@}|jj!d |jdt| Yd }~|d }~wwxYw)z4 Remove vSwitch from configuration FrMrNzvSwitch '%s' would be removedrz"vSwitch '%s' removed successfully.rPz vSwitch 'z' not available. NzFailed to remove vSwitch 'z:' as vSwitch is used by several virtual network adapters: rrVrYTrOrZ)r,r$r`r!r3r r&r'RemoveVirtualSwitchrrgNotFoundrr rrir%rjrFrm)r4rnvswitch_not_foundvswitch_in_userrrus r<r?z-VMwareHostVirtualSwitch.state_destroy_vswitchs uR0 ;; ! !z>VMwareHostVirtualSwitch.state_update_vswitch..s#q)9!)<rxrQNteamingzvSwitch '%s' would be updatedrrSz$vSwitch '%s' is updated successfullyrPzFailed to update vSwitch 'rUrz$Failed to update vSwitch with name 'z' as it does not exists: rVrWrXzB' as network adapter teaming policy is set but is not supported : rYrOrZ)*r,rr!r1rr2rsetmaprrrr[r\r^r_r"policy nicTeamingnicOrder activeNic standbyNicrcrdrer$r`r(rfrgrir%r rr{rjrrkrl NotSupportedrFrm)r4rOrnr1 nics_currentrirq not_foundrrrsrt not_supportedrus r<rAz,VMwareHostVirtualSwitch.state_update_vswitchs u-H4;;-VWxx}} 88<<488 #xxDHG ==D00 0 00DMG3 )yy!hh44??$))?T " G;;y);;11::%%X5G5G)Z1PTPYPY>!)ZZ5=5G5G)Z1PTPYPY>!)ZH&&&h6I6I*\QRVR[R[^1*\\6>6I6I*\QRVR[R[^1*\H'tyy>L0&&#dii.<*GG&  & &tW 5G  % %dG 4G  - -dG <G {{%%!@4;;!N"d$$88T[[>B9D(NQUQ\Q\(\GH%B"&GI  ((}*[)Z*\*\2yy..wKK))X\XcXcXabobsbsXt/v)wwyy))iKK))NRkkNWXaXeXeNf/h)iiyy00pKK))MQ[[MVWhWlWlMm/o)pp{{22~KK))]a\g\g\efvfzfz\{ /})~~ {{..{KK))]a]h]h]fgsgwgw]x/z){{{{//tKK))UYU`U`U^_l_p_pUq/s)tt!dKK))KO;;KTU`Ka/c)ddds0L%L%L*/L*L/(L/?L4L4 9L99W?N W:?O>> W?Q## W?S W(?T-- W ?V W5WWct|j|j|j|_|jyy)zj Check if vSwitch exists Returns: 'present' if vSwitch exists or 'absent' if not r>r)rbr rr!rws r<rCz3VMwareHostVirtualSwitch.check_vswitch_configurations2 ,,T-=-=t{{K 88 rxc|jjjjD]}|j|k(s|cSy)z Find and return vSwitch managed object Args: host: Host system managed object vswitch_name: Name of vSwitch to find Returns: vSwitch managed object if found, else None N)r&r'r*r.r3)r[ vswitch_namer!s r<rbz,VMwareHostVirtualSwitch.find_vswitch_by_name&sA%%33??GG Cxx<'  rxcD|jdr|jjsy|jj}d}|jdjd}|jdjd}|jdjd}|+||d<|j|ur|j|d<||_d}|+||d <|j |ur|j |d <||_d}|+||d <|j |ur|j |d <||_d}|S) z Update the security policy according to the parameters Args: spec: The vSwitch spec results: The results dict Returns: True if changes have been made, else false securityFpromiscuous_modeforged_transmits mac_changessec_promiscuous_modesec_promiscuous_mode_previousTsec_mac_changessec_mac_changes_previoussec_forged_transmitssec_forged_transmits_previous)r"rrr)allowPromiscuous macChangesforgedTransmits)r4r1rnsecurity_policyrOrrrs r<rcz.VMwareHostVirtualSwitch.update_security_policy6s@{{:&dkk.B.B++..#{{:6::;MN#{{:6::;MN++j155mD  +.BG* +//7KK;J;[;[783G0  &)8G% &))@6E6P6P23-<*  +.BG* +..6JJ;J;Z;Z782F/rxc|jdr|jjsy|jj}d}|jdjd}|jdjd}|jdjd}|jdjd}|jdjd} |jdjd} |,||d<|j|k7r|j|d <||_d }|+||d<|j|ur|j|d <||_d }|&||d<|j } | |k7r| |d <| |_d }| J| |d <|j j| k7r,|j j|d<| |j _d }| J| |d<|j j| k7r,|j j|d<| |j _d }|q||d<|dk(r2|jjd urd|d<d|j_ d }|S|dk(r0|jjdurd|d<d |j_ d }|S)z Update the teaming policy according to the parameters Args: spec: The vSwitch spec results: The results dict Returns: True if changes have been made, else false rFload_balancingnetwork_failure_detectionnotify_switchesfailbackactive_adaptersstandby_adaptersload_balancing_previousTnotify_switches_previousfailback_previousfailover_activefailover_active_previousfailover_standbyfailover_standby_previousfailure_detectionlink_status_onlybeacon_probingfailure_detection_previous) r"rrr)notifySwitches rollingOrderrrrfailureCriteria checkBeacon) r4r1rnteaming_policyrOteaming_load_balancingteaming_failure_detectionteaming_notify_switchesteaming_failbackteaming_failover_order_activeteaming_failover_order_standbycurrent_failbacks r<rdz-VMwareHostVirtualSwitch.update_teaming_policy_s{{9%T[[-C-C//!%Y!7!;!;$>?Z$[!"&++i"8"<"<=N"O;;y155jA(, I(>(B(BCT(U%)-Y)?)C)CDV)W& " -(>G$ %$$(>>5C5J5J12(>% # .)@G% &,,4KK6D6S6S230G-  '"2GJ #1#>#>> #33/?+,2B.B+ ) 4)FG% &&&004QQ6D6M6M6W6W234Q''1 ) 5*HG& '&&115SS7E7N7N7Y7Y345S''2 % 0+DG' ((,>>!11==E"G +.>>!11==F"Grxcr|jdr|jjsy|jj}d}|jdj d}|s|j r d|_d}|SdD]@}|jdj |r"|j jd|zB|jdj dd z}|jdj d d z}|jdj d d z} |j s d|_d}|j|k7r||d <|j|d<||_d}|j|k7r||d<|j|d<||_ d}|j| k7r| |d<|j|d<| |_ d}|S)z Update the traffic shaping policy according to the parameters Args: spec: The vSwitch spec results: The results dict Returns: True if changes have been made, else false traffic_shapingFenabledT)average_bandwidthpeak_bandwidth burst_sizezItraffic_shaping.%s is a required parameter if traffic_shaping is enabled.rrirritraffic_shaping_avg_bandw"traffic_shaping_avg_bandw_previoustraffic_shaping_peak_bandw#traffic_shaping_peak_bandw_previoustraffic_shaping_bursttraffic_shaping_burst_previous) r"rr shapingPolicyr)rr$r%averageBandwidth peakBandwidth burstSize) r4r1rn ts_policyrO ts_enabledvaluets_average_bandwidthts_peak_bandwidth ts_burst_sizes r<rez5VMwareHostVirtualSwitch.update_traffic_shaping_policys{{,-T[[5K5KKK-- [[!2377 B   $) !NJ E;;0155e< %%*ux}*}%~  ${{+<=AABUVY]] KK(9:>>?OPSWW $56::<H4O   $I G  % %)= =3GG/ 0)rrchoicesr[)rrr,bool)r)rrrrnetwork_policy)roptionsr)loadbalance_iploadbalance_srcmacloadbalance_srcidfailover_explicitload_balance_policy)rrrrr)rr)rr)rrrrrrr)rrrr)rr) rrrrrrrrr) argument_specsupports_check_mode)r updater,rr rK)rr$host_virtual_switchs r<mainrsv&(M G v |R% P%5 eT *y8Y:OPx8!%6!2!%6!2 f- '(89 # 33 +//1AB+!%& 16* $&5 A!%6E!B%(&&- 0&)"&E"2#/U+  Q11f/35F2&9%%'rx__main__N) __future__rrrr __metaclass__ DOCUMENTATIONEXAMPLESRETURNpyVmomirr ImportErroransible.module_utils.basicr@ansible_collections.community.vmware.plugins.module_utils.vmwarer Hansible_collections.community.vmware.plugins.module_utils._argument_specr ansible.module_utils._textr r rrrZrxr<rsA@ x tc J  "5Tg0_g_D9(x zFO  sAAA