本文导读

展开导读

文档首页/ 数据管理服务 DAS/ API参考/ API（公测中）/ 云DBA/ 查询实例会话列表

查询实例会话列表

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

查看PDF

功能介绍

支持根据数据库、用户查询实例会话列表。目前仅支持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.

错误码

请参见错误码。

父主题： 云DBA

上一篇：查询元数据锁列表

下一篇：查询InnoDB锁等待列表

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消