更新时间:2024-07-11 GMT+08:00

创建DDM账号

功能介绍

DDM账号用于连接和管理逻辑库。一个DDM实例最多能创建100个DDM账号,一个DDM账号可以关联多个逻辑库。

接口约束

URI

POST /v1/{project_id}/instances/{instance_id}/users

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

租户在某一region下的project ID。

获取方法请参见获取项目ID

instance_id

String

DDM实例ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

通过调用IAM服务的“获取用户Token”接口来获取。

表3 请求Body参数

参数

是否必选

参数类型

描述

users

Array of CreateUsersInfo objects

DDM实例账号相关信息的集合。

表4 CreateUsersInfo

参数

是否必选

参数类型

描述

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字段可以省略,即创建用户时可以不关联逻辑库。

表5 CreateUsersDatabases

参数

是否必选

参数类型

描述

name

String

关联逻辑库名称。

响应参数

状态码: 200

表6 响应Body参数

参数

参数类型

描述

users

Array of CreateUsersDetailResponses objects

DDM实例账号相关信息的集合。

表7 CreateUsersDetailResponses

参数

参数类型

描述

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

错误码

请参见错误码