를 사용한 Amazon SES 예제 AWS CLI

자격 증명을 삭제하려면

다음 예제에서는 delete-identity 명령을 사용하여 Amazon 로 확인된 자격 증명 목록에서 자격 증명을 삭제합니다SES.

aws ses delete-identity --identity user@example.com

확인된 자격 증명에 대한 자세한 내용은 Amazon Simple Email Service 개발자 안내서SES의 Amazon에서 이메일 주소 및 도메인 확인을 참조하세요.

자격 증명 목록에 대한 Amazon SES Easy DKIM 속성을 가져오려면

다음 예제에서는 get-identity-dkim-attributes 명령을 사용하여 자격 증명 목록에 대한 Amazon SES Easy DKIM 속성을 검색합니다.

aws ses get-identity-dkim-attributes --identities "example.com" "user@example.com"

출력:

{
   "DkimAttributes": {
       "example.com": {
           "DkimTokens": [
               "EXAMPLEjcs5xoyqytjsotsijas7236gr",
               "EXAMPLEjr76cvoc6mysspnioorxsn6ep",
               "EXAMPLEkbmkqkhlm2lyz77ppkulerm4k"
           ],
           "DkimEnabled": true,
           "DkimVerificationStatus": "Success"
       },
       "user@example.com": {
           "DkimEnabled": false,
           "DkimVerificationStatus": "NotStarted"
       }
   }
}

확인을 위해 제출한 적이 없는 자격 증명을 사용하여 이 명령을 직접적으로 호출하는 경우 해당 자격 증명은 출력에 표시되지 않습니다.

Easy 에 대한 자세한 내용은 Amazon Simple Email Service 개발자 안내서SES의 AmazonDKIM에서 Easy를 DKIM참조하세요.

자격 증명 목록에 대한 Amazon SES 알림 속성을 가져오려면

다음 예제에서는 get-identity-notification-attributes 명령을 사용하여 자격 증명 목록에 대한 Amazon SES 알림 속성을 검색합니다.

aws ses get-identity-notification-attributes --identities "user1@example.com" "user2@example.com"

출력:

{
   "NotificationAttributes": {
       "user1@example.com": {
           "ForwardingEnabled": false,
           "ComplaintTopic": "arn:aws:sns:us-east-1:EXAMPLE65304:MyTopic",
           "BounceTopic": "arn:aws:sns:us-east-1:EXAMPLE65304:MyTopic",
           "DeliveryTopic": "arn:aws:sns:us-east-1:EXAMPLE65304:MyTopic"
       },
       "user2@example.com": {
           "ForwardingEnabled": true
       }
   }
}

이 명령은 이메일 피드백 전달 상태를 반환하고, 해당하는 경우 반송, 불만 및 전송 알림을 보내는 Amazon SNS 주제의 Amazon 리소스 이름(ARNs)을 반환합니다.

확인을 위해 제출한 적이 없는 자격 증명을 사용하여 이 명령을 직접적으로 호출하는 경우 해당 자격 증명은 출력에 표시되지 않습니다.

알림에 대한 자세한 내용은 Amazon Simple Email Service 개발자 안내서의 AmazonSES에서 알림 사용을 참조하세요.

자격 증명 목록에 대한 Amazon SES 확인 상태를 가져오려면

다음 예제에서는 get-identity-verification-attributes 명령을 사용하여 자격 증명 목록에 대한 Amazon SES 확인 상태를 검색합니다.

aws ses get-identity-verification-attributes --identities "user1@example.com" "user2@example.com"

출력:

{
   "VerificationAttributes": {
       "user1@example.com": {
           "VerificationStatus": "Success"
       },
       "user2@example.com": {
           "VerificationStatus": "Pending"
       }
   }
}

확인을 위해 제출한 적이 없는 자격 증명을 사용하여 이 명령을 직접적으로 호출하는 경우 해당 자격 증명은 출력에 표시되지 않습니다.

확인된 자격 증명에 대한 자세한 내용은 Amazon Simple Email Service 개발자 안내서SES의 Amazon에서 이메일 주소 및 도메인 확인을 참조하세요.

Amazon SES 전송 한도를 가져오려면

다음 예제에서는 get-send-quota 명령을 사용하여 Amazon SES 전송 한도를 반환합니다.

aws ses get-send-quota

출력:

{
   "Max24HourSend": 200.0,
   "SentLast24Hours": 1.0,
   "MaxSendRate": 1.0
}

Max24HourSend 는 24시간 동안 보낼 수 있는 최대 이메일 수인 전송 할당량입니다. 발신 할당량은 롤링 기간을 반영합니다. 이메일을 보내려고 할 때마다 Amazon은 지난 24시간 동안 보낸 이메일 수를 SES 확인합니다. 보낸 이메일의 총 수가 할당량보다 낮으면 전송 요청이 수락되고 이메일이 전송됩니다.

SentLast24Hours은 지난 24시간 동안 보낸 이메일 수입니다.

MaxSendRate 는 초당 전송할 수 있는 최대 이메일 수입니다.

발신 한도는 메시지 수가 아닌 수신자 수를 기준으로 한다는 점에 유의하세요. 예를 들어, 수신자가 10명인 이메일은 전송 할당량에서 10개로 간주됩니다.

자세한 내용은 Amazon Simple Email Service 개발자 안내서의 Amazon SES 전송 한도 관리를 참조하세요.

Amazon SES 전송 통계를 가져오려면

다음 예제에서는 get-send-statistics 명령을 사용하여 Amazon SES 전송 통계를 반환합니다.

aws ses get-send-statistics

출력:

{
   "SendDataPoints": [
       {
           "Complaints": 0,
           "Timestamp": "2013-06-12T19:32:00Z",
           "DeliveryAttempts": 2,
           "Bounces": 0,
           "Rejects": 0
       },
       {
           "Complaints": 0,
           "Timestamp": "2013-06-12T00:47:00Z",
           "DeliveryAttempts": 1,
           "Bounces": 0,
           "Rejects": 0
       }
   ]
}

그 결과 지난 2주간의 전송 활동을 나타내는 데이터 포인트 목록이 생성됩니다. 목록의 각 데이터 포인트에는 15분 간격의 통계가 포함됩니다.

이 예제에서는 지난 2주 동안 사용자가 보낸 유일한 이메일이 2개의 15분 간격 내에 속했기 때문에 두 개의 데이터 포인트만 있습니다.

자세한 내용은 Amazon Simple Email Service 개발자 안내서의 Amazon SES 사용 통계 모니터링을 참조하세요.

특정 AWS 계정의 모든 자격 증명(이메일 주소 및 도메인)을 나열하려면

다음 예제에서는 list-identities 명령을 사용하여 Amazon 에 확인을 위해 제출된 모든 자격 증명을 나열합니다SES.

aws ses list-identities

출력:

{
    "Identities": [
      "user@example.com",
      "example.com"
    ]
}

반환되는 목록에는 확인 상태(확인됨, 확인 보류 중, 실패 등)와 상관없이 모든 자격 증명이 포함됩니다.

이 예제에서는 자격 증명 유형 파라미터를 지정하지 않았으므로 이메일 주소와 도메인이 모두 반환됩니다.

확인에 대한 자세한 내용은 Amazon Simple Email Service 개발자 안내서SES의 Amazon에서 이메일 주소 및 도메인 확인을 참조하세요.

Amazon을 사용하여 형식이 지정된 이메일을 보내려면 SES

다음 예제에서는 send-email 명령을 사용하여 서식이 지정된 이메일을 보냅니다.

aws ses send-email --from sender@example.com --destination file://destination.json --message file://message.json

출력:

{
   "MessageId": "EXAMPLEf3a5efcd1-51adec81-d2a4-4e3f-9fe2-5d85c1b23783-000000"
}

대상과 메시지는 현재 디렉터리의 .json 파일에 저장된 JSON 데이터 구조입니다. 이러한 파일은 다음과 같습니다.

destination.json:

{
  "ToAddresses":  ["recipient1@example.com", "recipient2@example.com"],
  "CcAddresses":  ["recipient3@example.com"],
  "BccAddresses": []
}

message.json:

{
   "Subject": {
       "Data": "Test email sent using the AWS CLI",
       "Charset": "UTF-8"
   },
   "Body": {
       "Text": {
           "Data": "This is the message body in text format.",
           "Charset": "UTF-8"
       },
       "Html": {
           "Data": "This message body contains HTML formatting. It can, for example, contain links like this one: <a class=\"ulink\" href=\"http://docs.aws.amazon.com/ses/latest/DeveloperGuide\" target=\"_blank\">Amazon SES Developer Guide</a>.",
           "Charset": "UTF-8"
       }
   }
}

발신자 및 수신자 이메일 주소를 사용하려는 주소로 바꿉니다. 발신자의 이메일 주소는 Amazon 로 확인해야 합니다SES. Amazon 에 대한 프로덕션 액세스 권한이 부여될 때까지 수신자가 Amazon SES 사서함 시뮬레이터가 아닌 한 각 수신자의 이메일 주소도 확인해야 SES합니다. 확인에 대한 자세한 내용은 Amazon Simple Email Service 개발자 안내서SES의 Amazon에서 이메일 주소 및 도메인 확인을 참조하세요.

출력의 Message ID는 직접적인 send-email 호출이 성공했음을 나타냅니다.

이메일을 받지 못한 경우 정크 박스를 확인해 보세요.

형식이 지정된 이메일 전송에 대한 자세한 내용은 Amazon Simple Email Service 개발자 안내서SESAPI의 Amazon을 사용하여 형식이 지정된 이메일 전송을 참조하세요.

Amazon을 사용하여 원시 이메일을 보내려면 SES

다음 예제에서는 send-raw-email 명령을 사용하여 TXT 첨부 파일이 포함된 이메일을 보냅니다.

aws ses send-raw-email --raw-message file://message.json

출력:

{
   "MessageId": "EXAMPLEf3f73d99b-c63fb06f-d263-41f8-a0fb-d0dc67d56c07-000000"
}

원시 메시지는 message.json 현재 디렉터리에 이름이 지정된 파일에 저장된 JSON 데이터 구조입니다. 이는 다음을 포함합니다.

{
   "Data": "From: sender@example.com\nTo: recipient@example.com\nSubject: Test email sent using the AWS CLI (contains an attachment)\nMIME-Version: 1.0\nContent-type: Multipart/Mixed; boundary=\"NextPart\"\n\n--NextPart\nContent-Type: text/plain\n\nThis is the message body.\n\n--NextPart\nContent-Type: text/plain;\nContent-Disposition: attachment; filename=\"attachment.txt\"\n\nThis is the text in the attachment.\n\n--NextPart--"
}

보시다시피 “데이터”는 attachment.txt라는 첨부 파일을 포함하여 MIME 형식의 전체 원시 이메일 콘텐츠를 포함하는 하나의 긴 문자열입니다.

sender@example.com 및 recipient@example.com을 사용하려는 주소로 바꿉니다. 발신자의 이메일 주소는 Amazon 로 확인해야 합니다SES. Amazon 에 대한 프로덕션 액세스 권한이 부여될 때까지 수신자가 Amazon SES 사서함 시뮬레이터가 아닌 한 수신자의 이메일 주소도 확인해야 SES합니다. 확인에 대한 자세한 내용은 Amazon Simple Email Service 개발자 안내서SES의 Amazon에서 이메일 주소 및 도메인 확인을 참조하세요.

출력의 메시지 ID는 send-raw-email에 대한 호출이 성공했음을 나타냅니다.

이메일을 받지 못한 경우 정크 박스를 확인해 보세요.

원시 이메일 전송에 대한 자세한 내용은 Amazon Simple Email Service 개발자 안내서SESAPI의 Amazon을 사용하여 원시 이메일 전송을 참조하세요.

Amazon에서 SES 확인한 자격 증명DKIM에 대해 Easy를 활성화 또는 비활성화하려면

다음 예제에서는 set-identity-dkim-enabled 명령을 사용하여 확인된 이메일 주소에 DKIM 대해 를 비활성화합니다.

aws ses set-identity-dkim-enabled --identity user@example.com --no-dkim-enabled

Easy 에 대한 자세한 내용은 Amazon Simple Email Service 개발자 안내서SES의 AmazonDKIM에서 Easy를 DKIM참조하세요.

Amazon SES 확인 자격 증명에 대한 반송 및 불만 이메일 피드백 전달을 활성화 또는 비활성화하려면

다음 예제에서는 set-identity-feedback-forwarding-enabled 명령을 사용하여 확인된 이메일 주소가 이메일로 반송 및 불만 사항 알림을 수신할 수 있도록 합니다.

aws ses set-identity-feedback-forwarding-enabled --identity user@example.com --forwarding-enabled

Amazon SNS 또는 이메일 피드백 전달을 통해 반송 및 불만 사항 알림을 수신해야 하므로 반송 및 불만 사항 알림 모두에 대해 Amazon SNS 주제를 선택한 경우에만 이메일 피드백 전달을 비활성화할 수 있습니다.

알림에 대한 자세한 내용은 Amazon Simple Email Service 개발자 안내서의 AmazonSES에서 알림 사용을 참조하세요.

Amazon이 확인된 자격 증명에 대한 반송 메일, 불만 사항 및/또는 전송 알림을 SES 게시할 Amazon SNS 주제를 설정하려면

다음 예제에서는 set-identity-notification-topic 명령을 사용하여 확인된 이메일 주소가 반송 알림을 수신할 Amazon SNS 주제를 지정합니다.

aws ses set-identity-notification-topic --identity user@example.com --notification-type Bounce --sns-topic arn:aws:sns:us-east-1:EXAMPLE65304:MyTopic

알림에 대한 자세한 내용은 Amazon Simple Email Service 개발자 안내서의 AmazonSES에서 알림 사용을 참조하세요.

Amazon에 DKIM 서명하기 위해 확인된 도메인의 DKIM 토큰을 생성하려면 SES

다음 예제에서는 verify-domain-dkim 명령을 사용하여 Amazon 로 확인된 도메인에 대한 DKIM 토큰을 생성합니다SES.

aws ses verify-domain-dkim --domain example.com

출력:

{
   "DkimTokens": [
       "EXAMPLEq76owjnks3lnluwg65scbemvw",
       "EXAMPLEi3dnsj67hstzaj673klariwx2",
       "EXAMPLEwfbtcukvimehexktmdtaz6naj"
   ]
}

를 설정하려면 반환된 DKIM 토큰을 사용하여 Amazon 에서 호스팅하는 DKIM 퍼블릭 키를 가리키는 CNAME 레코드로 도메인의 DNS 설정을 업데이트해야 DKIM합니다SES. 자세한 내용은 Amazon Simple Email Service 개발자 안내서SES의 AmazonDKIM에서 Easy를 참조하세요.

Amazon을 사용하여 도메인을 확인하려면 SES

다음 예제에서는 verify-domain-identity 명령을 사용하여 도메인을 확인합니다.

aws ses verify-domain-identity --domain example.com

출력:

{
   "VerificationToken": "eoEmxw+YaYhb3h3iVJHuXMJXqeu1q1/wwmvjuEXAMPLE"
}

도메인 확인을 완료하려면 반환된 확인 토큰이 포함된 TXT 레코드를 도메인 DNS 설정에 추가해야 합니다. 자세한 내용은 Amazon Simple Email Service 개발자 안내서SES의 Amazon에서 도메인 확인을 참조하세요.

Amazon에서 이메일 주소를 확인하려면 SES

다음 예제에서는 verify-email-identity 명령을 사용하여 이메일 주소를 확인합니다.

aws ses verify-email-identity --email-address user@example.com

Amazon 를 사용하여 이메일을 전송하려면 먼저 이메일을 보내는 주소 또는 도메인을 확인하여 이메일을 소유하고 있음을 증명해야 SES합니다. 아직 프로덕션 액세스 권한이 없는 경우 Amazon SES 사서함 시뮬레이터에서 제공한 이메일 주소를 제외하고 이메일을 보내는 이메일 주소도 확인해야 합니다.

가 호출되면 verify-email-identity 이메일 주소에 확인 이메일이 전송됩니다. 확인 프로세스를 완료하려면 이메일에 포함된 링크를 클릭해야 합니다.

자세한 내용은 Amazon Simple Email Service 개발자 안내서SES의 Amazon에서 이메일 주소 확인을 참조하세요.