community.general.zpool_facts 模块 – 收集有关 ZFS 池的事实

注意

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

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

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

要在 playbook 中使用它，请指定： community.general.zpool_facts。

概要

  • 收集 ZFS 池属性的事实。

参数

参数

注释

name

别名：pool, zpool

字符串

ZFS 池名称。

parsable

布尔值

指定是否应以机器友好的格式显示属性值。

选项

  • false ← (默认)

  • true

properties

字符串

指定应以逗号分隔的格式查询哪些数据集属性。有关数据集属性的更多信息，请查看 zpool(1M) 手册页。

默认值： "all"

属性

属性

支持

描述

check_mode

支持：完全支持

此操作不会修改状态。

可以在 check_mode 中运行并返回更改状态预测，而无需修改目标。

diff_mode

支持： N/A

此操作不会修改状态。

处于 diff 模式时，将返回有关已更改内容（或可能需要在 check_mode 中更改）的详细信息。

facts

支持：完全支持

操作返回一个 ansible_facts 字典，该字典将更新现有的主机事实。

示例

- name: Gather facts about ZFS pool rpool
  community.general.zpool_facts: pool=rpool

- name: Gather space usage about all imported ZFS pools
  community.general.zpool_facts: properties='free,size'

- name: Print gathered information
  ansible.builtin.debug:
    msg: 'ZFS pool {{ item.name }} has {{ item.free }} free space out of {{ item.size }}.'
  with_items: '{{ ansible_zfs_pools }}'

返回的事实

此模块返回的事实会添加到/更新 hostvars 主机事实中，并且可以像任何其他主机事实一样按名称引用。它们无需注册即可使用。

键

描述

ansible_zfs_pools

字符串

ZFS 池事实

返回：始终

示例： "{'allocated': '3.46G', 'altroot': '-', 'autoexpand': 'off', 'autoreplace': 'off', 'bootfs': 'rpool/ROOT/openindiana', 'cachefile': '-', 'capacity': '6%', 'comment': '-', 'dedupditto': '0', 'dedupratio': '1.00x', 'delegation': 'on', 'expandsize': '-', 'failmode': 'wait', 'feature@async_destroy': 'enabled', 'feature@bookmarks': 'enabled', 'feature@edonr': 'enabled', 'feature@embedded_data': 'active', 'feature@empty_bpobj': 'active', 'feature@enabled_txg': 'active', 'feature@extensible_dataset': 'enabled', 'feature@filesystem_limits': 'enabled', 'feature@hole_birth': 'active', 'feature@large_blocks': 'enabled', 'feature@lz4_compress': 'active', 'feature@multi_vdev_crash_dump': 'enabled', 'feature@sha512': 'enabled', 'feature@skein': 'enabled', 'feature@spacemap_histogram': 'active', 'fragmentation': '3%', 'free': '46.3G', 'freeing': '0', 'guid': '15729052870819522408', 'health': 'ONLINE', 'leaked': '0', 'listsnapshots': 'off', 'name': 'rpool', 'readonly': 'off', 'size': '49.8G', 'version': '-'}"

返回值

常用返回值已在此处说明，以下是此模块独有的字段

键

描述

name

字符串

ZFS 池名称

返回：始终

示例： "rpool"

parsable

布尔值

如果应以机器友好的格式提供可解析的输出。

返回：如果将‘parsable’设置为 True

示例： true

作者

  • Adam Števko (@xen0l)