调用CreateCluster创建一个Cassandra实例。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateCluster

系统规定参数。取值:CreateCluster。

ClientToken String ETnLKlblzczshOTUbOCzxxxxxxxxxx

用于保证请求的幂等性。由客户端生成该参数值,要保证在不同请求间唯一,大小写敏感、不超过64个ASCII字符。

DiskSize Integer 160

磁盘存储大小。(每节点,单位:GB)

DiskType String cloud_ssd

磁盘存储类型。可取值示例:

  • cloud_ssd:SSD云盘
  • cloud_essd:ESSD云盘
  • cloud_efficiency:高效云盘
  • local_ssd_pro:本地SSD盘
InstanceType String cassandra.c.xlarge

集群实例类型。可取值部分示例:

  • cassandra.c.large:2核 4G
  • cassandra.c.xlarge:4核 8G
  • cassandra.c.2xlarge:8核 16G
MajorVersion String 3.11

主版本号。

NodeCount Integer 3

节点数。

PayType String Subscription

付费类型:

  • Subscription:包年包月
  • PayAsYouGo:按量付费
说明 按量付费实例无到期时间。
RegionId String cn-hangzhou

地域ID,可以通过接口DescribeRegions查看可用的地域ID。

VpcId String vpc-bp1oxxxxxxxxxxgzv26cd

VPC网络的ID。

VswitchId String vsw-oqscxxxxxxxxxxxxx5e8c

虚拟交换机的ID。

ZoneId String cn-hangzhou-h

可用区ID,可调用DescribeRegions查询,使用此参数指定要创建实例的可用区。

PeriodUnit String Year

指定预付费实例为包年或者包月类型,取值:

  • Year:包年;
  • Month:包月。
说明 若付费类型为Subscription则该参数必须传入。
Period Integer 12

付费周期,PayType(付费类型)为Subscription时为必选参数,单位为月,可选值:1-9,12,24,36 。

说明 付费类型为PayAsYouGo时不支持传入此参数。
AutoRenew Boolean true

是否开启自动续费,可选值:

  • true(开启)
  • false(不开启)

默认值:false。

AutoRenewPeriod Integer 3

自动续费周期,单位为月,可选值:

  • 1
  • 2
  • 3
  • 6
  • 12
说明 当AutoRenew为true时该参数必选。
ClusterName String apitest

集群名称。

长度为2-128个字符,以大小写字母或中文开头,可包含数字,‘.’,‘_’或‘-’。

DataCenterName String apitest

数据中心名称。

Password String Alibaba****!@#

密码。

格式要求:大写、小写、数字、特殊字符占三种,长度8-32位;特殊字符为!@#$%^&*()_+-=

ResourceGroupId String rg-xxxxxx

资源组ID,不设置时落在默认资源组里,可在资源组控制台查看资源组ID。

返回数据

名称 类型 示例值 描述
ClusterId String cds-bp1hy2ip****z46g

实例ID。

RequestId String 3E19E345-101D-4014-946C-A2055AEE1F26

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateCluster
&ClientToken=ETnLKlblzczshOTUbOCzxxxxxxxxxx
&DiskSize=160
&DiskType=cloud_ssd
&InstanceType=cassandra.c.xlarge
&MajorVersion=3.11
&NodeCount=3
&PayType=Subscription
&RegionId=cn-hangzhou
&VpcId=vpc-bp1oxxxxxxxxxxgzv26cd
&VswitchId=vsw-oqscxxxxxxxxxxxxx5e8c
&ZoneId=cn-hangzhou-h
&<公共请求参数>

正常返回示例

XML格式

<CreateClusterResponse>
  <ClusterId>hb-bp16o0pd5****582s</ClusterId>
  <RequestId>728C7EAF-4844-4D42-9BBE-DFFFBB77CF33</RequestId>
</CreateClusterResponse>

JSON格式

{
	"ClusterId":"hb-bp16o0pd5****582s",
	"RequestId":"728C7EAF-4844-4D42-9BBE-DFFFBB77CF33"
}

错误码

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