文档首页/ 数据管理服务 DAS/ API参考/ API（公测中）/ 云DBA/ 查询实例会话列表
更新时间：2024-02-26 GMT+08:00
查看PDF
分享

查询实例会话列表

功能介绍

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

调试

您可以在API Explorer中调试该接口。

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.

错误码

请参见错误码。

父主题： 云DBA

相关文档