Skip to main content

We've Moved!

Product Documentation has moved to docs.hitachivantara.com
Hitachi Vantara Knowledge

Modify a group quota

Modifies a group quota by file system ID.

HTTP request syntax (URI)
PATCH {base_URI}/v7/storage/filesystems/{id}/group-quota
Parameters
Name Type Required Values Description
id URI_PARAM Y string Either the object ID or the HNAS file system ID
diskUsageThreshold BODY Y object quotaThresholdPercentages object of the disk space to be added to the virtual volume.
fileCountThreshold BODY Y object quotaThresholdPercentages object of the file count to be added to the virtual volume.
logEvent BODY Y boolean Indicates whether to log an event.
groupId BODY Y string Group can be either a NFS group or a CIFS group. For an NFS group, it can be the NFS v2/3 format with its UNIX group ID optionally registered in the HNAS group mappings. For example, if group NFSgroup with its UNIX group ID 501 is added to Group Mappings, then you can add a group quota with the group named “NFSGroup.” For an NFS v4 format, the group must attach its host name in format of group@host (NFSv4Group@deb5010-57-75).A CIFS group can be discovered from The Windows Domain Controller or inputted by an HNAS user. Usually the group is in the format of Domain\group, such as BUILTIN\Current Group. When inputted as an HNAS group, a windows Security Identifier (SID) may also be supplied. In this case, the group can have an empty domain name at the beginning. That is, CIFSTest can be inputted in Group Mappings with a windows SID of S-1-5-21-2073948960-1606239773-750479623-1121 under the Windows group name \CIFSTest. In this case, the parameter takes the format of CIFSTest.
virtualServerId BODY N number Virtual server ID where the file system resides. This parameter is ignored, as the virtual server ID can be derived from the filesystem ID. It is maintained for backward compatability.
Return codes
Code Data Description
204 No Data Group quota successfully modified.
400 No Data Missing or invalid request contents.
404 Error Message Requested resource not found.
500 Error message Error associated with the storage system.
501 No Data Server has not implemented the request operation on the resource.

Any HTTP status code other than 204 indicates that the API did not complete successfully.

Request example
curl -vk -H "X-Api-Key: zrxvSDAv9x.RIP4gkmKarG3beF.or.4Tc2im7oeqYN88C9XPGHxbXC" https://172.17.57.75:8444/v7/storage/filesystems/864553F647F8647D0000000000000000/group-quota -d ‘{"diskUsageThreshold":{"limit":1234567890,"isHard":true,"reset":65,"warning":75,"severe":95}, "fileCountThreshold":{"limit":1000,"isHard":false,"reset":85,"warning":90, "severe":95},"logEvent":true, "groupId":"xyz", "virtualServerId":3}’ -X PATCH
Response example
HTTP/1.1 204 No Content

 

  • Was this article helpful?