VhpJddlmZmZmZdZdZdZddlZddlm Z ddl m Z m Z e ZdZGd d eZGd d eZd ZdZddZdZdZedk(reyy))absolute_importdivisionprint_functionav module: nxos_devicealias short_description: Configuration of device alias for Cisco NXOS MDS Switches. description: - Configuration of device alias for Cisco MDS NXOS. version_added: 1.0.0 author: - Suhas Bharadwaj (@srbharadwaj) (subharad@cisco.com) notes: - Tested against Cisco MDS NX-OS 8.4(1) options: distribute: description: - Enable/Disable device-alias distribution type: bool mode: description: - Mode of devices-alias, basic or enhanced choices: - basic - enhanced type: str da: description: - List of device-alias to be added or removed type: list elements: dict suboptions: name: description: - Name of the device-alias to be added or removed required: true type: str pwwn: description: - pwwn to which the name needs to be associated with type: str remove: description: - Removes the device-alias if set to True type: bool default: false rename: description: - List of device-alias to be renamed type: list elements: dict suboptions: old_name: description: - Old name of the device-alias that needs to be renamed required: true type: str new_name: description: - New name of the device-alias required: true type: str a - name: Test that device alias module works cisco.nxos.nxos_devicealias: da: - name: test1_add pwwn: 56:2:22:11:22:88:11:67 - name: test2_add pwwn: 65:22:22:11:22:22:11:d - name: dev1 remove: true - name: dev2 remove: true distribute: true mode: enhanced rename: - new_name: bcd old_name: abc - new_name: bcd1 old_name: abc1 aF commands: description: commands sent to the device returned: always type: list sample: - terminal dont-ask - device-alias database - device-alias name somename pwwn 10:00:00:00:89:a1:01:03 - device-alias name somename1 pwwn 10:00:00:00:89:a1:02:03 - device-alias commit - no terminal dont-ask N) AnsibleModule) load_config run_commands)-_$^c4eZdZdZdZdZdZdZdZdZ y) showDeviceAliasStatusz#docstring for showDeviceAliasStatusc\||_d|_d|_d|_|j y)NF)module distributemodelockedupdateselfrs o/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/cisco/nxos/plugins/modules/nxos_devicealias.py__init__zshowDeviceAliasStatus.__init__zs'    c8t||jd}|SNrexecute_show_commandrrcmdoutputs rexecute_show_cmdz&showDeviceAliasStatus.execute_show_cmd%c4;;7: rcRd}|j|jd}|D]}d|vr5|jddjj|_d|vr5|jddjj|_d|vszd |_y) Nzshow device-alias status zFabric Distribution:ModezMode:LockedT)r"splitstriplowerrrr)rcommandr!os rrzshowDeviceAliasStatus.updates,&&w/55d; #A$)"#''#,q/"7"7"9"?"?"A{GGG,Q/557==? 1}"  #rc|jSN)rrs risLockedzshowDeviceAliasStatus.isLockeds {{rc|jSr0)rr1s r getDistributez#showDeviceAliasStatus.getDistributes rc|jSr0)rr1s rgetModezshowDeviceAliasStatus.getModes yyrN) __name__ __module__ __qualname____doc__rr"rr2r4r6rrrrws#- #rrc@eZdZdZdZdZdZdZdZdZ dZ d Z y ) showDeviceAliasDatabasez%docstring for showDeviceAliasDatabasec@||_i|_|jyr0)rda_dictrrs rrz showDeviceAliasDatabase.__init__s   rc8t||jd}|Srrrs rr"z(showDeviceAliasDatabase.execute_show_cmdr#rcd}|j|}|jd|_|jD]:}d|vs|jj}|d|j|d<<y)Nzshow device-alias databaser%z device-alias)r"r*da_listr+r?)rr-r!eachlinesvs rrzshowDeviceAliasDatabase.updatesm.&&w/||D)   ,H)^^%++-&(e RU# ,rc:||jjvSr0r?keysrnames risNameInDaDatabasez*showDeviceAliasDatabase.isNameInDaDatabasest||((***rc dj|jdDcgc] }t|dk(rdt|zn|"c}}||jj vScc}wNr&r'0)joinr*lenstrr?values)rpwwnepnewpwwns risPwwnInDaDatabasez*showDeviceAliasDatabase.isPwwnInDaDatabases]((=AZZ_ Mrc"glS3r7] 2 M $,,--/// Ns%A'c dj|jdDcgc] }t|dk(rdt|zn|"c}}||jj vr||j|k(ryycc}w)Nr&r'rOTF)rPr*rQrRr?rI)rrKrTrUrVs risNamePwwnPresentInDatabasez3showDeviceAliasDatabase.isNamePwwnPresentInDatabasesq((=AZZ_ Mrc"glS3r7] 2 M  4<<$$& &$,,t,, Ns%A;cZ||jjvr|j|Syr0rHrJs r getPwwnByNamez%showDeviceAliasDatabase.getPwwnByNames) 4<<$$& &<<% %rc dj|jdDcgc] }t|dk(rdt|zn|"c}}|jj D]\}}||k(s |cSycc}wrN)rPr*rQrRr?items)rrTrUrVnps r getNameByPwwnz%showDeviceAliasDatabase.getNameByPwwnsv((=AZZ_ Mrc"glS3r7] 2 M LL&&( DAqG|  Ns%A7N) r7r8r9r:rr"rrLrWrYr[r`r;rrr=r=s-/ ,+0  rr=c|jd}t|dk7ry|D]4}t|dkDst|dkrytd|Dr4yy)Nr&FrCr'c3@K|]}|tjvywr0)string hexdigits).0cs r zisPwwnValid..s@Q1(((@sT)r*rQall)rT pwwnsplit eachpwwnsplits r isPwwnValidrls_ 3I 9~" }  !S%7!%;@-@@  rc|djsyt|dkDry|D]}|jr|tvsyy)NrF@T)isalpharQisalnumVALID_DA_CHARS)rK characters r isNameValidrssK 7??  4y2~   "y'F rc.d}||dg}t||}|S)Ntext)r-r!)r)r-r command_typer!commandsouts rrrs% F#v67H vx (C Jrc~g}|D]5}t|tr|j|%|j|7|Sr0) isinstancelistextendappend) command_listsflat_command_listr-s r flatten_listrsE . gt $  $ $W -  $ $W - . rc ttddtdtdd}ttddtdd }ttdtdd d g td d|td d|}t|d}t}t}t}ddi}|jd}|jd} |jd} |jd} | | D]} | d} | d}| d}||j }|r'|!|j dt | zdzt| sW|j dt | zdzdzd jtDcgc]}d!j|c}zt|r|j d"t |zd#z| | D]} | d$}| d%}t|sW|j dt |zdzdzd jtDcgc]}d!j|c}zt|r{|j dt |zdzdzd jtDcgc]}d!j|c}zt|}|j}|j}|jr|j d&g}|u|r:|d'k(r#|j!d(|j!d)nK|j!d*n9|d+k(r#|j!d,|j!d-n|j!d.t#|}|r#||z}|j$rnd|d<t'||g}| x| d k(r:|d k(r#|j!d/|j!d0nK|j!d1n9|d k(r#|j!d2|j!d3n|j!d4|r@|r|j!d5d6g|zd7gz}n"| |d+k(r|j!d5d6g|zd7gz}t#|}|r#||z}|j$rnd|d<t'||g}t)|}| Ag}g}| D]C} | d} | d}| d}||j }|rL|j+| r&|j!d8| z|j!| ^|j!| d9zs|j-| |r|j!| d:z|zd;z|j+| r+|j | dz|j3|zd=z|j!d?| zd@z|z|j!| Ft5|dAk7st5|dAk7rFdBg|z}|r|j!d5d6g|zd7gz}n"| |d+k(r|j!d5d6g|zd7gz}t#|}|r||z}|j$rnsd|d<t'||t5|dAk7r#|j!dCdDj|zt5|dAk7r#|j!dEdDj|zg}| | D]}} | d$}| d%}|j+|r|j d||dFz|zdGzH|j+|r|j!dI|zdJz|zg|j d||dKzHt5|dAk7rFdBg|z}|r|j!d5d6g|zd7gz}n"| |d+k(r|j!d5d6g|zd7gz}t#|}|r#||z}|j$rnd|d<t'|||j$r|j7d|dLH||dM<||dN<||dO<|j6dPi|ycc}wcc}wcc}w)QNTrR)requiredtype)rboolF)rdefault)rKrTremove)old_namenew_nameenhancedbasic)rchoicesr{dict)relementsoptions)rrdarename) argument_specsupports_check_modechangedrrrrrKrTrzThis device alias name zS which needs to be added, does not have pwwn specified. Please specify a valid pwwn)msgzThis pwwn name is invalid : z<. Note that name cannot be more than 64 alphanumeric chars, zDit must start with a letter, and can only contain these characters: z, z'{0}'zThis pwwn is invalid : z$. Please check that its a valid pwwnrrzCdevice-alias has acquired lock on the switch. Hence cannot procced.disabledzdevice-alias distributez8device-alias distribute changed from disabled to enabledzOdevice-alias distribute remains unchanged. current distribution mode is enabledenabledzno device-alias distributez8device-alias distribute changed from enabled to disabledzPdevice-alias distribute remains unchanged. current distribution mode is disabledzno device-alias mode enhancedz0device-alias mode changed from enhanced to basicz:device-alias mode remains unchanged. current mode is basiczdevice-alias mode enhancedz0device-alias mode changed from basic to enhancedz=device-alias mode remains unchanged. current mode is enhancedzdevice-alias commitzterminal dont-askzno terminal dont-askzno device-alias name zZ - This device alias name is not in switch device-alias database, hence cannot be removed.z : ze - This device alias name,pwwn is already in switch device-alias database, hence nothing to configurezk - This device alias name is already present in switch device-alias database but assigned to another pwwn (z) hence cannot be addedzk - This device alias pwwn is already present in switch device-alias database but assigned to another name (zdevice-alias name z pwwn rzdevice-alias databasez(the required device-alias were removed. ,z&the required device-alias were added. zU - this name is already present in the device-alias database, hence we cannot rename z with this one)rrwrzdevice-alias rename  zQ - this name is not present in the device-alias database, hence we cannot rename.z'Check Mode: No cmds issued to the hostsmessagesrwwarningsr;)rrr{paramsr, fail_jsonrRrsrPrqformatrlrr4r6r2r}r check_moderr=rLrYr[rWr`rQ exit_json) element_specelement_spec_renamerrrrcommands_to_executeresultrrrreachdictrKrTrrgoldnamenewname shDAStausObjdmrwcmdsshDADatabaseObjda_remove_list da_add_lists rmainrs  4e , u /L t%0t%0 V$ uz7&; < Vfl C&:MN MD QFvHvH& F|,J == D t B ]]8 $F ~ HF#DF#Dh'Fzz|<$$5d)$op% #4($$:d)$XYaa))$O1W^^A%6$OP Q%#4($$5d)$@A%- 6 Hz*Gz*Gw'  6'l#TU]]iiN Kq!2 KL M!w'  6'l#TU]]iiN Kq!2 KL M! *)0L""$AAU  H J 9:Ne I~ <=Nf  !D 1D8     $F9   %H  7?J ?@ RSP G| <= RSS  OO1 2+,x7;Q:RRH!a9n 56/08;?U>VV  !D 1D8     $F9   %H-f5O ~ * 1HF#DF#Dh'Fzz|"55d;OO$;d$BC"))$/OOvw #>>tTJOO BB'99$?(( $L!L-;;DA!B8!8));;DA(( $L!L-;;DA!B8!8)!(VV%!y.OO$9: 34x?CYBZZHH% "5"<   $(y!FD)~&!+OOBSXXnE]]{#q(OO@388KCXX H  Hz*Gz*G11':  !!mn''!11': 6 @3 F PQ  !!ij! , x=A /08;H 56/08;?U>VV%!y.OO$9: 34x?CYBZZHH% "5"<   $(y!FD)(9  "F:,F:!F:FvA%P$!L!Ls`4'`9 `>__main__)cli_show) __future__rrr DOCUMENTATIONEXAMPLESRETURNrdansible.module_utils.basicrEansible_collections.cisco.nxos.plugins.module_utils.network.nxos.nxosrrr __metaclass__rqobjectrr=rlrsrrrr7r;rrrs A@: x * 4  % F F5f5p  up  zFr