列出 File

分页列出工作空间下的文件，按 created_at 倒序返回。可通过 scope_id 仅列出某会话沙箱内的文件。

前提

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

接口

GET /files

Query 参数

请求示例

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

for file in client.files.list(limit=20):
    print(file.id, file.filename, file.size_bytes)

import os
from dashscope import Files

# 列出已上传的文件（page 为页码，page_size 为每页数量）
result = Files.list(page=1, page_size=10, api_key=os.getenv('DASHSCOPE_API_KEY'))
print(result)

CursorPage<AgentStudioFile> page = client.files().list(
    FileListParam.builder().limit(20).build());
for (AgentStudioFile f : page.getData()) {
    System.out.println(f.getId() + " " + f.getFilename() + " " + f.getSizeBytes());
}

响应示例

{
  "data": [
    {
      "id": "file_xxx",
      "type": "file",
      "filename": "sales_2025.csv",
      "downloadable": false,
      "mime_type": "text/csv",
      "size_bytes": 524288,
      "status": "available",
      "created_at": "2026-06-16T14:51:39+08:00"
    },
    {
      "id": "file_xxx",
      "type": "file",
      "filename": "demo.png",
      "downloadable": false,
      "mime_type": "image/png",
      "size_bytes": 102400,
      "status": "checking",
      "created_at": "2026-06-16T14:48:02+08:00"
    }
  ],
  "next_page": "xxx",
  "requestId": "xxx"
}

响应包含 data（File 对象数组）与 next_page。File 对象字段如下：

File 对象字段