community.general.zpool_facts – Сбор фактов о пулах ZFS.
Примечание
Этот плагин входит в коллекцию community.general (версия 2.0.1).
Для его установки используйте: ansible-galaxy collection install community.general.
Для использования в плейбуке укажите: community.general.zpool_facts.
Обзор
- Сбор фактов из свойств пула ZFS.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| name строка | Имя пула ZFS. алиасы: pool, zpool | |
| parsable булево |
| Указывает, следует ли отображать значения свойств в удобном для обработки формате. |
| properties строка | По умолчанию: "all" | Указывает, какие свойства наборов данных следует запрашивать в формате, разделенном запятыми. Дополнительную информацию о свойствах наборов данных см. в руководстве man для zpool(1M). |
Примеры
- 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.46ГБ', 'altroot': '-', 'autoexpand': 'выкл.', 'autoreplace': 'выкл.', 'bootfs': 'rpool/ROOT/openindiana', 'cachefile': '-', 'capacity': '6%', 'comment': '-', 'dedupditto': '0', 'dedupratio': '1.00x', 'delegation': 'вкл.', 'expandsize': '-', 'failmode': 'ожидание', 'feature@async_destroy': 'включено', 'feature@bookmarks': 'включено', 'feature@edonr': 'включено', 'feature@embedded_data': 'активно', 'feature@empty_bpobj': 'активно', 'feature@enabled_txg': 'активно', 'feature@extensible_dataset': 'включено', 'feature@filesystem_limits': 'включено', 'feature@hole_birth': 'активно', 'feature@large_blocks': 'включено', 'feature@lz4_compress': 'активно', 'feature@multi_vdev_crash_dump': 'включено', 'feature@sha512': 'включено', 'feature@skein': 'включено', 'feature@spacemap_histogram': 'активно', 'fragmentation': '3%', 'free': '46.3ГБ', 'freeing': '0', 'guid': '15729052870819522408', 'health': 'ВСЕГДА', 'leaked': '0', 'listsnapshots': 'выкл.', 'name': 'rpool', 'readonly': 'выкл.', 'size': '49.8ГБ', 'version': '-'} |
Значения возврата
Общие значения возврата описаны в здесь, следующие — это поля, уникальные для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| name строка | всегда | Имя пула ZFS Пример: rpool |
| parsable булево | если 'parsable' установлено в True | если выводимые данные должны предоставляться в формате, удобном для обработки. Пример: True |
Авторы
- Adam Števko (@xen0l)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/zpool_facts_module.html