cisco.nxos.nxos_zone_zoneset module – Configuration of zone/zoneset for Cisco NXOS MDS Switches.
Note
This module is part of the cisco.nxos collection (version 5.3.0).
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_zone_zoneset
.
New in cisco.nxos 1.0.0
Synopsis
Configuration of zone/zoneset for Cisco MDS NXOS.
Note
This module has a corresponding action plugin.
Aliases: zone_zoneset
Parameters
Parameter |
Comments |
---|---|
List of zone/zoneset details to be added or removed |
|
default zone behaviour for the vsan Choices:
|
|
mode of the zone for the vsan Choices:
|
|
Removes the vsan if True Choices:
|
|
vsan id |
|
List of zone options for that vsan |
|
Members of the zone that needs to be removed or added |
|
devtype of the zone member used along with Smart zoning config Choices:
|
|
pwwn member of the zone, use alias ‘device_alias’ as option for device_alias member |
|
Removes member from the zone if True Choices:
|
|
name of the zone |
|
Deletes the zone if True Choices:
|
|
List of zoneset options for the vsan |
|
activates/de-activates the zoneset Choices:
|
|
Members of the zoneset that needs to be removed or added |
|
name of the zone that needs to be added to the zoneset or removed from the zoneset |
|
Removes zone member from the zoneset Choices:
|
|
name of the zoneset |
|
Removes zoneset if True Choices:
|
Notes
Note
Tested against Cisco MDS NX-OS 8.4(1)
Examples
- name: Test that zone/zoneset module works
cisco.nxos.nxos_zone_zoneset:
zone_zoneset_details:
- mode: enhanced
vsan: 22
zone:
- members:
- pwwn: 11:11:11:11:11:11:11:11
- device_alias: test123
- pwwn: 61:61:62:62:12:12:12:12
remove: true
name: zoneA
- members:
- pwwn: 10:11:11:11:11:11:11:11
- pwwn: 62:62:62:62:21:21:21:21
name: zoneB
- name: zoneC
remove: true
zoneset:
- action: activate
members:
- name: zoneA
- name: zoneB
- name: zoneC
remove: true
name: zsetname1
- action: deactivate
name: zsetTestExtra
remove: true
- mode: basic
smart_zoning: true
vsan: 21
zone:
- members:
- devtype: both
pwwn: 11:11:11:11:11:11:11:11
- pwwn: 62:62:62:62:12:12:12:12
- devtype: both
pwwn: 92:62:62:62:12:12:1a:1a
remove: true
name: zone21A
- members:
- pwwn: 10:11:11:11:11:11:11:11
- pwwn: 62:62:62:62:21:21:21:21
name: zone21B
zoneset:
- action: activate
members:
- name: zone21A
- name: zone21B
name: zsetname212
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key |
Description |
---|---|
commands sent to the device Returned: always Sample: |
|
debug messages Returned: always Sample: |