Create a virtual volume quota

NAS File Storage REST API v7 Reference

Version
14.7.x
14.6.x
Audience
anonymous
Part Number
MK-92HNAS088-05

Creates a virtual volume quota for a virtual volume, by virtual volume ID. Only a single virtual volume quota can be associated with a virtual volume.

HTTP request syntax (URI)

POST <base_URI>/v7/storage/virtual-volumes/{vivolObjectId}/quotas

Parameters

Name Type Required Values Description
vivolObjectId URI_PARAM Y string ID of the virtual volume object to create the quota for.
diskUsageThreshold BODY Y object quotaThresholdPercentages object of disk space to be added to the virtual volume.
fileCountThreshold BODY Y object quotaThresholdPercentages object of file count to be added to the virtual volume.
logEvent BODY Y boolean Whether to log an event.

Return codes

Code Data Description
201 virtualVolumeQuota virtualVolumeQuota object is returned.
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 201 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/virtual-volumes/ 353a3a3a37353431323730394531434239414142303030303030303030303030303030303a3a3a3136/quotas -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}’ -X POST

Response example

HTTP/1.1 201 Created
{
   "virtualVolumeQuota" : {
      "filesystemId" : "75412709E1CB9AAB0000000000000000",
      "objectId" : "353a3a3a37353431323730394531434239414142303030303030303030303030303030303a3a3a3136",
      "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" : 1,
         "logEvent" : true
      },
      "virtualServerId" : 5,
      "virtualVolumeId" : 16,
      "virtualVolumeName" : "xyz-unit-test2"
   },
   "uri" : "https://172.17.57.75:8444/v7/storage/quotas/353a3a3a37353431323730394531434239414142303030303030303030303030303030303a3a3a3136"
}