Creating Quotas for a Directory
Function
This API is used to create quotas for a directory.
Constraints
Only empty directories can have quotas configured. Root directories of the SFS Turbo file systems' OBS targets cannot have quotas configured.
URI
POST /v1/{project_id}/sfs-turbo/shares/{share_id}/fs/dir-quota
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
project_id |
Yes |
String |
Project ID |
share_id |
Yes |
String |
File system ID |
Request Parameters
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
X-Auth-Token |
Yes |
String |
Account token |
Content-Type |
Yes |
String |
MIME type |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
path |
Yes |
String |
Valid full path of an existing directory |
capacity |
No |
Integer |
Size of the directory, in MB |
inode |
No |
Integer |
Maximum number of inodes allowed in the directory |
Response Parameters
Status code: 200
Parameter |
Type |
Description |
---|---|---|
path |
String |
Valid full path of an existing directory |
capacity |
Integer |
Size of the directory, in MB |
inode |
Integer |
Maximum number of inodes allowed in the directory |
used_capacity |
Integer |
Used size of the directory, in MB. This parameter is returned only for SFS Turbo HPC file systems. |
used_inode |
Integer |
Number of used inodes in the directory. This parameter is returned only for SFS Turbo HPC file systems. |
Status code: 400
Parameter |
Type |
Description |
---|---|---|
errCode |
String |
Error code Minimum: 8 Maximum: 36 |
errMsg |
String |
Error description Minimum: 2 Maximum: 512 |
Status code: 409
Parameter |
Type |
Description |
---|---|---|
errCode |
String |
Error code Minimum: 8 Maximum: 36 |
errMsg |
String |
Error description Minimum: 2 Maximum: 512 |
Status code: 500
Parameter |
Type |
Description |
---|---|---|
errCode |
String |
Error code Minimum: 8 Maximum: 36 |
errMsg |
String |
Error description Minimum: 2 Maximum: 512 |
Example Requests
Creating quotas for the /data/test directory, with the capacity quota set to 1024 MB and number of inodes set to 100000.
{ "path" : "/data/test", "capacity" : 1024, "inode" : 100000 }
Example Responses
Status code: 200
Directory quotas created
{ "path" : "/data/test", "capacity" : 1024, "inode" : 100000 }
Status code: 400
Error response
{ "errCode" : "SFS.TURBO.0102", "errMsg" : "Path is not directory" }
Status code: 409
Error response
{ "errCode" : "SFS.TURBO.0112", "errMsg" : "quota alreay exist" }
Status code: 500
Error response
{ "errCode" : "SFS.TURBO.0005", "errMsg" : "Internal server error" }
Status Codes
Status Code |
Description |
---|---|
200 |
Directory quotas created |
400 |
Error response |
409 |
Error response |
500 |
Error response |
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot