Querying Permission Rules of a File System¶
Function¶
This API is used to query the permission rules of a file system.
URI¶
GET /v1/{project_id}/sfs-turbo/shares/{share_id}/fs/perm-rules
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 |
Response Parameters¶
Status code: 200
Parameter | Type | Description |
---|---|---|
rules | Array of Table 4 objects | Permission rule information |
count | int | Total rules |
Parameter | Type | Description |
---|---|---|
id | String | Permission rule ID |
ip_cidr | String | IP address or IP address range of the authorized object |
rw_type | String | Read/write permission of the authorized object. The value can be rw (read and write permission), ro (read only permission), or none (no access permission). The default value is rw. |
user_type | String | File system access permission granted to the user of the authorized object. The value can be no_root_squash, root_squash, or all_squash. Value no_root_squash allows the root user on the client to access the file system as root. Value root_squash allows the root user on the client to access the file system as nfsnobody. Value all_squash allows any user on the client to access the file system as nfsnobody. |
Status code: 500
Parameter | Type | Description |
---|---|---|
errCode | String | Error code Minimum length: 8 characters Maximum length: 36 characters |
errMsg | String | Error message Minimum length: 2 characters Maximum length: 512 characters |
Example Request¶
None
Example Response¶
Status code: 200
Successful query
{
"rules": [
{
"id": "2be0cc3d-cf1e-49d5-bce3-83e91e32ff42",
"ip_cidr": "*",
"rw_type": "rw",
"user_type": "no_root_squash"
},
{
"id": "d56a5130-6744-4a64-866b-9dc259f5a64c",
"ip_cidr": "188.88.88.88",
"rw_type": "ro",
"user_type": "no_root_squash"
}
],
"count": 2
}
Status code: 500
Error response
{
"errCode" : "SFS.TURBO.0005",
"errMsg" : "Internal server error"
}
Status Codes¶
Status Code | Description |
---|---|
200 | Successful query |
500 | Error response |