You need to enable JavaScript to run this app.
导航
CreateDBAccount
最近更新时间:2024.10.11 16:59:28首次发布时间:2023.11.15 22:39:51

调用 CreateDBAccount 接口创建账号。

请求类型

同步请求。

请求参数

参数
类型
是否必选
示例值
描述
InstanceId
String
postgres-ca7b7019****
实例 ID。
AccountName
String
testuser1

数据库账号名称。账号名称的设置规则如下:

  • 长度 2~63 个字符。
  • 由字母、数字、下划线(_)或中划线(-)组成。
  • 以字母开头,字母或数字结尾。
  • 不能以 pg_ 开头。
  • 不能使用保留关键字,所有被禁用的关键词请参见禁用关键词
AccountPassword
String
Test@123456

数据库账号的密码。数据库账号密码的设置规则如下:

  • 长度为 8~32 个字符。
  • 由大写字母、小写字母、数字、特殊字符中的任意三种组成。
  • 特殊字符为 !@#$%^*()&_+-=
AccountType
String
Normal

数据库账号类型,取值范围如下:

  • Super:高权限账号。
  • Normal:普通账号。
  • InstanceReadOnly:实例只读账号。
AccountPrivileges
String
Inherit,Login,CreateRole,CreateDB

账号权限信息。多个权限中间以英文逗号(,)分隔。取值:

  • Login:登录权限。
  • Inherit:继承权限。
  • CreateRole:创建角色权限。
  • CreateDB:创建数据库权限。

说明

  • 当账号类型为高权限账号时,无需传入该参数,默认支持全部权限。
  • 当账号类型为普通账号时,支持传入该参数,默认值为 LoginInherit
  • 账号类型为实例只读账号时,即 AccountType 取值为 InstanceReadOnly 时,不支持传入该参数。

返回参数

null

示例

请求示例

POST /?Action=CreateDBAccount&Version=2022-01-01 HTTP/1.1
Content-Type: application/json
Host: rds.volcengineapi.com
X-Date: 20231002T101010Z
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20211202/cn-beijing/rds_postgresql/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c6458****
{
    "InstanceId": "postgres-ca7b7019****",
    "AccountName": "yy_123",
    "AccountType": "Super",
    "AccountPassword": "Root123@",
    "AccountPrivileges": "CreateDB,CreateRole,Inherit,Login"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2023080216414436E7C5AAAC0F06F41091",
        "Action": "CreateDBAccount",
        "Version": "2022-01-01",
        "Service": "rds_postgresql",
        "Region": "cn-beijing"
    },
    "Result": null
}