Automatically pausing email sending for a configuration set

Open the IAM console at https://console.aws.amazon.com/iam/.

In the navigation pane, choose Roles.

Choose Create role.

Under Select type of trusted entity, choose AWS service.

Under Choose the service that will use this role, choose Lambda. Choose Next: Permissions.

On the Attach permissions policies page, choose the following policies:

Choose Next: Review.

On the Review page, for Name, type a name for the role. Choose Create role.

Open the AWS Lambda console at https://console.aws.amazon.com/lambda/.

Use the region selector to choose the region in which you want to deploy this Lambda function.

Choose Create function.

Under Create function, choose Author from scratch.

Under Author from scratch, complete the following steps:

Choose Create function.

Under Function code, in the code editor, paste the following code:

'use strict';

import {
    SES
}
from 'aws-sdk';

const ses = new SES();
const configSet = 'CONFIG_SET_NAME_HERE';

const params = {
    ConfigurationSetName: configSet,
    Enabled: false
};

export const handler = async (event) => {
    try {
        const data = await ses.updateConfigurationSetSendingEnabled(params).promise();
        
        console.log('Configuration Set Update:', data);
        
        return {
            statusCode: 200,
            body: JSON.stringify({
                message: 'Successfully paused email sending for configuration set.',
                data
            }),
        };
    }
    catch (err) {
        console.error('Error:', err.message);
        return {
            statusCode: 500,
            body: JSON.stringify({
                message: 'Failed to pause email sending for configuration set.',
                error: err.message
            }),
        };
    }
};

Replace ConfigSet in the preceding code with the name of the configuration set. Choose Save.

Choose Test. If the Configure test event window appears, type a name in the Event name field, and then choose Create.

Ensure that the notification bar at the top of the page says Execution result: succeeded. If the function failed to execute, do the following:

At the command line, type the following command to re-enable email sending for the configuration set:

aws ses update-configuration-set-sending-enabled \
--configuration-set-name ConfigSet \
--enabled

In the preceding command, replace ConfigSet with the name of the configuration set for which you want to pause email sending.

At the command line, type the following command to ensure that email sending is enabled:

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

The command produces output that resembles the following example:

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

If the value of SendingEnabled is true, then email sending for the configuration set was successfully re-enabled.

Open the Amazon SNS console at https://console.aws.amazon.com/sns/v3/home.

Use the region selector to choose the region in which you want to automatically pause email sending.

In the navigation pane, choose Topics.

Choose Create new topic.

On the Create new topic window, for Topic name, type a name for the topic. Optionally, you can type a more descriptive name in the Display name field.

Choose Create topic.

In the list of topics, check the box next to the topic you created in the previous step. On the Actions menu, choose Subscribe to topic.

On the Create subscription window, make the following selections:

Choose Create subscription.

Open the CloudWatch console at https://console.aws.amazon.com/cloudwatch/.

Use the region selector to choose the region in which you want to automatically pause email sending.

In the navigation pane on the left, choose Alarms.

Choose Create Alarm.

On the Create Alarm window, under SES Metrics, choose Configuration Set Metrics.

In the ses:configuration-set column, locate the configuration set for which you want to create an alarm. Under Metric Name, choose one of the following options:

Choose Next.

Complete the following steps:

Choose Create Alarm.

At the command line, type the following command to check the email sending status for the configuration set:

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

If sending is enabled for the configuration set, you see the following output:

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

If the value of SendingEnabled is true, then email sending is currently enabled for the configuration set.

At the command line, type the following command to temporarily change the alarm state to ALARM:

aws cloudwatch set-alarm-state \
--alarm-name MyAlarm \
--state-value ALARM \
--state-reason "Testing execution of Lambda function"

Replace MyAlarm in the preceding command with the name of the alarm you created in Part 6: Create a CloudWatch Alarm.

At the command line, type the following command to check the email sending status for the configuration set:

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

If the Lambda function executed successfully, you see output that resembles the following example:

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

If the value of SendingEnabled is false, then email sending for the configuration set is disabled, indicating that the Lambda function executed successfully.

Complete the steps in Part 4: Re-Enable Email Sending for the Configuration Set to re-enable email sending for the configuration set.