1부: 구성 세트에 대한 평판 지표 보고 활성화 2부 - IAM 역할 만들기 3부: Lambda 함수 생성 4부: 구성 세트에 대한 이메일 전송 재활성화 5부: Amazon SNS 주제 생성 6부: CloudWatch 경보를 생성하려면 7부: 솔루션 테스트

구성 집합에 대한 이메일 전송 자동 일시 중지

Amazon CloudWatch로 설정된 특정 구성을 사용하여 전송된 이메일 전용 평판 지표를 내보내도록 Amazon SES를 구성할 수 있습니다. 그 다음 이러한 지표를 사용하여 이러한 구성 세트 전용 CloudWatch 경보를 생성할 수 있습니다. 이러한 경보가 특정 임계값을 초과하면 Amazon SES 계정의 전체 이메일 전송 기능에 영향을 주지 않고 지정된 구성 세트를 사용하는 이메일 전송을 자동으로 일시 중지할 수 있습니다.

참고

이 단원에 설명된 솔루션에서는 단일 AWS 리전의 특정 구성 세트에 대해 이메일 전송을 일시 중지합니다. 여러 리전으로부터 이메일을 보내려면, 이 방법을 구현하고자 하는 리전마다 이 단원의 절차를 반복하세요.

1부: 구성 세트에 대한 평판 지표 보고 활성화

구성 세트에 대해 이메일 전송을 자동으로 일시 중지하도록 Amazon SES를 구성하려면 먼저 구성 세트에 대한 평판 지표 내보내기를 활성화해야 합니다.

구성 세트에 대한 반송 메일 및 불만 지표 내보내기를 활성화하려면 평판 지표 보기 및 내보내기의 단계를 완료해야 합니다.

2부 - IAM 역할 만들기

이메일 전송 자동 일시 중지를 구성하는 첫 단계는 UpdateConfigurationSetSendingEnabled API 작업을 실행할 수 있는 IAM 역할을 생성하는 것입니다.

IAM 역할 생성

https://console.aws.amazon.com/iam/에서 IAM 콘솔을 엽니다.
탐색 창에서 역할을 선택합니다.
Create role(역할 생성)을 선택합니다.
신뢰할 수 있는 유형의 엔터티 선택(Select type of trusted entity) 아래에서 AWS 서비스를 선택합니다.
Choose the service that will use this role(이 역할을 사용할 서비스 선택) 아래에서 Lambda를 선택합니다. Next: Permissions(다음: 권한)를 선택합니다.
[Attach permissions policies] 페이지에서 다음 정책을 선택합니다.
- AWS LambdaBasicExecutionRole
- AmazonSESFullAccess
작은 정보
정책 목록 상단의 검색 상자를 사용하여 이러한 정책을 빨리 찾습니다.

Next: Review(다음: 검토)를 선택합니다.
[Review] 페이지의 [Name]에서 역할 이름을 입력합니다. 역할 생성을 선택합니다.

3부: Lambda 함수 생성

IAM 역할을 생성한 후에는 구성 세트에 대한 이메일 전송을 일시 중지시키는 Lambda 함수를 생성할 수 있습니다.

Lambda 함수를 생성하려면

AWS Lambdahttps://console.aws.amazon.com/lambda/에서 콘솔을 엽니다.
리전 선택기를 사용하여 이 Lambda 함수를 배포할 리전을 선택합니다.

참고
이 함수는 이 단계에서 선택하는 AWS 리전에서만 구성 세트에 대한 이메일 전송을 일시 중지시킵니다. 둘 이상의 리전으로부터 이메일을 보내는 경우, 이메일 전송을 자동으로 일시 중지하려는 리전마다 이 단원의 절차를 반복하세요.
함수 생성(Create function)을 선택합니다.
함수 생성에서 Author from scratch를 선택합니다.
Author from scratch에서 다음 단계를 수행합니다.
- 이름에 Lambda 함수의 이름을 입력합니다.
- 런타임(Runtime)에서 Node.js 14x(또는 선택 목록에 현재 제공된 버전).
- 역할에서 기존 역할 선택을 선택합니다.
- 기존 역할에서 2부 - IAM 역할 만들기에서 생성한 IAM 역할을 선택합니다.
함수 생성(Create function)을 선택합니다.

코드 편집기의 [Function code]에 다음 코드를 붙여 넣습니다.


'use strict';

var aws = require('aws-sdk');

// Create a new SES object. 
var ses = new aws.SES();

// Specify the parameters for this operation. In this example, you pass the 
// Enabled parameter, with a value of false (Enabled = false disables email 
// sending, Enabled = true enables it). You also pass the ConfigurationSetName
// parameter, with a value equal to the name of the configuration set for 
// which you want to pause email sending.
var params = {
    ConfigurationSetName: ConfigSet,
    Enabled: false
};

exports.handler = (event, context, callback) => {
    // Pause sending for a configuration set
    ses.updateConfigurationSetSendingEnabled(params, function(err, data) {
        if(err) {
            console.log(err.message);
        } else {
            console.log(data);
        }
    });
};

위 코드의 ConfigSet을 구성 세트의 이름으로 바꿉니다. 저장을 선택합니다.

테스트를 선택합니다. [Configure test event] 창이 나타나면 [Event name] 필드에 이름을 입력한 후 [Create]를 선택합니다.
페이지 상단의 알림 표시줄에 Execution result: succeeded라고 표시되는지 확인합니다. 함수가 실행되지 못하면 다음을 수행합니다.
- 2부 - IAM 역할 만들기에서 생성한 IAM 역할에 올바른 정책이 포함되는지 확인합니다.
- Lambda 함수의 코드에 오류가 없는지 확인합니다. Lambda 코드 편집기가 구문 오류 및 다른 잠재적인 문제를 자동으로 강조 표시합니다.

4부: 구성 세트에 대한 이메일 전송 재활성화

3부: Lambda 함수 생성에서 Lambda 함수를 테스트할 때의 부작용은 구성 세트에 대한 이메일 전송이 일시 중지되는 것입니다. 대부분의 경우 CloudWatch 경보가 트리거될 때까지 구성 세트에 대한 전송을 일시 중지하지 않습니다.

이 단원의 절차에서는 구성 세트에 대한 이메일 전송 재활성화를 설명합니다. 이 절차를 완료하려면 AWS Command Line Interface을 설치하고 구성해야 합니다. 자세한 내용은 AWS Command Line Interface 사용 설명서를 참조하세요.

이메일 전송을 재활성화하려면

명령줄에 다음 명령을 입력하여 구성 세트에 대한 이메일 전송을 다시 활성화합니다.
```
aws ses update-configuration-set-sending-enabled \
--configuration-set-name ConfigSet \
--enabled
```
앞의 명령에서 ConfigSet를 이메일 전송을 일시 중지하려는 구성 세트의 이름으로 바꿉니다.

명령줄에 다음 명령을 입력하여 이메일 전송이 활성화되었는지 확인합니다.


aws ses describe-configuration-set \
--configuration-set-name ConfigSet \
--configuration-set-attribute-names reputationOptions

이 명령은 다음 예제와 유사한 출력을 생성합니다.


{                           
    "ConfigurationSet": {   
        "Name": "ConfigSet" 
    },
    "ReputationOptions": {
        "ReputationMetricsEnabled": true,
        "SendingEnabled": true
    }	
}

SendingEnabled의 값이 true이면 구성 세트에 대한 이메일 전송이 성공적으로 재활성화된 것입니다.

5부: Amazon SNS 주제 생성

경보가 트리거될 때 CloudWatch가 Lambda 함수를 실행하려면 먼저 Amazon SNS 주제를 생성하고 해당 Lambda 함수를 구독해야 합니다.

Amazon SNS 주제를 생성하려면

https://console.aws.amazon.com/sns/v3/home에서 Amazon SNS 콘솔을 엽니다.
리전 선택기를 사용하여 이메일 전송을 자동으로 일시 중지하려는 리전을 선택합니다.
탐색 창에서 주제를 선택합니다.
[Create new topic]을 선택합니다.
[Create new topic] 창의 [Topic name]에서 주제 이름을 입력합니다. 선택적으로 [Display name] 필드에 더 세부적인 이름을 입력할 수 있습니다.

주제 생성을 선택합니다.
주제 목록에서 이전 단계에서 생성한 주제 옆의 상자를 선택합니다. [Actions] 메뉴에서 [Subscribe to topic]을 선택합니다.
[Create subscription] 창에서 다음과 같이 선택합니다.
- 프로토콜에서 AWS Lambda을 선택합니다.
- 엔드포인트에서 3부: Lambda 함수 생성에서 생성한 Lambda 함수를 선택합니다.
- [Version or alias]에서 [default]를 선택합니다.
구독 생성을 선택합니다.

6부: CloudWatch 경보를 생성하려면

이 단원에는 지표가 특정 임계값에 도달하면 트리거되는 CloudWatch에 경보를 생성하기 위한 절차가 포함되어 있습니다. 경보가 트리거되면 5부: Amazon SNS 주제 생성에서 생성한 Amazon SNS 주제에 알림을 전달한 후 3부: Lambda 함수 생성에서 생성한 Lambda 함수를 실행합니다.

CloudWatch 경보를 생성하려면

https://console.aws.amazon.com/cloudwatch/에서 CloudWatch 콘솔을 엽니다.
리전 선택기를 사용하여 이메일 전송을 자동으로 일시 중지하려는 리전을 선택합니다.
왼쪽의 탐색 창에서 [Alarms]를 선택합니다.
경보 생성(Create Alarm)을 선택합니다.
[Create Alarm] 창의 [SES Metrics] 아래에서 [Configuration Set Metrics]를 선택합니다.
[ses:configuration-set] 열에서 경보를 생성할 구성 세트를 찾습니다. [Metric Name] 아래에서 다음 옵션 중 하나를 선택합니다.
- Reputation.BounceRate – 구성 세트의 전체 하드 반송 메일 발생률이 사용자가 정의하는 임계값을 교차할 때 구성 세트에 대한 이메일 전송을 일시 중지하려는 경우 이 지표를 선택합니다.
- Reputation.ComplaintRate – 구성 세트의 전체 수신 거부 발생률이 사용자가 정의하는 임계값을 교차할 때 구성 세트에 대한 이메일 전송을 일시 중지하려는 경우 이 지표를 선택합니다.
다음(Next)을 선택합니다.
다음 단계를 완료합니다.
- [Alarm Threshold]에서 [Name]에 경보 이름을 입력합니다.
- [Whenever: Reputation.BounceRate] 또는 [Whenever: Reputation.ComplaintRate] 아래에서 경보를 트리거하게 하는 임계값을 지정합니다.
  
  참고
  Amazon SES 계정에 대한 전체 반송 메일 발생률이 10%를 초과하거나 Amazon SES 계정에 대한 전체 수신 거부 발생률이 0.5%를 초과하면 Amazon SES 계정이 자동으로 검토 상태로 설정됩니다. CloudWatch 경보를 트리거하게 하는 반송 메일 또는 수신 거부 발생률을 지정하면 계정이 검토 상태가 되지 않도록 이러한 발생률보다 매우 낮은 값을 사용하는 것이 좋습니다.
- 작업의 이 경보가 발생할 경우 항상에서 상태가 ALARM입니다를 선택합니다. 알림 보내기에서 5부: Amazon SNS 주제 생성에서 생성한 Amazon SNS 주제를 선택합니다.
경보 생성(Create Alarm)을 선택합니다.

7부: 솔루션 테스트

이제 경보를 테스트하여 ALARM 상태로 전환될 때 Lambda 함수를 실행하는지 확인할 수 있습니다. CloudWatch API에서 SetAlarmState 작업을 사용하여 경보의 상태를 일시적으로 변경할 수 있습니다.

이 단원의 절차는 선택 사항이지만 전체 솔루션을 올바로 구성할 수 있도록 완료하는 것이 좋습니다.

솔루션을 테스트하려면

명령줄에 다음 명령을 입력하여 구성 세트에 대한 이메일 전송 상태를 확인합니다.


aws ses describe-configuration-set --configuration-set-name ConfigSet

구성 세트에 대해 전송이 활성화되어 있으면 다음 결과가 표시됩니다.


{                           
    "ConfigurationSet": {   
        "Name": "ConfigSet" 
    },
    "ReputationOptions": {
        "ReputationMetricsEnabled": true,
        "SendingEnabled": true
    }	
}

SendingEnabled의 값이 true이면 구성 세트에 대한 이메일 전송이 현재 활성화된 것입니다.

명령줄에 다음 명령을 입력하여 경보 상태를 ALARM으로 임시 변경합니다.
```
aws cloudwatch set-alarm-state \
--alarm-name MyAlarm \
--state-value ALARM \
--state-reason "Testing execution of Lambda function"
```
위 명령의 MyAlarm을 6부: CloudWatch 경보를 생성하려면에서 생성한 경보의 이름으로 바꿉니다.

참고
이 명령을 실행하면 경보의 상태가 OK에서 ALARM으로 바뀌고 몇 초 이내에 다시 OK로 바뀝니다. 이러한 상태 변경 사항은 CloudWatch 콘솔 내 경보의 기록 탭을 사용하거나 DescribeAlarmHistory 작업을 사용합니다.
명령줄에 다음 명령을 입력하여 구성 세트에 대한 이메일 전송 상태를 확인합니다.
```
aws ses describe-configuration-set \
--configuration-set-name ConfigSet
```
Lambda 함수가 성공적으로 실행되면 다음 예제와 유사한 출력이 표시됩니다.
```
{                           
    "ConfigurationSet": {   
        "Name": "ConfigSet" 
    },
    "ReputationOptions": {
        "ReputationMetricsEnabled": true,
        "SendingEnabled": false
    }	
}
```
SendingEnabled의 값이 false이면 구성 세트에 대한 이메일 전송이 비활성화된 것으로, Lambda 함수가 성공적으로 실행되었음을 나타냅니다.
4부: 구성 세트에 대한 이메일 전송 재활성화의 단계를 완료하여 구성 세트에 대한 이메일 전송을 재활성화합니다.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

전체 계정의 경우

다음을 사용한 모니터링 EventBridge