调用CreateDBCluster接口创建一个AnalyticDB MySQL版集群。

调试

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

请求参数

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

系统规定参数。取值：CreateDBCluster。

RegionId String 是 cn-hangzhou

地域ID，通过DescribeRegions查看可用的地域。

ZoneId String 否 cn-hangzhou-h

可用区ID，通过DescribeRegions查看可用区ID。

DBClusterVersion String 是 3.0

AnalyticDB MySQL集群版本，取值：3.0。

DBClusterCategory String 是 Cluster

系列。取值说明：

  • Cluster：预留模式集群版。
说明 仅中国内地地域和新加坡地域支持购买预留模式集群版。其中，新加坡地域仅支持在按量付费模式下购买预留模式集群版。
  • MixedStorage：弹性模式集群版（新版）。
说明 当DBClusterCategory为Cluster时，Mode参数必须填写Reserver；当DBClusterCategory为MixedStorage时，Mode参数必须填写Flexible，否则会导致创建集群失败。
DBClusterClass String 否 C8

集群规格，取值：

  • C8
  • C32
说明 Mode取值为Reserver（即预留模式）时，本参数必填。
DBNodeGroupCount String 否 2

节点组数量，取值范围为：1~200（整数）。

说明 Mode取值为Reserver（即预留模式）时，本参数必填。
DBNodeStorage String 否 200

节点存储空间，单位：GB。取值说明：

  • 规格为C8时，取值范围为：100~1000。
  • 规格为C32时，取值范围为：100~8000。
说明
  • Mode取值为Reserver（即预留模式）时，本参数必填。
  • 1000 GB以下步长为100 GB，1000 GB以上步长为1000 GB。
DBClusterNetworkType String 是 VPC

网络类型：VPC。

DBClusterDescription String 否 test

集群描述。

  • 不能以http://或者https开头。
  • 长度为2~256个字符。
PayType String 是 Postpaid

付费类型。取值说明：

  • Postpaid：按量付费。
  • Prepaid：预付费（包年包月）。
Period String 否 Year

指定预付费集群为包年或包月类型。取值说明：

  • Year：包年类型。
  • Month：包月类型。
说明 PayType为Prepaid（即预付费（包年包月））时，本参数为必填参数。
UsedTime String 否 1

使用时间。取值说明：

  • 当Period为Year时，UsedTime取值范围为：1~3（整数）。
  • 当Period为Month时，UsedTime取值范围为：1~9（整数）。
说明 PayType为Prepaid（即预付费（包年包月））时，本参数为必填参数。
VPCId String 否 vpc-bp1at5ze0t5u3xtqn****

专有网络ID。
VSwitchId String 否 vsw-bp1aadw9k19x6cis9****

虚拟交换机ID。
ClientToken String 否 123e4567-e89b-12d3-a456-t7241****

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

预留参数，不涉及。
ResourceGroupId String 否 rg-4690g37929****

资源组ID。
Mode String 是 Reserver

模式。取值说明：

  • Reserver：预留模式。
  • Flexible：弹性模式。
说明 本参数不填写时，默认为预留模式。
StorageResource String 否 无

预留参数，不涉及。
StorageType String 否 无

预留参数，不涉及。
ComputeResource String 否 32Core128GB

计算资源，您可以调用DescribeAvailableResource接口查询指定地域中可用的计算资源。

说明 Mode取值为Flexible（即弹性模式）时，本参数必填。
RestoreType String 否 无

预留参数，不涉及。
SourceDBInstanceName String 否 无

预留参数，不涉及。
BackupSetID String 否 无

预留参数，不涉及。
RestoreTime String 否 无

预留参数，不涉及。
ElasticIOResource String 否 0

弹性IO资源（Elastic IO Unit，简称EIU），更多详情，请参见EIU详解。

返回数据

名称 类型 示例值 描述
RequestId String 1AD222E9-E606-4A42-BF6D-8A4442913CEF

请求ID。
ResourceGroupId String rg-4690g37929****

资源组ID。
DBClusterId String am-bp1r053byu48p****

集群ID。
OrderId String 202353278****

订单ID。

示例

请求示例

http(s)://adb.aliyuncs.com/?Action=CreateDBCluster
&RegionId=cn-hangzhou
&ZoneId=cn-hangzhou-h
&DBClusterVersion=3.0
&DBClusterCategory=Cluster
&DBClusterClass=C8
&DBNodeGroupCount=2
&DBNodeStorage=200
&DBClusterNetworkType=VPC
&DBClusterDescription=test
&PayType=Postpaid
&Period=Year
&UsedTime=1
&VPCId=vpc-bp1at5ze0t5u3xtqn****
&VSwitchId=vsw-bp1aadw9k19x6cis9****
&ClientToken=123e4567-e89b-12d3-a456-t7241****
&ResourceGroupId=rg-4690g37929****
&Mode=Reserver
&ComputeResource=32Core128GB
&ElasticIOResource=0
&公共请求参数

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateDBClusterResponse>
    <RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>
    <ResourceGroupId>rg-4690g37929****</ResourceGroupId>
    <DBClusterId>am-bp1r053byu48p****</DBClusterId>
    <OrderId>202353278****</OrderId>
</CreateDBClusterResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "1AD222E9-E606-4A42-BF6D-8A4442913CEF",
  "ResourceGroupId" : "rg-4690g37929****",
  "DBClusterId" : "am-bp1r053byu48p****",
  "OrderId" : "202353278****"
}

错误码

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