Querying Quotas of a Directory
Function
This API is used to update quotas of a directory. The used_capacity and used_inode 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 | Project ID |
share_id | Yes | String | File system ID |
Parameter | Mandatory | Type | Description |
---|---|---|---|
path | Yes | String | Valid full path of an existing directory |
Request Parameters
Parameter | Mandatory | Type | Description |
---|---|---|---|
X-Auth-Token | Yes | String | Account token |
Content-Type | Yes | String | MIME type |
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 space of the directory, in MB. This field is returned only for 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 | Number of inodes used in the directory. This field is returned only for 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 | Error code |
errMsg | String | Error description |
Status code: 500
Parameter | Type | Description |
---|---|---|
errCode | String | Error code |
errMsg | String | Error description |
Example Requests
Querying the quotas 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 quotas 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 quotas queried |
400 | Error response |
500 | Error response |
Error Codes
See Error Codes.
- URI