community.routeros.facts 模块 – 从运行 MikroTik RouterOS 的远程设备收集信息

注意

此模块是 community.routeros 集合（版本 3.1.0）的一部分。

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

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

要在 Playbook 中使用它，请指定：community.routeros.facts。

概要 

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

参数 

参数	注释
gather_subset 列表 / 元素=字符串	提供时，此参数会将收集的信息限制为给定的子集。此参数的可能值包括 `all`、`hardware`、`config`、`interfaces` 和 `routing`。可以指定值的列表以包含更大的子集。值也可以与初始的 `!` 一起使用，以指定不应收集特定的子集。默认值： `["!config"]`

属性 

属性	支持	描述
check_mode	支持：完全此操作不修改状态。	可以在 `check_mode` 中运行，并返回更改的状态预测，而无需修改目标。
diff_mode	支持：不适用此操作不修改状态。	当处于 diff 模式时，将返回有关已更改的内容（或可能需要在 `check_mode` 中更改的内容）的详细信息。
facts	支持：完全	操作返回一个 `ansible_facts` 字典，该字典将更新现有主机信息。
platform	平台： RouterOS	可以操作的目标操作系统/系列。

另请参阅 

另请参阅

如何使用 SSH 连接到 RouterOS 设备: 如何使用 SSH 连接到 RouterOS 设备

示例 

- name: Collect all facts from the device
  community.routeros.facts:
    gather_subset: all

- name: Collect only the config and default facts
  community.routeros.facts:
    gather_subset:
      - config

- name: Do not collect hardware facts
  community.routeros.facts:
    gather_subset:
      - "!hardware"

返回的事实 

此模块返回的事实已添加/更新到 hostvars 主机事实中，并且可以像任何其他主机事实一样按名称引用。它们不需要注册即可使用它们。

键	描述
ansible_net_all_ipv4_addresses 列表 / 元素=字符串	设备上配置的所有 IPv4 地址。返回： `gather_subset` 包含 `interfaces`
ansible_net_all_ipv6_addresses 列表 / 元素=字符串	设备上配置的所有 IPv6 地址。返回： `gather_subset` 包含 `interfaces`
ansible_net_arch 字符串	设备的 CPU 架构。返回： `gather_subset` 包含 `default`
ansible_net_bgp_instance 字典	包含 BGP 实例信息的字典。返回： `gather_subset` 包含 `routing`
ansible_net_bgp_peer 字典	包含 BGP 对等信息的字典。返回： `gather_subset` 包含 `routing`
ansible_net_bgp_vpnv4_route 字典	包含 BGP vpnv4 路由信息的字典。返回： `gather_subset` 包含 `routing`
ansible_net_config 字符串	来自设备的当前活动配置。返回： `gather_subset` 包含 `config`
ansible_net_config_nonverbose 字符串在 community.routeros 1.2.0 中添加	来自设备的当前活动配置，以最简形式呈现。此值是幂等的，这意味着如果 facts 模块运行两次，并且设备配置在两次运行之间没有更改，则该值是相同的。这是通过运行 `/export` 并从第一行的注释中剥离时间戳来实现的。返回： `gather_subset` 包含 `config`
ansible_net_cpu_load 字符串	当前 CPU 负载。返回： `gather_subset` 包含 `default`
ansible_net_gather_subset 列表 / 元素=字符串	从设备收集的信息子集列表。返回：始终
ansible_net_hostname 字符串	设备的配置主机名。返回： `gather_subset` 包含 `default`
ansible_net_interfaces 字典	系统上运行的所有接口的哈希值。返回： `gather_subset` 包含 `interfaces`
ansible_net_memfree_mb 整数	远程设备上的可用空闲内存（以 MiB 为单位）。返回: `gather_subset` 包含 `hardware`
ansible_net_memtotal_mb 整数	远程设备的总内存（以 MiB 为单位）。返回: `gather_subset` 包含 `hardware`
ansible_net_model 字符串	从设备返回的型号名称。返回： `gather_subset` 包含 `default`
ansible_net_neighbors 字典	来自远程设备的邻居列表。返回： `gather_subset` 包含 `interfaces`
ansible_net_ospf_instance 字典	包含 OSPF 实例的字典。返回： `gather_subset` 包含 `routing`
ansible_net_ospf_neighbor 字典	包含 OSPF 邻居的字典。返回： `gather_subset` 包含 `routing`
ansible_net_route 字典	包含所有路由表中路由的字典。返回： `gather_subset` 包含 `routing`
ansible_net_serialnum 字符串	远程设备的序列号。返回： `gather_subset` 包含 `default`
ansible_net_spacefree_mb 字典	远程设备的可用磁盘空间（以 MiB 为单位）。返回: `gather_subset` 包含 `hardware`
ansible_net_spacetotal_mb 字典	远程设备的总磁盘空间（以 MiB 为单位）。返回: `gather_subset` 包含 `hardware`
ansible_net_uptime 字符串	设备的正常运行时间。返回： `gather_subset` 包含 `default`
ansible_net_version 字符串	远程设备上运行的操作系统版本。返回： `gather_subset` 包含 `default`

作者

Egor Zaitsev (@heuels)