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

调试

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

请求参数

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

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

ClientToken String ETnLKlblzczshOTUbOC***ioIUBoiB

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

ClusterId String cds-bp113rmn****2uy9

集群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核 4
  • 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=ETnLKlblzczshOTUbOC***ioIUBoiB
&ClusterId=cds-bp113rmn****2uy9
&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 格式

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

JSON 格式

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

错误码

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