cisco.nxos.nxos_igmp_snooping module – Manages IGMP snooping global configuration.
Note
This module is part of the cisco.nxos collection (version 8.1.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_igmp_snooping
.
New in cisco.nxos 1.0.0
Synopsis
Manages IGMP snooping global configuration.
Aliases: igmp_snooping
Parameters
Parameter |
Comments |
---|---|
Group membership timeout value for all VLANs on the device. Accepted values are integer in range 1-10080, never and default. |
|
Global link-local groups suppression. Choices:
|
|
Global IGMPv1/IGMPv2 Report Suppression. Choices:
|
|
Enables/disables IGMP snooping on the switch. Choices:
|
|
Manage the state of the resource. Choices:
|
|
Global IGMPv3 Report Suppression and Proxy Reporting. Choices:
|
Notes
Note
Tested against NXOSv 7.3.(0)D1(1) on VIRL
Unsupported for Cisco MDS
When
state=default
, params will be reset to a default state.group_timeout
also accepts never as an input.For information on using CLI and NX-API see the :ref:`NXOS Platform Options guide <nxos_platform_options>`
For more information on using Ansible to manage network devices see the :ref:`Ansible Network Guide <network_guide>`
For more information on using Ansible to manage Cisco devices see the `Cisco integration page <https://www.ansible.com/integrations/networks/cisco>`_.
Examples
# ensure igmp snooping params supported in this module are in there default state
- cisco.nxos.nxos_igmp_snooping:
state: default
# ensure following igmp snooping params are in the desired state
- cisco.nxos.nxos_igmp_snooping:
group_timeout: never
snooping: true
link_local_grp_supp: false
optimize_mcast_flood: false
report_supp: true
v3_report_supp: true
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key |
Description |
---|---|
command sent to the device Returned: always Sample: |