Try SpotterManage quota tree on the Unity storage system
| "added in version" 1.2.0 of dellemc.unity"
Authors: Spandita Panigrahi (@panigs7) <ansible.team@dell.com>
preview | supported by community
Install with ansible-galaxy collection install dellemc.unity:==1.2.1
collections:
- name: dellemc.unity
version: 1.2.1Managing Quota tree on the Unity storage system includes Create quota tree, Get quota tree, Modify quota tree and Delete quota tree.
- name: Get quota tree details by quota tree id
dellemc.unity.dellemc_unity_tree_quota:
unispherehost: "{{unispherehost}}"
username: "{{username}}"
password: "{{password}}"
verifycert: "{{verifycert}}"
quota_tree_id: "treequota_171798700679_10"
state: "present"
- name: Get quota tree details by quota tree path
dellemc.unity.dellemc_unity_tree_quota:
unispherehost: "{{unispherehost}}"
username: "{{username}}"
password: "{{password}}"
verifycert: "{{verifycert}}"
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.dellemc_unity_tree_quota:
unispherehost: "{{unispherehost}}"
username: "{{username}}"
password: "{{password}}"
verifycert: "{{verifycert}}"
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.dellemc_unity_tree_quota:
unispherehost: "{{unispherehost}}"
username: "{{username}}"
password: "{{password}}"
verifycert: "{{verifycert}}"
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.dellemc_unity_tree_quota:
unispherehost: "{{unispherehost}}"
username: "{{username}}"
password: "{{password}}"
verifycert: "{{verifycert}}"
path: "/test_new"
hard_limit: 10
cap_unit: "TB"
soft_limit: 8
state: "present"
- name: Modify quota tree by quota tree id
dellemc.unity.dellemc_unity_tree_quota:
unispherehost: "{{unispherehost}}"
username: "{{username}}"
password: "{{password}}"
verifycert: "{{verifycert}}"
filesystem_id: "fs_2171"
quota_tree_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.dellemc_unity_tree_quota:
unispherehost: "{{unispherehost}}"
username: "{{username}}"
password: "{{password}}"
verifycert: "{{verifycert}}"
filesystem_id: "fs_2171"
quota_tree_id: "treequota_171798700679_10"
state: "absent"
- name: Delete quota tree by path
dellemc.unity.dellemc_unity_tree_quota:
unispherehost: "{{unispherehost}}"
username: "{{username}}"
password: "{{password}}"
verifycert: "{{verifycert}}"
filesystem_id: "fs_2171"
path: "/test_new"
state: "absent"
path:
description:
- The path to the quota tree.
- Either tree_quota_id or path to quota tree is required to create/view/modify/delete
a quota tree.
- Path must start with a forward slash '/'.
type: str
port:
default: 443
description:
- Port number through which communication happens with Unity management server.
required: false
type: int
state:
choices:
- absent
- present
description:
- The state option is used to mention the existence of the filesystem quota tree.
required: true
type: str
cap_unit:
choices:
- MB
- GB
- TB
description:
- Unit of soft_limit and hard_limit size.
- It defaults to 'GB' if not specified.
type: str
password:
description:
- The password of the Unity management server.
required: true
type: str
username:
description:
- The username of the Unity management server.
required: true
type: str
hard_limit:
description:
- Hard limitation for a quota tree on the total space available. If exceeded, users
in quota tree cannot write data.
- Value 0 implies no limit.
- One of the values of soft_limit and hard_limit can be 0, however, both cannot be
both 0 during creation of a quota tree.
type: int
soft_limit:
description:
- Soft limitation for a quota tree on the total space available. If exceeded, notification
will be sent to users in the quota tree for the grace period mentioned, beyond which
users cannot use space.
- Value 0 implies no limit.
- Both soft_limit and hard_limit cannot be 0 during creation of quota tree.
type: int
verifycert:
choices:
- true
- false
default: true
description:
- Boolean variable to specify whether or not to validate SSL certificate.
- True - Indicates that the SSL certificate should be verified.
- False - Indicates that the SSL certificate should not be verified.
required: false
type: bool
description:
description:
- Description of a quota tree.
type: str
filesystem_id:
description:
- The ID of the filesystem for which the quota tree is created.
- For creation of a quota tree either filesystem_id or filesystem_name is required.
type: str
nas_server_id:
description:
- The ID of the NAS server in which the filesystem is created.
- For creation of a quota tree either filesystem_id or filesystem_name is required.
type: str
tree_quota_id:
description:
- The ID of the quota tree.
- Either tree_quota_id or path to quota tree is required to view/modify/delete quota
tree.
type: str
unispherehost:
description:
- IP or FQDN of the Unity management server.
required: true
type: str
filesystem_name:
description:
- The name of the filesystem for which quota tree is created.
- For creation or modification of a quota tree either filesystem_name or filesystem_id
is required.
type: str
nas_server_name:
description:
- The name of the NAS server in which the filesystem is created.
- For creation of a quota tree either nas_server_name or nas_server_id is required.
type: str
changed:
description: Whether or not the resource has changed.
returned: always
type: bool
get_quota_tree_details:
contains:
description:
description: Description of the quota tree.
type: str
filesystem:
contains:
UnityFileSystem:
contains:
id:
description: ID of the filesystem for which the quota tree is create.
type: str
description: Filesystem details for which the quota tree is created.
type: complex
description: Filesystem details for which the quota tree is created.
type: complex
gp_left:
description: The grace period left after the soft limit for the user quota is
exceeded.
type: int
hard_limit:
description: Hard limit of quota tree. If the quota tree's space usage exceeds
the hard limit, users in quota tree cannot write data.
type: int
id:
description: Quota tree ID.
type: str
path:
description: Path to quota tree. A valid path must start with a forward slash
'/'. It is mandatory while creating a quota tree.
type: str
size_used:
description: Size of used space in the filesystem by the user files.
type: int
soft_limit:
description: Soft limit of the quota tree. If the quota tree's space usage exceeds
the soft limit, the storage system starts to count down based on the specified
grace period.
type: int
state:
description: State of the quota tree.
type: int
description: Details of the quota tree.
returned: When quota tree exists
type: complex