CreateAccount - 创建账号

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

调试

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

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
clickhouse:CreateAccountcreate
  • EnterpriseDBCluster
    acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}

请求参数

名称类型必填描述示例值
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

返回结果详情。

RequestIdstring

请求 ID。

2FED790E-FB61-4721-8C1C-07C627FA****
Dataobject

返回结果。

DBInstanceIdstring

集群 ID。

cc-bp100p4q1g9z3****
Accountstring

数据库账号。

test1

示例

正常返回示例

JSON格式

{
  "RequestId": "2FED790E-FB61-4721-8C1C-07C627FA****",
  "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.

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

变更历史

变更时间变更内容概要操作
暂无变更历史