cisco.nxos.nxos_devicealias (7.0.0) — module

Install collection

Install with ansible-galaxy collection install cisco.nxos:==7.0.0

Add to requirements.yml

  collections:
    - name: cisco.nxos
      version: 7.0.0

Description

Configuration of device alias for Cisco MDS NXOS.

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- 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

Inputs

    
da:
    description:
    - List of device-alias to be added or removed
    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:
        default: false
        description:
        - Removes the device-alias if set to True
        type: bool
    type: list

mode:
    choices:
    - basic
    - enhanced
    description:
    - Mode of devices-alias, basic or enhanced
    type: str

rename:
    description:
    - List of device-alias to be renamed
    elements: dict
    suboptions:
      new_name:
        description:
        - New name of the device-alias
        required: true
        type: str
      old_name:
        description:
        - Old name of the device-alias that needs to be renamed
        required: true
        type: str
    type: list

distribute:
    description:
    - Enable/Disable device-alias distribution
    type: bool

Outputs

commands:
  description: commands sent to the device
  returned: always
  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
  type: list