이메일 발신 도메인 삭제

DELETE /v1/email-sender-domains/{sender_domain_id} · 권한 email-sender-domains:write · 모든 요금제

발신 도메인을 삭제합니다. 이메일 전달 구성이 아직 사용 중인 도메인은 삭제할 수 없습니다. 먼저 이메일 공급자를 다른 모드로 전환하십시오. 삭제한 뒤에는 도메인의 DNS 레코드를 제거할 수 있습니다.

요청

필드 타입 필수 설명
sender_domain_id string 예 발신 도메인 ID(sdom_…).
If-Match 헤더 예 도메인의 ETag. *는 모든 버전과 일치합니다. 없으면 428, 일치하지 않으면 412.

요청 본문은 없습니다.

응답

204 No Content.

오류

HTTP code 발생 조건
404 not_found 발신 도메인이 없거나, 다른 환경에 속하거나, ID 형식이 잘못되었습니다.
409 conflict 이메일 전달 구성이 이 도메인을 사용 중입니다(platform_managed_domain). 먼저 이메일 공급자를 다른 모드 또는 도메인으로 전환하십시오.
412 precondition_failed If-Match가 도메인의 현재 버전과 일치하지 않습니다.
428 precondition_required If-Match가 없습니다.
401 unauthenticated 자격 증명이 없거나, 잘못되었거나, 폐기되었습니다.
403 insufficient_permissions 자격 증명에 필요한 권한이 없습니다.
429 rate_limited 속도 제한을 초과했습니다. Retry-After 시간이 지난 후 다시 시도하십시오.
503 service_unavailable 종속 서비스를 일시적으로 사용할 수 없습니다. Retry-After 시간이 지난 후 다시 시도하십시오.

예시

curl -X DELETE https://api.eu.keenauth.com/v1/email-sender-domains/sdom_01k7r9m3q5t8v2w4x6y8z0a2b4 \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H 'If-Match: "2"'

CLI: keenauth email-sender-domains delete sdom_01k7r9m3q5t8v2w4x6y8z0a2b4 --if-match '"2"'