Модуль dellemc.unity.tree_quota — управление деревом квот в системе хранения Unity

Примечание

Этот модуль входит в коллекцию dellemc.unity (версия 2.1.0).

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

Для установки используйте: ansible-galaxy collection install dellemc.unity. Для работы с этим модулем требуются дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: dellemc.unity.tree_quota.

Добавлено в dellemc.unity 1.2.0

Краткое описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Краткое описание

Управление деревом квот в системе хранения Unity включает создание, получение, изменение и удаление дерева квот.

Требования

На хосте, выполняющем этот модуль, должны быть установлены следующие компоненты.

Устройство Dell Unity Storage версии 5.3 или более поздней.
Ansible-core 2.17 или более поздней версии.
Python 3.11, 3.12 или 3.13.
Storops Python SDK 1.2.12.

Параметры

Параметр	Описание
cap_unit string	Единица измерения размера параметров soft_limit и hard_limit. Если параметр не указан, по умолчанию используется `GB`. Допустимые значения: `"MB"` `"GB"` `"TB"`
description string	Описание дерева квот.
filesystem_id string	Идентификатор файловой системы, для которой создается дерево квот. Для создания дерева квот необходимо указать либо filesystem_id, либо filesystem_name.
filesystem_name string	Имя файловой системы, для которой создается дерево квот. Для создания или изменения дерева квот необходимо указать либо filesystem_name, либо filesystem_id.
hard_limit integer	Жесткое ограничение общего доступного пространства для дерева квот. При превышении этого ограничения пользователи дерева квот не смогут записывать данные. Значение `0` означает отсутствие ограничения. Параметр soft_limit или hard_limit может иметь значение `0`, однако при создании дерева квот оба параметра не могут одновременно иметь значение `0`.
nas_server_id string	Идентификатор NAS-сервера, на котором создана файловая система. Для создания дерева квот необходимо указать либо filesystem_id, либо filesystem_name.
nas_server_name string	Имя NAS-сервера, на котором создана файловая система. Для создания дерева квот необходимо указать либо nas_server_name, либо nas_server_id.
password string / обязательный	Пароль сервера управления Unity.
path string	Путь к дереву квот. Для создания, просмотра, изменения или удаления дерева квот необходимо указать либо tree_quota_id, либо path. Путь должен начинаться с косой черты «/».
port integer	Номер порта для связи с сервером управления Unity. По умолчанию: `443`
soft_limit integer	Мягкое ограничение общего доступного пространства для дерева квот. При его превышении пользователи дерева квот получат уведомление. По истечении указанного льготного периода пользователи не смогут использовать пространство. Значение `0` означает отсутствие ограничения. При создании дерева квот параметры soft_limit и hard_limit не могут одновременно иметь значение `0`.
state string / обязательный	Параметр state указывает, должно ли существовать дерево квот файловой системы. Допустимые значения: `"absent"` `"present"`
tree_quota_id string	Идентификатор дерева квот. Для просмотра, изменения или удаления дерева квот необходимо указать либо tree_quota_id, либо path.
unispherehost string / обязательный	IP-адрес или FQDN сервера управления Unity.
username string / обязательный	Имя пользователя сервера управления Unity.
validate_certs псевдонимы: verifycert boolean	Логическая переменная, указывающая, нужно ли проверять SSL-сертификат. `true` — указывает, что SSL-сертификат необходимо проверить. `false` — указывает, что SSL-сертификат проверять не нужно. Допустимые значения: `false` `true` ← (значение по умолчанию)

Примечания

Примечание

Режим check_mode не поддерживается.
Модули этой коллекции под названием «dellemc.unity» предназначены для поддержки платформы хранения Dell Unity.

Примеры

- name: Get quota tree details by quota tree id
  tree_quota:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    tree_quota_id: "treequota_171798700679_10"
    state: "present"

- name: Get quota tree details by quota tree path
  tree_quota:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    filesystem_name: "fs_2171"
    nas_server_id: "nas_21"
    path: "/test"
    state: "present"

- name: Create quota tree for a filesystem with filesystem id
  tree_quota:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    filesystem_id: "fs_2171"
    hard_limit: 6
    cap_unit: "TB"
    soft_limit: 5
    path: "/test_new"
    state: "present"

- name: Create quota tree for a filesystem with filesystem name
  tree_quota:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    filesystem_name: "Test_filesystem"
    nas_server_name: "lglad068"
    hard_limit: 6
    cap_unit: "TB"
    soft_limit: 5
    path: "/test_new"
    state: "present"

- name: Modify quota tree limit usage by quota tree path
  tree_quota:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    path: "/test_new"
    hard_limit: 10
    cap_unit: "TB"
    soft_limit: 8
    state: "present"

- name: Modify quota tree by quota tree id
  tree_quota:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    filesystem_id: "fs_2171"
    tree_quota_id: "treequota_171798700679_10"
    hard_limit: 12
    cap_unit: "TB"
    soft_limit: 10
    state: "present"

- name: Delete quota tree by quota tree id
  tree_quota:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    filesystem_id: "fs_2171"
    tree_quota_id: "treequota_171798700679_10"
    state: "absent"

- name: Delete quota tree by path
  tree_quota:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    filesystem_id: "fs_2171"
    path: "/test_new"
    state: "absent"

Возвращаемые значения

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

Ключ	Описание
changed boolean	Изменился ли ресурс. Возвращается: всегда Пример: `true`
get_tree_quota_details dictionary	Сведения о дереве квот. Возвращается: если дерево квот существует Пример: `{"description": "", "existed": true, "filesystem": {"UnityFileSystem": {"hash": 8788549469862, "id": "fs_137", "name": "test", "nas_server": {"id": "nas_1", "name": "lglad072"}}}, "gp_left": null, "hard_limit": "6.0 TB", "hash": 8788549497558, "id": "treequota_171798694897_1", "path": "VALUE_SPECIFIED_IN_NO_LOG_PARAMETER", "size_used": 0, "soft_limit": "5.0 TB", "state": 0}`
description string	Описание дерева квот. Возвращается: при успешном выполнении
filesystem dictionary	Сведения о файловой системе, для которой создано дерево квот. Возвращается: при успешном выполнении
UnityFileSystem dictionary	Сведения о файловой системе, для которой создано дерево квот. Возвращается: при успешном выполнении
id string	Идентификатор файловой системы, для которой создано дерево квот. Возвращается: при успешном выполнении
gp_left integer	Оставшийся льготный период после превышения мягкого ограничения квоты пользователя. Возвращается: при успешном выполнении
hard_limit integer	Жесткое ограничение дерева квот. Если использование пространства деревом квот превышает жесткое ограничение, пользователи дерева квот не смогут записывать данные. Возвращается: при успешном выполнении
id string	Идентификатор дерева квот. Возвращается: при успешном выполнении
path string	Путь к дереву квот. Допустимый путь должен начинаться с косой черты «/». Этот параметр обязателен при создании дерева квот. Возвращается: при успешном выполнении
size_used integer	Объем пространства файловой системы, занятый файлами пользователя. Возвращается: при успешном выполнении
soft_limit integer	Мягкое ограничение дерева квот. Если использование пространства деревом квот превышает мягкое ограничение, система хранения начинает обратный отсчет в соответствии с заданным льготным периодом. Возвращается: при успешном выполнении
state integer	Состояние дерева квот. Возвращается: при успешном выполнении

Авторы

Spandita Panigrahi (@panigs7)

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

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/dellemc/unity/tree_quota_module.html