获取实例的会话
功能介绍
获取实例的会话。
接口约束
该接口支持如下数据库实例。
- GeminiDB Redis
URI
GET https://{Endpoint}/v3/{project_id}/instances/{instance_id}/sessions
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
参数解释: 租户在某一region下的project ID。获取方法请参见获取项目ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
instance_id |
是 |
String |
参数解释: 实例ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
node_id |
否 |
String |
参数解释: 节点ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
参数解释: 用户Token。 通过调用IAM服务获取用户Token接口获取。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
node_sessions |
Array of 表5 objects |
参数解释: 节点的会话信息列表。 取值范围: 不涉及。 |
参数 |
参数类型 |
描述 |
---|---|---|
node_id |
String |
参数解释: 节点ID。 取值范围: 不涉及。 |
total_count |
Integer |
参数解释: 总会话数。 取值范围: 不涉及。 |
sessions |
Array of 表6 objects |
参数解释: 节点会话详细信息列表。 取值范围: 不涉及。 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
参数解释: 会话ID。 取值范围: 不涉及。 |
name |
String |
参数解释: 连接名。 取值范围: 不涉及。 |
cmd |
String |
参数解释: 最近一次执行的命令。 取值范围: 不涉及。 |
age |
String |
参数解释: 以秒计算的已连接时长。 取值范围: 不涉及。 |
idle |
String |
参数解释: 以秒计算的空闲时长。 取值范围: 不涉及。 |
db |
String |
参数解释: 该客户端正在使用的数据库ID。 取值范围: 不涉及。 |
addr |
String |
参数解释: 客户端的地址和端口。 取值范围: 不涉及。 |
fd |
String |
参数解释: 套接字所使用的文件描述符。 取值范围: 不涉及。 |
sub |
String |
参数解释: 已订阅频道的数量。 取值范围: 不涉及。 |
psub |
String |
参数解释: 已订阅模式的数量。 取值范围: 不涉及。 |
multi |
String |
参数解释: 在事务中被执行的命令数量。 取值范围: 不涉及。 |
请求示例
- 查询实例所有节点的会话信息
GET https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/e73893ef73754465a8bd2e0857bbf13ein12/sessions
- 查询实例指定节点的会话信息
GET https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/e73893ef73754465a8bd2e0857bbf13ein12/sessions?node_id=9d3288bbbb81448e8a99ff41a5717281no12
响应示例
状态码: 200
Success.
{ "node_sessions" : [ { "node_id" : "8436a91546294036b75931e879882200in06", "total_count" : 1, "sessions" : [ { "addr" : "127.0.0.1:8080", "id" : 54487, "name" : "cli", "cmd" : "get", "age" : 8888581, "idle" : 8888581, "db" : 0, "fd" : 1311, "sub" : 0, "psub" : 0, "multi" : -1 } ] }, { "node_id" : "8123sa46294daw13def423fw79882200in06", "total_count" : 1, "sessions" : [ { "addr" : "127.0.0.1:8080", "id" : 54488, "name" : "cli", "cmd" : "get", "age" : 3124124, "idle" : 4414141, "db" : 0, "fd" : 1312, "sub" : 0, "psub" : 0, "multi" : -1 } ] } ] }
状态码
请参见状态码。
错误码
请参见错误码。