文档

CreateAccount - 创建账号

更新时间:

调用CreateAccount接口为云数据库ClickHouse企业版集群创建数据库账号。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
DBInstanceIdstring

集群 ID。

cc-bp100p4q1g9z3****
AccountTypestring

数据库账号的类型,取值说明:

  • NormalAccount:普通账号。
  • SuperAccount:高权限账号。
NormalAccount
Accountstring

数据库账号,设置规则如下。

  • 名称唯一。
  • 由小写字母、数字或下划线组成。
  • 以小写字母开头,以小写字母或数字结尾。
  • 长度为 2~64 个字符。
test1
Passwordstring

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

  • 由大写字母、小写字母、数字和特殊字符中的至少三种组成。

  • !@#$%^&*()_+-=为特殊字符。

  • 长度为 8~32 个字符。

a1b2c3d4@
DmlAuthSettingobject

授权信息。

DmlAuthorityinteger

是否授予数据库账号 DML 权限。取值如下:

  • 0:允许进行读取、写入和更改设置的查询
  • 1:仅允许进行读取数据的查询。
  • 2:允许进行读取数据和更改设置的查询。
0
DdlAuthorityboolean

是否授予数据库账号 DDL 权限,取值说明:

  • true:允许 DDL。
  • false:禁止 DDL。
true
AllowDictionariesarray

需要授权的字典列表。如果有多个,用英文逗号(,)隔开。

string

需要授权的字典列表。如果有多个,用英文逗号(,)隔开。

dc1,dc2
AllowDatabasesarray

需要授权的数据库列表。如果有多个,用英文逗号(,)隔开。

string

需要授权的数据库列表。如果有多个,用英文逗号(,)隔开。

db1,db2
RegionIdstring

地域 ID。

cn-hangzhou
Productstring

产品 code。

clickhouse
Descriptionstring

备注说明。

测试使用

返回参数

名称类型描述示例值
object

Schema of Response

RequestIdstring

请求 ID。

2FED790E-FB61-4721-8C1C-07C627FA5A19
Dataobject

返回结果。

DBInstanceIdstring

集群 ID。

cc-bp100p4q1g9z3****
Accountstring

数据库账号。

test1

示例

正常返回示例

JSON格式

{
  "RequestId": "2FED790E-FB61-4721-8C1C-07C627FA5A19",
  "Data": {
    "DBInstanceId": "cc-bp100p4q1g9z3****",
    "Account": "test1"
  }
}

错误码

HTTP status code错误码错误信息
400InvalidAccountType.MalformedThe specified parameter "AccountType" is not valid.
400InvalidAccountName.MalformedThe specified parameter "Account" is not valid.
400InvalidAccountPassword.MalformedThe specified parameter "Password" is not valid.
403InvalidDBInstanceState.NotSupportThe specified instance state does't support this operation.
404InvalidDBInstanceId.NotFoundThe DBInstanceId provided does not exist in our records.

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
暂无变更历史
  • 本页导读 (1)
文档反馈