调用CreateAccount创建数据库账号-云数据库 ClickHouse-阿里云-云数据库 ClickHouse-阿里云帮助中心

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

调试

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

调试

授权信息

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

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

clickhouse:CreateAccount

create

*EnterpriseDBCluster

acs:clickhouse:{#regionId}:{#accountId}:enterprisedbcluster/{#DBInstanceId}

无

请求参数

名称	类型	必填	描述	示例值
DBInstanceId	string	是	集群 ID。	cc-bp100p4q1g9z3****
AccountType	string	是	数据库账号的类型，取值说明： NormalAccount：普通账号。 SuperAccount：高权限账号。枚举值： SuperAccount : 高权限账号 NormalAccount : 普通账号	NormalAccount
Account	string	是	数据库账号，设置规则如下。名称唯一。由小写字母、数字或下划线组成。以小写字母开头，以小写字母或数字结尾。长度为 2~64 个字符。	test1
Password	string	是	数据库账号密码，设置规则如下。由大写字母、小写字母、数字和特殊字符中的至少三种组成。 !@#$%^&*()_+-=为特殊字符。长度为 8~32 个字符。	a1b2c3d4@
DmlAuthSetting	object	否	授权信息。
DmlAuthority	integer	否	是否授予数据库账号 DML 权限。取值如下： 0：允许进行读取、写入和更改设置的查询 1：仅允许进行读取数据的查询。 2：允许进行读取数据和更改设置的查询。枚举值： 0 : 允许读取、写入和更改设置 1 : 仅允许读取数据 2 : 允许读取数据和更改设置	0
DdlAuthority	boolean	否	是否授予数据库账号 DDL 权限，取值如下： true：允许 DDL。 false：禁止 DDL。	true
AllowDictionaries	array	否	需要授权的字典列表。如果有多个，用英文逗号（,）隔开。
	string	否	需要授权的字典列表。如果有多个，用英文逗号（,）隔开。	dc1,dc2
AllowDatabases	array	否	需要授权的数据库列表。如果有多个，用英文逗号（,）隔开。
	string	否	需要授权的数据库列表。如果有多个，用英文逗号（,）隔开。	db1,db2
RegionId	string	是	地域 ID。	cn-hangzhou
Product	string	否	产品 code。	clickhouse
Description	string	否	备注说明。	测试使用

返回参数

名称	类型	描述	示例值
	object	返回结果详情。
RequestId	string	请求 ID。	2FED790E-FB61-4721-8C1C-07C627FA****
Data	object	返回结果。
DBInstanceId	string	集群 ID。	cc-bp100p4q1g9z3****
Account	string	数据库账号。	test1

示例

正常返回示例

JSON格式

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

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidAccountType.Malformed	The specified parameter "AccountType" is not valid.
400	InvalidAccountName.Malformed	The specified parameter "Account" is not valid.
400	InvalidAccountPassword.Malformed	The specified parameter "Password" is not valid.
403	InvalidDBInstanceState.NotSupport	The specified instance state does't support this operation.
404	InvalidDBInstanceId.NotFound	The DBInstanceId provided does not exist in our records.	未找到有效实例

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

变更历史

更多信息，参考变更详情。