community.network.cnos_facts 模块 – 收集运行 Lenovo CNOS 的远程设备的 facts

注意

此模块是 community.network 集合 (版本 5.1.0) 的一部分。

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

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

要在剧本中使用它，请指定：community.network.cnos_facts。

注意

community.network 集合已被弃用，并将从 Ansible 12 中移除。有关更多信息，请参阅 讨论主题。

已弃用

在以下版本中移除：

6.0.0 版本

原因：

此集合及其中的所有内容均未维护且已弃用。

替代方案：

未知。

概要

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

别名：network.cnos.cnos_facts

参数

参数

注释

auth_pass

字符串

指定如果需要在远程设备上进入特权模式时要使用的密码。如果 *authorize* 为 false，则此参数无效。如果任务中未指定此值，则将改为使用环境变量 ANSIBLE_NET_AUTH_PASS 的值。

authorize

布尔值

指示模块在发送任何命令之前进入远程设备的特权模式。如果未指定，则设备将尝试以非特权模式执行所有命令。如果任务中未指定此值，则将改为使用环境变量 ANSIBLE_NET_AUTHORIZE 的值。

选项

  • false ← (默认)

  • true

gather_subset

字符串

提供此参数时，它将收集的 facts 限制为给定的子集。此参数的可能值为 all、hardware、config 和 interfaces。可以指定一个值列表以包含更大的子集。值也可以与初始 ! 一起使用，以指定不应收集特定子集。

默认值： "!config"

备注

注意

  • 针对 CNOS 10.8.1 进行了测试

示例

Tasks: The following are examples of using the module cnos_facts.
---
- name: Test cnos Facts
  community.network.cnos_facts:

---
# Collect all facts from the device
- community.network.cnos_facts:
    gather_subset: all

# Collect only the config and default facts
- community.network.cnos_facts:
    gather_subset:
      - config

# Do not collect hardware facts
- community.network.cnos_facts:
    gather_subset:
      - "!hardware"

返回值

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

键

描述

ansible_net_all_ipv4_addresses

列表 / 元素=字符串

在设备上配置的所有 IPv4 地址

返回：配置 interfaces 时

ansible_net_all_ipv6_addresses

列表 / 元素=字符串

在设备上配置的所有 IPv6 地址

返回：配置 interfaces 时

ansible_net_config

字符串

设备当前活动的配置

返回：配置 config 时

ansible_net_gather_subset

列表 / 元素=字符串

从设备收集的 fact 子集列表

返回：始终返回

ansible_net_hostname

字符串

设备配置的主机名

返回：始终返回

ansible_net_image

字符串

指示设备的活动镜像

返回：始终返回

ansible_net_interfaces

字典

系统上运行的所有接口的哈希值。这提供了有关描述、MAC 地址、MTU、速度、双工和 operstatus 的信息

返回：配置 interfaces 时

ansible_net_memfree_mb

整数

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

返回：配置 hardware 时

ansible_net_model

字符串

Lenovo CNOS 设备返回的型号名称

返回：始终返回

ansible_net_neighbors

字典

远程设备的 LLDP 邻居列表

返回：配置 interfaces 时

ansible_net_serialnum

字符串

Lenovo CNOS 设备的序列号

返回：始终返回

ansible_net_version

字符串

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

返回：始终返回

状态

  • 此模块将在 6.0.0 版本中移除。[已弃用]

  • 有关更多信息，请参阅 已弃用。

作者

  • Anil Kumar Muraleedharan (@amuraleedhar)