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 2.5.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 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 |
---|---|
When supplied, this argument restricts the facts collected to a given subset. Possible values for this argument include all and the resources like ‘all’, ‘interfaces’, ‘vlans’, ‘lag_interfaces’, ‘l2_interfaces’, ‘l3_interfaces’. Can specify a list of values to include a larger subset. Values can also be used with an initial ‘!’ to specify that a specific subset should not be collected. Choices:
|
|
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. Can specify a list of values to include a larger subset. Values can also be used with an initial ‘!’ to specify that a specific subset should not be collected. Default: |
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