创建集群
功能介绍
该接口用于创建集群。
集群必须要运行在VPC之内，创建集群前，您需要先创建VPC，并获取VPC和子网的id。
该接口为异步接口，创建集群需要10～15分钟。
调用创建集群接口目前只支持创建标准数仓类型。
URI
- URI 格式
POST /v1.0/{project_id}/clusters - 参数说明
表1 URI参数说明 参数
是否必选
参数类型
描述
project_id
是
String
项目ID。获取方法，请参见获取项目ID。
请求消息
- 请求样例
POST /v1.0/89cd04f168b84af6be287f71730fdb4b/clusters { "cluster": { "node_type": "dws.d1.xlarge.ultrahigh", "number_of_node": 3, "subnet_id": "374eca02-cfc4-4de7-8ab5-dbebf7d9a720", "security_group_id": "dc3ec145-9029-4b39-b5a3-ace5a01f772b", "vpc_id": "85b20d7e-9eb7-4b2a-98f3-3c8843ea3574", "availability_zone": "eu-west-0a", "port": 8000, "name": "dws-1", "user_name": "dbadmin", "user_pwd": "Password!", "public_ip": { "public_bind_type": "auto_assign", "eip_id": "" } } }
- 参数说明
表2 请求参数说明 参数
是否必选
参数类型
描述
cluster
是
CreateClusterInfo object
集群对象
表3 CreateClusterInfo 参数
是否必选
参数类型
描述
node_type
是
String
节点类型。
number_of_node
是
Integer
集群节点数量，取值范围为2~256。
subnet_id
是
String
指定子网ID，用于集群网络配置。
security_group_id
是
String
指定安全组ID，用于集群网络配置。
vpc_id
是
String
指定虚拟私有云ID，用于集群网络配置。
availability_zone
否
String
配置集群可用区。
port
否
Integer
集群服务端口，取值范围为8000~30000，默认值：8000。
name
是
String
集群名称，要求唯一性，必须以字母开头并只包含字母、数字、中划线或下划线，长度为4~64个字符。
user_name
是
String
DWS集群管理员用户名。用户命名要求如下：
- 只能由小写字母、数字或下划线组成。
- 必须以小写字母或下划线开头。
- 长度为1～63个字符。
- 用户名不能为DWS数据库的关键字。
user_pwd
是
String
DWS集群管理员密码。
public_ip
否
PublicIp object
公网IP地址，如果未指定，则默认不使用公网连接。
number_of_cn
否
Integer
CN部署量，取值范围为2~集群节点数-1，最大值为20，默认值为3。
enterprise_project_id
否
String
企业项目ID，对集群指定企业项目，如果未指定，则使用默认企业项目“default”的ID，即0。
响应消息
- 响应样例
{ "cluster": { "id": "7d85f602-a948-4a30-afd4-e84f47471c15" } }
- 参数说明
表5 响应参数参数 参数
参数类型
描述
cluster
Cluster object
集群对象
