환경 역할 삭제
DELETE /v1/roles/{role_id} · 권한 roles:write
역할을 삭제합니다. force=true를 지정하면 할당된 역할도 삭제되며, 해당 멤버십 할당도 같은 작업에서 제거됩니다. 그렇지 않으면 할당된 역할에 대해 409 role_in_use가 반환됩니다. 조직의 관리자 역할 또는 기본 멤버 역할로 사용 중인 역할은 삭제되지 않습니다. If-Match는 선택 사항입니다. 삭제는 role.deleted로 감사됩니다.
요청
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
role_id |
경로 | 예 | 역할 ID (rol_…)입니다. |
force |
쿼리 | 아니요 | true이면 역할의 할당도 제거합니다. false(기본값)이면 할당된 역할의 삭제를 거부합니다. |
If-Match |
헤더 | 아니요 | 현재 ETag입니다. 일치하지 않으면 412가 반환됩니다. |
요청 본문은 없습니다.
응답
204 No Content.
오류
| HTTP | code | 발생 조건 |
|---|---|---|
| 404 | not_found |
이 범위에 역할이 존재하지 않습니다. |
| 409 | role_in_use |
역할이 할당되어 있고 force가 true가 아니거나, 조직의 관리자 역할 또는 기본 멤버 역할입니다. |
| 412 | precondition_failed |
If-Match가 현재 버전과 일치하지 않습니다. |
| 422 | validation_failed |
force가 true 또는 false가 아니거나 반복되어 있습니다. |
| 401 | unauthenticated |
자격 증명이 없거나, 유효하지 않거나, 취소되었습니다. |
| 403 | insufficient_permissions |
자격 증명에 필요한 권한이 없습니다. |
| 429 | rate_limited |
요청 한도를 초과했습니다. Retry-After 기간이 지난 후 다시 시도하십시오. |
| 503 | service_unavailable |
종속 서비스를 일시적으로 사용할 수 없습니다. Retry-After 기간이 지난 후 다시 시도하십시오. |
예시
curl -i -X DELETE "https://api.eu.keenauth.com/v1/roles/rol_01j9xr7s1t2w6x8y0z2a4b6c8e?force=true" \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"