Monitorización de las estadísticas de uso mediante la API de Amazon SES - Amazon Simple Email Service Classic

Esta es la guía del usuario de Amazon SES Classic. Las actualizaciones y las nuevas características solo se documentan en la Guía para desarrolladores del nuevo Amazon SES que recomendamos utilizar.

Monitorización de las estadísticas de uso mediante la API de Amazon SES

La API de Amazon SES proporciona elGetSendStatisticsEsta operación devuelve información sobre el uso que se hace del servicio. Le recomendamos que compruebe las estadísticas de envío con regularidad, a fin de que pueda realizar ajustes si es necesario.

Si llama a la operación GetSendStatistics, recibe una lista de puntos de datos que representan las dos últimas semanas de su actividad de envío. Cada punto de datos de esta lista representa 15 minutos de actividad y contiene la siguiente información para ese periodo:

  • El número de rebotes permanentes

  • El número de reclamaciones

  • El número de intentos de entrega (corresponde al número de correos electrónicos que haya enviado)

  • El número de intentos de envío rechazados

  • Una marca de tiempo para el periodo de análisis

Para obtener una descripción completa de laGetSendStatistics, consulte laReferencia de Amazon Simple Email Service.

En esta sección, encontrará los temas siguientes:

Llamada a la operación GetSendStatistics de la API mediante la AWS CLI

La forma más sencilla de llamar a la operación GetSendStatistics de la API consiste en utilizar la AWS Command Line Interface (AWS CLI).

Para llamar a la operación GetSendStatistics de la API utilizando la AWS CLI

  1. Si aún no lo ha hecho, descargue e instale la AWS CLI. Para obtener más información, consulte "Instalación de la AWS Command Line Interface" en la Guía del usuario de la AWS Command Line Interface.

  2. Si aún no lo ha hecho, configure la AWS CLI para utilizar sus credenciales de AWS. Para obtener más información, consulte "Configuración de la AWS CLI" en la Guía del usuario de la AWS Command Line Interface.

  3. En la línea de comandos, escriba aws ses get-send-statistics.

    Si la AWS CLI está configurada correctamente, verá una lista de estadísticas de envío en formato JSON. Cada objeto JSON incluye estadísticas de envío agregadas para un periodo de 15 minutos.

Llamada a la operación GetSendStatistics mediante programación

También puede llamar a laGetSendStatisticsMediante los SDK de AWS. Esta sección incluye ejemplos de código para los AWS SDK para Go, PHP, Python y Ruby. Elija uno de los siguientes enlaces para ver ejemplos de código para dicho lenguaje:

nota

Estos ejemplos de código suponen que ha creado un archivo de credenciales compartidas de AWS de que contiene su ID de clave de acceso secreta de AWS de y su región de AWS preferida. Para obtener más información, consulte Crear un archivo de credenciales compartidas.

Llamada a la GetSendStatistics mediante AWS SDK for 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) }

Llamada a la GetSendStatistics mediante 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"); } ?>

Llamada a la GetSendStatistics mediante 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))

Llamada a la GetSendStatistics mediante 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