文档首页/分布式数据库中间件 DDM/API参考/API（推荐）/账号管理/DDM管理员账号密码管理V3
更新时间：2025-11-28 GMT+08:00
查看PDF
分享

DDM管理员账号密码管理V3

功能介绍

首次调用时新建DDM管理员账号并设置密码。后续调用时仅更新管理员密码。

接口约束

DDM 3.0.9版本及以上。

调试

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

URI

PUT /v3/{project_id}/instances/{instance_id}/admin-user

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户在某一region下的project ID。

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

instance_id

是

String

DDM实例ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

x-auth-token

是

String

用户Token。

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

表3 请求Body参数

参数

是否必选

参数类型

描述

name

是

String

管理员账号用户名。

  • 长度为1-32个字符。
  • 必须以字母开头。
  • 可以包含字母，数字、下划线，不能包含其它特殊字符。

password

是

String

管理员账号密码。

  • 长度为8~32位。
  • 必须是大写字母（A~Z）、小写字母（a~z）、数字（0~9）、特殊字符~!@#%^*-_+?的组合。 建议您输入高强度密码，以提高安全性，防止出现密码被暴力破解等安全风险。

响应参数

状态码： default

表4 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息。

请求示例

创建管理员账号root，并设置密码。

PUT https://{endpoint}/v3/{project_id}/instances/{instance_id}/admin-user

{
  "name" : "root",
  "password" : "xxxxx"
}

响应示例

无

状态码

错误码

请参见错误码。

父主题：账号管理

相关文档