Querying Quota Limits of a Directory
Function
This API is used to query quota limits of a directory. The used_capacity and used_inode values obtained may not be the latest.
URI
GET /v1/{project_id}/sfs-turbo/shares/{share_id}/fs/dir-quota
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
project_id |
Yes |
String |
The project ID. |
share_id |
Yes |
String |
The file system ID. |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
path |
Yes |
String |
The valid full path of an existing directory. |
Request Parameters
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
X-Auth-Token |
Yes |
String |
The account token. |
Content-Type |
Yes |
String |
The MIME type. |
Response Parameters
Status code: 200
Parameter |
Type |
Description |
---|---|---|
path |
String |
The valid full path of an existing directory. |
capacity |
Integer |
The directory capacity limit, in MB. |
inode |
Integer |
The quantity limit of inodes of the directory. |
used_capacity |
Integer |
The used capacity of the directory, in MB. This field is returned only for 1,000 MB/s/TiB, 500 MB/s/TiB, 250 MB/s/TiB, 125 MB/s/TiB, 40 MB/s/TiB, and 20 MB/s/TiB file systems. The returned data may not be the latest. |
used_inode |
Integer |
The number of inodes used in the directory. This field is returned only for 1,000 MB/s/TiB, 500 MB/s/TiB, 250 MB/s/TiB, 125 MB/s/TiB, 40 MB/s/TiB, and 20 MB/s/TiB file systems. The returned data may not be the latest. |
Status code: 400
Parameter |
Type |
Description |
---|---|---|
errCode |
String |
The error code. |
errMsg |
String |
The error message. |
Status code: 500
Parameter |
Type |
Description |
---|---|---|
errCode |
String |
The error code. |
errMsg |
String |
The error message. |
Example Requests
Querying the quota limits of the directory /data/test in the file system whose ID is 77ba6f4b-6365-4895-8dda-bc7142af4ddw
GET HTTPS://{endpoint}/v1/{project_id}/sfs-turbo/shares/77ba6f4b-6365-4895-8dda-bc7142af4ddw/fs/dir-quota?path=/data/test
Example Responses
Status code: 200
Directory quota limits queried
{ "path" : "/data/test", "capacity" : 1024, "inode" : 100000 }
Status code: 400
Error response
{ "errCode" : "SFS.TURBO.0102", "errMsg" : "Path is not directory" }
Status code: 500
Error response
{ "errCode" : "SFS.TURBO.0005", "errMsg" : "Internal server error" }
Status Codes
Status Code |
Description |
---|---|
200 |
Directory quota limits queried |
400 |
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