1. 接口描述
本接口(CreateRedis)用于创建实例。
接口请求域名:redis.api.qcloud.com
1. 实例容量单位:MB, 取值为1024的整数倍, 范围以 查询售卖规格接口返回的规格为准, 取值范围[data.types.minMemSize, data.types.maxMemSize], 主从版默认取值范围[1024MB, 61440MB], 集群版默认配置为:[1024MB, 307200MB]
2. 单次购买实例数量以 查询售卖规格接口返回的规格为准, 取值范[data.types.minBuyNum, data.types.maxBuyNum], 默认值为: [1, 100]
3. 购买时长单位:月, 取值范围 [1,2,3,4,5,6,7,8,9,10,11,12,24,36]
4. 密码规则: 长度为8-16个字符;至少包含字母、数字和字符(!@#%^())中的两种。
5. 如果需要购买某可用区的实例,请通过 工单 提起申请。
2. 输入参数
参数名称 | 是否必选 | 类型 | 描述 |
zoneId | 是 | UInt | 实例所属的可用区 ID。 |
typeId | 是 | UInt | 实例类型:1 – 集群版,2 – 主从版。 |
memSize | 是 | UInt | |
goodsNum | 是 | UInt | |
period | 是 | UInt | 购买时长,单位:月,取值范围 [1,2,3,4,5,6,7,8,9,10,11,12,24,36] |
password | 是 | String | 实例密码,密码规则:1.长度为8-16个字符;2:至少包含字母、数字和字符(!@#%^())中的两种。 |
vpcId | 否 | UInt | 历史原因,仍保留该参数,推荐使用下面参数 unVpcId。 私有网络 ID,如果不传则默认选择基础网络。 |
unVpcId | 否 | String | |
subnetId | 否 | UInt | 历史原因,仍保留该参数,推荐使用下面参数 unSubnetId。私有网络下的子网 ID,如果设置了 vpcId,则 subnetId 必填。 |
unSubnetId | 否 | String | |
projectId | 否 | UInt |
3. 输出参数
参数名称 | 类型 | 描述 |
code | Int | |
message | String | 错误信息描述, 成功时,该值为空 |
codeDesc | String | 业务侧错误码英文描述。成功时返回Success,错误时返回具体业务错误原因。 |
data | Array | 返回的订单数组 |
data 数组的结构:
参数名称 | 类型 | 描述 |
data.dealId | String |
4. 错误码
以下错误码表列出了该接口的业务逻辑错误码。
错误代码 | 英文提示 | 错误描述 |
11052 | UserNotInWhiteList | 用户不在白名单中 |
10000 | NoRedisService | 请求的区域暂时不提供 redis 服务 |
11062 | NoTypeIdRedisService | 请求的区域暂时不提供请求类型的 redis 服务 |
11053 | InvalidInstanceTypeId | 请求购买的实例类型错误(TypeId 1:集群版;2:主从版,即原主从版) |
10703 | InvalidMemSize | 请求的容量不在售卖规格中(memSize 应为1024的整数倍,单位:MB) |
11063 | MemSizeNotInRange | |
11065 | PeriodExceedMaxLimit | 购买时长超过最大时长限制 |
11066 | PeriodLessThanMinLimit | 购买时长小于最小时长限制 |
11064 | GoodsNumNotInRange | |
11067 | OnlyVPCOnSpecZoneId | 请求的地区目前只提供 VPC 网络下的 redis 服务 |
11054 | InvalidSubnetId | VPC 网络下的子网 ID 不存在 |
10501 | PasswordEmpty | 密码为空 |
11058 | PasswordRuleError | 密码规则错误,密码必须是8-16位字符,且至少包含字母、数字和字符(!@#%^*())中的两种 |
100207 | OperationConstraints.AccountBalanceNotEnough | 账号余额不足,请充值 |
5. 示例
输入
https://redis.api.qcloud.com/v2/index.php?Action=CreateRedis&<公共请求参数>&zoneId=100002&typeId=1&memSize=1024&goodsNum=1&period=2&password=49A2d!e@f12e
输出
{"code":"0","message":"","codeDesc": "Success","data":{"dealId":"432583"}}