cisco.nxos.nxos_vsan module – Configuration of vsan for Cisco NXOS MDS Switches.

Note

This module is part of the cisco.nxos collection (version 2.9.1).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install cisco.nxos.

To use it in a playbook, specify: cisco.nxos.nxos_vsan.

New in version 1.0.0: of cisco.nxos

Synopsis

  • Configuration of vsan for Cisco MDS NXOS.

Note

This module has a corresponding action plugin.

Parameters

Parameter

Comments

vsan

list / elements=dictionary

List of vsan details to be added or removed

id

integer / required

Vsan id

interface

list / elements=string

List of vsan’s interfaces to be added

name

string

Name of the vsan

remove

boolean

Removes the vsan if True

Choices:

  • no

  • yes

suspend

boolean

suspend the vsan if True

Choices:

  • no

  • yes

Notes

Note

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

Examples

- name: Test that vsan module works
  cisco.nxos.nxos_vsan:
    vsan:
    - id: 922
      interface:
      - fc1/1
      - fc1/2
      - port-channel 1
      name: vsan-SAN-A
      remove: false
      suspend: false
    - id: 923
      interface:
      - fc1/11
      - fc1/21
      - port-channel 2
      name: vsan-SAN-B
      remove: false
      suspend: true
    - id: 1923
      name: vsan-SAN-Old
      remove: true

Return Values

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

Key

Description

commands

list / elements=string

commands sent to the device

Returned: always

Sample: [“terminal dont-ask”, “vsan database”, “vsan 922 interface fc1/40”, “vsan 922 interface port-channel 155”, “no terminal dont-ask”]

Authors

  • Suhas Bharadwaj (@srbharadwaj)