cisco.asa.asa_facts 模块 – 从运行 Cisco ASA 的远程设备收集事实

注意

此模块是 cisco.asa 集合 (版本 6.0.0) 的一部分。

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

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

要在 playbook 中使用它，请指定：cisco.asa.asa_facts。

注意

cisco.asa 集合已被弃用，并将从 Ansible 12 中删除。有关更多信息，请参阅讨论主题。

cisco.asa 1.0.0 中的新增功能

概要 

从运行 ASA 的远程设备收集基本设备事实集。此模块将所有基本网络事实键加上 ansible_net_<fact> 前缀。事实模块将始终从设备收集基本事实集，并且可以启用或禁用其他事实的收集。
注意，要正确地从 ASA 设备收集事实，用户应提升权限以成为。

参数 

参数	注释
context 字符串	如果您在多上下文模式下运行 ASA，则指定要定位的上下文。默认为您登录的当前上下文。
gather_network_resources 列表 / 元素=字符串	提供此参数时，它将收集的事实限制为给定的子集。此参数的可能值为 all 和诸如接口、VLAN 等资源。可以指定一个值列表以包含更大的子集。值也可以以 `!` 开头使用，以指定不应收集特定的子集。值也可以以 `!` 开头使用，以指定不应收集特定的子集。有效的子集是 ‘all’、‘acls’、‘ogs’。
gather_subset 列表 / 元素=字符串	提供此参数时，它将收集的事实限制为给定的子集。此参数的可能值为 `all`、`min`、`hardware`、`config`。指定一个值列表以包含更大的子集。使用以 `!` 开头的值来收集除该子集之外的所有事实。默认值： `["!config"]`
passwords 布尔值	设置为 True 时，保存以纯文本形式运行的配置密码。默认为 False 选项 `false` `true`

备注 

注意

针对 asa 9.10(1)11 进行了测试
有关使用 Ansible 管理网络设备的更多信息，请参阅：ref:`Ansible 网络指南 <network_guide>`

示例 

- name: Gather all legacy facts
  cisco.asa.asa_facts:
    gather_subset: all

- name: Gather only the config and default facts
  cisco.asa.asa_facts:
    gather_subset:
      - config

- name: Do not gather hardware facts
  cisco.asa.asa_facts:
    gather_subset:
      - '!hardware'

- name: Gather legacy and resource facts
  cisco.asa.asa_facts:
    gather_subset: all

返回值 

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

键	描述
ansible_net_api 字符串	传输的名称返回：始终
ansible_net_asatype 字符串	远程设备上运行的操作系统类型（Cisco ASA）。返回：始终
ansible_net_config 字符串	设备的当前活动配置返回：配置 config 时
ansible_net_device_mgr_version 字符串	远程设备上运行的设备管理器版本。返回：始终
ansible_net_filesystems 列表 / 元素=字符串	设备上可用的所有文件系统名称返回：配置 hardware 时
ansible_net_filesystems_info 字典	包含有关每个文件系统的信息（例如可用空间和总空间）的所有文件系统的哈希表返回：配置 hardware 时
ansible_net_firepower_version 字符串	远程设备上运行的 Firepower 操作系统版本。返回：始终
ansible_net_gather_subset 列表 / 元素=字符串	从设备收集的事实子集列表返回：始终
ansible_net_hostname 字符串	设备的已配置主机名返回：始终
ansible_net_image 字符串	设备正在运行的映像文件返回：始终
ansible_net_memfree_mb 整数	远程设备上以 MB 为单位的可用空闲内存返回：配置 hardware 时
ansible_net_memtotal_mb 整数	远程设备上以 MB 为单位的总内存返回：配置 hardware 时
ansible_net_memused_mb 整数	远程设备上以 MB 为单位的已用内存返回：配置 hardware 时
ansible_net_model 字符串	设备返回的型号名称返回：始终
ansible_net_python_version 字符串	Ansible 控制器正在使用的 Python 版本返回：始终
ansible_net_serialnum 字符串	远程设备的序列号返回：始终
ansible_net_stacked_models 列表 / 元素=字符串	堆栈中每个设备的型号名称返回：在堆栈中配置多个设备时
ansible_net_stacked_serialnums 列表 / 元素=字符串	堆栈中每个设备的序列号返回：在堆栈中配置多个设备时
ansible_net_version 字符串	远程设备上运行的操作系统版本返回：始终

作者

Sumit Jaiswal (@justjais)