在会话运行期间动态挂载一个文件。服务端会将文件复制一份内部副本,并把挂载路径加上 /mnt/session/uploads/ 前缀。此操作不产生会话事件。
前提
已完成 Endpoint 与鉴权配置,详见API 总览与认证。
接口
POST /sessions/{session_id}/resources
路径参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
session_id | 是 | string | 会话 ID,格式 sesn_<ULID> |
请求体
| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
type | 是 | string | 资源类型,固定为 file |
file_id | 是 | string | 已上传的文件 ID |
mount_path | 是 | string | 挂载路径,以 /uploads 开头 |
请求示例
响应
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | 资源 ID,格式 sesrsc_<ULID> |
type | string | 资源类型,固定为 file |
file_id | string | 内部副本的文件 ID,与请求中的 file_id 不同 |
mount_path | string | 会话内的完整挂载路径 |
created_at | string | 创建时间,ISO 8601 |
updated_at | string | 最近更新时间,ISO 8601 |
request_id | string | 本次请求的唯一标识 |
错误码
| 状态码 | 错误码 | 说明 |
|---|---|---|
| 400 | InvalidParameter | Required parameter missing or invalid. |
| 401 | InvalidApiKey | Invalid API-key provided. |