Surveillance de vos statistiques d'utilisation à l'aide de l'API Amazon SES - Amazon Simple Email Service

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

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.

Dans cette section, vous allez retrouver les rubriques suivantes :

Appel de l'opération GetSendStatistics d'API à l'aide du AWS CLI

La manière la plus simple d'appeler l'opération d'API GetSendStatistics consiste à utiliser l'AWS Command Line Interface (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 » dans le guide de AWS Command Line Interface l'utilisateur.

  2. 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 » dans le guide de AWS Command Line Interface l'utilisateur.

  3. 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

Vous pouvez également appeler l'GetSendStatisticsopé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 :

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.

Téléphoner GetSendStatistics à l'aide du AWS SDK pour Go

package main import ( "fmt" //go get github.com/aws/aws-sdk-go/... "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/ses" "github.com/aws/aws-sdk-go/aws/awserr" ) const ( // Replace us-west-2 with the AWS Region you're using for Amazon SES. AwsRegion = "us-west-2" ) func main() { // Create a new session and specify an AWS Region. sess, err := session.NewSession(&aws.Config{ Region:aws.String(AwsRegion)}, ) // Create an SES client in the session. svc := ses.New(sess) input := &ses.GetSendStatisticsInput{} result, err := svc.GetSendStatistics(input) // Display error messages if they occur. if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) } return } fmt.Println(result) }

Téléphoner GetSendStatistics à l'aide du AWS SDK for PHP

<?php // Replace path_to_sdk_inclusion with the path to the SDK as described in // http://docs.aws.amazon.com/aws-sdk-php/v3/guide/getting-started/basic-usage.html define('REQUIRED_FILE','path_to_sdk_inclusion'); // Replace us-west-2 with the AWS Region you're using for Amazon SES. define('REGION','us-west-2'); require REQUIRED_FILE; use Aws\Ses\SesClient; $client = SesClient::factory(array( 'version'=> 'latest', 'region' => REGION )); try { $result = $client->getSendStatistics([]); echo($result); } catch (Exception $e) { echo($e->getMessage()."\n"); } ?>

Téléphoner GetSendStatistics à l'aide du AWS SDK for Python (Boto)

import boto3 #pip install boto3 import json from botocore.exceptions import ClientError client = boto3.client('ses') try: response = client.get_send_statistics( ) except ClientError as e: print(e.response['Error']['Message']) else: print(json.dumps(response, indent=4, sort_keys=True, default=str))

Téléphoner GetSendStatistics à l'aide du AWS SDK for Ruby

require 'aws-sdk' # gem install aws-sdk require 'json' # Replace us-west-2 with the AWS Region you're using for Amazon SES. awsregion = "us-west-2" # Create a new SES resource and specify a region ses = Aws::SES::Client.new(region: awsregion) begin resp = ses.get_send_statistics({ }) puts JSON.pretty_generate(resp.to_h) # If something goes wrong, display an error message. rescue Aws::SES::Errors::ServiceError => error puts error end