Amazon SES 이메일 전송 오류

이 주제는 Amazon SES를 통해 이메일을 전송할 때 발생할 수 있는 이메일 전송 고유 오류에 대해 알아봅니다. Amazon SES를 통해 이메일을 전송하려 할 때 Amazon SES 호출이 실패할 경우, Amazon SES가 애플리케이션으로 오류 메시지를 반환하고 이메일을 전송하지 않습니다. 이 오류 메시지를 확인하는 방법은 Amazon SES를 호출하는 방법에 따라 달라집니다.

• Amazon SES API를 직접 호출하는 경우 쿼리 작업이 오류를 반환합니다. 오류는 MessageRejected이거나 Amazon Simple Email Service API 참조의 일반 오류 주제에 지정된 오류 중 하나일 수 있습니다.

• 예외를 지원하는 프로그래밍 언어를 사용하는AWS SDK를 사용하여 Amazon SES를 호출하는 경우 Amazon SES에서 예외가 발생할 수 있습니다. 예외의 유형은 SDK 및 오류에 따라 달라집니다. 예를 들어 예외는 Amazon SES MessageRejectedException(실제 이름은 SDK에 따라 다름) 또는 일반 AWS 예외일 수 있습니다. 예외의 유형과 상관없이 예외의 오류 유형 및 오류 메시지를 통해 더 많은 정보를 확인할 수 있습니다.

• SMTP 인터페이스를 통해 Amazon SES를 호출하는 경우 애플리케이션에 따라 오류를 경험하는 방식이 달라집니다. 일부 애플리케이션은 구체적 오류 메시지를 표시할 수 있지만 다른 애플리케이션은 그렇지 않을 수 있습니다. Amazon SES에서 반환하는 SMTP 응답 코드 목록은 Amazon SES에서 반환하는 SMTP 응답 코드 단원을 참조하십시오.

참고

이메일을 전송하기 위한 Amazon SES 호출이 실패할 경우 해당 이메일에 대해서는 비용이 부과되지 않습니다.

다음은 이메일을 전송할 때 Amazon SES가 오류를 반환할 수 있는 Amazon SES 고유 문제의 유형입니다. 이러한 오류는 Amazon Simple Email Service API 참조의 일반 오류 주제에 지정된 MalformedQueryString와(과) 같은 일반 AWS 오류에 추가됩니다.

• Email address is not verified(이메일 주소가 확인되지 않음). region 리전에서 identity1, identity2, identity3을 확인하는데 실패했습니다.—Amazon SES에서 확인되지 않은 이메일 주소 또는 도메인에서 이메일을 보내려고 합니다. 이 오류는 "From", "Source", "Sender" 또는 "Return-Path" 주소에 해당할 수 있습니다. 계정이 여전히 Amazon SES 샌드박스에 있을 경우 Amazon SES 메일박스 시뮬레이터에서 제공하는 수신자를 제외한 모든 수신자 이메일 주소를 확인해야 합니다. Amazon SES에서 실패한 자격 증명을 전부 표시할 수 없는 경우 오류 메시지가 말줄임표로 끝납니다.

  참고

  Amazon SES는 여러 AWS 리전에 엔드포인트가 있으며 이메일 주소의 확인 상태는AWS 리전마다 서로 다릅니다. 사용하려는 AWS 리전에서 각 발신자에 대해 확인 프로세스를 완료해야 합니다.

• 계정이 일시 중지됨—사용자 계정의 이메일 전송 기능이 일시 중지됩니다. Amazon SES 콘솔에 계속 액세스하여 대부분의 작업을 수행할 수는 있습니다. 그러나 이메일을 전송할 경우 이 메시지를 받습니다.

  사용자 계정의 이메일 전송 기능이 일시 중지되면 AWS 계정과 연결된 이메일 주소로 알림이 자동 전송됩니다. 자세한 내용은 섹션을 참조하세요Amazon SES 전송 검토 프로세스 FAQ

• 제한—애플리케이션이 초당 너무 많은 메시지를 전송하려고 시도하고 있거나 최근 24시간 동안 너무 많은 이메일을 전송했을 수 있습니다. 이러한 경우 오류 메시지는 다음 예와 유사할 수 있습니다.

  • 일일 메시지 할당량 초과—24시간 기준으로 허용된 최대 메시지 수를 전송했습니다. 일일 할당량을 초과한 경우 다음 24시간 기간까지 기다렸다가 추가로 이메일을 전송할 수 있습니다.

  • 최대 송신률 초과—최대 송신률이 허용하는 초당 이메일보다 많은 이메일을 전송하려 했습니다. 전송 속도를 초과한 경우 계속 이메일을 전송할 수는 있지만 전송 속도를 낮춰야 합니다. 자세한 내용은 AWS 메시징 및 타겟팅 블로그에서 ‘제한 - 최대 전송 속도 초과’ 오류를 처리 하는 방법을 참조하십시오.

  • 최대 SigV2 SMTP 전송률 초과—2019년 1월 10일 이전에 생성된 SMTP 자격 증명을 사용하여 메시지를 보내려고 합니다. SMTP 자격 증명이 이전 버전의 AWS Signature를 사용하여 생성되었습니다. 보안을 위해 이 날짜 이전에 생성한 자격 증명을 삭제하고 새로운 자격 증명으로 교체하십시오. IAM 콘솔을 사용하여 이전 자격 증명을 삭제할 수 있습니다. 자격 증명 생성에 대한 자세한 내용은 아마존 SES SMTP 자격 증명 취득 단원을 참조하십시오.

  정기적으로 전송 활동을 모니터링하여 얼마나 발신 할당량에 근접해 있는지 확인해야 합니다. 자세한 내용은 Amazon SES 전송 할당량 모니터링 단원을 참조하세요. 발신 할당량에 대한 일반적인 정보는 Amazon SES 발신 한도 관리 단원을 참조하세요. 발신 할당량을 높이는 방법에 대한 자세한 내용은 Amazon SES 발신 할당량 높이기 단원을 참조하세요.

  중요

  스로틀링 오류를 설명하는 오류 텍스트가 일일 할당량 또는 최대 전송 속도 초과와 관련되지 않은 경우 시스템 전체 문제로 인해 전송 용량이 감소한 것일 수 있습니다. 서비스 상태에 대한 자세한 내용은 AWS Service Health Dashboard를 참조하십시오.

• 지정된 수신자가 없음—수신자를 입력하지 않았습니다.

• 이메일 주소에 비 ASCII 문자가 포함되어 있음—이메일 주소 문자열은 7비트 ASCII여야 합니다. 주소의 도메인 부분에 유니코드 문자가 포함된 이메일 주소와 메시지를 주고받으려면 퓨니코드를 사용하여 도메인을 인코딩해야 합니다. 이메일 주소의 로컬 부분(@ 기호 앞부분)은 물론 "대화명"에도 퓨니코드를 사용할 수 없습니다. "대화명"에 유니코드 문자를 사용하려면 Amazon SES API v2를 사용하여 원시 이메일 보내기에서 설명한 것과 같이 MIME 인코딩된 단어 구문을 사용하여 "대화명"을 인코딩해야 합니다. 퓨니코드에 대한 자세한 내용은 RFC 3492를 참조하세요.

• Mail FROM 도메인이 확인되지 않음—Amazon SES가 지정된 MAIL FROM 도메인을 사용하는 데 필요한 MX 레코드를 읽지 못했습니다. 사용자 지정 MAIL FROM 도메인 설정에 대한 자세한 내용은 사용자 지정 MAIL FROM 도메인 사용 단원을 참조하세요.

• 구성 세트가 존재하지 않음—사용자가 지정한 구성 세트가 존재하지 않습니다. 구성 세트는 이메일 전송 이벤트를 게시하는 데 사용하는 선택적 파라미터입니다. 자세한 내용은 Amazon SES 이벤트 게시를 사용하여 이메일 전송을 모니터링합니다. 단원을 참조하세요.