Amazon Simple Email Service
개발자 안내서

Amazon SES에서 반환하는 API 오류 코드

이 주제에는 Amazon SES 쿼리(HTTPS) API가 반환하는 오류 코드의 목록이 포함되어 있습니다. Amazon SES API에 대한 자세한 내용은 Amazon Simple Email Service API Reference를 참조하십시오.

5xx 오류가 수신되는 HTTPS 요청을 재시도해야 합니다. 이 경우 중복 생성 가능성을 줄이려면 시간 초과가 연이어 발생할 때마다 점진적으로 더 오래 대기한 후(5, 10, 30초) 지수 재시도 방법을 구현하는 것이 좋습니다. 세 번째 재시도 호출이 실패하면 20분 후 다시 처음부터 재시도를 수행하십시오. Amazon SES에서 지수 재시도 정책을 사용하는 구현 예제는 Amazon SES 블로그의 "조절 - 최대 송신률 초과" 오류를 처리하는 방법을 참조하십시오.

참고

AWS SDK는 재시도 로직을 자동으로 구현합니다.

HTTPS 클라이언트 오류(4xx)가 발생할 경우 다시 시도하기 전에 요청을 수정하여 문제를 해결해야 합니다. 예를 들어, AWS 인증 자격 증명이 잘못된 경우 이메일을 다시 보내기 전에 설정을 업데이트하여 적절한 자격 증명을 사용해야 합니다.

오류 설명 HTTPS 상태 코드 이 코드를 반환하는 작업

ConfigurationSetDoesNotExist

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

400

SendEmail, SendRawEmail

IncompleteSignature

요청 서명이 AWS 표준을 준수하지 않습니다.

400

모두

InternalFailure

알 수 없는 오류, 예외 또는 장애 때문에 요청 처리가 실패했습니다.

500

모두

InvalidAction

요청된 동작 또는 작업이 유효하지 않습니다. 작업을 올바로 입력했는지 확인합니다.

400

모두

InvalidClientTokenId

제공된 X.509 인증서 또는 AWS 액세스 키 ID가 AWS의 레코드에 존재하지 않습니다.

403

모두

InvalidParameterCombination

함께 사용할 수 없는 파라미터가 함께 사용되었습니다.

400

모두

InvalidParameterValue

입력 파라미터로 잘못된 값 또는 범위를 벗어나는 값이 제공되었습니다.

400

모두

InvalidQueryParameter

AWS 쿼리 문자열이 잘못된 양식이거나 AWS 표준을 준수하지 않습니다.

400

모두

MailFromDomainNotVerified

Amazon SES가 지정된 MAIL FROM 도메인을 사용하는 데 필요한 MX 레코드를 읽을 수 없어 메시지가 전송되지 않았습니다.

400

SendEmail, SendRawEmail

MalformedQueryString

쿼리 문자열에 구문 오류가 있습니다.

404

모두

MessageRejected

작업이 실패하고 메시지를 전송하지 못했음을 나타냅니다. 오류 스택에서 오류 원인에 대한 설명이 있는지 확인합니다. 이 오류를 유발할 수 있는 문제에 대한 자세한 내용은 Amazon SES 이메일 전송 오류 단원을 참조하십시오.

400

SendEmail, SendRawEmail

MissingAction

요청에서 작업 또는 필요한 파라미터가 누락되었습니다.

400

모두

MissingAuthenticationToken

요청은 유효한(등록된) AWS 액세스 키 ID 또는 X.509 인증서를 포함해야 합니다.

403

모두

MissingParameter

지정된 작업에 필요한 파라미터가 제공되지 않았습니다.

400

모두

OptInRequired

AWS 액세스 키 ID는 서비스 가입이 필요합니다.

403

모두

RequestExpired

요청이 요청상의 날짜 스탬프로부터 15분 이상, 또는 요청 만료 날짜(예: 미리 서명된 URL)로부터 15분 이상 경과한 후 서비스에 도달했거나, 요청상의 날짜 스탬프가 15분 이상 미래입니다.

400

모두

ServiceUnavailable

요청이 서버의 일시정적 장애 때문에 실패했습니다.

503

모두

Throttling

요청 제한 때문에 요청이 거부되었습니다.

400

모두