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 设备收集信息。 此模块将收集到的信息放置在以相应资源名称为键的事实树中。 facts 模块将始终从设备收集一组基本信息，并且可以启用或禁用其他信息的收集。

参数

参数

注释

available_network_resources

boolean

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

选择

  • false ← (默认)

  • true

gather_network_resources

list / elements=string

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

gather_subset

list / elements=string

提供此参数后，此参数将把收集的信息限制为给定的子集。 此参数的可能值包括 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

list / elements=string

设备上配置的所有 IPv4 地址

已返回：当配置 interfaces 时

ansible_net_all_ipv6_addresses

list / elements=string

设备上配置的所有 IPv6 地址

已返回：当配置 interfaces 时

ansible_net_api

string

传输的名称

已返回：始终

ansible_net_config

string

来自设备的当前活动配置

已返回：当配置 config 时

ansible_net_filesystems

list / elements=string

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

已返回：当配置 hardware 时

ansible_net_fqdn

string

设备的完全限定域名

已返回：始终

ansible_net_gather_network_resources

list / elements=string

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

已返回：当配置资源时

ansible_net_gather_subset

list / elements=string

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

已返回：始终

ansible_net_hostname

string

设备的已配置主机名

已返回：始终

ansible_net_image

string

设备正在运行的镜像文件

已返回：始终

ansible_net_interfaces

dictionary

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

已返回：当配置 interfaces 时

ansible_net_memfree_mb

integer

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

已返回：当配置 hardware 时

ansible_net_memtotal_mb

integer

远程设备上以 Mb 为单位的总内存

已返回：当配置 hardware 时

ansible_net_model

string

从设备返回的型号名称

已返回：始终

ansible_net_neighbors

dictionary

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

已返回：当配置 interfaces 时

ansible_net_python_version

string

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

已返回：始终

ansible_net_serialnum

string

远程设备的序列号

已返回：始终

ansible_net_version

string

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

已返回：始终

作者

  • Peter Sprygada (@privateip)

  • Nathaniel Case (@Qalthos)