归档凭证空间
更新时间:2026-11-13
POST
https://api.dumate.cn/api/dma/v1/vaults/{vault_id}/archive
本接口用于归档指定的凭证空间(Vault)。
归档后的凭证空间不能再关联新会话,创建会话时传入已归档的凭证空间标识返回 400。归档成功后返回凭证空间对象,archived_at 为归档时间。获取凭证空间列表接口传入 include_archived=true 时返回已归档的凭证空间。
权限说明
使用 API Key 鉴权调用 API 流程,具体调用流程,请查看认证鉴权。
请求参数
Headers 参数
除公共头域外,无其它特殊头域
URL 参数
vault_id
string
凭证空间(Vault)标识。
凭证空间不存在时返回 404。
必选
请求结构
POST /api/dma/v1/vaults/{vault_id}/archive HTTP/1.1
Host: api.dumate.cn
Authorization: Bearer <YOUR_API_KEY>
示例代码
请求示例
curl --location --request POST "https://api.dumate.cn/api/dma/v1/vaults/vault_23312a16793d4477/archive" \
--header 'Authorization: Bearer <YOUR_API_KEY>'
返回响应
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:49:23Z",
"archived_at": "2026-11-11T03:49:23Z"
}
评价此篇文章
