

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
<a name="monitor-sending-activity-api"></a>

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](https://docs.aws.amazon.com/ses/latest/APIReference/GetSendStatistics.html).

En esta sección, encontrará los temas siguientes:
+ [Llamar a la operación de la `GetSendStatistics` API mediante el AWS CLI](#monitor-sending-activity-api-cli)
+ [Llamada a la operación `GetSendStatistics` mediante programación](#monitor-sending-activity-api-sdk)

## Llamar a la operación de la `GetSendStatistics` API mediante el AWS CLI
<a name="monitor-sending-activity-api-cli"></a>

La forma más sencilla de llamar a la operación `GetSendStatistics` de la API consiste en utilizar la [AWS Command Line Interface](https://aws.amazon.com/cli) (AWS CLI).

**Para llamar a la operación de `GetSendStatistics` API mediante el AWS CLI**

1. Si aún no lo ha hecho, descargue e instale la AWS CLI. Para obtener más información, consulte la sección "[Instalación del AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html)" en la *Guía del AWS Command Line Interface usuario*.

1. Si aún no lo ha hecho, configúrelo AWS CLI para que utilice sus AWS credenciales. Para obtener más información, consulte [la sección "Configuración del AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html)" en la *Guía del AWS Command Line Interface usuario*.

1. En la línea de comandos, ejecute el comando siguiente:

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

   Si AWS CLI está configurado 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
<a name="monitor-sending-activity-api-sdk"></a>

También puede llamar a la `GetSendStatistics` operación mediante AWS SDKs. Esta sección incluye ejemplos de código AWS SDKs para Go, PHP, Python y Ruby. Elija uno de los siguientes enlaces para ver ejemplos de código para dicho lenguaje:
+ [Ejemplo de código para el AWS SDK para Go](#code-example-getsendstatistics-golang)
+ [Ejemplo de código para el AWS SDK para PHP](#code-example-getsendstatistics-php)
+ [Ejemplo de código para el AWS SDK para Python (Boto)](#code-example-getsendstatistics-python)
+ [Ejemplo de código para el AWS SDK para Ruby](#code-example-getsendstatistics-ruby)

**nota**  
En estos ejemplos de código se supone que has creado un archivo de credenciales AWS compartidas que contiene tu identificador de clave de AWS acceso, tu clave de acceso AWS secreta y tu AWS región preferida. Para obtener más información, consulte [Archivos de configuración y credenciales compartidas](https://docs.aws.amazon.com/credref/latest/refdocs/creds-config-files.html).

### Llamar `GetSendStatistics` usando el AWS SDK para 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. }
```

### Llamar `GetSendStatistics` mediante el AWS SDK para 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. ?>
```

### Llamar `GetSendStatistics` mediante el AWS SDK para 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))
```

### Llamar `GetSendStatistics` mediante el AWS SDK para 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
```