調用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. 請求失敗，內部錯誤

訪問錯誤中心查看更多錯誤碼。