arista.eos.eos_facts 模块 – 从运行 Arista EOS 的远程设备收集事实

注意

此模块是 arista.eos 集合 (版本 10.0.1) 的一部分。

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

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

要在 playbook 中使用它，请指定：arista.eos.eos_facts。

arista.eos 1.0.0 中的新增功能

概要

  • 从运行 EOS 操作系统的 Arista 设备收集事实。此模块将收集到的事实放置在由相应资源名称作为键的事实树中。事实模块将始终从设备收集一组基本事实，并且可以启用或禁用其他事实的收集。

参数

参数

注释

available_network_resources

布尔值

当为“True”时，将提供可用于资源模块的网络资源列表。

选项

  • false ← (默认)

  • true

gather_network_resources

列表 / 元素=字符串

提供此参数时，它将收集的事实限制为给定的子集。此参数的可能值包括 all 和诸如 interfaces、vlans 等资源。可以指定一个值列表以包含更大的子集。值也可以与初始 ! 一起使用，以指定不应收集特定子集。值也可以与初始 ! 一起使用，以指定不应收集特定子集。有效的子集是 'all'、'interfaces'、'l2_interfaces'、'l3_interfaces'、'lacp'、'lacp_interfaces'、'lag_interfaces'、'lldp_global'、'lldp_interfaces'、'vlans'、'acls'。

gather_subset

列表 / 元素=字符串

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

默认值： ["min"]

示例

- name: Gather all legacy facts
- arista.eos.eos_facts:
    gather_subset: all

- name: Gather only the config and default facts
  arista.eos.eos_facts:
    gather_subset:
      - config

- name: Do not gather hardware facts
  arista.eos.eos_facts:
    gather_subset:
      - '!hardware'

- name: Gather legacy and resource facts
  arista.eos.eos_facts:
    gather_subset: all
    gather_network_resources: all

- name: Gather only the interfaces resource facts and no legacy facts
- arista.eos.eos_facts:
    gather_subset:
      - '!all'
      - '!min'
    gather_network_resources:
      - interfaces

- name: Gather all resource facts and minimal legacy facts
  arista.eos.eos_facts:
    gather_subset: min
    gather_network_resources: all

返回值

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

键

描述

ansible_net_all_ipv4_addresses

列表 / 元素=字符串

设备上配置的所有 IPv4 地址

返回：当配置 interfaces 时

ansible_net_all_ipv6_addresses

列表 / 元素=字符串

设备上配置的所有 IPv6 地址

返回：当配置 interfaces 时

ansible_net_api

字符串

传输的名称

返回：始终返回

ansible_net_config

字符串

设备的当前活动配置

返回：当配置 config 时

ansible_net_filesystems

列表 / 元素=字符串

设备上可用的所有文件系统名称

返回：当配置 hardware 时

ansible_net_fqdn

字符串

设备的完全限定域名

返回：始终返回

ansible_net_gather_network_resources

列表 / 元素=字符串

从设备收集的网络资源子集的事实列表

返回：当配置资源时

ansible_net_gather_subset

列表 / 元素=字符串

从设备收集的事实子集列表

返回：始终返回

ansible_net_hostname

字符串

设备的配置主机名

返回：始终返回

ansible_net_image

字符串

设备正在运行的镜像文件

返回：始终返回

ansible_net_interfaces

字典

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

返回：当配置 interfaces 时

ansible_net_memfree_mb

整数

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

返回：当配置 hardware 时

ansible_net_memtotal_mb

整数

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

返回：当配置 hardware 时

ansible_net_model

字符串

从设备返回的型号名称

返回：始终返回

ansible_net_neighbors

字典

远程设备的 LLDP 邻居列表

返回：当配置 interfaces 时

ansible_net_python_version

字符串

Ansible 控制器正在使用的 Python 版本

返回：始终返回

ansible_net_serialnum

字符串

远程设备的序列号

返回：始终返回

ansible_net_version

字符串

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

返回：始终返回

作者

  • Peter Sprygada (@privateip)

  • Nathaniel Case (@Qalthos)