创建DDM账号
功能介绍
DDM账号用于连接和管理逻辑库。一个DDM实例最多能创建100个DDM账号，一个DDM账号可以关联多个逻辑库。
接口约束
无
URI
POST /v1/{project_id}/instances/{instance_id}/users
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
租户在某一region下的project ID。 获取方法请参见获取项目ID。 |
|
instance_id |
是 |
String |
DDM实例ID。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务的“获取用户Token”接口来获取。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
users |
是 |
Array of CreateUsersInfo objects |
DDM实例账号相关信息的集合。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
name |
是 |
String |
DDM实例账号名称，命名要求如下。
最小长度：1 最大长度：32 |
|
password |
是 |
String |
DDM实例账号密码。 |
|
base_authority |
是 |
Array of strings |
DDM实例账号的基础权限。 取值为：CREATE、DROP、ALTER、INDEX、INSERT、DELETE、UPDATE、SELECT 枚举值：
|
|
description |
否 |
String |
DDM实例账号的描述，最大长度不能超过256。默认值为空。 最大长度：256 |
|
databases |
否 |
Array of CreateUsersDatabases objects |
关联的逻辑库的集合。 databases字段可以省略，即创建用户时可以不关联逻辑库。 |
响应参数
状态码： 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
users |
Array of CreateUsersDetailResponses objects |
DDM实例账号相关信息的集合。 |
状态码： 400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
errCode |
String |
业务错误码。 |
|
externalMessage |
String |
错误信息。 |
状态码： 500
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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 |
错误码
请参见错误码。
