Monitoramento de suas estatísticas de uso usando a API do Amazon SES

A API do Amazon SES fornece a operação GetSendStatistics, que retorna informações sobre seu uso do serviço. Recomendamos que você verifique regularmente suas estatísticas de envio, para que possa fazer ajustes, se necessário.

Quando você chama a operação GetSendStatistics, recebe uma lista de pontos de dados que representa as duas últimas semanas de sua atividade de envio. Cada ponto de dados na lista representa 15 minutos de atividade e contém as seguintes informações desse período:

• O número de devoluções definitivas

• O número de reclamações

• O número de tentativas de entrega (corresponde ao número de e-mails que você enviou)

• O número de tentativas de envio rejeitadas

• Um carimbo de data e hora do período de análise

Para obter uma descrição detalhada da operação GetSendStatistics, consulte a Referência da API do Amazon Simple Email Service.

Nesta seção, você encontrará os seguintes tópicos:

• Chamar a operação da API GetSendStatistics com a AWS CLI

• Chamar a operação GetSendStatistics de forma programática

Chamar a operação da API GetSendStatistics com a AWS CLI

A maneira mais fácil de chamar a operação da API GetSendStatistics é usar a AWS Command Line Interface (AWS CLI).

Para chamar a operação da API GetSendStatistics usando a AWS CLI

1. Se você ainda não tiver feito isso, instale a AWS CLI. Para obter mais informações, consulte "Instalar a AWS Command Line Interface no Guia do usuário da AWS Command Line Interface.

2. Se você ainda fez isso, configure a AWS CLI para usar suas credenciais da AWS. Para obter mais informações, consulte "Configurar a AWS CLI" no Guia do usuário da AWS Command Line Interface.

3. Na linha de comando, execute o seguinte comando:

   aws ses get-send-statistics

   Se a AWS CLI estiver configurada corretamente, você verá uma lista de estatísticas de envio no formato JSON. Cada objeto JSON inclui estatísticas de envio agregadas para um período de 15 minutos.

Chamar a operação GetSendStatistics de forma programática

Você também pode chamar a operação GetSendStatistics usando os SDKs da AWS. Esta seção inclui exemplos de código para os SDKs da AWS para Go, PHP, Python e Ruby. Escolha um dos seguintes links para visualizar exemplos de código da linguagem:

• Exemplo de código do AWS SDK for Go

• Exemplo de código do AWS SDK for PHP

• Exemplo de código do AWS SDK for Python (Boto)

• Exemplo de código do AWS SDK for Ruby

nota

Esses exemplos de código pressupõem que você criou um arquivo de credenciais compartilhadas da AWS que contém seu ID da chave de acesso da AWS, a chave de acesso secreta da AWS e a região da AWS de sua preferência. Para obter mais informações, consulte Credenciais e arquivos de configuração compartilhados.

Chamar GetSendStatistics com o 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)
}

Chamar GetSendStatistics com o 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");
}

?>

Chamar GetSendStatistics com o 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))

Chamar GetSendStatistics com o 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