修改权限规则 - UpdatePermRule
功能介绍
修改权限规则。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项。
URI
PUT /v1/{project_id}/sfs-turbo/shares/{share_id}/fs/perm-rules/{rule_id}
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 项目ID,用于标识资源所属的IAM项目空间,实现项目级资源隔离与权限管控。 获取方法请参见获取项目ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| share_id | 是 | String | 参数解释: 文件系统ID,用于唯一标识SFS Turbo文件系统实例。 获取方法请参见查询文件系统列表接口。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| rule_id | 是 | String | 参数解释: 权限规则ID,用于唯一标识文件系统中的某一条权限规则。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 参数解释: 用户Token,用于鉴权认证。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| Content-Type | 是 | String | 参数解释: 请求消息体MIME类型,用于标识请求正文的数据格式。 约束限制: 不涉及。 取值范围: application/json 默认取值: application/json |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 参数解释: 权限规则的ID,用于唯一标识该权限规则。 取值范围: 不涉及。 |
| ip_cidr | String | 参数解释: 授权对象的IP地址或网段。 取值范围: 不涉及。 |
| rw_type | String | 参数解释: 授权对象的读写权限。 取值范围: |
| user_type | String | 参数解释: 授权对象的系统用户对文件系统的访问权限,用于控制客户端用户在NFS服务端的身份映射方式。 取值范围: |
状态码:400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| errCode | String | 参数解释: 错误码,用于标识请求失败的原因。详细错误码请参见错误码。 取值范围: 不涉及。 |
| errMsg | String | 参数解释: 错误描述,用于描述请求失败的具体原因,便于排查问题。请参见错误码。 取值范围: 不涉及。 |
状态码:500
请求示例
{
"rw_type" : "rw",
"user_type" : "no_root_squash"
} 响应示例
状态码:200
{
"id" : "1131ed520xxxxxxebedb6e57xxxxxxxx",
"ip_cidr" : "192.32.0.0/16",
"rw_type" : "rw",
"user_type" : "no_root_squash"
} 状态码:400
{
"errCode" : "SFS.TURBO.0001",
"errMsg" : "Invalid rule id"
} 状态码:500
{
"errCode" : "SFS.TURBO.0005",
"errMsg" : "Internal server error"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 成功 |
| 400 | 错误响应 |
| 500 | 错误响应 |
错误码
请参见错误码。