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。

示例请求

curl -X DELETE "https://api.qoder.com/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)。
401authentication_error缺少或无效的认证令牌。
403permission_error当前调用方无权访问所属 Vault 或 Credential。
404not_found_errorVault/Credential 不存在或不可见。
409conflict_errorCredential 状态冲突。
500/502/503api_errorForward 或依赖服务失败。
Credential 请求中的认证信息属于敏感数据。部分详细校验消息会被替换为统一的脱敏文案,HTTP 状态码和错误 type 保持不变。