
# 修改用户
#### 场景描述
调用此接口来更新用户信息，采用Patch方法，支持消息体中指定的字段的局部更新，即若指定了phone字段，则更新phone字段，若指定了email字段，则更新email字段。
#### 接口方法
PATCH
#### 接口URI
https://域名/apiaccess/rest/sum/v1/tenantSpaces/users/{userId}，例如域名是service.besclouds.com
#### URL参数
表1URL参数 
| 序号 | 参数     | 是否为必选 | 类型     | 描述         |
|:---|:---|:---|:---|:---|
| 1  | userId | 是     | String | 租户下用户唯一标识。 |
   
#### 请求说明
表2请求头参数 
| 序号 | 名称            | 参数类型   | 是否必选  | 说明                                                             |
|:---|:---|:---|:---|:---|
| 1  | X-APP-Key     | string | False | app标识。                                                         |
| 2  | Authorization | string | True  | 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格）。 |
| 3  | Content-Type  | String | False | "application/json"                                             |
   
表3请求体参数 
| 序号 |     参数      | 是否必选 |   类型    |                                                                                                                                                                                                                                              描述                                                                                                                                                                                                                                               |
|---|---|---|---|---|
| 1  | userName    | 是    | String  | 用户的展示名称，长度不超过100字节（UTF-8）                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| 2  | phone       | 否    | String  | 租户下用户联系号码，长度不超过32                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| 3  | email       | 否    | String  | 租户下用户邮箱地址(符合RFC 2882) localPart最大长度不超过64，domainPart长度不超过255，其中domainPart dot前面部分最长为63                                                                                                                                                                                                                                                                                                 |
| 4  | description | 否    | String  | 仅适用于SAAS\&OP集成部署环境 用户的描述信息，长度不超过540                                                                                                                                                                                                                                                                                                                                                   |
| 5  | status      | 是    | Integer | 仅适用于SAAS\&OP集成部署环境 用户状态： 1:正常, 2:停用, 3.禁用（禁用状态的用户只能被删除） |
| 6  | profile     | 否    | String  | 仅适用于Case2.0独立部署环境 业务用户权限，只可传参"Operator"或"Administrator" 如未传递profile参数，则默认为"Operator" 其中"Administrator"为管理员权限，"Operator"为基础操作权限                                   |
   
#### 响应说明
- **响应状态码: 200**
  表4响应体参数 
  | 序号 | 名称      | 参数类型   | 说明                                                                                                                                                                                                                                      |
  |:---|:---|:---|:---|
  | 1  | message | string | 描述。                                                                                                                                                                                                                                     |
  | 2  | retcode | string | 错误码。取值如下： 0：成功 非0：失败 |
     
  
 
#### 错误码
- **响应状态码: 400**
  错误的请求：请检查请求路径及参数。
  
- **响应状态码: 401**
  未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。
  
- **响应状态码: 403**
  鉴权失败。
  
- **响应状态码: 404**
  请求的内容未找到：请检查请求的路径。
  
- **响应状态码: 500**
  业务失败：请依次确认您请求中各参数的取值。
  
 
#### 报文样例
场景描述：修改用户
URL：https://域名/apiaccess/rest/sum/v1/tenantSpaces/users/{userId}
- 请求头
```
x-app-key:953587d812f642998ee1f633b81212f3
Authorization:Bearer e3fca9398eaa5cef4b57b523b9c75fae
Content-Type:application/json
```
- 请求消息:
```
{
    "userName":"userName01",
    "phone":"12012341234",
    "email":"test@huawei.com"
}
```
- 响应消息:
```
{
    "message": "SUCCESS",
    "retcode": "0"
}
```
