分页查询当前用户的ROS Agent V2会话列表。
接口说明
请求说明
调用 V2 服务时请将
AgentVersion设为V2。接口只返回当前用户的会话，默认按
UpdatedAt从新到旧排序。可以通过
Mode参数筛选会话模式，支持IaCCodeNormal或IaCCodePipeline。切换
Mode后不要复用旧的NextToken。时间信息请使用
CreatedAt和UpdatedAt字段，元数据中的UpdatedTime是兼容字段，当前响应不返回。请求条数请以请求参数
MaxResults为准，范围是 1 到 100。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
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 |
||
| RequestId |
string |
OpenAPI 请求 ID。 |
4C68F7A5-2D16-5C8F-A4B1-01E9C6A9B0D2 |
| Sessions |
array<object> |
当前用户的会话列表，按更新时间倒序。 |
[] |
|
object |
会话对象。 |
{} |
|
| SessionId |
string |
会话 ID，可用于 StartChat 重入、StopChat 和 ListChatMessages。 |
7f4e2a8c6d9b4a1f8e3c5b7d2a6f9012 |
| Summary |
string |
会话摘要，当前与 Title 同源，可能为空。 |
创建 VPC 模板 |
| UpdatedTime |
string |
兼容字段。V2 当前响应不返回，请使用 UpdatedAt。 |
2026-08-26T10:00:00Z |
| Title |
string |
会话标题，可能为空。 |
创建 VPC 模板 |
| Mode |
string |
会话模式，取值为 IaCCodeNormal 或 IaCCodePipeline。 |
IaCCodePipeline |
| NextToken |
string |
下一页 Token；最后一页可能不返回或为 null。 |
CAES... |
| MaxResults |
integer |
兼容字段。V2 当前响应不返回，请以请求参数 MaxResults 为准。 |
20 |
示例
正常返回示例
JSON格式
{
"RequestId": "4C68F7A5-2D16-5C8F-A4B1-01E9C6A9B0D2",
"Sessions": [
{
"SessionId": "7f4e2a8c6d9b4a1f8e3c5b7d2a6f9012",
"Summary": "创建 VPC 模板",
"UpdatedTime": "2026-08-26T10:00:00Z",
"Title": "创建 VPC 模板",
"Mode": "IaCCodePipeline"
}
],
"NextToken": "CAES...",
"MaxResults": 20
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。