火山方舟
火山方舟
API参考
请输入
- 文档首页
火山方舟Managed Agents APISessions会话资源查询会话资源
复制全文
下载 pdf查询会话资源
文档反馈
问问助手GET https://ark.cn-beijing.volces.com/api/v3/sessions/{session_id}/resources/{resource_id}
按 session_id 和 resource_id 查询单个已挂载资源。响应字段随 type 变化；file 资源的后续引用请以查询返回的 file_id 为准。
鉴权
- API Key 鉴权，请在 API Key 管理 页面，获取长效 API Key。
请求参数
Path 参数
resource_id string 必选 | 资源 ID
会话资源 ID，形如 sesrsc-...，可从添加资源或资源列表响应的 id 字段获得
session_id string 必选 | 会话 ID
填写资源所属的会话 ID，形如 sesn-...
响应参数
created_at string | 挂载时间
资源挂载到会话的时间，采用 RFC 3339 格式。
id string | 资源 ID
会话资源 ID。
type string | 资源类型
资源类型，用于确定返回哪些类型专属字段。可选值：file、memory_store、tos。
updated_at string | 更新时间
会话资源信息最后更新的时间，采用 RFC 3339 格式。
access string | 访问权限
资源访问权限。file 固定为 read_only；其他资源返回对应的挂载配置。取值：read_only / read_write。
file_id string | 文件 ID
当 type 为 file 时返回，表示当前可用的文件 ID。
instructions string | 使用指导
当 type 为 memory_store 时返回，表示会话当前用于该记忆库的使用指导。
memory_store_id string | 记忆库 ID
当 type 为 memory_store 时返回，表示挂载到会话的记忆库 ID。
mount_path string | 挂载路径
当 type 为 file 或 tos 时返回，表示资源在会话运行环境中的挂载路径。创建会话时未指定 TOS 挂载路径，则不返回该字段。
tos_bucket string | TOS 存储桶
当 type 为 tos 时返回，表示挂载源所在的 TOS 存储桶名称。
tos_key string | TOS 目录前缀
当 type 为 tos 时返回，表示 TOS 中已挂载目录的对象前缀。
tos_region string | TOS 地域
当 type 为 tos 时返回，表示挂载源所在地域的 Region ID。
查询会话资源详情
发起调试等同于请求真实调用，可能产生云产品费用，请谨慎操作！
Request
cURL
curl -sS --fail-with-body "https://ark.cn-beijing.volces.com/api/v3/sessions/<SESSION_ID>/resources/<RESOURCE_ID>" \
-H "Authorization: Bearer $ARK_API_KEY"Response
{
"id": "<RESOURCE_ID>",
"type": "memory_store",
"memory_store_id": "<MEMORY_STORE_ID>",
"access": "read_only",
"created_at": "2026-07-15T08:30:20.000Z",
"updated_at": "2026-07-15T08:30:20.000Z"
}最近更新时间：2026.10.24 17:19:38
这个页面对您有帮助吗？
有用
有用
无用
无用