文档中心

火山方舟

Vaults

更新保管库

POST https://ark.cn-beijing.volces.com/api/v3/vaults/{vault_id}

更新指定保管库的展示名称或自定义元数据。请求体为空，或者只传入空的 metadata 对象时，服务端返回当前保管库信息，不修改数据或更新时间。

鉴权

本接口支持鉴权方式如下，详情请参见 Base URL 及鉴权。

API Key 鉴权，请在 API Key 管理页面，获取长效 API Key。

请求参数

Path 参数

vault_id string 必选 | 保管库 ID

Body 参数

display_name string | 保管库展示名

metadata object | 自定义元数据

响应参数

created_at string | 创建时间

display_name string | 保管库展示名

id string | 保管库 ID

type string | 对象类型

updated_at string | 更新时间

metadata object | 自定义元数据

更新保管库

发起调试等同于请求真实调用，可能产生云产品费用，请谨慎操作！

Request

curl -sS --fail-with-body "https://ark.cn-beijing.volces.com/api/v3/vaults/<VAULT_ID>" \
  -H "Authorization: Bearer $ARK_API_KEY" \
  -H "Content-Type: application/json" \
  -d @- <<'EOF'
{
  "display_name": "Agent Infra · 生产凭证 (2026H2)",
  "metadata": {
    "env": "prod",
    "review_cycle": "2026H2"
  }
}
EOF

Response

{
  "id": "<VAULT_ID>",
  "type": "vault",
  "display_name": "Agent Infra · 生产凭证 (2026H2)",
  "metadata": {
    "team": "agent-infra",
    "env": "prod",
    "review_cycle": "2026H2"
  },
  "created_at": "2026-07-15T08:00:00Z",
  "updated_at": "2026-07-15T10:00:00Z"
}

最近更新时间：2026.10.09 19:08:07

这个页面对您有帮助吗？

有用

无用