软归档指定 Vault。归档后默认不出现在列表中,已绑定会话仍可使用其 Credential。
前提
已完成 Endpoint 与鉴权配置,详见API 总览与认证。
接口
POST /vaults/{vault_id}/archive
路径参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
vault_id | 是 | string | Vault ID,格式 vlt_xxx |
请求示例
响应
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | Vault ID,格式 vlt_xxx |
type | string | 固定为 vault |
display_name | string | Vault 可读名称 |
metadata | object | 业务自定义键值对 |
archived_at | string | null | 归档时间,已填入归档时间,ISO 8601 |
created_at | string | 创建时间,ISO 8601 |
updated_at | string | 最近更新时间,ISO 8601 |
错误码
| 状态码 | 错误码 | 说明 |
|---|---|---|
| 400 | InvalidParameter | Required parameter missing or invalid. |
| 401 | InvalidApiKey | Invalid API-key provided. |