AWS CLI를 사용한 Amazon SES 예시

ID 삭제

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

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

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

자격 증명 목록에 대한 Amazon SES Easy DKIM 속성을 가져오는 방법

다음 예시에서는 get-identity-dkim-attributes 명령을 사용하여 ID 목록에 대한 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"
       }
   }
}

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

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

자격 증명 목록에 대한 Amazon SES 알림 속성을 가져오는 방법

다음 예시에서는 get-identity-notification-attributes 명령을 사용하여 ID 목록에 대한 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 리소스 이름(ARN)을 반환합니다.

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

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

ID 목록의 Amazon SES 확인 상태 가져오기

다음 예시에서는 get-identity-verification-attributes 명령을 사용하여 ID 목록에 대한 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"
       }
   }
}

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

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

Amazon SES 발신 한도 가져오기

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

aws ses get-send-quota

출력:

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

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

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주 동안 사용자가 보낸 유일한 이메일이 두 번의 15분 간격 내에 속했기 때문에 두 개의 데이터 포인트만 있습니다.

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

특정 AWS 계정에 대한 모든 ID(이메일 주소 및 도메인) 나열

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

aws ses list-identities

출력:

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

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

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

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

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 SES에 대한 프로덕션 액세스 권한을 부여받기 전까지는 각 수신자의 이메일 주소도 확인해야 합니다. 단, 수신자가 Amazon SES 메일박스 시뮬레이터인 경우는 예외입니다. 확인에 대한 자세한 내용은 Amazon Simple Email Service 개발자 안내서의 Amazon SES에서 이메일 주소 및 도메인 확인을 참조하세요.

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

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

서식 지정된 이메일을 보내는 방법에 대한 자세한 내용은 Amazon Simple Email Service 개발자 안내서의 Amazon SES API를 사용하여 서식 지정된 이메일 전송을 참조하세요.

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--"
}

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

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

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

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

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

Amazon SES 확인 자격 증명에 대해 Easy DKIM을 활성화 또는 비활성화하는 방법

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

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

Easy DKIM에 대한 자세한 내용은 Amazon Simple Email Service 개발자 안내서의 Amazon SES의 간편한 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 개발자 안내서의 Amazon SES에서 알림 사용을 참조하세요.

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 개발자 안내서의 Amazon SES에서 알림 사용을 참조하세요.

Amazon SES를 사용한 DKIM 서명을 위해 확인된 도메인의 DKIM 토큰을 생성하는 방법

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

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

출력:

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

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

Amazon SES를 사용하여 도메인 확인

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

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

출력:

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

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

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 개발자 안내서의 Amazon SES에서 이메일 주소 확인을 참조하세요.