调用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。

说明 VPCid字段如果不填，会使用该region默认的vpc或vswitch，如果默认VPC不存在，则会自动创建一个VPC。
VSwitchId String 否 vsw-xxxxxxxx

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

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

不涉及。
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 否 无

不涉及。

返回数据

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

请求ID。
ResourceGroupId String rg-xxxxxxxx

资源组ID。
DBClusterId String am-bpxxxxxxxx47

实例ID。
OrderId String 20235327xxxxx

订单ID。

示例

请求示例

http(s)://[Endpoint]/?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

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

JSON格式 

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

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

错误码

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