更新凭证空间
更新时间：2026-11-13
POST
https://api.dumate.cn/api/dma/v1/vaults/{vault_id}
本接口用于更新凭证空间（Vault）的显示名称和自定义键值。
所有字段均可选，只需传入要修改的字段。更新成功后返回更新后的凭证空间对象。
权限说明
使用 API Key 鉴权调用 API 流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
URL 参数
vault_id
string
凭证空间（Vault）标识。
凭证空间不存在时返回 404。
必选
Body 参数
display_name
string
显示名称。
长度：1–255 个字符。
可选
metadata
object
自定义键值，按键合并。
传入的键覆盖原值，值为 null 的键删除，未传的键保留。
可选
显示子属性
隐藏子属性
请求结构
POST /api/dma/v1/vaults/{vault_id} HTTP/1.1
Host: api.dumate.cn
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json示例代码
请求示例
curl --location --request POST "https://api.dumate.cn/api/dma/v1/vaults/vault_23312a16793d4477" \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"display_name": "doc-test-vault-renamed"
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
type
string
资源类型标识，固定为 vault。
可选
id
string
凭证空间（Vault）标识，vault_ 前缀。
可选
display_name
string
显示名称。
可选
metadata
object
自定义键值。
可选
显示子属性
隐藏子属性
created_at
string
创建时间，RFC 3339 格式，UTC。
可选
updated_at
string
最近更新时间，RFC 3339 格式，UTC。
可选
archived_at
string
归档时间，RFC 3339 格式，UTC；未归档时为 null。
可选
响应示例
{
"type": "vault",
"id": "vault_23312a16793d4477",
"display_name": "doc-test-vault-renamed",
"metadata": {
"ticket": "doc"
},
"created_at": "2026-11-11T03:47:43Z",
"updated_at": "2026-11-11T03:47:44Z",
"archived_at": null
}评价此篇文章