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

注意

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

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

要安装它,请使用:ansible-galaxy collection install community.network

要在 playbook 中使用它,请指定:community.network.cnos_facts

注意

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

已弃用

移除于:

版本 6.0.0

原因:

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

替代方案:

未知。

概要

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

别名:network.cnos.cnos_facts

参数

参数

说明

auth_pass

字符串

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

authorize

布尔值

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

选择

  • false ←(默认)

  • true

gather_subset

字符串

如果提供,此参数会将收集的信息限制为给定的子集。此参数的可能值包括 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 地址

返回: 当配置了接口时

ansible_net_all_ipv6_addresses

列表 / 元素=字符串

设备上配置的所有 IPv6 地址

返回: 当配置了接口时

ansible_net_config

字符串

设备中的当前活动配置

返回: 当配置了配置时

ansible_net_gather_subset

列表 / 元素=字符串

从设备收集的信息子集列表

返回: 始终

ansible_net_hostname

字符串

设备的配置主机名

返回: 始终

ansible_net_image

字符串

指示设备的活动映像

返回: 始终

ansible_net_interfaces

字典

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

返回: 当配置了接口时

ansible_net_memfree_mb

整数

远程设备上可用的可用内存(以 MB 为单位)

返回: 当配置了硬件时

ansible_net_model

字符串

从 Lenovo CNOS 设备返回的型号名称

返回: 始终

ansible_net_neighbors

字典

来自远程设备的 LLDP 邻居列表

返回: 当配置了接口时

ansible_net_serialnum

字符串

Lenovo CNOS 设备的序列号

返回: 始终

ansible_net_version

字符串

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

返回: 始终

状态

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

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

作者

  • Anil Kumar Muraleedharan (@amuraleedhar)