ListChatSessions - 查询ROS Agent V2会话列表-资源编排(ROS)-阿里云帮助中心

分页查询当前用户的ROS Agent V2会话列表。

接口说明

请求说明

调用 V2 服务时请将 AgentVersion 设为 V2。
接口只返回当前用户的会话，默认按 UpdatedAt 从新到旧排序。
可以通过 Mode 参数筛选会话模式，支持 IaCCodeNormal 或 IaCCodePipeline。
切换 Mode 后不要复用旧的 NextToken。
时间信息请使用 CreatedAt 和 UpdatedAt 字段，元数据中的 UpdatedTime 是兼容字段，当前响应不返回。
请求条数请以请求参数 MaxResults 为准，范围是 1 到 100。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ros:ListChatSessions

list

*全部资源

*

无

请求语法

POST  HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
MaxResults	integer	否	每页返回的会话数量，范围 1 到 100，默认值为 20。	20
NextToken	string	否	上一次响应返回的翻页 Token；第一页不传，切换 Mode 后不要复用旧 Token。	CAES...
AgentVersion	string	否	传 V2 路由到 ROS Agent V2 后端。	V2
Mode	string	否	按会话模式筛选，仅支持 IaCCodeNormal 或 IaCCodePipeline。	IaCCodePipeline

返回参数

名称	类型	描述	示例值
	object	Schema of Response
MaxResults	integer	兼容字段。V2 当前响应不返回，请以请求参数 MaxResults 为准。	20
NextToken	string	下一页 Token；最后一页可能不返回或为 null。	CAES...
RequestId	string	OpenAPI 请求 ID。	4C68F7A5-2D16-5C8F-A4B1-01E9C6A9B0D2
Sessions	array<object>	当前用户的会话列表，按更新时间倒序。	[]
	object	会话对象。	{}
HistoryReadiness	string	会话历史消息可读状态。仅 READY 时可加载历史;STARTING/RUNNING/STOPPING/FINALIZING(处理中)、NOT_READY(未就绪)、RECOVERY_REQUIRED(待恢复)、UNKNOWN(未知)均暂不可加载。	STARTING
Mode	string	会话模式，取值为 IaCCodeNormal 或 IaCCodePipeline。	IaCCodePipeline
PipelineName	string	流水线名称，取值为 EvaluationFirstSelling 或 SolutionFirstSelling。	SolutionFirstSelling
SessionId	string	会话 ID，可用于 StartChat 重入、StopChat 和 ListChatMessages。	7f4e2a8c6d9b4a1f8e3c5b7d2a6f9012
Summary	string	会话摘要，当前与 Title 同源，可能为空。	创建 VPC 模板
Title	string	会话标题，可能为空。	创建 VPC 模板
UpdatedTime	string	兼容字段。V2 当前响应不返回，请使用 UpdatedAt。	2026-08-26T10:00:00Z

示例

正常返回示例

JSON格式

{
  "MaxResults": 20,
  "NextToken": "CAES...",
  "RequestId": "4C68F7A5-2D16-5C8F-A4B1-01E9C6A9B0D2",
  "Sessions": [
    {
      "HistoryReadiness": "STARTING",
      "Mode": "IaCCodePipeline",
      "PipelineName": "SolutionFirstSelling",
      "SessionId": "7f4e2a8c6d9b4a1f8e3c5b7d2a6f9012",
      "Summary": "创建 VPC 模板",
      "Title": "创建 VPC 模板",
      "UpdatedTime": "2026-08-26T10:00:00Z"
    }
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。