기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Amazon SES에 대한 Amazon SNS 알림 내용

반송 메일, 수신 거부 및 전송 알림이 Amazon Simple Notification Service(Amazon SNS) 주제에 JavaScript Object Notation(JSON) 형식으로 게시됩니다. 최상위 JSON 객체는 notificationType 문자열, mail 객체 및 bounce 객체, complaint 객체 또는 delivery 객체를 포함합니다.

다양한 객체 유형에 대한 설명은 다음 단원을 참조하세요.

다음은 Amazon SES용 Amazon SNS 알림의 내용에 관한 몇 가지 중요한 정보입니다.

최상위 JSON 객체

SES 알림의 최상위 JSON 객체에는 다음 필드가 포함됩니다.

Mail 객체

각 반송 메일, 수신 거부 또는 전송 알림은 mail 객체에 원래 메일에 대한 정보를 포함하고 있습니다. mail 객체 정보를 포함하는 JSON 객체는 다음 필드로 구성됩니다.

다음은 원래 이메일 헤더가 포함되어 있는 mail 객체의 예제입니다. 이 알림 유형에 원래 이메일 헤더가 포함되도록 구성하지 않은 경우, mail 객체에 headersTruncated, headers 및 commonHeaders 필드가 없습니다.

{
   "timestamp":"2018-10-08T14:05:45 +0000",
   "messageId":"000001378603177f-7a5433e7-8edb-42ae-af10-f0181f34d6ee-000000",
   "source":"sender@example.com",
   "sourceArn": "arn:aws:ses:us-east-1:888888888888:identity/example.com",
   "sourceIp": "127.0.3.0",
   "sendingAccountId":"123456789012",
   "destination":[
      "recipient@example.com"
   ],
   "headersTruncated":false,
   "headers":[ 
      { 
         "name":"From",
         "value":"\"Sender Name\" <sender@example.com>"
      },
      { 
         "name":"To",
         "value":"\"Recipient Name\" <recipient@example.com>"
      },
      { 
         "name":"Message-ID",
         "value":"custom-message-ID"
      },
      { 
         "name":"Subject",
         "value":"Hello"
      },
      { 
         "name":"Content-Type",
         "value":"text/plain; charset=\"UTF-8\""
      },
      { 
         "name":"Content-Transfer-Encoding",
         "value":"base64"
      },
      { 
         "name":"Date",
         "value":"Mon, 08 Oct 2018 14:05:45 +0000"
      }
   ],
   "commonHeaders":{ 
      "from":[ 
         "Sender Name <sender@example.com>"
      ],
      "date":"Mon, 08 Oct 2018 14:05:45 +0000",
      "to":[ 
         "Recipient Name <recipient@example.com>"
      ],
      "messageId":" custom-message-ID",
      "subject":"Message sent using SES"
   }
}

Bounce 객체

반송 메일에 대한 정보를 포함하는 JSON 객체는 다음 필드로 구성됩니다.

SES가 원격 메시지 전송 기관(MTA)에 연락할 수 있는 경우 다음 필드도 있습니다.

반송 메일에 전송 상태 알림(DSN)이 첨부된 경우 다음 필드도 존재합니다.

다음은 bounce 객체의 예입니다.

{
   "bounceType":"Permanent",
   "bounceSubType": "General",
   "bouncedRecipients":[
      {
         "status":"5.0.0",
         "action":"failed",
         "diagnosticCode":"smtp; 550 user unknown",
         "emailAddress":"recipient1@example.com"
      },
      {
         "status":"4.0.0",
         "action":"delayed",
         "emailAddress":"recipient2@example.com"
      }
   ],
   "reportingMTA": "example.com",
   "timestamp":"2012-05-25T14:59:38.605Z",
   "feedbackId":"000001378603176d-5a4b5ad9-6f30-4198-a8c3-b1eb0c270a1d-000000",
   "remoteMtaIp":"127.0.2.0"
}

반송 수신자

반송 메일 알림은 단일 수신자 또는 여러 수신자와 관련이 있을 수 있습니다. bouncedRecipients 필드는 객체(반송 메일 알림이 관련된 수신자당 1개)의 목록을 포함하고 있으며 항상 다음 필드로 구성됩니다.

또는 반송 메일에 DSN이 첨부된 경우 다음 필드도 존재할 수 있습니다.

다음은 bouncedRecipients 목록에 포함될 수 있는 객체의 예입니다.

{
    "emailAddress": "recipient@example.com",
    "action": "failed",
    "status": "5.0.0",
    "diagnosticCode": "X-Postfix; unknown user"
}

반송 메일 유형

반송 메일 객체에는 Undetermined, Permanent (하드) 또는 Transient (소프트)의 반송 메일 유형이 포함됩니다. Permanent (하드) 및 Transient (소프트) 반송 메일 유형에는 여러 반송 메일 하위 유형 중 하나가 포함될 수도 있습니다.

반송 메일 유형이 Transient (소프트)인 반송 메일 알림을 받으면 메시지 반송을 유발한 문제가 해결되면 나중에 해당 수신자에게 이메일을 보낼 수 있습니다.

반송 메일 유형이 Permanent (하드)인 반송 메일 알림을 받으면 향후 해당 수신자에게 이메일을 보낼 수 없을 것입니다. 이러한 이유로 메일 발송 목록에서 반송 메일을 생성한 주소의 수신자를 즉시 제거해야 합니다.

Complaint 객체

수신 거부에 대한 정보를 포함하는 JSON 객체는 다음 필드로 구성됩니다.

또한, 수신 거부에 피드백 보고서가 첨부된 경우 다음 필드가 포함될 수 있습니다.

다음은 complaint 객체의 예입니다.

{
   "userAgent":"ExampleCorp Feedback Loop (V0.01)",
   "complainedRecipients":[
      {
         "emailAddress":"recipient1@example.com"
      }
   ],
   "complaintFeedbackType":"abuse",
   "arrivalDate":"2009-12-03T04:24:21.000-05:00",
   "timestamp":"2012-05-25T14:59:38.623Z",
   "feedbackId":"000001378603177f-18c07c78-fa81-4a58-9dd1-fedc3cb8f49a-000000"
}
            

수신 거부한 수신자

complainedRecipients 필드는 수신 거부를 제출했을 수 있는 수신자의 목록을 포함합니다. 이 정보를 사용하여 수신 거부를 제출한 수신자를 확인한 다음 해당 수신자를 메일링 목록에서 즉시 제거해야 합니다.

이 목록의 JSON 객체는 다음 필드를 포함합니다.

다음은 수신 거부를 제기한 수신자 객체의 예입니다.

{ "emailAddress": "recipient1@example.com" }

수신 거부 유형

Internet Assigned Numbers Authority 웹사이트에 따라 complaintFeedbackType 필드에 보고 ISP가 할당한 다음과 같은 수신 거부 유형이 나타날 수 있습니다.

전송 객체

전송에 대한 정보를 포함하는 JSON 객체에는 항상 다음 필드가 포함됩니다.

다음은 delivery 객체의 예입니다.

{
   "timestamp":"2014-05-28T22:41:01.184Z",
   "processingTimeMillis":546,
   "recipients":["success@simulator.amazonses.com"],
   "smtpResponse":"250 ok:  Message 64111812 accepted",
   "reportingMTA":"a8-70.smtp-out.amazonses.com",
   "remoteMtaIp":"127.0.2.0"
}