火山方舟
火山方舟
API参考
请输入
- 文档首页
火山方舟Managed Agents APIVaults查询保管库列表
复制全文
下载 pdf查询保管库列表
文档反馈
问问助手GET https://ark.cn-beijing.volces.com/api/v3/vaults
查询当前项目中的保管库列表，结果按创建时间降序排列。
根据响应中是否包含 next_page 判断是否有更多结果：
- 包含 next_page 时，将该值原样传入下一次请求的 page。
- 不包含 next_page 时，表示没有更多结果，停止分页查询。
鉴权
- API Key 鉴权，请在 API Key 管理 页面，获取长效 API Key。
请求参数
Query 参数
在 URL Query String 中传入。
limit integer 默认值 20 | 每页数量
每页返回的保管库数量。
取值范围：[1, 100]
page string | 下一页标识
用于告诉服务端从上一页结束的位置继续返回数据。该值由服务端生成，不是页码。
首次请求 GET /api/v3/vaults?limit=20 时不传 page。后续翻页规则如下：
- 响应返回 "next_page": "<NEXT_PAGE>" 时，将该值传入下一次请求：GET /api/v3/vaults?limit=20&page=<NEXT_PAGE>。
- 响应不包含 next_page 时，表示没有更多结果。
不要自行生成或修改该值。
scene string | 保管库场景
按保管库的使用场景过滤。省略或传空值时不过滤。
- default：普通业务场景。
- dreams：记忆整理场景。
传入其他值不会报错；没有匹配的场景时返回空列表。
响应参数
data object[] | 保管库列表
查询到的保管库列表。
created_at string | 创建时间
data.created_at
保管库的创建时间，采用 RFC 3339 格式。
display_name string | 保管库展示名
data.display_name
保管库的展示名称，用于识别该保管库。
id string | 保管库 ID
data.id
保管库 ID，以 vlt- 开头。
type string | 对象类型
data.type
表示当前对象是一个保管库。
取值固定为 vault。
updated_at string | 更新时间
data.updated_at
保管库最后一次更新的时间，采用 RFC 3339 格式。
metadata object | 自定义元数据
data.metadata
为保管库设置的字符串键值对，可用于分类或关联业务信息。未设置时返回 null。
scene string | 保管库场景
data.scene
保管库的使用场景。
- default：普通业务场景。
- dreams：记忆整理场景。
next_page string | 下一页标识
下一页标识。无更多数据时不返回；后续请求需将该值原样作为 page 传入。
查询保管库列表
发起调试等同于请求真实调用，可能产生云产品费用，请谨慎操作！
Request
cURL
curl -sS --fail-with-body "https://ark.cn-beijing.volces.com/api/v3/vaults?limit=20" \
-H "Authorization: Bearer $ARK_API_KEY"Response
{
"data": [
{
"id": "vlt-01hx3z9r0w8n3p5q6s7t8v9x40",
"type": "vault",
"display_name": "Agent Infra · 生产凭证",
"metadata": {
"team": "agent-infra",
"env": "prod"
},
"created_at": "2026-07-15T08:00:00Z",
"updated_at": "2026-07-15T09:00:00Z"
}
],
"next_page": "page_xxxxxxxx"
}最近更新时间：2026.10.17 12:32:59
这个页面对您有帮助吗？
有用
有用
无用
无用