Skip to main content
Credentials

Credential の削除

Vault から Credential を削除します。

パス

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

リクエストヘッダー

ヘッダー必須説明
AuthorizationはいBearer <PAT または SAT>
Forward は Credential を削除する前に、呼び出し元が対象 Vault を所有していることを確認します。

パス参数

パラメーター必須説明
idstringはいVault ID。
cred_idstringはいCredential 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
}

レスポンスフィールド

フィールド説明
idstringID of the deleted resource.
typestring削除結果のタイプ。
deletedbooleanリソースが削除されたかどうか。

エラー

HTTPType発生条件
400invalid_request_errorリクエストボディ、パスパラメーター、またはページネーションパラメーターが不正です。token のない static_bearer など、不正な auth オブジェクトも含まれます。
401authentication_error認証トークンがないか、無効です。
403permission_error呼び出し元には親 Vault または Credential へのアクセス権限がありません。
404not_found_errorVault または Credential が存在しないか、参照できません。
409conflict_errorCredential の状態が操作と競合しています。
500/502/503api_errorForward または依存サービスでエラーが発生しました。
Credential リクエストの認証情報は機密データです。一部の詳細な検証メッセージは共通のマスク済みメッセージに置き換えられますが、HTTP ステータスとエラー type は変わりません。