调用CreateDrdsInstance接口创建新实例。

调试

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

请求参数

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

系统规定参数,取值为CreateDrdsInstance

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

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

ZoneId String cn-hangzhou-e

可用区ID。

PayType String drdsPost

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

  • drdsPre:包年包月(也称预付费)。
  • drdsPost:按量付费(也称后付费)。
  • drdsRo:创建只读实例时,默认按量付费模式。
Quantity Integer 1

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

RegionId String cn-hangzhou

地域ID。

Specification String drds.sn1.4c16g.8C32G

实例规格码,取值由实例系列加具体实例规格组成,例如drds.sn1.4c8g.8C16G

关于实例规格详情,请参见实例规格

Type String PRIVATE

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

说明 您也可以传入1表示专享实例。
Description String test

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

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

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

  • drds.sn2.4c16g:入门版
  • drds.sn2.8c32g:标准版
  • drds.sn2.16c64g:企业版
VpcId String vpc-**********

专有网络ID。

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

虚拟交换机ID。

isHa Boolean true

是否为高可用实例。

PricingCycle String month

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

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

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

  • PricingCycleyear时,取值范围为1~3。
  • PricingCyclemonth时,取值范围为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。

返回数据

名称 类型 示例值 描述
Data Struct

结果详情。

DrdsInstanceIdList List drds************

实例ID。

OrderId Long 111111111111111

订单ID。

RequestId String D99D4644-A70D-49A3-B8B4-767ACC50****

请求ID。

Success Boolean true

请求结果。

示例

请求示例

http(s)://drds.aliyuncs.com/?Action=CreateDrdsInstance
&ClientToken=c1dd299c-10c6-11ea-bbbb-************
&ZoneId=cn-hangzhou-e
&PayType=drdsPost
&Quantity=1
&RegionId=cn-hangzhou
&Specification=drds.sn1.4c16g.8C32G
&Type=PRIVATE
&Description=test
&<公共请求参数>

正常返回示例

XML 格式

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

JSON 格式

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

错误码

HttpCode 错误码 错误信息 描述
400 ActionUnauthorized The specified action is not available for you 指定的action未授权,请您先做RAM授权再进行操作。

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