Creating a Permission Rule
Function
This API is used to create a permission rule.
Constraints
A maximum of 64 permission rules can be added for a file system.
This API is only supported for NFS file systems.
URI
POST /v1/{project_id}/sfs-turbo/shares/{share_id}/fs/perm-rules
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
project_id |
Yes |
String |
The project ID. |
share_id |
Yes |
String |
The file system ID. |
Request Parameters
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
X-Auth-Token |
Yes |
String |
The account token. |
Content-Type |
Yes |
String |
The MIME type. |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
rules |
Yes |
Array of OnePermRuleRequestInfo objects |
The permission rule details. You can add a maximum of five rules at a time. |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
ip_cidr |
Yes |
String |
The IP address or IP address range of the object to be authorized. Once configured, this parameter cannot be modified. |
rw_type |
Yes |
String |
The read/write permission of the object to be authorized.
|
user_type |
Yes |
String |
The file system access permission granted to the user of the object to be authorized. The value can be:
|
Response Parameters
Status code: 200
Parameter |
Type |
Description |
---|---|---|
rules |
Array of OnePermRuleResponseInfo objects |
The permission rule information. |
Parameter |
Type |
Description |
---|---|---|
id |
String |
The permission rule ID. |
ip_cidr |
String |
The IP address or IP address range of the authorized object. |
rw_type |
String |
The read/write permission of the authorized object.
|
user_type |
String |
The file system access permission granted to the user of the authorized object. The value can be:
|
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
-
Request example for creating permission rules
{ "rules" : [ { "ip_cidr" : "192.168.xx.xx/16", "rw_type" : "rw", "user_type" : "no_root_squash" }, { "ip_cidr" : "192.32.xx.xx/16", "rw_type" : "rw", "user_type" : "no_root_squash" } ] }
Example Responses
Status code: 200
Successful creation
-
Response example for creating permission rules
{ "rules" : [ { "id" : "1131ed520xxxxxxebedb6e57xxxxxxxx", "ip_cidr" : "192.32.0.0/16", "rw_type" : "rw", "user_type" : "no_root_squash" }, { "id" : "1131ed520xxxxxxebedb6e57xxxxxxxx", "ip_cidr" : "192.32.0.1", "rw_type" : "rw", "user_type" : "no_root_squash" } ] }
Status code: 400
Error response
{ "errCode" : "SFS.TURBO.0001", "errMsg" : "Rules not allowed empty" }
Status code: 500
Error response
{ "errCode" : "SFS.TURBO.0005", "errMsg" : "Internal server error" }
Status Codes
Status Code |
Description |
---|---|
200 |
Successful creation |
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