调用CreateDrdsInstance接口创建新实例。

调试

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

请求参数

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

系统规定参数。取值:CreateDrdsInstance

Description String test

实例描述,需满足如下要求:

  • 不能以http://或https://开头。
  • 必须以字母或中文开头,可包含大小写字母、中文、数字、下划线(_)或短划线(-)。
  • 长度为2~256个字符。
RegionId String cn-hangzhou

地域ID。

ZoneId String cn-hangzhou-e

可用区ID。

Type String PRIVATE

实例类型,仅支持PRIVATE,即专享实例。

说明 您也可以传入1表示专享实例。
Quantity Integer 1

创建实例的数量,仅支持传入1,即一次只能创建一个实例。

InstanceSeries String drds.sn2.4c16g

实例系列参数,取值范围如下:

  • drds.sn2.4c16g:入门版
  • drds.sn2.8c32g:标准版
  • drds.sn2.16c64g:企业版
Specification String drds.sn2.4c16g.8C32g

实例规格码,取值由实例系列加具体实例规格组成,例如drds.sn2.4c16g.8c32g。

ClientToken String c1dd299c-10c6-11ea-bbbb-************

用于保证请求的幂等性,防止重复提交请求。由客户端生成该参数值,要保证在不同请求间唯一,最大值不超过64个ASCII字符,且该参数值中不能包含非ASCII字符。

PayType String drdsPost

付费类型,取值范围如下:

  • drdsPre:包年包月(也称预付费)。
  • drdsPost:按量付费(也称后付费)。
  • drdsRo:创建只读实例时,默认按量付费模式。
VpcId String vpc-**********

专有网络ID。

VswitchId String vsw-**********

虚拟交换机ID。

isHa Boolean true

是否为高可用实例。

PricingCycle String month

指定预付费实例为包年或包月类型,取值范围如下:

  • year:年
  • month:月
说明 若付费类型为drdsPre,该参数为必传参数。
Duration Integer 1

包年或包月实例的购买时长。

  • 当PricingCycle为year时,取值范围为1~3。
  • 当PricingCycle为month时,取值范围为1~9。
说明 仅当付费类型是drdsPre时该参数生效。
IsAutoRenew Boolean true

是否自动续费,取值范围如下:

  • true:如果按月购买则自动续费一个月,如果按年购买则自动续费一年。
  • false:不自动续费。
说明 仅当付费类型为drdsPre时该参数生效。
MasterInstId String drds***********

主实例ID,仅在创建只读实例时填写。

MySQLVersion Integer 5

实例支持的MySQL版本,取值范围如下:

  • 5:与MySQL 5.x完全兼容(默认)
  • 8:与MySQL 8.0完全兼容
说明 仅当创建主实例时该参数生效,只读实例的MySQL版本默认与主实例相同。
ResourceGroupId String rg-************

资源组ID。

返回数据

名称 类型 示例值 描述
Success Boolean true

请求是否成功。

RequestId String D99D4644-A70D-49A3-B8B4-767ACC50SE2R

请求ID。

Data Object

结果详情。

OrderId Long 111111111111111

订单ID。

DrdsInstanceIdList Array of String drds************

实例ID。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateDrdsInstance
&Description=test
&RegionId=cn-hangzhou
&ZoneId=cn-hangzhou-e
&Type=PRIVATE
&Quantity=1
&InstanceSeries=drds.sn2.4c16g
&Specification=drds.sn2.4c16g.8C32g
&ClientToken=c1dd299c-10c6-11ea-bbbb-************
&PayType=drdsPost
&VpcId=vpc-**********
&VswitchId=vsw-**********
&isHa=true
&PricingCycle=month
&Duration=1
&IsAutoRenew=true
&MasterInstId=drds***********
&MySQLVersion=5
&ResourceGroupId=rg-************
&公共请求参数

正常返回示例

XML格式

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

<CreateDrdsInstanceResponse>
    <Success>true</Success>
    <RequestId>D99D4644-A70D-49A3-B8B4-767ACC50SE2R</RequestId>
    <Data>
        <OrderId>111111111111111</OrderId>
        <DrdsInstanceIdList>drds************</DrdsInstanceIdList>
    </Data>
</CreateDrdsInstanceResponse>

JSON格式

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

{
  "Success" : true,
  "RequestId" : "D99D4644-A70D-49A3-B8B4-767ACC50SE2R",
  "Data" : {
    "OrderId" : 111111111111111,
    "DrdsInstanceIdList" : [ "drds************" ]
  }
}

错误码

HttpCode 错误码 错误信息 描述
400 ActionUnauthorized The specified action is not available for you 指定的action未授权,请您先做RAM授权再进行操作。
500 InternalError The request processing has failed due to some unknown error. 请求失败,内部错误

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