# 修改权限规则 - UpdatePermRule #### 功能介绍 修改权限规则。 #### 接口约束 - 该接口仅适用于NFS文件系统共享协议。 - 该接口不适用于100MB/s/TiB-智算型、200MB/s/TiB-智算型文件系统。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/SFSTurbo/doc?api=UpdatePermRule)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-sfsturbo/sfsturbo_02_0079.html)。 #### URI PUT /v1/{project_id}/sfs-turbo/shares/{share_id}/fs/perm-rules/{rule_id} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 项目ID | | share_id | 是 | String | 文件系统ID | | rule_id | 是 | String | 权限规则id | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | 账号的token | | Content-Type | 是 | String | MIME类型 | 表3请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | rw_type | 否 | String | 授权对象的读写权限 - rw：默认选项，以读写的方式共享 - ro：以只读的方式共享 - none: 没有权限 | | user_type | 否 | String | 授权对象的系统用户对文件系统的访问权限。取值如下： - no_root_squash：默认选项。客户端使用包括root用户在内的任何用户，NFS服务器都保持客户端使用的用户，不做映射。 - root_squash：客户端使用的是root用户时，映射到NFS服务器的用户为NFS的匿名用户（nfsnobody）。客户端使用非root用户时，NFS服务器保持客户端使用的用户，不做映射。 - all_squash：所有访问NFS服务器的客户端的用户都映射为匿名用户。 | #### 响应参数 **状态码：200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | 权限规格的id | | ip_cidr | String | 授权对象的IP地址或网段，设置后不支持修改 | | rw_type | String | 授权对象的读写权限 - rw：默认选项，以读写的方式共享 - ro：以只读的方式共享 - none: 没有权限 | | user_type | String | 授权对象的系统用户对文件系统的访问权限。取值如下： - no_root_squash：默认选项。客户端使用包括root用户在内的任何用户，NFS服务器都保持客户端使用的用户，不做映射。 - root_squash：客户端使用的是root用户时，映射到NFS服务器的用户为NFS的匿名用户（nfsnobody）。客户端使用非root用户时，NFS服务器保持客户端使用的用户，不做映射。 - all_squash：所有访问NFS服务器的客户端的用户都映射为匿名用户。 | **状态码：400** 表5响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | errCode | String | 错误码 | | errMsg | String | 错误描述 | **状态码：500** 表6响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | errCode | String | 错误码 | | errMsg | String | 错误描述 | #### 请求示例 ``` { "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 | 错误响应 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-sfsturbo/ErrorCode.html)。