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

调试

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

请求参数

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

系统规定参数,取值:

CreateDBCluster。

DBClusterCategory String Cluster

系列。

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

    MixedStorage:集群版(新版)

DBClusterNetworkType String VPC

网络类型:VPC。

DBClusterVersion String 3.0

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

Mode String Reserver

模式。

  • Reserver:预留
  • Flexible:弹性
PayType String Postpaid

付费类型:

  • Postpaid:按量付费;
  • Prepaid:预付费(包年包月)。
RegionId String cn-hangzhou

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

ZoneId String cn-hangzhou-h

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

DBClusterDescription String test

备注信息。

DBNodeGroupCount String 2

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

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

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

  • 基础版:T8/T16/T32/T52
  • 集群版:C8/C32
DBNodeStorage String 200

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

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

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

Period String Year

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

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

专有网络ID。

VSwitchId String vsw-xxxxxxxx

虚拟交换机ID。

ResourceGroupId String rg-xxxxxxxx

资源组ID。

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

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

StorageResource String

不涉及。

StorageType String

不涉及。

RestoreType String

不涉及。

ExecutorCount String

不涉及。

SourceDBInstanceName String

不涉及。

BackupSetID String

不涉及。

RestoreTime String

不涉及。

返回数据

名称 类型 示例值 描述
DBClusterId String am-bpxxxxxxxx47

实例ID。

OrderId String 20235327xxxxx

订单ID。

RequestId String 1AD222E9-E606-4A42-BF6D-8A4442913CEF

请求ID。

ResourceGroupId String rg-xxxxxxxx

资源组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 格式

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

JSON 格式

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

错误码

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