文档首页> 分布式缓存服务 DCS> API参考> API V2（推荐）> 分片与副本> 查询实例节点信息
更新时间：2023-12-12 GMT+08:00
在线调试
CLI示例
查看PDF

查询实例节点信息

功能介绍

查询指定实例的节点信息。 支持Redis4.0、Redis5.0和Redis6.0实例查询。 创建中的实例不返回节点信息。

接口约束

支持Redis4.0、Redis5.0和Redis6.0

调用方法

请参见如何调用API。

URI

GET /v2/{project_id}/instances/{instance_id}/logical-nodes

表1 路径参数

参数

是否必选

参数类型

描述

instance_id

是

String

实例ID。

project_id

是

String

项目ID。获取方法请参见获取项目ID。

请求参数

无

响应参数

状态码： 200

表2 响应Body参数

参数

参数类型

描述

instance_id

String

实例ID

total

Integer

节点数量

nodes

Array of NodesInfoResp objects

节点信息
表3 NodesInfoResp

参数

参数类型

描述

logical_node_id

String

逻辑节点ID。

name

String

节点名称。

status

String

节点状态，所有值如下:

  • Creating：创建中。

  • Active：运行中。

  • Inactive：故障。

  • Deleting：删除中。

  • AddSharding：添加分片中。

枚举值：

  • Creating

  • Active

  • Inactive

  • Deleting

  • AddSharding

az_code

String

可用区code。

node_role

String

节点角色，所有值如下：

  • redis-server：Redis server节点。

  • redis-proxy：proxy节点。

枚举值：

  • redis-server

  • redis-proxy

node_type

String

节点主从角色：

  • master：主节点

  • slave：从节点

  • proxy: proxy实例节点角色为"proxy"

枚举值：

  • master

  • slave

  • proxy

node_ip

String

节点的IP。

node_port

String

节点的端口。

node_id

String

节点ID。

priority_weight

Integer

节点主备切换优先级权重。

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

副本对应的监控指标维度信息。可用于调用云监控服务的查询监控数据指标相关接口。

  • 副本的监控维度为多维度，返回数组中包含两个维度信息。从云监控查询监控数据时，要按多维度传递指标维度参数，才能查询到监控指标值。

  • 第一个维度为副本父维度信息。 维度名称为dcs_instance_id，维度值对应副本所在的实例ID。

  • 第二个维度，维度名称为dcs_cluster_redis_node，维度值为副本的监控对象ID，与副本ID和节点ID不同。
表4 InstanceReplicationDimensionsInfo

参数

参数类型

描述

name

String

监控维度名称。

value

String

维度取值。

状态码： 500

表5 响应Body参数

参数

参数类型

描述

error_msg

String

错误信息。

最大长度：1024

error_code

String

错误码。

最大长度：9

error_ext_msg

String

扩展错误信息（暂未使用，赋值为null）。

最大长度：1024

状态码： 400

表6 响应Body参数

参数

参数类型

描述

error_msg

String

错误信息。

最大长度：1024

error_code

String

错误码。

最大长度：9

error_ext_msg

String

扩展错误信息（暂未使用，赋值为null）。

最大长度：1024

请求示例

GET https://{dcs_endpoint}/v2/{project_id}/instances/{instance_id}/logical-nodes?status={status}

响应示例

状态码： 200

查询节点信息成功。

{
  "instance_id" : "11368fbb-de1e-4613-9080-1c374b71a1af",
  "total" : 1,
  "nodes" : [ {
    "logical_node_id" : "79653bcbd0e5c104fefedd188aa372d6",
    "name" : "(master)192.168.68.157",
    "status" : "Active",
    "az_code" : "region01",
    "node_role" : "redis-server",
    "node_type" : "master",
    "node_ip" : "192.168.68.157",
    "node_id" : "ff80808189bf92a50189d330303b77aa",
    "is_access" : true,
    "group_id" : "6e0f6e95-57cd-4baf-86d6-bea8815b25a8",
    "group_name" : "group-0",
    "priority_weight" : 100,
    "is_remove_ip" : false,
    "dimensions" : [ {
      "name" : "dcs_instance_id",
      "value" : "11368fbb-de1e-4613-9080-1c374b71a1af"
    }, {
      "name" : "dcs_cluster_redis_node",
      "value" : "79653bcbd0e5c104fefedd188aa372d6"
    } ],
    "replication_id" : null
  } ]
}

状态码： 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

非法请求。

错误码

请参见错误码。

父主题： 分片与副本