更新时间:2024-08-05 GMT+08:00

查询实例会话列表

功能介绍

支持根据数据库、用户查询实例会话列表。 目前仅支持MySQL实例。

URI

GET /v3/{project_id}/instances/{instance_id}/processes

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。

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

instance_id

String

实例ID。

表2 Query参数

参数

是否必选

参数类型

描述

db_user_id

String

数据库用户ID。

user

String

用户。

database

String

数据库。

offset

Integer

偏移量。从第一条数据偏移offset条数据后开始查询,默认为0(偏移0条数据,表示从第一条数据开始查询),必须为数字,不能为负数。

limit

Integer

每页记录数,默认为20,最大取值100。

node_id

String

节点ID。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户token。

X-Language

String

语言。

枚举值:

  • zh-cn
  • en-us

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

processes

Array of Process objects

会话列表。

count

Long

总记录数。

表5 Process

参数

参数类型

描述

id

String

会话ID。

user

String

用户。

host

String

主机。

database

String

数据库。

command

String

命令。

time

String

会话持续时间。

state

String

状态。

sql

String

SQL语句。

trx_executed_time

String

事务持续时间。

状态码: 400

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

最小长度:8

最大长度:36

error_msg

String

错误描述。

最小长度:2

最大长度:512

状态码: 500

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

最小长度:8

最大长度:36

error_msg

String

错误描述。

最小长度:2

最大长度:512

请求示例

查询实例会话列表。

GET https://das.cn-north-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/instances/da304cd5bbb944de828759bc7be3d3fein01/processes?db_user_id=2c250598-1e3c-4d31-bc19-be1d866247e6&offset=0&limit=10

响应示例

状态码: 200

{
  "processes" : [ {
    "id" : "1",
    "user" : "event_scheduler",
    "host" : "localhost",
    "database" : "--",
    "command" : "Daemon",
    "time" : "4260107",
    "state" : "Waiting on empty queue",
    "sql" : "",
    "trx_executed_time" : "0"
  } ],
  "count" : 1
}

状态码

状态码

描述

200

Success.

400

BadRequest.

500

InternalServerError.

错误码

请参见错误码