cisco.nxos.nxos_devicealias_module.rst

cisco.nxos.nxos_devicealias

Configuration of device alias for Cisco NXOS MDS Switches.

Version added: 1.0.0

Synopsis

• Configuration of device alias for Cisco MDS NXOS.

Parameters

Parameter		Choices/Defaults	Comments
da list / elements=dictionary			List of device-alias to be added or removed
	name string / required		Name of the device-alias to be added or removed
	pwwn string		pwwn to which the name needs to be associated with
	remove boolean	Choices: no ← yes	Removes the device-alias if set to True
distribute boolean		Choices: no yes	Enable/Disable device-alias distribution
mode string		Choices: basic enhanced	Mode of devices-alias, basic or enhanced
rename list / elements=dictionary			List of device-alias to be renamed
	new_name string / required		New name of the device-alias
	old_name string / required		Old name of the device-alias that needs to be renamed

Notes

Note

- Tested against Cisco MDS NX-OS 8.4(1)

Examples

- 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

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key	Returned	Description
commands list	always	commands sent to the device 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']

Status

Authors

• Suhas Bharadwaj (@srbharadwaj) (subharad@cisco.com)