Модуль community.general.zfs_facts — Сбор данных о наборах данных ZFS

Примечание

Этот модуль является частью коллекции community.general (версия 9.5.0).

У вас, возможно, уже установлена эта коллекция, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Чтобы установить ее, используйте: ansible-galaxy collection install community.general.

Чтобы использовать ее в книге задач, укажите: community.general.zfs_facts.

Описание
Параметры
Атрибуты
Примеры
Возвращаемые значения

Описание

Сбор данных из свойств наборов данных ZFS.

Параметры

Параметр	Комментарии
depth целое число	Указывает глубину рекурсии. По умолчанию: `0`
имя псевдонимы: ds, набор данных строка / обязательный	Имя набора данных ZFS.
parsable булево	Указывает, следует ли отображать значения свойств в формате, удобном для обработки машиной. Варианты: `false` ← (по умолчанию) `true`
properties строка	Указывает, какие свойства набора данных следует запросить в формате, разделенном запятыми. Более подробную информацию о свойствах набора данных см. в справке man zfs(1M). По умолчанию: `"all"`
recurse булево	Указывает, следует ли рекурсивно отображать свойства для дочерних элементов. Варианты: `false` ← (по умолчанию) `true`
тип строка	Указывает типы наборов данных для отображения. Несколько значений должны быть предоставлены в виде строки, разделенной запятыми. Варианты: `"all"` ← (по умолчанию) `"filesystem"` `"volume"` `"snapshot"` `"bookmark"`

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная Это действие не изменяет состояние.	Может выполняться в режиме `check_mode` и возвращать прогноз измененного статуса без изменения целевого объекта.
diff_mode	Поддержка: Нет Это действие не изменяет состояние.	Вернет подробности о том, что изменилось (или, возможно, что нужно изменить в `check_mode`), когда режим отличается.
facts	Поддержка: полная	Действие возвращает словарь `ansible_facts`, который обновит существующие фактические данные хоста.

Примеры

- name: Gather facts about ZFS dataset rpool/export/home
  community.general.zfs_facts:
    dataset: rpool/export/home

- name: Report space usage on ZFS filesystems under data/home
  community.general.zfs_facts:
    name: data/home
    recurse: true
    type: filesystem

- ansible.builtin.debug:
    msg: 'ZFS dataset {{ item.name }} consumes {{ item.used }} of disk space.'
  with_items: '{{ ansible_zfs_datasets }}'

END_OF_DOCUMENT_MARKER

Значения возврата

Общие значения возврата документированы здесь, следующие поля уникальны для данного модуля:

Ключ	Описание
name строка	Имя набора данных ZFS Возвращается: всегда Пример: `"rpool/var/spool"`
parsable логический	если выводимые данные должны быть предоставлены в формате, удобном для машинного анализа. Возвращается: если ‘parsable’ установлено в True Пример: `true`
recurse логический	если необходимо выполнить рекурсивный поиск по набору данных ZFS Возвращается: если ‘recurse’ установлено в True Пример: `true`
zfs_datasets строка	Данные фактов о наборах данных ZFS Возвращается: всегда Пример: "{'aclinherit': 'restricted', 'aclmode': 'discard', 'atime': 'on', 'available': '43.8G', 'canmount': 'on', 'casesensitivity': 'sensitive', 'checksum': 'on', 'compression': 'off', 'compressratio': '1.00x', 'copies': '1', 'creation': 'Thu Jun 16 11:37 2016', 'dedup': 'off', 'devices': 'on', 'exec': 'on', 'filesystem_count': 'none', 'filesystem_limit': 'none', 'logbias': 'latency', 'logicalreferenced': '18.5K', 'logicalused': '3.45G', 'mlslabel': 'none', 'mounted': 'yes', 'mountpoint': '/rpool', 'name': 'rpool', 'nbmand': 'off', 'normalization': 'none', 'org.openindiana.caiman:install': 'ready', 'primarycache': 'all', 'quota': 'none', 'readonly': 'off', 'recordsize': '128K', 'redundant_metadata': 'all', 'refcompressratio': '1.00x', 'referenced': '29.5K', 'refquota': 'none', 'refreservation': 'none', 'reservation': 'none', 'secondarycache': 'all', 'setuid': 'on', 'sharenfs': 'off', 'sharesmb': 'off', 'snapdir': 'hidden', 'snapshot_count': 'none', 'snapshot_limit': 'none', 'sync': 'standard', 'type': 'filesystem', 'used': '4.41G', 'usedbychildren': '4.41G', 'usedbydataset': '29.5K', 'usedbyrefreservation': '0', 'usedbysnapshots': '0', 'utf8only': 'off', 'version': '5', 'vscan': 'off', 'written': '29.5K', 'xattr': 'on', 'zoned': 'off'}"

Авторы

Adam Števko (@xen0l)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/zfs_facts_module.html