查询 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"
}]
}
}

如果遇到产品相关问题,您可咨询 在线客服 寻求帮助。

返回顶部
可通过正文划词反馈文档内容问题,我们会快速处理并更新文档内容。

API 文档版本提示

关闭
此版本已不再维护,请使用最新 API 3.0 文档