创建权限规则
功能介绍
创建权限规则
接口约束
一个文件系统最多可以配置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 |
-| 授权对象的读写权限 rw:默认选项,以读写的方式共享 ro:以只读的方式共享 none: 没有权限 |
user_type |
否 |
String |
-| 授权对象的系统用户对文件系统的访问权限。取值如下: no_root_squash:客户端使用的是root用户时,映射到NFS服务器的用户依然为root用户。 root_squash:客户端使用的是root用户时,映射到NFS服务器的用户为NFS的匿名用户(nfsnobody)。 all_squash:默认选项。所有访问NFS服务器的客户端的用户都映射为匿名用户。 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
rules |
Array of OnePermRuleResponseInfo objects |
权限规格信息 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
权限规格的id |
ip_cidr |
String |
授权对象的IP地址或网段 |
rw_type |
String |
-| 授权对象的读写权限 rw:默认选项,以读写的方式共享 ro:以只读的方式共享 none: 没有权限 |
user_type |
String |
-| 授权对象的系统用户对文件系统的访问权限。取值如下: no_root_squash:客户端使用的是root用户时,映射到NFS服务器的用户依然为root用户。 root_squash:客户端使用的是root用户时,映射到NFS服务器的用户为NFS的匿名用户(nfsnobody)。 all_squash:默认选项。所有访问NFS服务器的客户端的用户都映射为匿名用户。 |
状态码: 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 |
错误响应 |
错误码
请参见错误码。