批量查询实例节点信息
功能介绍
批量查询指定项目所有实例的节点信息、有效实例个数及节点个数。
创建中实例不返回节点信息。
支持Redis4.0及以上版本实例查询。
接口约束
支持Redis4.0及以上版本实例查询。
URI
GET /v2/{project_id}/instances-logical-nodes
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释: 项目ID。获取方法请参见获取项目ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
offset |
否 |
Integer |
参数解释: 偏移量,表示生成的列表从此偏移量开始显示,例如偏移量为3时,生成的列表从第4条开始。 约束限制: 不涉及。 取值范围: 大于等于0。 默认取值: 0 |
|
limit |
否 |
Integer |
参数解释: 每页显示的条目数量。 约束限制: 不涉及。 取值范围: 1-100 默认取值: 10 |
请求参数
无
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
count |
Integer |
参数解释: 查询结果的实例总数。 取值范围: 不涉及。 |
|
instances |
Array of InstanceNodesInfoResp objects |
参数解释: 实例列表。 取值范围: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
instance_id |
String |
参数解释: 实例ID。 取值范围: 不涉及。 |
|
node_count |
Integer |
参数解释: 当前实例节点总数。 取值范围: 不涉及。 |
|
nodes |
Array of NodesInfoResp objects |
参数解释: 节点详情。 取值范围: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
logical_node_id |
String |
参数解释: 逻辑节点ID。 取值范围: 不涉及。 |
|
name |
String |
参数解释: 节点名称。 取值范围: 不涉及。 |
|
status |
String |
参数解释: 节点状态。 取值范围:
|
|
az_code |
String |
参数解释: 可用区code。 取值范围: 不涉及。 |
|
node_role |
String |
参数解释: 节点角色。 取值范围:
|
|
node_type |
String |
参数解释: 节点主从角色。 取值范围:
|
|
node_ip |
String |
参数解释: 节点的IP。 取值范围: 不涉及。 |
|
node_port |
String |
参数解释: 节点的端口。 取值范围: 不涉及。 |
|
node_id |
String |
参数解释: 节点ID。 取值范围: 不涉及。 |
|
priority_weight |
Integer |
参数解释: 节点主备切换优先级权重。 取值范围: 0-100(1-100优先级逐步降低,1为最高,100为最低,0为禁止倒换)。 |
|
is_access |
Boolean |
参数解释: 节点的IP是否可直接访问。 取值范围:
|
|
group_id |
String |
参数解释: 实例分片ID。 取值范围: 不涉及。 |
|
group_name |
String |
参数解释: 实例分片名称。 取值范围: 不涉及。 |
|
is_remove_ip |
Boolean |
参数解释: 是否从只读域名中摘除IP。 取值范围:
|
|
replication_id |
String |
参数解释: 实例副本ID。 取值范围: 不涉及。 |
|
dimensions |
Array of InstanceReplicationDimensionsInfo objects |
参数解释: 副本对应的监控指标维度信息。可用于调用云监控服务的查询监控数据指标相关接口。
取值范围: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
name |
String |
参数解释: 监控维度名称。 取值范围:
|
|
value |
String |
参数解释: 维度取值。 取值范围: 不涉及。 |
状态码:500
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_msg |
String |
参数解释: 错误信息。 取值范围: 不涉及。 |
|
error_code |
String |
参数解释: 错误码。 取值范围: 请参见错误码。 |
|
error_ext_msg |
String |
参数解释: 扩展错误信息(暂未使用,赋值为null)。 取值范围: 不涉及。 |
状态码:400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_msg |
String |
参数解释: 错误信息。 取值范围: 不涉及。 |
|
error_code |
String |
参数解释: 错误码。 取值范围: 请参见错误码。 |
|
error_ext_msg |
String |
参数解释: 扩展错误信息(暂未使用,赋值为null)。 取值范围: 不涉及。 |
请求示例
GET https://{dcs_endpoint}/v2/{project_id}/instances-logical-nodes?offset={offset}&limit={limit}
响应示例
状态码:200
查询节点信息成功。
{
"count" : 1,
"instances" : [ {
"instance_id" : "b4468cb1-4f75-4866-a49d-86959acc0c9c",
"node_count" : 2,
"nodes" : [ {
"logical_node_id" : "8f997eb512a92834bf5914be52ca8919",
"name" : "(replica)192.168.0.178",
"status" : "Active",
"az_code" : "region01",
"node_role" : "redis-server",
"node_type" : "slave",
"node_ip" : "192.168.0.178",
"node_port" : "6379",
"node_id" : "8a2c26c17f4d6516017f4d7b77940030",
"is_access" : true,
"group_id" : "ace962d1-7841-4e50-9313-c239fd75dee3",
"group_name" : "group-0",
"priority_weight" : 100,
"is_remove_ip" : false,
"replication_id" : "e40aa09e-03c2-4319-86eb-5ef4ca637544",
"dimensions" : [ {
"name" : "dcs_instance_id",
"value" : "caf2d19f-7783-44b0-be46-8c9da3ef1e94"
}, {
"name" : "dcs_cluster_redis_node",
"value" : "8263dc69629c5b2d840e9816fa9c6200"
} ]
} ]
} ]
}
状态码:500
内部服务错误。
{
"error_code" : "DCS.5000",
"error_msg" : "Internal service error."
}
状态码:400
非法请求。
{
"error_code" : "DCS.4800",
"error_msg" : "Invalid offset in the request."
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
查询节点信息成功。 |
|
500 |
内部服务错误。 |
|
400 |
非法请求。 |
错误码
请参见错误码。