dellemc.enterprise_sonic.sonic_facts module – Collects facts on devices running Enterprise SONiC

Note

This module is part of the dellemc.enterprise_sonic collection (version 1.1.2).

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 dellemc.enterprise_sonic.

To use it in a playbook, specify: dellemc.enterprise_sonic.sonic_facts.

New in dellemc.enterprise_sonic 1.0.0

Synopsis

  • Collects facts from devices running Enterprise SONiC Distribution by Dell Technologies. This module places the facts gathered in the fact tree keyed by the respective resource name. The facts module always collects a base set of facts from the device and can enable or disable collection of additional facts.

Note

This module has a corresponding action plugin.

Parameters

Parameter

Comments

gather_network_resources

list / elements=string

When supplied, this argument restricts the facts collected to a given network resource or a given list of network resources. Possible values for this argument include ‘all’ and specific network resource names such as ‘interfaces’, ‘vlans’, ‘lag_interfaces’, ‘l2_interfaces’, and ‘l3_interfaces’. Multiple resources can be specified by placing them in a comma-separated list. A given value can also be enclosed in double quotes and preceded by an exclamation mark to indicate that the information for the corresponding resource should not be collected.

Choices:

  • "all"

  • "vlans"

  • "interfaces"

  • "l2_interfaces"

  • "l3_interfaces"

  • "lag_interfaces"

  • "bgp"

  • "bgp_af"

  • "bgp_neighbors"

  • "bgp_neighbors_af"

  • "bgp_as_paths"

  • "bgp_communities"

  • "bgp_ext_communities"

  • "mclag"

  • "vrfs"

  • "vxlans"

  • "users"

  • "system"

  • "port_breakout"

  • "aaa"

  • "tacacs_server"

  • "radius_server"

gather_subset

list / elements=string

When supplied, this argument restricts the facts collected to a given subset. Possible values for this argument include all, min, hardware, config, legacy, and interfaces. It can also specify a list of values to include a larger subset. A value can also be enclosed in double quotes and preceded by an exclamation mark to indicate that the corresponding information should not be collected.

Default: ["!config"]

Notes

Note

  • Tested against Enterprise SONiC Distribution by Dell Technologies.

  • Supports check_mode.

Examples

- name: Gather all facts
  dellemc.enterprise_sonic.sonic_facts:
    gather_subset: all
    gather_network_resources: all

- name: Collects VLAN and interfaces facts
  dellemc.enterprise_sonic.sonic_facts:
    gather_subset:
      - min
    gather_network_resources:
      - vlans
      - interfaces

- name: Do not collects VLAN and interfaces facts
  dellemc.enterprise_sonic.sonic_facts:
    gather_network_resources:
      - "!vlans"
      - "!interfaces"

- name: Collects VLAN and minimal default facts
  dellemc.enterprise_sonic.sonic_facts:
    gather_subset: min
    gather_network_resources: vlans

- name: Collect lag_interfaces and minimal default facts
  dellemc.enterprise_sonic.sonic_facts:
    gather_subset: min
    gather_network_resources: lag_interfaces

Authors

  • Mohamed Javeed (@javeedf)

  • Abirami N (@abirami-n)