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

錯誤碼

訪問錯誤中心查看更多錯誤碼。