创建权限规则
功能介绍
创建权限规则
接口约束
一个文件系统最多可以配置64条权限规则。
调用方法
请参见如何调用API。
URI
POST /v1/{project_id}/sfs-turbo/shares/{share_id}/fs/perm-rules
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID |
share_id |
是 |
String |
文件系统id |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
账号的token |
Content-Type |
是 |
String |
MIME类型 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
rules |
是 |
Array of OnePermRuleRequestInfo objects |
权限信息,一次最多允许添加5条规则 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
ip_cidr |
否 |
String |
授权对象的IP地址或网段,设置后不支持修改 |
rw_type |
否 |
String |
授权对象的读写权限
|
user_type |
否 |
String |
授权对象的系统用户对文件系统的访问权限。取值如下:
|
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
rules |
Array of OnePermRuleResponseInfo objects |
权限规格信息 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
权限规格的id |
ip_cidr |
String |
授权对象的IP地址或网段 |
rw_type |
String |
授权对象的读写权限
|
user_type |
String |
授权对象的系统用户对文件系统的访问权限。取值如下:
|
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
errCode |
String |
错误码 最小长度:8 最大长度:36 |
errMsg |
String |
错误描述 最小长度:2 最大长度:512 |
状态码: 500
参数 |
参数类型 |
描述 |
---|---|---|
errCode |
String |
错误码 最小长度:8 最大长度:36 |
errMsg |
String |
错误描述 最小长度:2 最大长度:512 |
请求示例
{ "rules" : [ { "ip_cidr" : "192.168.0.0/16", "rw_type" : "rw", "user_type" : "no_root_squash" }, { "ip_cidr" : "192.32.0.0/16", "rw_type" : "rw", "user_type" : "no_root_squash" } ] }
响应示例
状态码: 200
创建成功
{ "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" } ] }
状态码: 400
错误响应
{ "errCode" : "SFS.TURBO.0001", "errMsg" : "Rules not allowed empty" }
状态码: 500
错误响应
{ "errCode" : "SFS.TURBO.0005", "errMsg" : "Internal server error" }
状态码
状态码 |
描述 |
---|---|
200 |
创建成功 |
400 |
错误响应 |
500 |
错误响应 |
错误码
请参见错误码。