cisco.ios.ios_facts 模块 – 从远程设备收集事实的模块。

注意

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

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

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

要在剧本中使用它，请指定： cisco.ios.ios_facts。

cisco.ios 1.0.0 中的新增功能

概要

  • 从运行 IOS 的远程设备收集一组基本的设备事实。此模块将所有基本网络事实键名前缀加上 ansible_net_<fact>。事实模块将始终从设备收集一组基本事实，并且可以启用或禁用其他事实的收集。

参数

参数

注释

available_network_resources

布尔值

设置为“True”时，将提供可用于资源模块的网络资源列表。

选项

  • false ← (默认)

  • true

gather_network_resources

列表 / 元素=字符串

提供此参数时，它将收集的事实限制为给定的子集。此参数的可能值为 all 和诸如 interfaces、vlans 等资源。可以指定一个值列表以包含更大的子集。值也可以与初始 ! 一起使用，以指定不应收集特定子集。有效的子集是“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”。

gather_subset

列表 / 元素=字符串

提供此参数时，它将收集的事实限制为给定的子集。

此参数的可能值为 all、min、default、hardware、config 和 interfaces。

指定一个值列表以包含更大的子集。

使用以初始 ! 开头的值来收集除该子集之外的所有事实。

默认值： ["min"]

注释

注意

示例

- 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

返回值

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

键

描述

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_filesystems_info

字典

包含有关每个文件系统信息（例如可用空间和总空间）的所有文件系统的哈希表

返回：配置 hardware 时

ansible_net_gather_network_resources

列表 / 元素=字符串

从设备收集的网络资源子集的事实列表

返回：配置资源时

ansible_net_gather_subset

列表 / 元素=字符串

从设备收集的事实子集列表

返回：始终返回

ansible_net_hostname

字符串

设备的已配置主机名

返回：始终返回

ansible_net_image

字符串

设备正在运行的镜像文件

返回：始终返回

ansible_net_interfaces

字典

系统上运行的所有接口的哈希表

返回：配置 interfaces 时

ansible_net_iostype

字符串

远程设备上运行的操作系统类型（IOS 或 IOS-XE）

返回：始终返回

ansible_net_memfree_mb

整数

远程设备上以 MiB 为单位的可用空闲内存

返回：配置 hardware 时

ansible_net_memtotal_mb

整数

远程设备上以 MiB 为单位的总内存

返回：配置 hardware 时

ansible_net_model

字符串

设备返回的型号名称

返回：始终返回

ansible_net_neighbors

字典

来自远程设备的 CDP 和 LLDP 邻居列表。如果在一个端口上同时存在 CDP 和 LLDP 邻居数据，则优先使用 CDP。

返回：配置 interfaces 时

ansible_net_python_version

字符串

Ansible 控制器正在使用的 Python 版本

返回：始终返回

ansible_net_serialnum

字符串

远程设备的序列号

返回：始终返回

ansible_net_stacked_models

列表 / 元素=字符串

堆叠中每个设备的型号名称

返回值：当多个设备配置在堆叠中时

ansible_net_stacked_serialnums

列表 / 元素=字符串

堆叠中每个设备的序列号

返回值：当多个设备配置在堆叠中时

ansible_net_version

字符串

远程设备上运行的操作系统版本

返回：始终返回

作者

  • Peter Sprygada (@privateip)

  • Sumit Jaiswal (@justjais)