Monitoreo de sus estadísticas de uso mediante la API de Amazon SES - Amazon Simple Email Service

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Monitoreo de sus estadísticas de uso mediante la API de Amazon SES

La API de Amazon SES proporciona la operación GetSendStatistics, que devuelve información acerca del 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 la operación GetSendStatistics, consulte la Referencia de la API 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 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, ejecute el comando siguiente:

    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 la operación GetSendStatistics utilizando los SDK de AWS. Esta sección incluye ejemplos de código para los SDK de AWS 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 que contiene su ID de clave de acceso de AWS, su clave de acceso secreta de AWS y su región de AWS preferida. Para obtener más información, consulte Archivos de configuración y 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