调用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查看可用的地域。

DBClusterVersion String 3.0

AnalyticDB MySQL集群版本,取值:3.0。

DBClusterCategory String Cluster

系列。

  • 预留模式,取值:
    • Basic:基础版
    • Cluster:集群版
  • 弹性模式,取值:

    MixedStorage:集群版(新版)

DBClusterClass String C8

规格,预留模式下需提供。取值:

  • 基础版:T8/T16/T32/T52
  • 集群版:C8/C32
DBNodeGroupCount String 2

节点组数量,预留模式下需提供。取值:

  • T8/T16/T32/T52:1
  • C8/C32:1-128
DBNodeStorage String 200

节点存储空间,预留模式下需提供。取值:

  • T8:100-500GB
  • T16/T32:100-2000GB
  • T52:100-4000GB
  • C8:100-1000GB
  • C32:100-8000GB
说明 1000GB以下步长为100GB,1000GB以上步长为1000GB
DBClusterNetworkType String VPC

网络类型:VPC。

DBClusterDescription String test

备注信息。

PayType String Postpaid

付费类型:

  • Postpaid:按量付费;
  • Prepaid:预付费(包年包月)。
Period String Year

若付费类型为Prepaid时,该参数为必传参数。指定预付费集群为包年或包月类型。

  • Year:包年;
  • Month:包月。
UsedTime String 1
  • 当Period为Month时,UsedTime取值为[1-9]。
  • 当Period为Year时,UsedTime取值为[1-3]。
VPCId String vpc-xxxxxxxx

专有网络ID。

说明 若该字段留空,则使用该地域下默认的专有网络VPC或交换机,如果默认VPC不存在,则会自动创建一个VPC。
VSwitchId String vsw-xxxxxxxx

虚拟交换机ID。

ClientToken String 123e4567-e89b-12d3-a456-xxxxxxxx

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

ExecutorCount String 1

弹性模式下集群使用的计算节点数量。

ResourceGroupId String rg-xxxxxxxx

资源组ID。

Mode String Reserver

模式。

  • Reserver:预留
  • Flexible:弹性
StorageResource String

不涉及。

StorageType String

不涉及。

ComputeResource String 32Core128GB

计算资源,弹性模式下需提供。

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-xxxxxxxx

资源组ID。

DBClusterId String am-bpxxxxxxxx47

集群ID。

OrderId String 20235327xxxxx

订单ID。

示例

请求示例

http(s)://adb.aliyuncs.com/?Action=CreateDBCluster
&DBClusterCategory=Cluster
&DBClusterClass=C8
&DBClusterNetworkType=VPC
&DBClusterVersion=3.0
&DBNodeGroupCount=2
&DBNodeStorage=200
&Mode=Reserver
&PayType=Postpaid
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML格式

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

<CreateDBClusterResponse>
    <ResourceGroupId>rg-xxxxxxxx</ResourceGroupId>
    <RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>
    <DBClusterId>am-bpxxxxxxxx47</DBClusterId>
    <OrderId>20235327xxxxx</OrderId>
</CreateDBClusterResponse>

JSON格式

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

{
  "ResourceGroupId" : "rg-xxxxxxxx",
  "RequestId" : "1AD222E9-E606-4A42-BF6D-8A4442913CEF",
  "DBClusterId" : "am-bpxxxxxxxx47",
  "OrderId" : "20235327xxxxx"
}

错误码

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