功能描述
创建 DRDS 实例。
请求参数
[backcolor=transparent]参数名 | [backcolor=transparent]类型 | [backcolor=transparent]是否必须 | [backcolor=transparent]描述 |
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 实例分为四种规格, 详见下表《实例规格参数》 |
PayType | String | 是 | 付费类型,暂时只支持drdsPost |
VpcId | String | 否 | 虚拟专用网络 ID,创建 VPC 网络类型的 DRDS 时必须指定 |
VswitchId | String | 否 | 虚拟交换机 ID,创建 VPC 网络类型的 DRDS 时必须指定 |
规格 | 内存与 CPU |
drds.small | 4核4G |
drds.standard | 8核8G |
drds.large | 16核16G |
drds.xlarge | 32核32G |
[backcolor=transparent]参数名 | [backcolor=transparent]类型 | [backcolor=transparent]描述 |
公共返回值 | ||
DrdsInstanceId | List<String> | 创建出来的实例标识 |
OrderId | String | 订单号 |
[backcolor=transparent]错误 | [backcolor=transparent]错误代码 | [backcolor=transparent]描述 | [backcolor=transparent]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 |
用户的 DRDS 实例个数已经达到上限 | QuotaExceeded.DRDSInstance | The quota of create instance exceeds. | 400 |
指定的地域不存在 | InvalidRegionId.NotFound | The RegionId provided does not exist in our records. | 404 |
参数description不合法 | InvalidDescription.MalFormed | The specified parameter description is not valid. | 400 |
与 DRDS Server 通信错误 | CommunicateWithManager.Error | Internal Error. Communicate with drds manager error | 400 |
虚拟交换机 ID 错误 | InvalidVSwitchId | Invalid vswitchId | 400 |
虚拟专用网络 ID | InvalidVpcId | Invalid vpcId | 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 |
生成 DRDS 实例错误 | CreateDRDSInstanceId.Error | create DRDS instance id error | 400 |
已有相同任务在执行中 | AnotherOrderExist.Error | there is another order | 400 |
实例数量超过上限 | InstanceExceedLimit.Error | instance number has exceeded | 400 |
不能创建 VPC 网络类型的共享实例 | InvalidDRDSInstanceType.Error | Cannot create Public DRDS instance with vpcId or vswitch | 400 |
Quantity 参数错误 | InvalidParameter.Quantity | Invalid parameter of quantity | 400 |
RegionId 参数错误 | InvalidParameter.RegionId | Invalid parameter of region id | 400 |
zoneId(可用区)参数错误 | InvalidParameter.ZoneId | Invalid parameter of zone id | 400 |
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。
根据您提供的信息,这是关于如何使用阿里云分布式关系型数据库服务(DRDS)创建实例的API请求参数、实例规格、返回值以及可能遇到的错误码的详细说明。下面我将帮助您理解这一过程:
确定需求:首先明确您需要创建的DRDS实例类型(共享或专享)、规格(如drds.small至drds.xlarge)、数量、付费方式等。
准备参数:
Action
: 必须设置为CreateDrdsInstance
。Description
: 输入对实例的描述,限制在2-128个字符。RegionId
: 选择实例所在的区域ID。Type
: 实例类型,0表示共享实例,1表示专享实例,也可以直接用PUBLIC
和PRIVATE
表示。ZoneId
: 可用区ID,需属于所选区域。Quantity
: 购买实例的数量。Specification
: 选择实例规格,如drds.small
到drds.xlarge
。PayType
: 付费类型,目前只支持预付费(可能已更新,请参考最新文档)。VpcId
和VswitchId
。发起请求:通过阿里云API Gateway或者SDK,以POST方法提交上述参数到指定的API端点。
处理响应:成功创建后,阿里云会返回新创建的DrdsInstanceIdList
(实例标识列表)和OrderId
(订单号)。如果遇到错误,会返回相应的错误码和描述。
ServiceUnableDRDS
: 表示您的账号未开通DRDS服务。InvalidParameter.PayType
: 指定的付费类型不被接受,可能是输入了不支持的付费模式。QuotaExceeded.DRDSInstance
: 您尝试创建的DRDS实例数量超出了账户的配额限制。请根据实际需求和上述指南操作,并随时查阅阿里云官方文档获取最新的API调用详情和最佳实践。