cisco.iosxr.iosxr_facts module – Module to collect facts from remote devices.
Note
This module is part of the cisco.iosxr collection (version 10.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.iosxr
.
To use it in a playbook, specify: cisco.iosxr.iosxr_facts
.
New in cisco.iosxr 1.0.0
Synopsis
Collects facts from network devices running the iosxr operating system. This module places the facts gathered in the fact tree keyed by the respective resource name. The facts module will always collect a base set of facts from the device and can enable or disable collection of additional facts.
Aliases: facts
Parameters
Parameter |
Comments |
---|---|
When ‘True’ a list of network resources for which resource modules are available will be provided. Choices:
|
|
When supplied, this argument will restrict the facts collected to a given subset. Possible values for this argument include all and the resources like interfaces, lacp etc. Can specify a list of values to include a larger subset. Values can also be used with an initial |
|
When supplied, this argument will restrict the facts collected to a given subset. Possible values for this argument include all, hardware, config, and interfaces. Can specify a list of values to include a larger subset. Values can also be used with an initial Default: |
Notes
Note
This module works with connection
network_cli
. See the IOS-XR 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
# Gather all facts
- cisco.iosxr.iosxr_facts:
gather_subset: all
gather_network_resources: all
# Collect only the config and default facts
- cisco.iosxr.iosxr_facts:
gather_subset:
- config
# Do not collect hardware facts
- cisco.iosxr.iosxr_facts:
gather_subset:
- '!hardware'
# Collect only the lacp facts
- cisco.iosxr.iosxr_facts:
gather_subset:
- '!all'
- '!min'
gather_network_resources:
- lacp
# Do not collect lacp_interfaces facts
- cisco.iosxr.iosxr_facts:
gather_network_resources:
- '!lacp_interfaces'
# Collect lacp and minimal default facts
- cisco.iosxr.iosxr_facts:
gather_subset: min
gather_network_resources: lacp
# Collect only the interfaces facts
- cisco.iosxr.iosxr_facts:
gather_subset:
- '!all'
- '!min'
gather_network_resources:
- interfaces
- l2_interfaces
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key |
Description |
---|---|
All IPv4 addresses configured on the device Returned: when interfaces is configured |
|
All IPv6 addresses configured on the device Returned: when interfaces is configured |
|
The name of the transport Returned: always |
|
The current active config from the device Returned: when config is configured |
|
The current CPU utilization of the device Returned: when hardware is configured |
|
All file system names available on the device Returned: when hardware is configured |
|
The list of fact resource subsets collected from the device Returned: always |
|
The list of fact subsets collected from the device Returned: always |
|
The configured hostname of the device Returned: always |
|
The image file the device is running Returned: always |
|
A hash of all interfaces running on the system Returned: when interfaces is configured |
|
The available free memory on the remote device in Mb Returned: when hardware is configured |
|
The total memory on the remote device in Mb Returned: when hardware is configured |
|
The model name returned from the device Returned: always |
|
The list of LLDP and CDP neighbors from the remote device. If both, CDP and LLDP neighbor data is present on one port, CDP is preferred. Returned: when interfaces is configured |
|
The Python version Ansible controller is using Returned: always |
|
The operating system version running on the remote device Returned: always |