Rimuovi un dominio personalizzato

DELETE /v1/custom-domains/{custom_domain_id} · autorizzazione custom-domains:write

Rimuove un dominio personalizzato: passa a released, l'accesso tramite esso si interrompe e il nome resta in quarantena per 30 giorni (nessun altro ambiente può aggiungerlo). Il dominio principale e il dominio usato come issuer dell'ambiente non possono essere rimossi; rendi prima primario un altro dominio. Rimuovere un dominio già rilasciato ripete solo il rilascio nel registro della piattaforma.

Richiesta

Campo Tipo Obbligatorio Descrizione
custom_domain_id string sì ID del dominio personalizzato (cdom_…).
If-Match header sì Obbligatorio. Il ETag del dominio; 428 se manca, 412 se non corrisponde.

Nessun corpo della richiesta.

Risposta

204 No Content.

Errori

HTTP code Quando
404 not_found Il dominio personalizzato non esiste o appartiene a un altro ambiente.
409 custom_domain_in_use Il dominio è il dominio principale o l'issuer dell'ambiente.
409 domain_in_use_by_rp_id Il dominio è il rpId di una passkey di una connessione, oppure il rpId precedente di una migrazione di rpId in corso; sposta prima il rpId con Cambia il rpId della passkey.
412 precondition_failed If-Match non corrisponde alla versione corrente del dominio.
428 precondition_required If-Match manca.
503 service_unavailable Il registro dei domini della piattaforma o le informazioni sull'issuer dell'ambiente non sono temporaneamente disponibili.
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.

Esempio

curl -X DELETE https://api.eu.keenauth.com/v1/custom-domains/cdom_01j9xk3m7q8r2s4t6v8w0y2z4a \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H 'If-Match: "3"'