You need to enable JavaScript to run this app.
导航
CreateDBAccount
最近更新时间:2024.06.13 14:27:24首次发布时间:2022.04.12 19:05:15

调用 CreateDBAccount 接口创建管理数据库的账号。

请求类型

同步请求。

请求参数

名称类型是否必选示例值描述

InstanceId

String

vedbm-r3xq0zdl****

实例 ID。

说明

您可以调用 DescribeDBInstances 接口查询实例 ID。

AccountName

String

testuser1

数据库账号名称。账号名称需满足以下要求:

  • 名称唯一,且长度在 2~32 个字符内。
  • 由小写字母、数字或下划线(_)组成。
  • 以小写字母开头,以字母或数字结尾。
  • 名称内不能包含某些禁用词,详细信息请参见禁用关键词。且不能使用某些预留字,例如 root、admin 等。

AccountPassword

String

Test@123

数据库账号的密码。账号密码需满足以下要求:

  • 只能包含大小写字母、数字及以下特殊字符 _#!@$%^&*()+=-
  • 长度需在 8~32 个字符内。
  • 至少包含大写字母、小写字母、数字或特殊字符中的 3 种。

AccountType

String

Normal

数据库账号类型,取值:

  • Super:高权限账号,一个实例只能创建一个高权限账号,且具备该实例下所有数据库所有权限,可以管理所有普通账号和数据库。
  • Normal:一个实例可以创建多个普通账号,需要手动给普通账号授予特定数据库的权限。

AccountPrivileges

Array of AccountPrivilegeObject

请参见请求示例

数据库的权限信息。详细的参数信息,请参见 AccountPrivilegeObject

说明

  • AccountType 取值为 Super时,无需传入该参数,高权限账号默认具备该实例下所有数据库的所有权限。
  • AccountType 取值为 Normal 时,建议传入该参数,为普通账号授予指定数据库的指定权限。不设置时,该账号不具备任何数据库的任何权限。

返回参数

null

请求示例

POST /?Action=CreateDBAccount&Version=2022-01-01 HTTP/1.1
Content-Type: application/json
Host:vedbm.volcengineapi.com
X-Date: 20220101T101010Z
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20211202/cn-beijing/vedbm/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c645****

{
        "InstanceId": "vedbm-ie2k349p****",
        "AccountName": "cece1",
        "AccountPassword": "Test@123",
        "AccountType": "Normal",
        "AccountPrivileges":[
           {
               "DBName":"bd",
               "AccountPrivilege":"ReadWrite"
           }
        ]
}

返回示例

正常返回示例

{
    "ResponseMetadata" : {
        "RequestId": "d78bbf4e-63a5-4937-ac3c-3767e7eddfbe",
        "Action": "CreateDBAccount",
        "Version": "2022-01-01",
        "Service": "vedbm",
        "Region": "cn-beijing"
    },
    "Result":  null
}

错误码

更多详情,请参见错误码