调用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

付费类型,创建只读实例时为drdsRo,默认按量付费模式。

Quantity Integer 1

创建数量,一次只能创建一个。

RegionId String cn-hangzhou

地域ID。

Specification String drds.sn1.4c16g.8C32G

实例规格。

Type String PRIVATE

实例类型。

  • 共享实例:0
  • 专享实例:1
说明 您也可以传入PRIVATE表示专享实例或传入PUBLIC表示共享实例
Description String test

DRDS实例的描述,2-128个字符。

InstanceSeries String drds.sn1.4c16g

实例系列参数。

VpcId String vpcId

虚拟专用网络ID,创建VPC网络类型时必须指定该参数。

VswitchId String vswitchId

虚拟交换机ID,创建VPC网络类型时必须指定该参数。

isHa Boolean true

是否为高可用实例。

PricingCycle String month

订购的周期单位。

  • 年:year
  • 月:month
说明 付费类型是drdsPre时参数生效。
Duration Integer 1

订购的周期数量 。

  • PricingCycle=year时:取值1-3
  • PricingCycle=month时:取值1-9
说明 付费类型是drdsPre时参数生效。
IsAutoRenew Boolean true

是否自动续费,如果按月购买则自动续费一个月,如果按年购买则自动续费一年。

说明 付费类型是drdsPre时参数生效。
MasterInstId String drdshbgaf7pp****

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

MySQLVersion Integer 5

DRDS所支持的MySQL协议版本,默认为5,可取值为5或8。

说明 仅当创建主实例时有效,只读实例默认与主实例相同。

返回数据

名称 类型 示例值 描述
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 格式

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

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授权再进行操作。

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

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