Eliminare un ruolo dell'ambiente

DELETE /v1/roles/{role_id} · autorizzazione roles:write

Elimina il ruolo. Con force=true viene eliminato anche un ruolo assegnato e le sue assegnazioni ai membri vengono rimosse nella stessa operazione; altrimenti un ruolo assegnato restituisce 409 role_in_use. Un ruolo usato come ruolo di amministratore o di membro predefinito dell'organizzazione non viene mai eliminato. If-Match è facoltativo. L'eliminazione viene registrata nel log di audit come role.deleted.

Richiesta

Campo Tipo Obbligatorio Descrizione
role_id path sì ID del ruolo (rol_…).
force query no true rimuove anche le assegnazioni del ruolo; false (predefinito) rifiuta un ruolo assegnato.
If-Match header no ETag corrente; in caso di mancata corrispondenza 412.

Nessun corpo della richiesta.

Risposta

204 No Content.

Errori

HTTP code Quando
404 not_found Il ruolo non esiste in questo ambito.
409 role_in_use Il ruolo è assegnato e force non è true, oppure è il ruolo di amministratore o di membro predefinito dell'organizzazione.
412 precondition_failed If-Match non corrisponde alla versione corrente.
422 validation_failed force non è true o false, oppure è ripetuto.
401 unauthenticated La credenziale manca, non è valida o è stata revocata.
403 insufficient_permissions La credenziale non ha l'autorizzazione richiesta.
429 rate_limited È stato superato il limite di richieste; riprova dopo il periodo indicato in Retry-After.
503 service_unavailable Una dipendenza è temporaneamente non disponibile; riprova dopo il periodo indicato in Retry-After.

Esempio

curl -i -X DELETE "https://api.eu.keenauth.com/v1/roles/rol_01j9xr7s1t2w6x8y0z2a4b6c8e?force=true" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"