사용자 지정 도메인 삭제
DELETE /v1/custom-domains/{custom_domain_id} · 권한 custom-domains:write
사용자 지정 도메인을 삭제합니다. 도메인은 released 상태가 되고, 그 도메인으로의 로그인은 중단되며, 이름은 30일 동안 격리됩니다(다른 환경은 이 이름을 추가할 수 없습니다). 기본 도메인과 환경의 발급자로 사용되는 도메인은 삭제할 수 없습니다. 먼저 다른 도메인을 기본 도메인으로 지정하십시오. 이미 해제된 도메인을 삭제하면 플랫폼 레지스트리의 해제 작업만 반복됩니다.
요청
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
custom_domain_id |
string | 예 | 사용자 지정 도메인 ID(cdom_…). |
If-Match |
header | 예 | 필수입니다. 도메인의 ETag입니다. 없으면 428, 일치하지 않으면 412를 반환합니다. |
요청 본문은 없습니다.
응답
204 No Content를 반환합니다.
오류
| HTTP | code | 발생 조건 |
|---|---|---|
| 404 | not_found |
사용자 지정 도메인이 존재하지 않거나 다른 환경에 속합니다. |
| 409 | custom_domain_in_use |
도메인이 기본 도메인이거나 환경의 발급자입니다. |
| 409 | domain_in_use_by_rp_id |
도메인이 연결의 패스키 rpId이거나, 진행 중인 rpId 마이그레이션의 이전 rpId입니다. 먼저 패스키 rpId 변경으로 rpId를 옮기십시오. |
| 412 | precondition_failed |
If-Match가 도메인의 현재 버전과 일치하지 않습니다. |
| 428 | precondition_required |
If-Match가 없습니다. |
| 503 | service_unavailable |
플랫폼 도메인 레지스트리 또는 환경의 발급자 정보를 일시적으로 사용할 수 없습니다. |
| 401 | unauthenticated |
자격 증명이 없거나 잘못되었거나 취소되었습니다. |
| 403 | insufficient_permissions |
자격 증명에 필요한 권한이 없습니다. |
| 429 | rate_limited |
요청 한도를 초과했습니다. Retry-After 기간 이후에 다시 시도하십시오. |
예시
curl -X DELETE https://api.eu.keenauth.com/v1/custom-domains/cdom_01j9xk3m7q8r2s4t6v8w0y2z4a \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
-H 'If-Match: "3"'