cisco.nxos.nxos_facts 模块 – 获取有关 NX-OS 交换机的事实信息

注意

此模块是 cisco.nxos 集合（版本 9.2.1）的一部分。

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

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

要在 playbook 中使用它，请指定：cisco.nxos.nxos_facts。

cisco.nxos 1.0.0 中的新增功能

概要 

从运行 NX-OS 操作系统的 Cisco Nexus 设备收集事实信息。事实信息的收集支持通过 network_cli 和 httpapi 进行。此模块将所有基本网络事实信息键加上前缀 ansible_net_<fact>。事实信息模块将始终从设备收集基本的事实信息集，并且可以启用或禁用其他事实信息的收集。

参数 

参数	注释
available_network_resources 布尔值	当设置为 `true` 时，将提供可用于资源模块的网络资源列表。选择 `false` ← (默认) `true`
gather_network_resources 列表 / 元素=字符串	当提供此参数时，将仅为给定的子集收集配置事实信息。可以指定值列表以包含更大的子集。值也可以与初始 `!` 一起使用，以指定不应收集特定的子集。有效的子集为 `all`、`bfd_interfaces`、`lag_interfaces`、`telemetry`、`vlans`、`lacp`、`lacp_interfaces`、`interfaces`、`l3_interfaces`、`l2_interfaces`、`lldp_global`、`acls`、`acl_interfaces`、`ospfv2`、`ospfv3`、`ospf_interfaces`、`bgp_global`、`bgp_address_family`、`route_maps`、`prefix_lists`、`logging_global`、`ntp_global`、`snmp_server`、`hostname`。
gather_subset 列表 / 元素=字符串	当提供此参数时，将仅为给定的子集收集操作事实信息。此参数的可能值包括 `all`、`hardware`、`config`、`legacy`、`interfaces` 和 `min`。可以指定值列表以包含更大的子集。值也可以与初始 `!` 一起使用，以指定不应收集特定的子集。默认值： `["min"]`

说明 

注意

已在 VIRL 上针对 NXOSv 7.3.(0)D1(1) 进行测试
不支持 Cisco MDS
有关使用 CLI 和 NX-API 的信息，请参阅 :ref:`NXOS 平台选项指南 <nxos_platform_options>`
有关使用 Ansible 管理网络设备的更多信息，请参阅 :ref:`Ansible 网络指南 <network_guide>`
有关使用 Ansible 管理 Cisco 设备的更多信息，请参阅 `Cisco 集成页面 <https://ansible.org.cn/integrations/networks/cisco>`_。

示例 

- name: Gather all legacy facts
  cisco.nxos.nxos_facts:
    gather_subset: all
- name: Gather only the config and default facts
  cisco.nxos.nxos_facts:
    gather_subset:
      - config
- name: Do not gather hardware facts
  cisco.nxos.nxos_facts:
    gather_subset:
      - '!hardware'
- name: Gather legacy and resource facts
  cisco.nxos.nxos_facts:
    gather_subset: all
    gather_network_resources: all
- name: Gather only the interfaces resource facts and no legacy facts
  cisco.nxos.nxos_facts:
    gather_subset:
      - '!all'
      - '!min'
    gather_network_resources:
      - interfaces
- name: Gather interfaces resource and minimal legacy facts
  cisco.nxos.nxos_facts:
    gather_subset: min
    gather_network_resources: interfaces

返回值 

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

键	描述
ansible_net_all_ipv4_addresses 列表 / 元素=字符串	设备上配置的所有 IPv4 地址返回: 当接口配置时
ansible_net_all_ipv6_addresses 列表 / 元素=字符串	设备上配置的所有 IPv6 地址返回: 当接口配置时
ansible_net_api 字符串	传输的名称返回: 总是
ansible_net_config 字符串	来自设备的当前活动配置返回: 当配置被配置时
ansible_net_filesystems 列表 / 元素=字符串	设备上所有可用的文件系统名称返回: 当硬件配置时
ansible_net_gather_network_resources 列表 / 元素=字符串	从设备收集的网络资源子集的 facts 列表返回: 当资源被配置时
ansible_net_gather_subset 列表 / 元素=字符串	从设备收集的 fact 子集列表返回: 总是
ansible_net_hostname 字符串	设备配置的主机名返回: 总是
ansible_net_image 字符串	设备正在运行的镜像文件返回: 总是
ansible_net_interfaces 字典	系统上运行的所有接口的哈希表返回: 当接口配置时
ansible_net_license_hostid 字符串	设备的许可证主机 ID 返回: 总是
ansible_net_memfree_mb 整数	远程设备上可用的空闲内存，单位为 Mb 返回: 当硬件配置时
ansible_net_memtotal_mb 整数	远程设备上的总内存，单位为 Mb 返回: 当硬件配置时
ansible_net_model 字符串	从设备返回的型号名称返回: 总是
ansible_net_neighbors 字典	来自设备的 LLDP 和 CDP 邻居列表。如果一个端口上同时存在 CDP 和 LLDP 邻居数据，则优先选择 CDP。返回: 当接口配置时
ansible_net_python_version 字符串	Ansible 控制器正在使用的 Python 版本返回: 总是
ansible_net_serialnum 字符串	远程设备的序列号返回: 总是
ansible_net_version 字符串	远程设备上运行的操作系统版本返回: 总是
fan_info 字典	关于远程设备中风扇的 facts 哈希表返回: 当配置 legacy 时
hostname 字典	远程设备配置的主机名返回: 当配置 legacy 时
interfaces_list 字典	远程设备上的接口名称列表返回: 当配置 legacy 时
kickstart 字符串	用于启动系统的软件版本返回: 当配置 legacy 时
module 字典	关于远程设备中模块的 facts 哈希表返回: 当配置 legacy 时
platform 字符串	远程设备报告的硬件平台返回: 当配置 legacy 时
power_supply_info 字符串	关于远程设备中电源的 facts 哈希表返回: 当配置 legacy 时
vlan_list 列表 / 元素=字符串	远程设备上配置的 VLAN ID 列表返回: 当配置 legacy 时

作者

Jason Edelman (@jedelman8)
Gabriele Gerbino (@GGabriele)