运行时挂载资源 API：POST /sessions/{session_id}/resources-大模型服务平台百炼(Model Studio)-阿里云帮助中心

在会话运行期间动态挂载一个文件。服务端会将文件复制一份内部副本，并把挂载路径加上 /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 开头

请求示例

bash

curl -X POST "$AGENTSTUDIO_URL/sessions/sesn_xxx/resources" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "file",
    "file_id": "file_xxx",
    "mount_path": "/uploads/workspace/late.csv"
  }'

响应

{
  "id": "sesrsc_xxx",
  "type": "file",
  "file_id": "file_xxx",
  "mount_path": "/mnt/session/uploads/workspace/late.csv",
  "created_at": "2026-05-28T08:25:00Z",
  "updated_at": "2026-05-28T08:25:00Z",
  "request_id": "xxx"
}

响应字段

字段	类型	说明
`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.