Credential の削除

パス

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

ヘッダー	必須	説明
`Authorization`	はい	`Bearer <PAT または SAT>`

Forward は Credential を削除する前に、呼び出し元が対象 Vault を所有していることを確認します。

パラメーター	型	必須	説明
`id`	string	はい	Vault ID。
`cred_id`	string	はい	Credential ID。

Parameter	Type	Required	Description
`identity_id`	string	No	Identity に属するリソースを操作する場合のみ使用する任意のパラメーターです。PAT では明示的に指定でき、省略時は管理者スコープになります。SAT では Identity スコープのトークンを発行し、このパラメーターを明示的に指定しないでください。指定すると HTTP 400 が返されます。Identity の帰属.

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
}

HTTP	Type	発生条件
400	`invalid_request_error`	The request body, path parameters, or pagination parameters are invalid, including an invalid `auth` object, such as `static_bearer` without `token`. SAT が `identity_id` を明示的に指定した場合も返されます。
401	`authentication_error`	認証トークンがないか、無効です。
403	`permission_error`	Vault `identity_id` を指定しない PAT または Admin SAT で Owner mismatch が発生したか、その他の権限が不足しています。
404	`not_found_error`	The Vault or Credential does not exist or is not visible. `identity_id` is invalid, disabled, or does not belong to the caller, or the target resource does not belong to the current Identity scope.
409	`conflict_error`	Credential の状態が操作と競合しています。
500/502/503	`api_error`	Forward または依存サービスでエラーが発生しました。

Credential リクエストの認証情報は機密データです。一部の詳細な検証メッセージは共通のマスク済みメッセージに置き換えられますが、HTTP ステータスとエラー type は変わりません。