community.network.ordnance_facts 模块 – 通过 SSH 收集 Ordnance 虚拟路由器的 facts

注意

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

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

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

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

注意

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

已弃用

在以下版本中移除:

6.0.0 版本

原因:

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

替代方案:

未知。

概要

  • 通过 SSH 从 Ordnance 虚拟路由器收集一组基本的设备 facts。此模块将所有基本网络 fact 键名前缀加上 ansible_net_<fact>。facts 模块将始终从设备收集一组基本的 facts,并且可以启用或禁用其他 facts 的收集。

别名:network.ordnance.ordnance_facts

参数

参数

注释

gather_subset

字符串

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

默认值: "!config"

示例

---
# Note: examples below use the following provider dict to handle
#       transport and authentication to the node.
vars:
  cli:
    host: "{{ inventory_hostname }}"
    username: RouterName
    password: ordnance
    transport: cli

---
- name: Collect all facts from the device
  community.network.ordnance_facts:
    gather_subset: all
    provider: "{{ cli }}"

- name: Collect only the config and default facts
  community.network.ordnance_facts:
    gather_subset:
      - config
    provider: "{{ cli }}"

- name: Do not collect hardware facts
  community.network.ordnance_facts:
    gather_subset:
      - "!hardware"
    provider: "{{ cli }}"

返回值

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

描述

ansible_net_all_ipv4_addresses

列表 / 元素=字符串

在虚拟路由器上配置的所有 IPv4 地址

返回:当配置 interfaces 时

ansible_net_all_ipv6_addresses

列表 / 元素=字符串

在虚拟路由器上配置的所有 IPv6 地址

返回:当配置 interfaces 时

ansible_net_config

字符串

虚拟路由器当前活动的配置

返回:当配置 config 时

ansible_net_gather_subset

列表 / 元素=字符串

从虚拟路由器收集的 fact 子集列表

返回:始终返回

ansible_net_interfaces

字典

虚拟路由器上运行的所有接口的哈希表

返回:当配置 interfaces 时

状态

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

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

作者

  • Alexander Turner (@alexanderturner)