Vh pddlmZmZmZeZdZdZdZddl m Z ddl m Z ddl mZmZdZed k(rey y ) )absolute_importdivisionprint_functionac module: ios_facts author: - Peter Sprygada (@privateip) - Sumit Jaiswal (@justjais) short_description: Module to collect facts from remote devices. description: - 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_). The facts module will always collect a base set of facts from the device and can enable or disable collection of additional facts. version_added: 1.0.0 extends_documentation_fragment: - cisco.ios.ios notes: - Tested against Cisco IOSXE Version 17.3 on CML and IOS 15.6 for L2 specific resource. - Facts gathering for L3 devices are supposed to produce blank output for unsupported resources like vlan. - This module works with connection C(network_cli). See U(https://docs.ansible.com/ansible/latest/network/user_guide/platform_ios.html) options: gather_subset: 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. required: false default: "min" type: list elements: str 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'. type: list elements: str available_network_resources: description: When 'True' a list of network resources for which resource modules are available will be provided. type: bool default: false a  - 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 a; ansible_net_gather_subset: description: The list of fact subsets collected from the device returned: always type: list 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 # default ansible_net_model: description: The model name returned from the device returned: always type: str ansible_net_serialnum: description: The serial number of the remote device returned: always type: str ansible_net_version: description: The operating system version running on the remote device returned: always type: str ansible_net_iostype: description: The operating system type (IOS or IOS-XE) running on the remote device returned: always type: str 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_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_api: description: The name of the transport returned: always type: str ansible_net_python_version: description: The Python version Ansible controller is using returned: always type: str # hardware 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_memfree_mb: description: The available free memory on the remote device in MiB returned: when hardware is configured type: int ansible_net_memtotal_mb: description: The total memory on the remote device in MiB returned: when hardware is configured type: int ansible_net_cpu_utilization: description: The current CPU utilization of the device returned: when hardware is configured type: dict # config ansible_net_config: description: The current active config from the device returned: when config is configured type: str # interfaces 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_interfaces: description: A hash of all interfaces running on the system returned: when interfaces is configured type: dict 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 ) AnsibleModule) FactsArgs)FACT_RESOURCE_SUBSETSFactscbtj}t|d}g}i}|jj dr t t j|d<t|j}|\}}|j||j||j||y)zL Main entry point for module execution :returns: ansible_facts T) argument_specsupports_check_modeavailable_network_resources) ansible_factswarningsN) rr rparamsgetsortedrkeysr get_factsupdateextend exit_json)r modulerrresultadditional_factsadditional_warningss g/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/cisco/ios/plugins/modules/ios_facts.pymainrs ++M D QFHM }}677=>S>X>X>Z7[ 34 6] $ $ &F,2)))* OO'( =8D__main__N) __future__rrrtype __metaclass__ DOCUMENTATIONEXAMPLESRETURNansible.module_utils.basicrRansible_collections.cisco.ios.plugins.module_utils.network.ios.argspec.facts.factsrJansible_collections.cisco.ios.plugins.module_utils.network.ios.facts.factsrr r__name__rrr+sW$A@ 1 f* Xd J5 E( zFr