# 创建用户
#### 功能介绍
创建用户
#### URI
POST /v1/{project_id}/users
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                              |
|:---|:---|:---|:---|
| project_id | 是    | String | 华为云项目ID，您可以从[获取项目ID](https://support.huaweicloud.com/api-eihealth/eihealth_33_0044.html)中获取。 最小长度：**1** 最大长度：**128** |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限，[获取Token](https://support.huaweicloud.com/api-eihealth/eihealth_33_0010.html)接口响应消息头中X-Subject-Token的值即为Token。 最小长度：**1** 最大长度：**32768** |
   
表3请求Body参数 
| 参数       | 是否必选 | 参数类型                                                         | 描述                                                                                                                                         |
|:---|:---|:---|:---|
| name     | 是    | String                                                       | 用户名，长度1\~64之间，首位不能为数字，特殊字符只能包含下划线"_"、中划线"-"和空格 最小长度：**1** 最大长度：**64**            |
| password | 是    | String                                                       | 用户密码，在8-32位之间支持用户自定义密码长度，至少包含以下四种字符中的两种： 大写字母、小写字母、数字和特殊字符。 最小长度：**8** 最大长度：**32** |
| role     | 是    | String                                                       | 角色类型：管理员(ADMIN)、操作者(OPERATOR) 最小长度：**1** 最大长度：**64**                             |
| email    | 否    | String                                                       | 用户邮箱，需符合邮箱格式 最小长度：**0** 最大长度：**128**                                             |
| phone    | 否    | String                                                       | 用户手机号，纯数字，长度小于等于32位。必须与国家码同时存在。 最小长度：**5** 最大长度：**32**                           |
| areacode | 否    | String                                                       | 国家码。中国大陆为"0086" 最小长度：**1** 最大长度：**10**                                          |
| settings | 否    | [UserSettingDto] object | 用户设置                                                                                                                                       |
   
 表4UserSettingDto 
| 参数                | 是否必选 | 参数类型    | 描述                                                                                                                              |
|:---|:---|:---|:---|
| job_quota         | 是    | Integer | 允许同时运行的作业数 最小值：**1** 最大值：**100**                                     |
| job_timeout       | 是    | Integer | 作业执行超时时长，单位天 最小值：**1** 最大值：**60**                                      |
| cpu_quota         | 是    | Integer | 作业的CPU资源配额，单位核 最小值：**1** 最大值：**1024**                                   |
| mem_quota         | 是    | Integer | 作业的内存资源配额，单位GB 最小值：**1** 最大值：**1024**                                |
| projects_per_user | 否    | Integer | 用户可创建项目数配额 最小值：**0** 最大值：**20** 缺省值：**2** |
   
#### 响应参数
**状态码： 201**
表5响应Body参数 
| 参数 | 参数类型   | 描述   |
|:---|:---|:---|
| id | String | 用户id |
   
#### 请求示例
创建用户，用户名为example_user，密码为example，角色为ADMIN，邮箱为example@huawei.com，电话为12345678910，作业配额为10，作业超时时长为1天，CPU的核数配额为50，内存的配额为128GB，用户可创建的项目数为2
```
https://eihealth.cn-north-4.myhuaweicloud.com/v1/{project_id}/users
{
  "name" : "example_user",
  "password" : "example",
  "role" : "ADMIN",
  "email" : "example@huawei.com",
  "phone" : "12345678910",
  "areacode" : "0086",
  "settings" : {
    "job_quota" : 10,
    "cpu_quota" : 50,
    "mem_quota" : 128,
    "job_timeout" : 1,
    "projects_per_user" : 2
  }
}
```
#### 响应示例
**状态码： 201**
CREATED
```
{
  "id" : "7116d09f88fa41908676fdd4b039..."
}
```
#### 状态码
| 状态码 | 描述      |
|:---|:---|
| 201 | CREATED |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-eihealth/ErrorCode.html)。