1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
|
.. Copyright 2010-2019 Amazon.com, Inc. or its affiliates. All Rights Reserved.
This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0
International License (the "License"). You may not use this file except in compliance with the
License. A copy of the License is located at http://creativecommons.org/licenses/by-nc-sa/4.0/.
This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
either express or implied. See the License for the specific language governing permissions and
limitations under the License.
.. _aws-boto3-ses-filters:
###################################
Managing email filters with SES API
###################################
.. meta::
:description: Use the Amazon SES API to manage email filters.
:keywords: SES Python
In addition to sending emails, you can also receive email with Amazon Simple
Email Service (SES). An IP address filter enables you to optionally specify
whether to accept or reject mail that originates from an IP address or range
of IP addresses. For more information, see `Managing IP Address Filters for
Amazon SES Email
Receiving <https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-managing-ip-filters.html>`__.
The following examples show how to:
* Create an email filter using
`create_receipt_filter() <https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/ses.html#SES.Client.create_receipt_filter>`__.
* List all email filters using
`list_receipt_filters() <https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/ses.html#SES.Client.list_receipt_filters>`__.
* Remove an email filter using
`delete_receipt_filter() <https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/ses.html#SES.Client.delete_receipt_filter>`__.
Prerequisite tasks
==================
To set up and run this example, you must first complete these tasks:
* Configure your AWS credentials, as described in :doc:`quickstart`.
Create an email filter
======================
To allow or block emails from a specific IP address, use the
`CreateReceiptFilter <https://docs.aws.amazon.com/ses/latest/APIReference/API_CreateReceiptFilter.html>`__
operation. Provide the IP address or range of addresses and a unique name to
identify this filter.
Example
-------
.. code-block:: python
import boto3
# Create SES client
ses = boto3.client('ses')
# Create receipt filter
response = ses.create_receipt_filter(
Filter = {
'NAME' : 'NAME',
'IpFilter' : {
'Cidr' : 'IP_ADDRESS_OR_RANGE',
'Policy' : 'Allow'
}
}
)
print(response)
List all email filters
======================
To list the IP address filters associated with your AWS account in the current
AWS Region, use the
`ListReceiptFilters <https://docs.aws.amazon.com/ses/latest/APIReference/API_ListReceiptFilters.html>`__
operation.
Example
-------
.. code-block:: python
import boto3
# Create SES client
ses = boto3.client('ses')
response = ses.list_receipt_filters()
print(response)
Delete an email filter
======================
To remove an existing filter for a specific IP address use the
`DeleteReceiptFilter <https://docs.aws.amazon.com/ses/latest/APIReference/API_DeleteReceiptFilter.html>`__
operation. Provide the unique filter name to identify the receipt filter to
delete.
If you need to change the range of addresses that are filtered, you can delete
a receipt filter and create a new one.
Example
-------
.. code-block:: python
import boto3
# Create SES client
ses = boto3.client('ses')
response = ses.delete_receipt_filter(
FilterName = 'NAME'
)
print(response)
|
