查询指定环境中已落盘的文件和目录分页。
接口
GET /agents/environments/{environment_id}/files
查询指定环境中的实时文件。成功返回 200 和目录分页。该接口用于核对文件是否已经落盘,不返回文件正文。
查询参数pathstring (可选)目录路径,可选,限定 /workspace/ 内已存在的绝对目录limit integer (可选)每页数量page string (可选)分页游标;首次不传,后续传上一页返回的 next分页请求参数名是 page,响应游标字段是 next;不是源文件或 Artifact 的 after。 | 请求示例 |
响应字段objectstring分页对象类型,固定为 pagedata array当前页的环境文件next string / null下一页游标;没有下一页时为 nullhas_more boolean是否还有下一页data[] 中每一项包含:响应包含当前页的 data 数组和下一页游标。目录为空时 data 为空数组。
data 项 environment_id string环境 IDobject string环境文件对象类型,固定为 agent.environment.filepath string环境内文件路径size_bytes integer文件大小,单位字节 | 响应示例 |
错误码
| HTTP 状态码 | 错误类型 / 错误码 | 解决方案 |
|---|---|---|
400 | invalid_request_error / invalid_request_error | 传入 /workspace/ 内已存在的绝对目录 |
404 | not_found_error / not_found_error | 使用当前工作空间中存在且可见的环境 ID |
{"error":{"type","code","message","param"}},网关错误可能使用不同结构。