cisco / cisco.ios / 8.0.0 / module / ios_facts Module to collect facts from remote devices. | "added in version" 1.0.0 of cisco.ios" Authors: Peter Sprygada (@privateip), Sumit Jaiswal (@justjais)cisco.ios.ios_facts (8.0.0) — module
Install with ansible-galaxy collection install cisco.ios:==8.0.0
collections: - name: cisco.ios version: 8.0.0
Collects a base set of device facts from a remote device that is running IOS. This module prepends all of the base network fact keys with C(ansible_net_<fact>). The facts module will always collect a base set of facts from the device and can enable or disable collection of additional facts.
- name: Gather all legacy facts cisco.ios.ios_facts: gather_subset: all
- name: Gather only the config and default facts cisco.ios.ios_facts: gather_subset: - config
- name: Do not gather hardware facts cisco.ios.ios_facts: gather_subset: - "!hardware"
- name: Gather legacy and resource facts cisco.ios.ios_facts: gather_subset: all gather_network_resources: all
- name: Gather only the interfaces resource facts and no legacy facts cisco.ios.ios_facts: gather_subset: - "!all" - "!min" gather_network_resources: - interfaces
- name: Gather interfaces resource and minimal legacy facts cisco.ios.ios_facts: gather_subset: min gather_network_resources: interfaces
- name: Gather L2 interfaces resource and minimal legacy facts cisco.ios.ios_facts: gather_subset: min gather_network_resources: l2_interfaces
- name: Gather L3 interfaces resource and minimal legacy facts cisco.ios.ios_facts: gather_subset: min gather_network_resources: l3_interfaces
gather_subset: default: min description: - When supplied, this argument restricts the facts collected to a given subset. - Possible values for this argument include C(all), C(min), C(default), C(hardware), C(config), and C(interfaces). - Specify a list of values to include a larger subset. - Use a value with an initial C(!) to collect all facts except that subset. elements: str required: false type: list gather_network_resources: description: - 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, vlans etc. Can specify a list of values to include a larger subset. Values can also be used with an initial C(!) to specify that a specific subset should not be collected. Valid subsets are 'bgp_global', 'l3_interfaces', 'lag_interfaces', 'ntp_global', 'acls', 'hostname', 'interfaces', 'lldp_interfaces', 'logging_global', 'ospf_interfaces', 'ospfv2', 'prefix_lists', 'static_routes', 'acl_interfaces', 'all', 'bgp_address_family', 'l2_interfaces', 'lacp', 'lacp_interfaces', 'lldp_global', 'ospfv3', 'snmp_server', 'vlans', 'service'. elements: str type: list available_network_resources: default: false description: When 'True' a list of network resources for which resource modules are available will be provided. type: bool
ansible_net_all_ipv4_addresses: description: All IPv4 addresses configured on the device returned: when interfaces is configured type: list ansible_net_all_ipv6_addresses: description: All IPv6 addresses configured on the device returned: when interfaces is configured type: list ansible_net_api: description: The name of the transport returned: always type: str ansible_net_config: description: The current active config from the device returned: when config is configured type: str ansible_net_cpu_utilization: description: The current CPU utilization of the device returned: when hardware is configured type: dict ansible_net_filesystems: description: All file system names available on the device returned: when hardware is configured type: list ansible_net_filesystems_info: description: A hash of all file systems containing info about each file system (e.g. free and total space) returned: when hardware is configured type: dict ansible_net_gather_network_resources: description: The list of fact for network resource subsets collected from the device returned: when the resource is configured type: list ansible_net_gather_subset: description: The list of fact subsets collected from the device returned: always type: list ansible_net_hostname: description: The configured hostname of the device returned: always type: str ansible_net_image: description: The image file the device is running returned: always type: str ansible_net_interfaces: description: A hash of all interfaces running on the system returned: when interfaces is configured type: dict ansible_net_iostype: description: The operating system type (IOS or IOS-XE) running on the remote device returned: always type: str ansible_net_memfree_mb: description: The available free memory on the remote device in Mb returned: when hardware is configured type: int ansible_net_memtotal_mb: description: The total memory on the remote device in Mb returned: when hardware is configured type: int ansible_net_model: description: The model name returned from the device returned: always type: str ansible_net_neighbors: description: - The list of CDP and LLDP 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 type: dict ansible_net_python_version: description: The Python version Ansible controller is using returned: always type: str ansible_net_serialnum: description: The serial number of the remote device returned: always type: str ansible_net_stacked_models: description: The model names of each device in the stack returned: when multiple devices are configured in a stack type: list ansible_net_stacked_serialnums: description: The serial numbers of each device in the stack returned: when multiple devices are configured in a stack type: list ansible_net_version: description: The operating system version running on the remote device returned: always type: str