且构网

分享程序员开发的那些事...
且构网 - 分享程序员编程开发的那些事

PolarDB-X 1.0-API参考-1.0(2017版本)-实例管理类 API-创建 DRDS 实例

更新时间:2022-05-09 22:49:03

功能描述

用于创建指定规格的 DRDS 实例。

请求参数

参数名 类型 是否必须 描述
Action String 系统规定参数,取值:CreateDrdsInstance
Description String DRDS 实例的描述,2-128个字符
RegionId String 区域
Type String 实例类型, 实例类型 0 -共享实例 1-专享实例,此外该参数也可以传递 PRIVATE 和 PUBLIC 分别表示专享实例和共享实例
ZoneId String 可用区,一个可用区属于某个区域,如杭州可用区 A(cn-hangzhou-a)属于区域杭州(cn-hangzhou)
Quantity Integer 购买数量
Specification String 实例规格,取值例如:drds.sn1.4c8g.8C16G,由DRDS实例系列(drds.sn1.4c8g)加上具体的实例规格(8C16G)组成。 DRDS 实例规格取值范围详见:分布式关系型数据库服务规格和定价
PayType String 付费类型,见《付费类型参数表》
VpcId String 虚拟专用网络 ID,创建 VPC 网络类型的 DRDS 时必须指定
VswitchId String 虚拟交换机 ID,创建 VPC 网络类型的 DRDS 时必须指定
InstanceSeries String 实例系列,详见下表《实例系列参数》
PricingCycle String 订购的周期单位,年:year,月:month。付费类型是drdsPre时参数生效。
Duration Integer 订购的周期数量 。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 String 订单号

错误码

错误码 报错信息 错误描述 HTTP 状态码
ServiceUnable DRDS service is not enable for you 服务未开通 400
ParameterError Parameter error 参数错误 400
ActionUnauthorized The specified action is not available for you 权限错误 400
OperationDenied The resource is out of usage. 资源不足,无法创建 400
QuotaExceeded.DRDSInstance The quota of create instance exceeds. 用户的 DRDS 实例个数已经达到上限 400
InvalidRegionId.NotFound The RegionId provided does not exist in our records. 指定的地域不存在 404
InvalidDescription.MalFormed The specified parameter description is not valid. 参数 description 不合法 400
CommunicateWithManager.Error Internal Error. Communicate with drds manager error 与 DRDS Server 通信错误 400
InvalidVSwitchId Invalid vswitchId 虚拟交换机 ID 错误 400
InvalidVpcId Invalid vpcId 虚拟专用网络 ID 400
InvalidZoneId.Mismatch zone is illegal in this order 可用区错误 400
LowInventory.ServerError low inventory error 库存不足 400
publicInstanceAlreadExist.Error A public DRDS instance is exist 该区域已存在共享实例 400
CreateDRDSInstanceId.Error create DRDS instance id error 生成 DRDS 实例错误 400
AnotherOrderExist.Error there is another order 已有相同任务在执行中 400
InstanceExceedLimit.Error instance number has exceeded 实例数量超过上限 400
InvalidDRDSInstanceType.Error Cannot create Public DRDS instance with vpcId or vswitch 不能创建 VPC 网络类型的共享实例 400
InvalidParameter.Quantity Invalid parameter of quantity Quantity 参数错误 400
InvalidParameter.RegionId Invalid parameter of region id RegionId 参数错误 400
InvalidParameter.ZoneId Invalid parameter of zone id zoneId(可用区)参数错误 400
InvalidParameter.PayType Invalid parameter of pay type 付费类型错误 400
InvalidParameter.Spection Invalid parameter of specification 规格错误 400
InvalidParameter.Series Invalid parameter of specification 实例系列错误 400
QueryVSwitchFailed.InvalidVpcIdOrServerError Query VSwitch failed, please check vpcId 校验 VSwitchId 失败 400
RegionNotSupportVPC.Error This region does not support vpc instance 该区域不支持创建 VPC 实例 400
InvalidParameter.duration_pricingCycle when payType=drdsPre, duration and pricingCycle is required 预付费模式时,必须填写参数duration和pricingCycle 400
InvalidParameter.year.duration when pricingCycle=year, duration must between 1 to 3 购买周期pricingCycle=year时,duration取值1-3 400
InvalidParameter.month.duration when pricingCycle=month, duration must between 1 to 9 购买周期pricingCycle=month时,duration取值1-9 400