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.

# Surveillance de vos statistiques d'utilisation à l'aide de l'API Amazon SES
<a name="monitor-sending-activity-api"></a>

L'API Amazon SES fournit l'opération `GetSendStatistics`, qui renvoie des informations sur votre utilisation des services. Nous vous recommandons de vérifier vos statistiques d'envoi régulièrement, afin de pouvoir procéder à des ajustements si nécessaire.

Lorsque vous appelez l'opération `GetSendStatistics`, vous recevez une liste des points de données représentant les deux dernières semaines de votre activité d'envoi. Chaque point de données de cette liste représente 15 minutes d'activité et contient les informations suivantes pour cette période :
+ Le nombre de messages d'erreur définitifs
+ Le nombre de réclamations
+ Le nombre de tentatives de remise (correspond au nombre d'e-mails envoyés)
+ Le nombre de tentatives d'envoi rejetées
+ Un horodatage pour la période d'analyse

Pour une description complète de l'opération `GetSendStatistics`, consultez le document [Amazon Simple Email Service API Reference](https://docs.aws.amazon.com/ses/latest/APIReference/GetSendStatistics.html).

Dans cette section, vous allez retrouver les rubriques suivantes :
+ [Appel de l'opération `GetSendStatistics` d'API à l'aide du AWS CLI](#monitor-sending-activity-api-cli)
+ [Appel de l'opération `GetSendStatistics` par programmation](#monitor-sending-activity-api-sdk)

## Appel de l'opération `GetSendStatistics` d'API à l'aide du AWS CLI
<a name="monitor-sending-activity-api-cli"></a>

La manière la plus simple d'appeler l'opération d'API `GetSendStatistics` consiste à utiliser l'[AWS Command Line Interface](https://aws.amazon.com/cli) (AWS CLI).

**Pour appeler l'opération `GetSendStatistics` d'API à l'aide du AWS CLI**

1. Si vous ne l'avez pas déjà fait, installez l AWS CLI.' Pour plus d'informations, reportez-vous à la section « [Installation du AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) » dans le *guide de AWS Command Line Interface l'utilisateur*.

1. Si ce n'est pas déjà fait, configurez le AWS CLI pour utiliser vos AWS informations d'identification. Pour plus d'informations, reportez-vous à [la section « Configuration du AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) » dans le *guide de AWS Command Line Interface l'utilisateur*.

1. Dans la ligne de commande, exécutez la commande suivante :

   ```
   aws ses get-send-statistics
   ```

   Si le AWS CLI est correctement configuré, vous pouvez voir une liste des statistiques d'envoi au format JSON. Chaque objet JSON inclut des statistiques d'envoi agrégées pour une période de 15 minutes.

## Appel de l'opération `GetSendStatistics` par programmation
<a name="monitor-sending-activity-api-sdk"></a>

Vous pouvez également appeler l'`GetSendStatistics`opération à l'aide du AWS SDKs. Cette section inclut des exemples de code AWS SDKs pour Go, PHP, Python et Ruby. Choisissez un des liens suivants pour afficher des exemples de code pour ce langage :
+ [Exemple de code pour le kit AWS SDK pour Go](#code-example-getsendstatistics-golang)
+ [Exemple de code pour le kit AWS SDK pour PHP](#code-example-getsendstatistics-php)
+ [Exemple de code pour le kit AWS SDK pour Python (Boto)](#code-example-getsendstatistics-python)
+ [Exemple de code pour le kit AWS SDK pour Ruby](#code-example-getsendstatistics-ruby)

**Note**  
Ces exemples de code supposent que vous avez créé un fichier d'informations d'identification AWS partagé contenant votre identifiant de clé d' AWS accès, votre clé d'accès AWS secrète et votre AWS région préférée. Pour de plus amples informations, veuillez consulter [Informations d'identification et fichiers de configuration partagés](https://docs.aws.amazon.com/credref/latest/refdocs/creds-config-files.html).

### Téléphoner `GetSendStatistics` à l'aide du AWS SDK pour Go
<a name="code-example-getsendstatistics-golang"></a>

```
 1. package main
 2.     
 3. import (
 4.     "fmt"
 5.     
 6.     //go get github.com/aws/aws-sdk-go/...
 7.     "github.com/aws/aws-sdk-go/aws"
 8.     "github.com/aws/aws-sdk-go/aws/session"
 9.     "github.com/aws/aws-sdk-go/service/ses"
10.     "github.com/aws/aws-sdk-go/aws/awserr"
11. )
12.     
13. const (
14.     // Replace us-west-2 with the AWS Region you're using for Amazon SES.
15.     AwsRegion = "us-west-2"
16. )
17.     
18. func main() {
19.     
20.     // Create a new session and specify an AWS Region.
21.     sess, err := session.NewSession(&aws.Config{
22.         Region:aws.String(AwsRegion)},
23.     )
24.     
25.     // Create an SES client in the session.
26.     svc := ses.New(sess)
27.     input := &ses.GetSendStatisticsInput{}
28.     
29.     result, err := svc.GetSendStatistics(input)
30.     
31.     // Display error messages if they occur.
32.     if err != nil {
33.         if aerr, ok := err.(awserr.Error); ok {
34.             switch aerr.Code() {
35.             default:
36.                 fmt.Println(aerr.Error())
37.             }
38.         } else {
39.             // Print the error, cast err to awserr.Error to get the Code and
40.             // Message from an error.
41.             fmt.Println(err.Error())
42.         }
43.         return
44.     }
45.     
46.     fmt.Println(result)
47. }
```

### Téléphoner `GetSendStatistics` à l'aide du AWS SDK pour PHP
<a name="code-example-getsendstatistics-php"></a>

```
 1. <?php
 2. 
 3. // Replace path_to_sdk_inclusion with the path to the SDK as described in 
 4. // http://docs.aws.amazon.com/aws-sdk-php/v3/guide/getting-started/basic-usage.html
 5. define('REQUIRED_FILE','path_to_sdk_inclusion');
 6.                                                   
 7. // Replace us-west-2 with the AWS Region you're using for Amazon SES.
 8. define('REGION','us-west-2'); 
 9. 
10. require REQUIRED_FILE;
11. 
12. use Aws\Ses\SesClient;
13. 
14. $client = SesClient::factory(array(
15.     'version'=> 'latest',     
16.     'region' => REGION
17. ));
18. 
19. try {
20.      $result = $client->getSendStatistics([]);
21. 	 echo($result);
22. } catch (Exception $e) {
23.      echo($e->getMessage()."\n");
24. }
25. 
26. ?>
```

### Téléphoner `GetSendStatistics` à l'aide du AWS SDK pour Python (Boto)
<a name="code-example-getsendstatistics-python"></a>

```
 1. import boto3 #pip install boto3
 2. import json
 3. from botocore.exceptions import ClientError
 4. 
 5. client = boto3.client('ses')
 6. 
 7. try:
 8.     response = client.get_send_statistics(
 9. )
10. except ClientError as e:
11.     print(e.response['Error']['Message'])
12. else:
13.     print(json.dumps(response, indent=4, sort_keys=True, default=str))
```

### Téléphoner `GetSendStatistics` à l'aide du AWS SDK pour Ruby
<a name="code-example-getsendstatistics-ruby"></a>

```
 1. require 'aws-sdk' # gem install aws-sdk
 2. require 'json'
 3. 
 4. # Replace us-west-2 with the AWS Region you're using for Amazon SES.
 5. awsregion = "us-west-2"
 6. 
 7. # Create a new SES resource and specify a region
 8. ses = Aws::SES::Client.new(region: awsregion)
 9. 
10. begin
11. 
12.   resp = ses.get_send_statistics({
13.   })
14.   puts JSON.pretty_generate(resp.to_h)
15. 
16. # If something goes wrong, display an error message.
17. rescue Aws::SES::Errors::ServiceError => error
18.   puts error
19. 
20. end
```