文档中心

E-MapReduce

请输入

EMR Agent API参考

ListChats - 查询会话列表

获取用户会话列表。

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：ListChats

要执行的操作，取值：ListChats。

Version string 必选示例值：2025-10-15

API的版本，取值：2025-10-15。

PageNum integer 可选示例值：1

页码，从 1 开始，默认值为 1。

PageSize integer 可选示例值：10

每页数量，默认值为 10。

JobId string 可选示例值：3058****472

作业 ID，用于筛选指定作业关联的会话。

ClusterId string 可选示例值：emr-xxx

集群 ID，用于筛选指定集群关联的会话。

ServiceName string 可选示例值：spark

服务名称，用于筛选指定服务关联的会话。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

Items object[] 示例值：见以下各参数说明

当前页列表项。

ChatId string 示例值：session_********-****-****-****-************

会话 ID。

Name string 示例值：请帮我诊断该作业

会话名称。

UserId string 示例值：2100000000

用户 ID。

SubAccountId string 示例值：2100000001

子用户 ID。

LastActive string 示例值：2026-08-10T12:00:00

最近活跃时间。

Status string 示例值：active

会话状态。

CreatedAt string 示例值：2026-08-10T12:00:00

创建时间。

TotalCount integer 示例值：10

符合条件的总条数。

PageNum integer 示例值：1

当前页码。

PageSize integer 示例值：10

每页数量。

请求示例

POST /?Action=ListChats&Version=2025-10-15 HTTP/1.1​
Host: emr.cn-beijing.volcengineapi.com​
Content-Type: application/json; charset=UTF-8​
X-Date: 20260818T125735Z​
X-Content-Sha256: 287e874e******d653b44d21e​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20260818/cn-beijing/emr/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
{}​

返回示例

{​
  "ResponseMetadata": {​
    "RequestId": "202608182057400220681601756029A8",​
    "Action": "ListChats",​
    "Version": "2025-10-15",​
    "Service": "emr",​
    "Region": "cn-beijing"​
  },​
  "Result": {​
    "Items": [],​
    "TotalCount": 10,​
    "PageNum": 1,​
    "PageSize": 10​
  }​
}​

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
500	1000	未知异常	未知异常。

最近更新时间：2026.08.20 20:18:39

这个页面对您有帮助吗？

有用

无用