# 创建DDM账号
#### 功能介绍
DDM账号用于连接和管理逻辑库。一个DDM实例最多能创建100个DDM账号，一个DDM账号可以关联多个逻辑库。
#### 接口约束
无
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=DDM&api=CreateUsers)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### URI
POST /v1/{project_id}/instances/{instance_id}/users
表1路径参数 
| 参数          | 是否必选 | 参数类型   | 描述                                                                                                                                     |
|:---|:---|:---|:---|
| project_id  | 是    | String | 租户在某一region下的project ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-ddm/ddm_api_01_0063.html)。 |
| instance_id | 是    | String | DDM实例ID。                                                                                                                               |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token。 通过调用IAM服务的"获取用户Token"接口来获取。 |
   
表3请求Body参数 
| 参数    | 是否必选 | 参数类型                                                                      | 描述              |
|:---|:---|:---|:---|
| users | 是    | Array of [CreateUsersInfo] objects | DDM实例账号相关信息的集合。 |
   
 表4CreateUsersInfo 
| 参数             | 是否必选 | 参数类型                                                                                | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
|:---|:---|:---|:---|
| name           | 是    | String                                                                              | DDM实例账号名称，命名要求如下。 - 长度为1-32个字符。  - 必须以字母开头。  - 可以包含字母，数字、下划线，不能包含其它特殊字符。   最小长度：**1** 最大长度：**32**                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| password       | 是    | String                                                                              | DDM实例账号密码。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| base_authority | 是    | Array of strings                                                                    | DDM实例账号的基础权限。 取值为：CREATE、DROP、ALTER、INDEX、INSERT、DELETE、UPDATE、SELECT 枚举值： - **CREATE**  - **DROP**  - **ALTER**  - **INDEX**  - **INSERT**  - **DELETE**  - **UPDATE**  - **SELECT**   |
| description    | 否    | String                                                                              | DDM实例账号的描述，最大长度不能超过256。默认值为空。 最大长度：**256**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| databases      | 否    | Array of [CreateUsersDatabases] objects | 关联的逻辑库的集合。 databases字段可以省略，即创建用户时可以不关联逻辑库。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
   
 表5CreateUsersDatabases 
| 参数   | 是否必选 | 参数类型   | 描述       |
|:---|:---|:---|:---|
| name | 是    | String | 关联逻辑库名称。 |
   
#### 响应参数
**状态码： 200**
表6响应Body参数 
| 参数    | 参数类型                                                                                             | 描述              |
|:---|:---|:---|
| users | Array of [CreateUsersDetailResponses] objects | DDM实例账号相关信息的集合。 |
   
 表7CreateUsersDetailResponses 
| 参数   | 参数类型   | 描述         |
|:---|:---|:---|
| name | String | DDM实例账号名称。 |
   
**状态码： 400**
表8响应Body参数 
| 参数              | 参数类型   | 描述     |
|:---|:---|:---|
| errCode         | String | 业务错误码。 |
| externalMessage | String | 错误信息。  |
   
**状态码： 500**
表9响应Body参数 
| 参数              | 参数类型   | 描述     |
|:---|:---|:---|
| errCode         | String | 业务错误码。 |
| externalMessage | String | 错误信息。  |
   
#### 请求示例
创建账号DDMuser1，具有CREATE、DROP、ALTER、INDEX、INSERT、DELETE、UPDATE、SELECT基础权限，关联的逻辑库为DDMdb1。
```
POST https://{endpoint}/v1/{project_id}/instances/{instance_id}/users
{
  "users" : [ {
    "name" : "DDMuser1",
    "password" : "xxxxxx",
    
    "base_authority" : [ "CREATE", "DROP", "ALTER", "INDEX", "INSERT", "DELETE", "UPDATE", "SELECT" ],
    "description" : "",
    "databases" : [ {
      "name" : "DDMdb1"
    } ]
  } ]
}
```
#### 响应示例
**状态码： 200**
OK
```
{
  "users" : [ {
    "name" : "DDMuser1"
  } ]
}
```
**状态码： 400**
bad request
```
{
  "externalMessage" : "Parameter error.",
  "errCode" : "DBS.280001"
}
```
**状态码： 500**
server error
```
{
  "externalMessage" : "Server failure.",
  "errCode" : "DBS.200412"
}
```
#### 状态码
| 状态码 | 描述           |
|:---|:---|
| 200 | OK           |
| 400 | bad request  |
| 500 | server error |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-ddm/ddm_api_01_0061.html)。