ansible.builtin.nxos_igmp_snooping (v2.3.3.0-1) — module

Manages IGMP snooping global configuration.

| "added in version" 2.2 of ansible.builtin"

Authors: Jason Edelman (@jedelman8), Gabriele Gerbino (@GGabriele)

preview | supported by community

Install Ansible via pip

Install with pip install ansible==2.3.3.0.post1

Description

Manages IGMP snooping global configuration.

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
# ensure igmp snooping params supported in this module are in there default state
- nxos_igmp_snooping:
    state: default
    host:  inventory_hostname }}
    username:  un }}
    password:  pwd }}
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
# ensure following igmp snooping params are in the desired state
- nxos_igmp_snooping:
   group_timeout: never
   snooping: true
   link_local_grp_supp: false
   optimize_mcast_flood: false
   report_supp: true
   v3_report_supp: true
   host: "{{ inventory_hostname }}"
   username: "{{ un }}"
   password: "{{ pwd }}"

Inputs

    
state:
    choices:
    - present
    - default
    default: present
    description:
    - Manage the state of the resource.
    required: false

snooping:
    choices:
    - 'true'
    - 'false'
    default: null
    description:
    - Enables/disables IGMP snooping on the switch.
    required: false

report_supp:
    default: null
    description:
    - Global IGMPv1/IGMPv2 Report Suppression.
    required: false

group_timeout:
    default: null
    description:
    - Group membership timeout value for all VLANs on the device. Accepted values are
      integer in range 1-10080, I(never) and I(default).
    required: false

v3_report_supp:
    choices:
    - 'true'
    - 'false'
    default: null
    description:
    - Global IGMPv3 Report Suppression and Proxy Reporting.
    required: false

link_local_grp_supp:
    choices:
    - 'true'
    - 'false'
    default: null
    description:
    - Global link-local groups suppression.
    required: false

Outputs

changed:
  description: check to see if a change was made on the device
  returned: always
  sample: true
  type: boolean
end_state:
  description: k/v pairs of configuration after module execution
  returned: always
  sample:
    group_timeout: '50'
    link_local_grp_supp: true
    report_supp: false
    snooping: false
    v3_report_supp: false
  type: dict
existing:
  description:
  - k/v pairs of existing configuration
  returned: always
  sample:
    group_timeout: never
    link_local_grp_supp: false
    report_supp: true
    snooping: true
    v3_report_supp: true
  type: dict
proposed:
  description: k/v pairs of parameters passed into module
  returned: always
  sample:
    group_timeout: '50'
    link_local_grp_supp: true
    report_supp: false
    snooping: false
    v3_report_supp: false
  type: dict
updates:
  description: command sent to the device
  returned: always
  sample:
  - ip igmp snooping link-local-groups-suppression
  - ip igmp snooping group-timeout 50
  - no ip igmp snooping report-suppression
  - no ip igmp snooping v3-report-suppression
  - no ip igmp snooping
  type: list