Skip to main content

列出会话资源

分页列出会话当前已挂载的资源。

前提

已完成 Endpoint 与鉴权配置,详见API 总览与认证。

接口

GET /sessions/{session_id}/resources

路径参数

参数必填类型说明
session_id是string会话 ID,格式 sesn_<ULID>

Query 参数

参数必填类型说明
limit否integer每页数量,最大 100,默认 20
page否string分页游标(opaque token)。首次不传,后续传上一次响应返回的游标

请求示例

curl "$AGENTSTUDIO_URL/sessions/sesn_xxx/resources?limit=20" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

响应

响应包含 data(会话资源对象数组)与 next_page(下一页游标,无更多数据时为 null)。
{
  "data": [
    {
      "id": "sesrsc_xxx",
      "type": "file",
      "file_id": "file_xxx",
      "mount_path": "/mnt/session/uploads/data.csv",
      "created_at": "2026-05-28T08:23:11.456000Z",
      "updated_at": "2026-05-28T08:23:11.456000Z"
    },
    {
      "id": "sesrsc_yyy",
      "type": "file",
      "file_id": "file_yyy",
      "mount_path": "/mnt/session/uploads/late.csv",
      "created_at": "2026-05-28T08:25:00.000000Z",
      "updated_at": "2026-05-28T08:25:00.000000Z"
    }
  ],
  "next_page": "page_xxxxxxxxxxxxx",
  "request_id": "xxx"
}

响应字段

字段类型说明
dataarray<object>资源对象数组
data[].idstring资源 ID,格式 sesrsc_<ULID>
data[].typestring资源类型,固定为 file
data[].file_idstring内部副本的文件 ID
data[].mount_pathstring加上 /mnt/session/uploads/ 前缀后的完整挂载路径
data[].created_atstring创建时间,ISO 8601
data[].updated_atstring最近更新时间,ISO 8601
next_pagestring下一页游标,原样传入 page 参数续翻;无更多数据时为 null
request_idstring本次请求的唯一标识

错误码

状态码错误码说明
400InvalidParameterRequired parameter missing or invalid.
401InvalidApiKeyInvalid API-key provided.
Flow Agent API
Sandbox API
RAG API
长期记忆
ParseX API
Security API
框架集成
Assistant API(下线中)