调用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 |
系列。取值说明:
说明 仅中国内地地域和新加坡地域支持购买预留模式集群版。其中,新加坡地域仅支持在按量付费模式下购买预留模式集群版。
说明 当DBClusterCategory为Cluster时,Mode参数必须填写Reserver;当DBClusterCategory为MixedStorage时,Mode参数必须填写Flexible,否则会导致创建集群失败。
|
DBClusterClass | String | 否 | C8 |
集群规格,取值:
说明 Mode取值为Reserver(即预留模式)时,本参数必填。
|
DBNodeGroupCount | String | 否 | 2 |
节点组数量,取值范围为:1~200(整数)。 说明 Mode取值为Reserver(即预留模式)时,本参数必填。
|
DBNodeStorage | String | 否 | 200 |
节点存储空间,单位:GB。取值说明:
说明
|
DBClusterNetworkType | String | 是 | VPC |
网络类型:VPC。 |
DBClusterDescription | String | 否 | test |
集群描述。
|
PayType | String | 是 | Postpaid |
付费类型。取值说明:
|
Period | String | 否 | Year |
指定预付费集群为包年或包月类型。取值说明:
说明 PayType为Prepaid(即预付费(包年包月))时,本参数为必填参数。
|
UsedTime | String | 否 | 1 |
使用时间。取值说明:
说明 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 |
模式。取值说明:
说明 本参数不填写时,默认为预留模式。
|
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****"
}
错误码
访问错误中心查看更多错误码。