- 文档首页
E-MapReduce
API 参考
EMR Agent API参考
ListChats - 查询会话列表
EMR Agent API参考
ListChats - 查询会话列表
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。
Status string 示例值:active
会话状态。
CreatedAt string 示例值:2026-08-10T12:00:00
创建时间。
TotalCount integer 示例值:10
符合条件的总条数。
PageNum integer 示例值:1
当前页码。
PageSize integer 示例值:10
每页数量。
请求示例
返回示例
错误码
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。
最近更新时间:2026.08.20 20:18:39