查询 Redis 实例及实例列表

最近更新时间:2019-08-14 20:41:35

1. 接口描述

本接口(DescribeRedis)用于查询 Redis 实例列表。
接口请求域名:redis.api.qcloud.com

2. 输入参数

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

参数名称 是否必选 类型 描述
limit Int 分页大小
offset Int 当前页码
redisId String 实例 ID
redisName String 实例名称
orderBy String 枚举范围 redisId,projectId,createtime
orderType Int 1倒序,0顺序,默认倒序
vpcIds.n Int 历史原因,仍保留该参数,推荐使用下面参数 unVpcIds。 私有网络 ID 数组,数组下标从0开始,如果不传则默认选择基础网络
unVpcIds.n String 私有网络ID数组,数组下标从0开始,如果不传则默认选择基础网络。请使用 私有网络列表 查询返回的 unVpcId 为准,如:vpc-kd7d06of
subnetIds.n Int 历史原因,仍保留该参数,推荐使用下面参数unSubnetIds。私有网络下的子网ID数组,数组下标从0开始
unSubnetIds.n String 子网 ID 数组,数组下标从0开始。 vpc 子网下,取值以查询 查询子网列表 返回的 unSubnetId 为准,如:subnet-3lzrkspo
projectIds.n String 项目ID 组成的数组,数组下标从0开始

3. 输出参数

参数名称 类型 描述
code Int 公共错误码,0表示成功,其他值表示失败。详见错误码页面的公共错误码
message String 模块错误信息描述,与接口相关
codeDesc String 业务侧错误码英文描述。成功时返回 Success,错误时返回具体业务错误原因
totalCount Int 实例数
data Array -
data.redisSet Array -
data.redisSet.redisName String 实例名称
data.redisSet.redisId String 实例唯一串号
data.redisSet.appid Int appid
data.redisSet.projectId Int 项目 ID
data.redisSet.regionId Int 地域id 1--广州 4--上海 5-- 中国香港 6--多伦多 7--上海金融 8--北京 9-- 新加坡 11--深圳金融 15--美西(硅谷)
data.redisSet.zoneId Int 区域 ID
data.redisSet.vpcId Int vpc 网络 ID,不推荐使用
data.redisSet.unVpcId String vpc 网络 ID,推荐使用
data.redisSet.subnetId Int vpc 网络下子网 ID,不推荐使用
data.redisSet.unSubnetId String vpc 网络下子网 ID,推荐使用
data.redisSet.status Int 实例当前状态,0:待初始化;1:实例在流程中;2:实例运行中;-2:实例已隔离
data.redisSet.statusDesc String 实例状态描述
data.redisSet.wanIp String 实例 vip
data.redisSet.port Int 实例端口号
data.redisSet.createtime String 实例创建时间
data.redisSet.size Int 实例容量大小,单位:MB
data.redisSet.sizeUsed Int 实例当前已使用容量,单位:MB
data.redisSet.typeId Int 实例类型,1:集群版;2:主从版
data.redisSet.typeIddesc String 实例类型描述
data.redisSet.autoRenewFlag Int 实例是否设置自动续费标识,1:设置自动续费;0:未设置自动续费
data.redisSet.deadlineTime String 实例到期时间

4. 错误码

以下错误码表列出了该接口的业务逻辑错误码。

错误代码 英文提示 错误描述
11201 InvalidParameter 业务参数错误

5. 示例

https://redis.api.qcloud.com/v2/index.php?Action=DescribeRedis
&<公共请求参数>
&limit=10
&offset=0

返回示例如下:

{
    "code": 0,
    "message": "",
    "codeDesc": "Success",
    "totalCount": 1,
    "data": {
        "redisSet": [{
            "redisName": "att_test",
            "redisId": "crs-ooakfyj3",
            "appid": "1251966477",
            "projectId": "0",
            "regionId": "1",
            "zoneId": "100002",
            "vpcId": 4864,
            "unVpcId": "vpc-j5yvvkul",
            "subnetId": 14158,
            "unSubnetId": "subnet-py2q60ty",
            "status": "2",
            "statusDesc": "实例运行中",
            "wanIp": "10.66.170.224",
            "port": "6379",
            "createtime": "2016-05-04 16:59:53",
            "size": "2048",
            "sizeUsed": "0",
            "typeId": "1",
            "typeIddesc": "集群版",
            "autoRenewFlag": 1,
            "deadlineTime": "2016-08-14 16:59:53"
        }]
    }
}