CreateDBAccount--云数据库 PostgreSQL 版-火山引擎

文档中心

立即注册

导航

CreateDBAccount

最近更新时间：2024.12.13 12:00:09首次发布时间：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`：创建数据库权限。说明当账号类型为高权限账号时，无需传入该参数，默认支持全部权限。当账号类型为普通账号时，支持传入该参数，默认值为 `Login` 和 `Inherit`。账号类型为实例只读账号时，即 AccountType 取值为 `InstanceReadOnly` 时，不支持传入该参数。

返回参数

null

示例

请求示例

POST /?Action=CreateDBAccount&Version=2022-01-01 HTTP/1.1
Content-Type: application/json
Host: open.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
}