Skip to main content
Vaults

删除 Vault

删除未被 Template 引用的 Vault。

路径

DELETE /api/v1/forward/vaults/{id}

请求头

头部必选说明
AuthorizationBearer <PAT 或 SAT>
删除前会执行 Template 引用检查。无引用时删除 Vault;删除后不再出现在默认列表中。

路径参数

参数类型必选说明
idstringVault ID。

示例请求

curl -X DELETE "https://api.qoder.com/api/v1/forward/vaults/vault_xxx" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

示例响应

{
  "id": "vault_xxx",
  "type": "vault_deleted",
  "deleted": true
}

响应字段解释

字段类型说明
idstring被删除资源的 ID。
typestring删除结果类型。
deletedboolean是否已删除。

错误码

HTTPtype触发条件
400invalid_request_error请求体、路径参数或分页参数非法。
401authentication_error缺少或无效的认证令牌。
403permission_error当前调用方无权访问该 Vault。
404not_found_errorVault 不存在、未注册或不可见。
409conflict_error幂等键冲突、创建恢复需要人工介入,或删除时仍被引用。
501feature_not_available当前尚未开放的 Vault 字段更新能力。
500/502/503api_errorForward 或依赖服务失败。
删除 Vault - Qoder