Menu
Amazon Simple Email Service
Developer Guide

Managing Receipt Rule Sets for Amazon SES Email Receiving

After you create a receipt rule set as described in Creating a Receipt Rule Set, you can update it as needed. Although editing a receipt rule set usually consists of editing individual receipt rules as described in Managing Receipt Rules, you can also delete, activate, disable, and copy receipt rule sets. Additionally, you can reorder the receipt rules in a receipt rule set. These operations are described in the following sections.

Deleting a Receipt Rule Set

You can use the Amazon SES console or the DeleteReceiptRuleSet API to delete a receipt rule set.

Note

You cannot delete the receipt rule set that is currently active.

To delete a receipt rule set (console)

  1. Sign in to the AWS Management Console and open the Amazon SES console at https://console.aws.amazon.com/ses/.

  2. In the left navigation pane, under Email Receiving, choose Rule Sets.

  3. In the Inactive Rule Sets list, select the receipt rule set that you want to delete.

  4. From the Actions menu, choose Delete, and then confirm that you want to delete the receipt rule set.

For information about how to use the DeleteReceiptRuleSet API to delete a receipt rule set, see the Amazon Simple Email Service API Reference.

Activating and Disabling a Receipt Rule Set

Each receipt rule set is in one of two states: active or disabled. Only one of your receipt rule sets can be active at any given time. Disabled receipt rule sets can be useful in cases where you want to make changes to your active receipt rule set, but you do not want those changes to be active until you are sure your updates are correct. In that case, you can copy the active receipt rule set and make changes to the copied, disabled receipt rule set. After you're satisfied with the changes, you can activate the copied receipt rule set. When you activate a receipt rule set, all other receipt rule sets are disabled automatically.

Note

To disable email receiving through Amazon SES completely, disable all of your receipt rule sets.

You can use the Amazon SES console or the SetActiveReceiptRuleSet API to control which rule set is active.

To activate a disabled receipt rule set (console)

  1. Sign in to the AWS Management Console and open the Amazon SES console at https://console.aws.amazon.com/ses/.

  2. In the left navigation pane, under Email Receiving, choose Rule Sets.

  3. In the Inactive Rule Sets list, select the receipt rule set that you want to activate.

  4. Choose Set as Active Rule Set.

To disable the active receipt rule set (console)

  1. Sign in to the AWS Management Console and open the Amazon SES console at https://console.aws.amazon.com/ses/.

  2. In the left navigation pane, under Email Receiving, choose Rule Sets.

  3. Under Active Rule Set, choose Disable Active Rule Set, and then confirm that you want to disable the receipt rule set.

For information about how to use the SetActiveReceiptRuleSet API to activate or disable a rule set, see the Amazon Simple Email Service API Reference.

Copying a Receipt Rule Set

You can use the Amazon SES console or the CloneReceiptRuleSet API to copy a receipt rule set. If you use the Amazon SES console, the procedure differs slightly, depending on whether the receipt rule set you want to copy is active or disabled.

To copy the active receipt rule set (console)

  1. Sign in to the AWS Management Console and open the Amazon SES console at https://console.aws.amazon.com/ses/.

  2. In the left navigation pane, under Email Receiving, choose Rule Sets.

  3. In the content pane, choose Copy Active Rule Set.

  4. In the Copy Rule Set dialog box, type the name you want to assign to the copied receipt rule set.

  5. Choose Copy Rule Set. The copied receipt rule set will appear in the Inactive Rule Sets list.

To copy a disabled receipt rule set (console)

  1. Sign in to the AWS Management Console and open the Amazon SES console at https://console.aws.amazon.com/ses/.

  2. In the left navigation pane, under Email Receiving, choose Rule Sets.

  3. In the Inactive Rule Sets list, select the receipt rule set that you want to copy.

  4. From the Actions menu, choose Copy.

  5. In the Copy Rule Set dialog box, type the name you want to assign to the copied receipt rule set.

  6. Choose Copy Rule Set. The copied receipt rule set will appear in the Inactive Rule Sets list.

For information about how to use the CloneReceiptRuleSet API to copy a receipt rule set, see the Amazon Simple Email Service API Reference.

Reordering Receipt Rules

You can use the Amazon SES console or the ReorderReceiptRuleSet API to reorder receipt rules in a receipt rule set. If you use the Amazon SES console, the procedure differs slightly, depending on whether the receipt rule set is active or disabled.

To reorder receipt rules in the active receipt rule set (console)

  1. Sign in to the AWS Management Console and open the Amazon SES console at https://console.aws.amazon.com/ses/.

  2. In the left navigation pane, under Email Receiving, choose Rule Sets.

  3. In the content pane, choose View Active Rule Set.

  4. Choose Reorder Rules.

  5. Use the up and down arrows next to the receipt rule names to reorder the receipt rules, and then choose Save Order.

To reorder receipt rules in a disabled receipt rule set (console)

  1. Sign in to the AWS Management Console and open the Amazon SES console at https://console.aws.amazon.com/ses/.

  2. In the left navigation pane, under Email Receiving, choose Rule Sets.

  3. In the Inactive Rule Sets list, select the receipt rule set.

  4. Choose Reorder Rules.

  5. Use the up and down arrows next to the receipt rule names to reorder the receipt rules, and then choose Save Order.

For information about how to use the ReorderReceiptRuleSet API to reorder receipt rules in a receipt rule set, see the Amazon Simple Email Service API Reference.