查询物理会话列表

功能介绍

获取DDM实例的物理会话列表。

接口约束

无

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

• URL格式

  GET /v3/{project_id}/instances/{instance_id}/physical-processes?offset={offset}&limit={limit}

• 参数说明

  表1 参数说明

  参数	是否必选	参数类型	描述
  project_id	是	String	租户在某一region下的project ID。 获取方法请参见获取项目ID。
  instance_id	是	String	关联RDS实例ID。
  offset	否	Integer	分页参数：起始值。默认值为0。 取值为大于等于0的整数。
  limit	否	Integer	分页参数：每页多少条。默认值为10。 取值范围：1~128。
  keyword	否	String	会话结果筛选关键字，支持返回结果全字段模糊匹配，长度最大255。

请求消息

请求示例

获取DDM实例的物理会话列表。

GET https://{endpoint}/v3/{project_id}/instances/{instance_id}/physical-processes?offset=0&limit=10

响应消息

• 正常响应参数说明

  表3 响应Body参数

  参数	参数类型	描述
  total_count	Integer	总条数。
  physical_processes	Array of 表4 objects	实例的物理会话列表。

  表4 PhysicalProcessInfo

  参数	参数类型	描述
  id	String	物理会话ID。
  user	String	当前连接的用户。
  host	String	所属的IP和端口。
  db	String	数据库名。
  command	String	连接状态，一般是休眠或空闲（sleep），查询（query），连接（connect）。
  time	Boolean	连接状态持续的时间，单位是秒（s）。
  state	Boolean	当前SQL语句的状态。
  info	Integer	当前所执行的SQL语句。
  trx_executed_time	Integer	事务持续时间，单位是秒（s）。

• 正常响应示例

  {
    "physical_processes": [
      {
        "id": 1973,
        "user": "DDMRW1613058863",
        "hots": "172.16.241.84:58908",
        "db": "ddm_db_test_0001",
        "state": "",
        "command": "Sleep",
        "info": null,
        "time": 13977,
        "trx_executed_time": 0
      }
    ],
    "total_count": 1
  }

• 异常响应

  请参见异常请求结果。

状态码

• 正常

  200

• 异常

  请参见状态码。

错误码

请参见错误码。