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 存储设备版本 5.1 或更高版本。

• Ansible-core 2.14 或更高版本。

• Python 3.9、3.10 或 3.11。

• Storops Python SDK 1.2.11。

参数

参数	注释
cap_unit 字符串	soft_limit 和 hard_limit 大小的单位。 如果未指定，则默认为 GB。 选项 "MB" "GB" "TB"
description 字符串	配额树的描述。
filesystem_id 字符串	创建配额树的文件系统的 ID。 要创建配额树，需要 filesystem_id 或 filesystem_name 之一。
filesystem_name 字符串	创建配额树的文件系统的名称。 要创建或修改配额树，需要 filesystem_name 或 filesystem_id 之一。
hard_limit 整数	配额树对可用总空间的硬限制。如果超过此限制，配额树中的用户将无法写入数据。 值 0 表示无限制。 soft_limit 和 hard_limit 的值之一可以为 0，但在创建配额树时，两者都不能同时为 0。
nas_server_id 字符串	创建文件系统的 NAS 服务器的 ID。 要创建配额树，需要 filesystem_id 或 filesystem_name 之一。
nas_server_name 字符串	创建文件系统的 NAS 服务器的名称。 要创建配额树，需要 nas_server_name 或 nas_server_id 之一。
password 字符串 / 必需	Unity 管理服务器的密码。
path 字符串	配额树的路径。 需要 tree_quota_id 或配额树的 path 来创建/查看/修改/删除配额树。 路径必须以正斜杠“/”开头。
port 整数	与 Unity 管理服务器通信的端口号。 默认值： 443
soft_limit 整数	配额树对可用总空间的软限制。如果超过此限制，系统会在规定的宽限期内向配额树中的用户发送通知，超过宽限期后，用户将无法使用空间。 值 0 表示无限制。 在创建配额树时，soft_limit 和 hard_limit 都不能为 0。
state 字符串 / 必需	state 选项用于说明文件系统配额树的存在。 选项 "absent" "present"
tree_quota_id 字符串	配额树的 ID。 需要 tree_quota_id 或配额树的 path 来查看/修改/删除配额树。
unispherehost 字符串 / 必需	Unity 管理服务器的 IP 或 FQDN。
username 字符串 / 必需	Unity 管理服务器的用户名。
validate_certs 别名：verifycert 布尔值	布尔变量，用于指定是否验证 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 布尔值	资源是否已更改。 返回：始终 示例： true
get_tree_quota_details 字典	配额树的详细信息。 返回：当配额树存在时 示例： {"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 字符串	配额树的描述。 返回：成功
文件系统 字典	为其创建配额树的文件系统详细信息。 返回：成功
UnityFileSystem 字典	为其创建配额树的文件系统详细信息。 返回：成功
ID 字符串	为其创建配额树的文件系统的ID。 返回：成功
gp_left 整数	超过用户配额的软限制后剩余的宽限期。 返回：成功
hard_limit 整数	配额树的硬限制。如果配额树的空间使用量超过硬限制，则配额树中的用户将无法写入数据。 返回：成功
ID 字符串	配额树ID。 返回：成功
path 字符串	配额树的路径。有效的路径必须以正斜杠“/”开头。创建配额树时，这是必需的。 返回：成功
size_used 整数	用户文件在文件系统中使用的空间大小。 返回：成功
soft_limit 整数	配额树的软限制。如果配额树的空间使用量超过软限制，则存储系统将根据指定的宽限期开始倒计时。 返回：成功
state 整数	配额树的状态。 返回：成功

作者

• Spandita Panigrahi (@panigs7)

资源链接

• 问题跟踪器
• 代码库（源代码）