Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Gestion des filtres d'e-mails à l'aide de l'API Amazon SES et de la AWS SDK pour PHP version 3
<a name="ses-filters"></a>

Outre l'envoi d'e-mails, vous pouvez également recevoir des e-mails via Amazon Simple Email Service (Amazon SES). Un filtre d’adresses IP vous permet, le cas échéant, de choisir d’accepter ou de rejeter les messages provenant d’une adresse IP ou d’une plage d’adresses IP. Pour plus d’informations, consultez la section [Gestion des filtres d’adresses IP pour la réception d’e-mails via Amazon SES](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-managing-ip-filters.html).

Les exemples suivants montrent comment :
+ Créez un filtre de courrier électronique à l'aide de [CreateReceiptFilter](https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-email-2010-12-01.html#createreceiptfilter).
+ Répertoriez tous les filtres de courrier électronique utilisés [ListReceiptFilters](https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-email-2010-12-01.html#listreceiptfilters).
+ Supprimez un filtre de courrier électronique à l'aide de [DeleteReceiptFilter](https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-email-2010-12-01.html#deletereceiptfilter).

Tous les exemples de code pour le AWS SDK pour PHP sont [disponibles ici GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/php/example_code).

## Informations d’identification
<a name="examplecredentials"></a>

Avant d'exécuter l'exemple de code, configurez vos AWS informations d'identification, comme décrit dans[Authentification à l' AWS aide de AWS SDK pour PHP la version 3](credentials.md). Importez ensuite le AWS SDK pour PHP, comme décrit dans[Installation de la AWS SDK pour PHP version 3](getting-started_installation.md).

Pour plus d'informations sur l'utilisation d'Amazon SES, consultez le [manuel du développeur Amazon SES](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/).

## Création d'un filtre d'e-mail
<a name="create-an-email-filter"></a>

Pour autoriser ou bloquer les e-mails provenant d'une adresse IP spécifique, utilisez l'[CreateReceiptFilter](https://docs.aws.amazon.com/ses/latest/APIReference/API_CreateReceiptFilter.html)opération. Indiquez l’adresse IP ou la plage d’adresses et un nom unique pour identifier ce filtre.

 **Importations** 

```
require 'vendor/autoload.php';

use Aws\Exception\AwsException;
```

 **Exemple de code** 

```
$SesClient = new Aws\Ses\SesClient([
    'profile' => 'default',
    'version' => '2010-12-01',
    'region' => 'us-east-2'
]);

$filter_name = 'FilterName';
$ip_address_range = '10.0.0.1/24';

try {
    $result = $SesClient->createReceiptFilter([
        'Filter' => [
            'IpFilter' => [
                'Cidr' => $ip_address_range,
                'Policy' => 'Block|Allow',
            ],
            'Name' => $filter_name,
        ],
    ]);
    var_dump($result);
} catch (AwsException $e) {
    // output error message if fails
    echo $e->getMessage();
    echo "\n";
}
```

## Répertorier tous les filtres d'e-mail
<a name="list-all-email-filters"></a>

Pour répertorier les filtres d'adresse IP qui vous sont associés Compte AWS dans la AWS région actuelle, utilisez l'[ListReceiptFilters](https://docs.aws.amazon.com/ses/latest/APIReference/API_ListReceiptFilters.html)opération.

 **Importations** 

```
require 'vendor/autoload.php';

use Aws\Exception\AwsException;
```

 **Exemple de code** 

```
$SesClient = new Aws\Ses\SesClient([
    'profile' => 'default',
    'version' => '2010-12-01',
    'region' => 'us-east-2'
]);

try {
    $result = $SesClient->listReceiptFilters();
    var_dump($result);
} catch (AwsException $e) {
    // output error message if fails
    echo $e->getMessage();
    echo "\n";
}
```

## Supprimer un filtre d'e-mail
<a name="delete-an-email-filter"></a>

Pour supprimer un filtre existant pour une adresse IP spécifique, utilisez l'[DeleteReceiptFilter](https://docs.aws.amazon.com/ses/latest/APIReference/API_DeleteReceiptFilter.html)opération. Indiquez un nom de filtre unique pour identifier le filtre de réception à supprimer.

Si vous avez besoin de modifier la plage des adresses filtrées, vous pouvez supprimer un filtre de réception et en créer un nouveau.

 **Importations** 

```
require 'vendor/autoload.php';

use Aws\Exception\AwsException;
```

 **Exemple de code** 

```
$SesClient = new Aws\Ses\SesClient([
    'profile' => 'default',
    'version' => '2010-12-01',
    'region' => 'us-east-2'
]);

$filter_name = 'FilterName';

try {
    $result = $SesClient->deleteReceiptFilter([
        'FilterName' => $filter_name,
    ]);
    var_dump($result);
} catch (AwsException $e) {
    // output error message if fails
    echo $e->getMessage();
    echo "\n";
}
```