PolarDB-X 1.0-API參考-1.0（2017版本）-執行個體管理類 API-建立 DRDS 執行個體

功能描述

用于建立指定規格的 DRDS 執行個體。

請求參數

參數名	類型	是否必須	描述
Action	String	是	系統規定參數，取值：CreateDrdsInstance
Description			DRDS 執行個體的描述，2-128個字元
RegionId			區域
Type			執行個體類型， 執行個體類型 0 -共享執行個體 1-專享執行個體，此外該參數也可以傳遞 PRIVATE 和 PUBLIC 分别表示專享執行個體和共享執行個體
ZoneId			可用區，一個可用區屬于某個區域，如杭州可用區 A（cn-hangzhou-a）屬于區域杭州（cn-hangzhou）
Quantity	Integer		購買數量
Specification			執行個體規格，取值例如：drds.sn1.4c8g.8C16G，由DRDS執行個體系列（drds.sn1.4c8g）加上具體的執行個體規格（8C16G）組成。 DRDS 執行個體規格取值範圍詳見： 分布式關系型資料庫服務規格和定價
PayType			付費類型，見 《付費類型參數表》
VpcId		否	虛拟專用網絡 ID，建立 VPC 網絡類型的 DRDS 時必須指定
VswitchId			虛拟交換機 ID，建立 VPC 網絡類型的 DRDS 時必須指定
InstanceSeries			執行個體系列，詳見下表 《執行個體系列參數》
PricingCycle			訂購的周期機關，年：year，月：month。付費類型是drdsPre時參數生效。
Duration			訂購的周期數量 。PricingCycle=year時，取值1-3；PricingCycle=month時，取值1-9。付費類型是drdsPre時參數生效。
IsAutoRenew	Boolean		是否自動續費，如果按月購買則自動續費一個月，如果按年購買則自動續費一年。付費類型是drdsPre時參數生效。

付費類型參數表

付費類型
drdsPost	按量付費
drdsPre	預付費，包月或者包年，具體購買時間由Duration和PricingCycle配置生效。 ⚠️注意：下訂單後，賬号自動付費。

執行個體系列參數

系列	記憶體與 CPU
drds.sn1.4c8g	入門版
drds.sn1.8c16g	标準版
drds.sn1.16c32g	企業版
drds.sn1.32c64g	至尊版

傳回值

公共傳回值
DrdsInstanceId	List<String>	建立出來的執行個體辨別
OrderId		訂單号

錯誤碼

	報錯資訊	錯誤描述	HTTP 狀态碼
ServiceUnable	DRDS service is not enable for you	服務未開通	400
ParameterError	Parameter error	參數錯誤
ActionUnauthorized	The specified action is not available for you	權限錯誤
OperationDenied	The resource is out of usage.	資源不足，無法建立
QuotaExceeded.DRDSInstance	The quota of create instance exceeds.	使用者的 DRDS 執行個體個數已經達到上限
InvalidRegionId.NotFound	The RegionId provided does not exist in our records.	指定的地域不存在	404
InvalidDescription.MalFormed	The specified parameter description is not valid.	參數 description 不合法
CommunicateWithManager.Error	Internal Error. Communicate with drds manager error	與 DRDS Server 通信錯誤
InvalidVSwitchId	Invalid vswitchId	虛拟交換機 ID 錯誤
InvalidVpcId	Invalid vpcId	虛拟專用網絡 ID
InvalidZoneId.Mismatch	zone is illegal in this order	可用區錯誤
LowInventory.ServerError	low inventory error	庫存不足
publicInstanceAlreadExist.Error	A public DRDS instance is exist	該區域已存在共享執行個體
CreateDRDSInstanceId.Error	create DRDS instance id error	生成 DRDS 執行個體錯誤
AnotherOrderExist.Error	there is another order	已有相同任務在執行中
InstanceExceedLimit.Error	instance number has exceeded	執行個體數量超過上限
InvalidDRDSInstanceType.Error	Cannot create Public DRDS instance with vpcId or vswitch	不能建立 VPC 網絡類型的共享執行個體
InvalidParameter.Quantity	Invalid parameter of quantity	Quantity 參數錯誤
InvalidParameter.RegionId	Invalid parameter of region id	RegionId 參數錯誤
InvalidParameter.ZoneId	Invalid parameter of zone id	zoneId（可用區）參數錯誤
InvalidParameter.PayType	Invalid parameter of pay type	付費類型錯誤
InvalidParameter.Spection	Invalid parameter of specification	規格錯誤
InvalidParameter.Series		執行個體系列錯誤
QueryVSwitchFailed.InvalidVpcIdOrServerError	Query VSwitch failed, please check vpcId	校驗 VSwitchId 失敗
RegionNotSupportVPC.Error	This region does not support vpc instance	該區域不支援建立 VPC 執行個體
InvalidParameter.duration_pricingCycle	when payType=drdsPre, duration and pricingCycle is required	預付費模式時，必須填寫參數duration和pricingCycle
InvalidParameter.year.duration	when pricingCycle=year, duration must between 1 to 3	購買周期pricingCycle=year時，duration取值1-3
InvalidParameter.month.duration	when pricingCycle=month, duration must between 1 to 9	購買周期pricingCycle=month時，duration取值1-9