调用CreateDataCenter为集群添加数据中心。

调试

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

请求参数

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

系统规定参数。取值：CreateDataCenter。
ClientToken String 是 ETnLKlblzczshOTUbOCioIU****

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

集群ID。
DiskSize Integer 是 160

磁盘存储大小（每节点，单位GB）。
DiskType String 是 cloud_ssd

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

  • cloud_ssd：SSD云盘
  • cloud_essd：ESSD云盘
  • cloud_efficiency：高效云盘
  • local_ssd_pro：本地SSD盘
InstanceType String 是 cassandra.c.large

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

  • cassandra.c.large：2核 4G
  • Gcassandra.c.xlarge：4核 8G
  • cassandra.c.2xlarge：8核 16G
NodeCount Integer 是 2

节点数。
PayType String 是 Subscription

付费类型：

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

地域ID，可以通过接口DescribeRegions查看可用的地域ID。
VpcId String 是 vpc-bp1oxxxxxxxxxxgzv26cf

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 否 12

自动续费周期，单位为月，可选值：

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

数据中心名称。

返回数据

名称 类型 示例值 描述
DataCenterId String cn-hangzhou-g

集群数据中心ID。
RequestId String 3E19E345-101D-4014-946C-A2055AEE1F26

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateDataCenter
&ClientToken=ETnLKlblzczshOTUbOCioIU****
&ClusterId=cds-bp113rmn2uy9****
&DiskSize=160
&DiskType=cloud_ssd
&InstanceType=cassandra.c.large
&NodeCount=2
&PayType=Subscription
&RegionId=cn-hangzhou
&VpcId=vpc-bp1oxxxxxxxxxxgzv26cf
&VswitchId=vsw-oqscxxxxxxxxxxxxx5e8c
&ZoneId=cn-hangzhou-h
&<公共请求参数>

正常返回示例

XML格式 

<DataCenterId>cn-hangzhou-g</DataCenterId>
<RequestId>728C7EAF-4844-4D42-9BBE-DFFFBB77CF33</RequestId>

JSON格式 

{
	"DataCenterId":"cn-hangzhou-g",
	"RequestId":"728C7EAF-4844-4D42-9BBE-DFFFBB77CF33"
}

错误码

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