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

注意

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

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

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

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

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)