cisco.iosxr.iosxr_facts 模块 – 从远程设备收集事实的模块。

注意

此模块是 cisco.iosxr 集合 (版本 10.2.2) 的一部分。

如果您使用的是 ansible 包，则可能已经安装了此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install cisco.iosxr。

要在 playbook 中使用它，请指定：cisco.iosxr.iosxr_facts。

cisco.iosxr 1.0.0 中的新增功能

概要 

从运行 iosxr 操作系统的网络设备收集事实。此模块将收集的事实放置在由相应资源名称作为键的事实树中。事实模块将始终从设备收集一组基本事实，并且可以启用或禁用其他事实的收集。

参数 

参数	注释
available_network_resources 布尔值	当为“True”时，将提供可用于资源模块的网络资源列表。选项 `false` ← (默认) `true`
gather_network_resources 列表 / 元素=字符串	当提供此参数时，它将收集的事实限制为给定的子集。此参数的可能值为 all 和诸如 interfaces、lacp 等资源。可以指定一个值列表以包含更大的子集。值也可以与初始 `!` 一起使用，以指定不应收集特定的子集。有效的子集是“all”、“lacp”、“lacp_interfaces”、“lldp_global”、“lldp_interfaces”、“interfaces”、“l2_interfaces”、“l3_interfaces”、“lag_interfaces”、“acls”、“acl_interfaces”、“static_routes”、“ospfv2”。
gather_subset 列表 / 元素=字符串	当提供此参数时，它将收集的事实限制为给定的子集。此参数的可能值为 all、hardware、config 和 interfaces。可以指定一个值列表以包含更大的子集。值也可以与初始 `!` 一起使用，以指定不应收集特定的子集。默认值： `["min"]`

备注 

注意

此模块与连接 network_cli 一起使用。请参阅 IOS-XR 平台选项。
有关使用 Ansible 管理网络设备的更多信息，请参阅 :ref:`Ansible 网络指南 <network_guide>`
有关使用 Ansible 管理 Cisco 设备的更多信息，请参阅 `Cisco 集成页面 <https://ansible.org.cn/integrations/networks/cisco>`_。

示例 

# 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

返回值 

常见的返回值已记录在此处，以下是此模块特有的字段

键	描述
ansible_net_all_ipv4_addresses 列表 / 元素=字符串	在设备上配置的所有 IPv4 地址返回：当配置 interfaces 时
ansible_net_all_ipv6_addresses 列表 / 元素=字符串	在设备上配置的所有 IPv6 地址返回：当配置 interfaces 时
ansible_net_api 字符串	传输的名称返回：始终返回
ansible_net_config 字符串	设备的当前活动配置返回：当配置 config 时
ansible_net_cpu_utilization 字典	设备的当前 CPU 利用率返回：当配置 hardware 时
ansible_net_filesystems 列表 / 元素=字符串	设备上可用的所有文件系统名称返回：当配置 hardware 时
ansible_net_gather_network_resources 列表 / 元素=字符串	从设备收集的事实资源子集列表返回：始终返回
ansible_net_gather_subset 列表 / 元素=字符串	从设备收集的事实子集列表返回：始终返回
ansible_net_hostname 字符串	设备的已配置主机名返回：始终返回
ansible_net_image 字符串	设备正在运行的镜像文件返回：始终返回
ansible_net_interfaces 字典	系统上运行的所有接口的哈希值返回：当配置 interfaces 时
ansible_net_memfree_mb 整数	远程设备上可用的空闲内存（以 MB 为单位）返回：当配置 hardware 时
ansible_net_memtotal_mb 整数	远程设备上的总内存（以 MB 为单位）返回：当配置 hardware 时
ansible_net_model 字符串	从设备返回的型号名称返回：始终返回
ansible_net_neighbors 字典	远程设备的 LLDP 和 CDP 邻居列表。如果一个端口上同时存在 CDP 和 LLDP 邻居数据，则优先使用 CDP。返回：当配置 interfaces 时
ansible_net_python_version 字符串	Ansible 控制器正在使用的 Python 版本返回：始终返回
ansible_net_version 字符串	远程设备上运行的操作系统版本返回：始终返回

作者

Ricardo Carrillo Cruz (@rcarrillocruz)
Nilashish Chakraborty (@Nilashishc)