
# 修改用户 - UpdateUser
#### 功能介绍
修改用户。
#### 接口约束
null
#### URI
PUT /api/v2/tenant/users/{user_id}
表1路径参数 
| 参数      | 是否必选 | 参数类型   | 描述    |
|:---|:---|:---|:---|
| user_id | 是    | String | 用户id。 |
   
#### 请求参数
表2请求Header参数 
| 参数            | 是否必选 | 参数类型   | 描述                                                       |
|:---|:---|:---|:---|
| Content-Type  | 是    | String | 该字段内容填为"application/json;charset=utf8"。                  |
| Authorization | 是    | String | 认证凭据，值：Bearer {access_token}，access_token通过"获取访问凭据"接口获取。 |
   
表3请求Body参数 
| 参数                     | 是否必选 | 参数类型                                                                                 | 描述                  |
|:---|:---|:---|:---|
| user_name              | 否    | String                                                                               | 用户名，用户唯一标识，企业内唯一。   |
| mobile                 | 否    | String                                                                               | 手机号，企业内唯一。          |
| org_code               | 否    | String                                                                               | 组织编码。               |
| name                   | 否    | String                                                                               | 姓名。                 |
| email                  | 否    | String                                                                               | 邮箱。                 |
| employee_id            | 否    | String                                                                               | 员工id。               |
| first_name             | 否    | String                                                                               | 名字。                 |
| middle_name            | 否    | String                                                                               | 中间名。                |
| last_name              | 否    | String                                                                               | 姓氏。                 |
| pwd_must_modify        | 否    | Boolean                                                                              | 首次登录是否需要强制修改密码。     |
| attr_gender            | 否    | String                                                                               | 性别。                 |
| attr_birthday          | 否    | String                                                                               | 生日，格式为yyyy-mm-dd。   |
| attr_nick_name         | 否    | String                                                                               | 昵称。                 |
| attr_identity_type     | 否    | String                                                                               | 证件类型。               |
| attr_identity_number   | 否    | String                                                                               | 证件号码。               |
| attr_area              | 否    | String                                                                               | 国家或者地区的编码。          |
| attr_city              | 否    | String                                                                               | 城市。                 |
| attr_manager_id        | 否    | String                                                                               | 直属上级。               |
| attr_user_type         | 否    | String                                                                               | 人员类型。               |
| attr_hire_date         | 否    | String                                                                               | 入职时间，格式为yyyy-MM-dd。 |
| attr_work_place        | 否    | String                                                                               | 工作地点。               |
| user_org_relation_list | 否    | [UserOrgRelationListOption] object | 用户归属组织列表。           |
| extension              | 否    | Object                                                                               | 自定义扩展属性。            |
   
 表4UserOrgRelationListOption 
| 参数           | 是否必选 | 参数类型   | 描述                       |
|:---|:---|:---|:---|
| orgCode      | 是    | String | 组织编码。                    |
| relationType | 是    | String | 归属关系，同一用户只能有1个归属，最多9个挂靠。 |
   
#### 响应参数
**状态码：200**
表5响应Body参数 
| 参数      | 参数类型   | 描述    |
|:---|:---|:---|
| user_id | String | 用户id。 |
   
**状态码：400**
表6响应Body参数 
| 参数         | 参数类型   | 描述    |
|:---|:---|:---|
| error_code | String | 错误编号。 |
| error_msg  | String | 错误详情。 |
   
#### 请求示例
修改用户，用户名zhangsan，手机号12345678901，邮箱zhangsan@example.com。
```
PUT https://{domain_name}/api/v2/tenant/users/{user_id}
Authorization: Bearer 334963fc-1e4a-473b-9096-52a929140...
{
    "user_name": "zhangsan",
    "org_code": "10000",
    "name": "zhangsan",
    "mobile": "12345678901",
    "email": "zhangsan@example.com",
    "employee_id": "123456789",
    "pwd_must_modify": false,
    "first_name": "F",
    "middle_name": "M",
    "last_name": "L",
    "attr_gender": "male",
    "attr_birthday": "1990-02-01",
    "attr_nick_name": "zhangsan",
    "attr_identity_type": "id_card",
    "attr_identity_number": "123456789",
    "attr_area": "CN",
    "attr_city": "xxx",
    "attr_manager_id": "123456789",
    "attr_user_type": "regular",
    "attr_hire_date": "2021-04-01",
    "attr_work_place": "xxx",
    "user_org_relation_list": [
     {
            "orgCode": "10000",
            "relationType": 1
      },
      {
            "orgCode": "TestOrg1",
            "relationType": 0
      },
      {
            "orgCode": "TestOrg2",
            "relationType": 0
      }
    ],
    "extension": {
        "age": "18"
    }
}
```
#### 响应示例
**状态码：200**
请求成功。
```
{
  "user_id" : "20210621095935811-5E16-6B3060..."
}
```
#### 状态码
| 状态码 | 描述    |
|:---|:---|
| 200 | 请求成功。 |
| 400 | 参数无效。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-oneaccess/ErrorCode.html)。
