文档数据库 MongoDB 版
文档数据库 MongoDB 版
文档指南
请输入
- 文档首页
文档数据库 MongoDB 版API 参考账号管理ResetDBAccount
复制全文
下载 pdfResetDBAccount
文档反馈
问问助手调用 ResetDBAccount 接口修改目标 MongoDB 实例中指定账号的密码或将 root 账号的权限重置为出初始状态。
请求类型
同步请求。
注意事项
- 账号类型不同，支持通过 ResetDBAccount 接口修改的信息也不同。其中：
- 高权限账号（即 AccountType 为 UserAdmin ）和普通账号（即 AccountType 为 Normal ）
- 支持通过当前接口修改高权限账号或普通账号的密码。更多关于不同类型账号的更多详情，请参见账号类型。
- 您可以通过 UpdateDBAccountPrivilege 接口修改高权限账号或普通账号的数据库权限和账号描述。更多详情，请参见修改账号权限。
- 超级管理员账号（即 AccountType 为 Super ）：
- 支持通过当前接口修改超级管理员的密码，或将权限重置为出初始状态（即补全超级管理员账号允许被授予的权限）。关于超级管理员账号允许授予的完整权限详情，请参见数据库与账号权限。
- 您可以通过 UpdateDBAccountPrivilege 接口修改超级管理员账号的账号描述。
- 修改密码可能导致正在使用 root 账号的数据库连接中断，请谨慎操作。
- 若您在密码中使用了特殊字符，在连接实例时可能需要对特殊字符进行转义。更多详情，请参见需要转义的特殊字符。
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
InstanceId String 必选 示例值：mongo-replica-e405f8e2f8e2
实例 ID。
说明
AuthDB String 可选 示例值：testdb
账号所属的数据库。
说明
若不设置该参数，默认需要修改密码的账号属于 admin 库。
ResetDBAccount Boolean 可选 示例值：false
是否将 root 账号的权限重置为出初始状态（即补全超级管理员账号允许被授予的权限）。取值范围如下：
- false（默认值）：不重置。
- true：重置。
说明
- 该参数仅对 admin 库中的 root 账号（即 AuthDB 为 admin 且 AccountName 为 root）生效。
- 关于超级管理员账号允许授予的完整权限详情，请参见数据库与账号权限。
返回参数
示例
请求示例 1
修改 testdb 中 testacc 账号的密码为 Test@12****。
POST https://mongodb.cn-beijing.volcengineapi.com/?Action=ResetDBAccount&Version=2022-01-01 HTTP/1.1
Host: mongodb.cn-beijing.volcengineapi.com
Content-Type: application/json; charset=utf-8
X-Date: 20201103T104027Z
Authorization: HMAC-SHA256 Credential=AK****/20201103/cn-beijing/mongodb/request,SignedHeaders=content-type;host;x-date,Signature=****
{
"InstanceId":"mongo-replica-e405f8e2f8e2",
"AccountName":"testacc",
"AuthDB":"testdb",
"AccountPassword":"Test@123456"
}
返回示例 1
{
"ResponseMetadata": {
"RequestId": "202203091439160102121681030B0B****",
"Action": "ResetDBAccount",
"Version": "2022-01-01",
"Service": "mongodb",
"Region": "cn-beijing"
},
"Result": null
}
请求示例 2
修改 admin 库中 root 账号的密码为 Pwd@12****，且将 root 账号的权限重置为初始状态。
POST https://mongodb.cn-beijing.volcengineapi.com/?Action=ResetDBAccount&Version=2022-01-01 HTTP/1.1
Host: mongodb.cn-beijing.volcengineapi.com
Content-Type: application/json; charset=utf-8
X-Date: 20201103T104027Z
Authorization: HMAC-SHA256 Credential=AK****/20201103/cn-beijing/mongodb/request,SignedHeaders=content-type;host;x-date,Signature=****
{
"InstanceId":"mongo-replica-e405f8e2f8e2",
"AccountName":"root",
"AuthDB":"admin",
"AccountPassword":"Pwd@123456",
"ResetDBAccount": true
}
返回示例 2
{
"ResponseMetadata": {
"RequestId": "202203091439160102121681030B0B****",
"Action": "ResetDBAccount",
"Version": "2022-01-01",
"Service": "mongodb",
"Region": "cn-beijing"
},
"Result": null
}
错误码
最近更新时间：2026.06.17 16:15:10
这个页面对您有帮助吗？
有用
有用
无用
无用