community.ciscosmb.facts 模块 – 从运行 Cisco SMB 的远程设备收集信息

注意

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

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

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

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

概要

  • 从运行 Cisco SMB 的远程设备收集基本设备信息。此模块会将所有基本网络信息键添加前缀 ansible_net_<fact>。信息模块将始终从设备收集基本信息，并可以启用或禁用其他信息的收集。

参数

参数

注释

gather_subset

列表 / 元素=字符串

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

选择

  • "default"

  • "all"

  • "hardware"

  • "config"

  • "interfaces"

  • "!hardware"

  • "!config" ← (默认)

  • "!interfaces"

默认值： ["!config"]

注释

注意

  • 支持 check_mode。

示例

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

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

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

返回值

通用返回值记录在此处此处，以下是此模块特有的字段

键

描述

ansible_net_all_ipv4_addresses

列表 / 元素=字符串

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

返回： 当配置了接口时

ansible_net_all_ipv6_addresses

列表 / 元素=字符串

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

返回： 当配置了接口时

ansible_net_config

字符串

设备当前的活动配置。

返回： 当配置了 config 时

ansible_net_cpu_load

字符串

当前 CPU 负载。

返回： 始终

ansible_net_gather_subset

列表 / 元素=字符串

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

返回： 始终

ansible_net_hostname

字符串

设备的已配置主机名。

返回： 始终

ansible_net_interfaces

字典

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

返回： 当配置了接口时

ansible_net_memfree_mb

整数

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

返回： 当配置了 hardware 时

ansible_net_memtotal_mb

整数

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

返回： 当配置了 hardware 时

ansible_net_model

字符串

从设备返回的型号名称。

返回： 始终

ansible_net_neighbors

字典

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

返回： 当配置了接口时

ansible_net_serialnum

字符串

远程设备的序列号。

返回： 始终

ansible_net_spacefree_mb

字典

远程设备上可用的磁盘空间（以 MiB 为单位）。

返回： 当配置了 hardware 时

ansible_net_spacetotal_mb

字典

远程设备上的总磁盘空间（以 MiB 为单位）。

返回： 当配置了 hardware 时

ansible_net_stacked_models

列表 / 元素=字符串

堆栈中每个设备的型号名称。

返回： 当在堆栈中配置了多个设备时

ansible_net_stacked_serialnums

列表 / 元素=字符串

堆栈中每个设备的序列号。

返回： 当在堆栈中配置了多个设备时

ansible_net_uptime

字符串

设备的正常运行时间。

返回： 始终

ansible_net_version

字符串

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

返回： 始终

作者

  • Petr Klima (@qaxi)