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"
}

错误码

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