调用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. 请求失败，内部错误

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