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

Примечание

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

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

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

Для использования в playbook, укажите: dellemc.unity.tree_quota.

Новое в dellemc.unity 1.2.0

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

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

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

Требования

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

Устройство хранения Dell Unity Storage версии 5.1 или выше.
Ansible-core 2.14 или выше.
Python 3.9, 3.10 или 3.11.
Storops Python SDK 1.2.11.

Параметры

Параметр	Комментарии
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 / required	Пароль сервера управления Unity.
path string	Путь к дереву квот. Для создания/просмотра/изменения/удаления дерева квот требуется либо tree_quota_id, либо path к дереву квот. Путь должен начинаться с прямой косой черты ‘/’.
port integer	Номер порта, через который осуществляется связь с сервером управления Unity. По умолчанию: `443`
soft_limit integer	Мягкое ограничение для дерева квот на общее доступное пространство. При превышении этого предела пользователям в дереве квот будет отправлено уведомление в течение указанного льготного периода, после которого пользователи не смогут использовать пространство. Значение `0` означает отсутствие предела. Оба значения soft_limit и hard_limit не могут быть `0` во время создания дерева квот.
state string / required	Параметр state используется для указания существования файловой квоты. Варианты: `"absent"` `"present"`
tree_quota_id string	Идентификатор дерева квот. Для просмотра/изменения/удаления дерева квот требуется либо tree_quota_id, либо path к дереву квот.
unispherehost string / required	IP-адрес или FQDN сервера управления Unity.
username string / required	Имя пользователя сервера управления Unity.
validate_certs aliases: verifycert boolean	Булева переменная, указывающая, следует ли проверять SSL-сертификат. `true` - Указывает, что SSL-сертификат должен быть проверен. `false` - Указывает, что SSL-сертификат не должен быть проверен. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

check_mode не поддерживается.
Модули, присутствующие в этой коллекции под названием ‘dellemc.unity’, разработаны для поддержки платформы хранения Dell Unity.

Примеры

- name: Get quota tree details by quota tree id
  dellemc.unity.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
  dellemc.unity.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
  dellemc.unity.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
  dellemc.unity.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
  dellemc.unity.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
  dellemc.unity.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
  dellemc.unity.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
  dellemc.unity.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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/dellemc/unity/tree_quota_module.html