更新时间:2024-07-02 GMT+08:00
分享

修改DDM账号

功能介绍

修改现有DDM账号的权限或者与逻辑库的管理关系。

接口约束

base_authority、description和databases参数中至少有一个参数必须进行配置。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

PUT /v1/{project_id}/instances/{instance_id}/users/{username}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。

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

instance_id

String

DDM实例ID。

username

String

需要修改的DDM账号名称。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

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

表3 请求Body参数

参数

是否必选

参数类型

描述

user

UpdateUserDetailReq object

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

表4 UpdateUserDetailReq

参数

是否必选

参数类型

描述

base_authority

Array of strings

DDM实例账号的基础权限,默认值为原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 UpdateUsersDatabases objects

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

表5 UpdateUsersDatabases

参数

是否必选

参数类型

描述

name

String

逻辑库名称,不区分大小写,databases和name字段必须同时缺失或者同时存在。

默认值为空。

响应参数

状态码: 200

表6 响应Body参数

参数

参数类型

描述

name

String

DDM实例账号名称。

状态码: 400

表7 响应Body参数

参数

参数类型

描述

errCode

String

业务错误码。

externalMessage

String

错误信息。

状态码: 500

表8 响应Body参数

参数

参数类型

描述

errCode

String

业务错误码。

externalMessage

String

错误信息。

请求示例

修改账号权限为SELECT,关联的逻辑库为db_7350。

PUT https://{endpoint}/v1/{project_id}/instances/{instance_id}/users/{username}

{
  "user" : {
   
    "base_authority" : [ "SELECT" ],
    "description" : "test11",
    "databases" : [ {
      "name" : "db_7350"
    } ]
  }
}

响应示例

状态码: 200

OK

{
  "name" : "ddmtest"
}

状态码: 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

错误码

请参见错误码

相关文档