调用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"
}

错误码

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