创建 Redis 实例

最近更新时间:2019-12-09 10:20:32

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. 输入参数

以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,见公共请求参数页面。其中,此接口的Action字段为CreateRedis。

参数名称 是否必选 类型 描述
zoneId UInt 实例所属的可用区ID
typeId UInt 实例类型:1 – 集群版,2 – 主从版
memSize UInt 实例容量,单位MB, 取值大小以 查询售卖规格接口返回的规格为准, 取值范围[data.types.minMemSize, data.types.maxMemSize]
goodsNum UInt 实例数量,单次购买实例数量以 查询售卖规格接口返回的规格为准, 取值范[data.types.minBuyNum, data.types.maxBuyNum]
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 私有网络ID,如果不传则默认选择基础网络,请使用私有网络列表 查询 返回的unVpcId为准,如:vpc-kd7d06of
subnetId UInt 历史原因,仍保留该参数,推荐使用下面参数unSubnetId。私有网络下的子网ID,如果设置了 vpcId,则 subnetId 必填。
unSubnetId String 基础网络下, subnetId无效; VPC子网下,取值以查询查询子网列表 返回的unSubnetId为准,如:subnet-3lzrkspo
projectId UInt 项目ID,取值以用户账户>用户账户相关接口查询>项目列表返回的projectId为准

3. 输出参数

参数名称 类型 描述
code Int 公共错误码, 0表示成功,其他值表示失败。详见错误码页面的公共错误码
message String 错误信息描述, 成功时,该值为空
codeDesc String 业务侧错误码英文描述。成功时返回Success,错误时返回具体业务错误原因。
data Array 返回的订单数组

data 数组的结构:

参数名称 类型 描述
data.dealId String 订单号,通过 DescribeRedisDealDetail 可以查询订单详情

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"
    }
}