查询所有实例列表
功能介绍
查询租户的缓存实例列表,支持按照条件查询。
URI
GET /v2/{project_id}/instances
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID。获取方法请参见获取项目ID。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
instance_id |
否 |
String |
实例ID。 |
include_failure |
否 |
String |
是否返回创建失败的实例数。 当参数值为“true”时,返回创建失败的实例数。参数值为“false”或者其他值,不返回创建失败的实例数。 |
include_delete |
否 |
String |
是否返回已删除的实例数。 当参数值为“true”时,返回已删除的实例数。参数值为“false”或者其他值,不返回已删除的实例数。 |
name |
否 |
String |
实例名称。 |
offset |
否 |
Integer |
偏移量,表示从此偏移量开始查询, offset大于等于0。 |
limit |
否 |
Integer |
每页显示条数,最小值为1,最大值为1000,若不设置该参数,则为10。 |
status |
否 |
String |
实例状态。详细状态说明见缓存实例状态说明。 |
name_equal |
否 |
String |
是否按照实例名称进行精确匹配查询。 默认为“false”,表示模糊匹配实例名称查询。若参数值为“true”表示按照实例名称进行精确匹配查询。 |
tags |
否 |
String |
根据实例标签键值对进行查询。{key}表示标签键,{value}表示标签值。 如果同时使用多个标签键值对进行查询,中间使用逗号分隔开,表示查询同时包含指定标签键值对的实例。 |
ip |
否 |
String |
连接缓存实例的IP地址。 |
capacity |
否 |
String |
缓存实例的容量(G Byte)。 |
请求参数
无
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
instance_num |
Integer |
实例个数。 |
instances |
Array of InstanceListInfo objects |
实例的详情数组。 |
参数 |
参数类型 |
描述 |
---|---|---|
publicip_id |
String |
Redis缓存实例绑定的弹性IP地址的ID。 该参数暂未开启,字段值为null。 |
vpc_name |
String |
VPC的名称。 |
charging_mode |
Integer |
计费模式,0表示按需计费。 |
vpc_id |
String |
VPC ID。 |
subnet_id |
String |
子网ID。 |
security_group_id |
String |
安全组ID。 |
created_at |
String |
创建时间。格式为:2017-03-31T12:24:46.297Z |
updated_at |
String |
更新时间。格式为:2017-03-31T19:24:46.297Z |
enable_ssl |
Boolean |
该参数暂未启用。 |
max_memory |
Integer |
总内存,单位:MB。 |
used_memory |
Integer |
已使用的内存,单位:MB。 |
publicip_address |
String |
Redis缓存实例绑定的弹性IP地址。 该参数暂未开启,字段值为null。 |
capacity |
Integer |
缓存容量(G Byte)。 |
capacity_minor |
String |
小规格缓存实例(小于1G)的容量(G Byte)。 |
order_id |
String |
订单ID,按需实例时此值为null。 |
maintain_begin |
String |
维护时间窗开始时间,为UTC时间,格式为HH:mm:ss。 |
maintain_end |
String |
维护时间窗结束时间,为UTC时间,格式为HH:mm:ss。 |
engine |
String |
缓存引擎。 |
engine_version |
String |
缓存版本。 |
service_upgrade |
Boolean |
实例是否存在升级任务。
|
no_password_access |
String |
是否允许免密码访问缓存实例。
|
service_task_id |
String |
升级任务的ID。
|
ip |
String |
连接缓存实例的IP地址。如果是集群实例,返回多个IP地址,使用逗号分隔。如:192.168.0.1,192.168.0.2。 |
access_user |
String |
通过密码认证访问缓存实例的认证用户名。 |
instance_id |
String |
实例ID。 |
enable_publicip |
Boolean |
该参数暂未启用。 |
port |
Integer |
缓存的端口。 |
user_id |
String |
用户id。 |
user_name |
String |
用户名。 |
domain_name |
String |
实例的域名。 |
readonly_domain_name |
String |
实例的只读域名,只有主备实例有该字段。 |
name |
String |
实例名称。 |
spec_code |
String |
产品规格编码。 |
status |
String |
实例状态。详细状态说明见缓存实例状态说明。 |
tags |
Array of ResourceTag objects |
实例标签键值。 |
description |
String |
实例描述备注 |
cpu_type |
String |
实例CPU类型,通常为x86_64或aarch64 |
az_codes |
Array of strings |
有资源的可用区编码。 |
features |
Features object |
实例支持特性。 |
sub_status |
String |
实例子状态。 |
参数 |
参数类型 |
描述 |
---|---|---|
key |
String |
标签键。
|
value |
String |
标签值。
|
参数 |
参数类型 |
描述 |
---|---|---|
support_acl |
Boolean |
是否支持ACL。
|
support_transparent_client_ip |
Boolean |
实例是否支持客户端IP透传。
|
support_ssl |
Boolean |
是否支持SSL。
|
support_audit_log |
Boolean |
是否支持审计日志。
|
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error_msg |
String |
错误信息。 最大长度:1024 |
error_code |
String |
错误码。 最大长度:9 |
error_ext_msg |
String |
扩展错误信息(暂未使用,赋值为null)。 最大长度:1024 |
状态码: 401
参数 |
参数类型 |
描述 |
---|---|---|
error_msg |
String |
错误信息。 最大长度:1024 |
error_code |
String |
错误码。 最大长度:9 |
error_ext_msg |
String |
扩展错误信息(暂未使用,赋值为null)。 最大长度:1024 |
状态码: 403
参数 |
参数类型 |
描述 |
---|---|---|
error_msg |
String |
错误信息。 最大长度:1024 |
error_code |
String |
错误码。 最大长度:9 |
error_ext_msg |
String |
扩展错误信息(暂未使用,赋值为null)。 最大长度:1024 |
状态码: 404
参数 |
参数类型 |
描述 |
---|---|---|
error_msg |
String |
错误信息。 最大长度:1024 |
error_code |
String |
错误码。 最大长度:9 |
error_ext_msg |
String |
扩展错误信息(暂未使用,赋值为null)。 最大长度:1024 |
状态码: 500
参数 |
参数类型 |
描述 |
---|---|---|
error_msg |
String |
错误信息。 最大长度:1024 |
error_code |
String |
错误码。 最大长度:9 |
error_ext_msg |
String |
扩展错误信息(暂未使用,赋值为null)。 最大长度:1024 |
请求示例
GET https://{dcs_endpoint}/v2/{project_id}/instances?offset=0&limit=10&name={name}&status={status}&id={id}&include_failure=true&include_delete=true&name_equal=false
响应示例
状态码: 400
非法请求。
{ "error_code" : "DCS.4800", "error_msg" : "Invalid offset in the request." }
状态码
状态码 |
描述 |
---|---|
200 |
查询所有实例列表成功。 |
400 |
非法请求。 |
401 |
认证信息非法。 |
403 |
请求被拒绝访问。 |
404 |
所请求的资源不存在。 |
500 |
内部服务错误。 |
错误码
请参见错误码。