Skip to main content
Credentials

删除 Credential

删除指定 Vault 下的 Credential。

路径

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

请求头

头部必选说明
AuthorizationBearer <PAT 或 SAT>
Forward 先确认调用方拥有对应 Vault,再删除 Credential。

路径参数

参数类型必选说明
idstringVault ID。
cred_idstringCredential ID。

查询参数

参数类型必选说明
identity_idstring仅在操作 Identity 归属资源时使用,非必填;PAT 场景可显式传入,未传时为管理员视角;SAT 场景请签发 Identity 维度凭证且不要显式携带该参数,否则返回 HTTP 400(详见 Identity 归属)。

示例请求

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

示例响应

{
  "id": "vcred_xxx",
  "type": "vault_credential_deleted",
  "deleted": true
}

响应字段解释

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

错误码

HTTPtype触发条件
400invalid_request_error请求体、路径参数或分页参数非法,包括 auth 字段不符合要求(如 static_bearer 缺少 token);或 SAT 携带了 identity_id
401authentication_error缺少或无效的认证令牌。
403permission_error未指定 identity_id 的 PAT、Admin SAT 发生 Vault Owner mismatch,或当前调用方存在其他权限不足。
404not_found_errorVault/Credential 不存在或不可见;或 identity_id 无效、已禁用、不属于当前调用方;或该资源不属于当前 Identity 归属。
409conflict_errorCredential 状态冲突。
500/502/503api_errorForward 或依赖服务失败。
Credential 请求中的认证信息属于敏感数据。部分详细校验消息会被替换为统一的脱敏文案,HTTP 状态码和错误 type 保持不变。