创建DDM账号
功能介绍
DDM账号用于连接和管理逻辑库。一个DDM实例最多能创建100个DDM账号,一个DDM账号可以关联多个逻辑库。
接口约束
无
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
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 |
错误码
请参见错误码。