Gets user and group quotas of a file system.
HTTP request syntax (URI)
GET <base_URI>/v7/storage/filesystems/{id}/quotas
Parameters
| Name | Type | Required | Values | Description |
|---|---|---|---|---|
| id | URI_PARAM | Y | string | Specifies either the object ID or the HNAS file system ID. |
| 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 |
|---|---|---|
| 200 | fileSystemQuotas | User and groups quotas successfully retrieved. |
| 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 200 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/ quotas -X GET -d '{"virtualServerId":3}
Response example
HTTP/1.1 200 OK
{
"filesystemQuotas" :
[
{
"filesystemId" : "864553F647F8647D0000000000000000",
"quota" :
{
"diskUsage" : 32768,
"diskUsageThreshold" :
{
"isHard" : true,
"limit" : 1073741824,
"reset" : 5,
"severe" : 90,
"warning" : 70
},
"fileCountThreshold" :
{
"isHard" : true,
"limit" : 20,
"reset" : 5,
"severe" : 70,
"warning" : 40
},
"fileUsage" : 9,
"logEvent" : false,
"targetDomain" : "",
"targetName" : "root",
"targetType" : "USER"
},
"virtualServerId" : 3
},
{
"filesystemId" : "864553F647F8647D0000000000000000",
"quota" :
{
"diskUsage" : 0,
"diskUsageThreshold" :
{
"isHard" : true,
"limit" : 1234567890,
"reset" : 65,
"severe" : 95,
"warning" : 75
},
"fileCountThreshold" :
{
"isHard" : false,
"limit" : 1000,
"reset" : 85,
"severe" : 95,
"warning" : 90
},
"fileUsage" : 5,
"logEvent" : true,
"targetDomain" : "BUILTIN",
"targetName" : "Current Owner",
"targetType" : "USER"
},
"virtualServerId" : 3
},
{
"filesystemId" : "864553F647F8647D0000000000000000",
"quota" :
{
"diskUsage" : 0,
"diskUsageThreshold" :
{
"isHard" : true,
"limit" : 1234567890,
"reset" : 65,
"severe" : 95,
"warning" : 75
},
"fileCountThreshold" :
{
"isHard" : false,
"limit" : 1000,
"reset" : 85,
"severe" : 95,
"warning" : 90
},
"fileUsage" : 0,
"logEvent" : true,
"targetDomain" : "BUILTIN",
"targetName" : "Current Owner",
"targetType" : "GROUP"
},
"virtualServerId" : 3
}
]
}