As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Como assinar relatórios diários de uso de SMS no Amazon SNS
É possível monitorar suas entregas de SMS inscrevendo-se para relatórios diários de uso do Amazon SNS. Para cada dia que você enviar pelo menos uma mensagem SMS, o Amazon SNS fornecerá um relatório de uso como um arquivo CSV para o bucket do Amazon S3 especificado. Leva 24 horas para que o relatório de uso de SMS esteja disponível no bucket do Amazon S3.
## Informações sobre relatório de uso diário
O relatório de uso inclui as seguintes informações para cada mensagem SMS que foi enviada de sua conta.
O relatório não inclui as mensagens que são enviadas aos destinatários que recusaram a opção.
+ Hora da publicação da mensagem (em UTC)
+ ID de mensagem
+ Número de telefone de destino
+ Tipo de mensagem
+ Status da entrega
+ Preço da mensagem (em USD)
+ Número da parte (uma mensagem é dividida em várias partes se for muito longa para uma única mensagem)
+ Número total de partes
**nota**
Se o Amazon SNS não recebeu o número da peça, definimos seu valor como zero.
## Assinar relatórios de uso diário
Para inscrever-se para relatórios de uso diário, você deve criar um bucket do Amazon S3 com as permissões apropriadas.
**Para criar um bucket do Amazon S3 para seus relatórios de uso diário**
1. Do Conta da AWS que envia mensagens SMS, faça login no console do [Amazon S3](https://console.aws.amazon.com/s3/).
1. Escolha **Criar bucket**.
1. Em **Nome do bucket**, recomendamos inserir um nome exclusivo para sua conta e organização. Por exemplo, use o padrão `--`.
Para obter informações sobre convenções e restrições de nomes de buckets, consulte [Regras de nomenclatura de buckets](https://docs.aws.amazon.com/AmazonS3/latest/userguide/BucketRestrictions.html#bucketnamingrules) no *Guia do desenvolvedor do Amazon Simple Storage Service*.
1. Escolha **Criar**.
1. Na tabela **All Buckets** (Todos os buckets), escolha o bucket.
1. Na guia **Permissions** (Permissões), escolha **Bucket policy** (Política de bucket).
1. Na janela **Bucket Policy Editor** (Editor de política de bucket), forneça uma política que permita ao principal do serviço Amazon SNS gravar no bucket. Para ver um exemplo, consulte [Exemplo de política de bucket](#example_bucket_policy).
Se você usar a política de exemplo, lembre-se de {{my-s3-bucket}} substituí-la pelo nome do bucket que você escolheu na Etapa 3.
1. Escolha **Salvar**.
**Para inscrever-se para relatórios de uso diário**
1. Faça login no [console do Amazon SNS](https://console.aws.amazon.com/sns/).
1. No painel de navegação, escolha **Text messaging (SMS) [Mensagens de texto (SMS)]**.
1. Na página **Mensagens de texto (SMS)**, na seção **Preferências de mensagens de texto**, escolha **Editar**.
1. Na página **Editar preferências de mensagens de texto**, na seção **Detalhes**, especifique o **Nome do bucket do Amazon S3 para relatórios de uso**.
1. Escolha **Salvar alterações**.
### Exemplo de política de bucket
A política a seguir permite que o principal do serviço Amazon SNS execute as ações `s3:PutObject`, `s3:GetBucketLocation` e `s3:ListBucket`.
AWS fornece ferramentas para todos os serviços com diretores de serviços que receberam acesso aos recursos em sua conta. Quando o principal em uma declaração de política de bucket do Amazon S3 é um [problema de representante confuso.](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html) Para limitar de qual região e conta o bucket pode receber relatórios de uso diário, use `aws:SourceArn`, como mostra o exemplo abaixo. Se não quiser limitar quais regiões podem gerar esses relatórios, use `aws:SourceAccount` para limitar com base em qual conta está gerando os relatórios. Se você não conhece o ARN do recurso, use `aws:SourceAccount`.
Use o exemplo a seguir, que inclui proteção contra representante confuso quando você cria um bucket do Amazon S3 para receber relatórios de uso diário de SMS do Amazon SNS.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "AllowPutObject",
"Effect": "Allow",
"Principal": {
"Service": "sns.amazonaws.com"
},
"Action": "s3:PutObject",
"Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "account_id"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:sns:us-west-1:123456789012:*"
}
}
},
{
"Sid": "AllowGetBucketLocation",
"Effect": "Allow",
"Principal": {
"Service": "sns.amazonaws.com"
},
"Action": "s3:GetBucketLocation",
"Resource": "arn:aws:s3:::amzn-s3-demo-bucket",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "account_id"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:sns:us-west-1:123456789012:*"
}
}
},
{
"Sid": "AllowListBucket",
"Effect": "Allow",
"Principal": {
"Service": "sns.amazonaws.com"
},
"Action": "s3:ListBucket",
"Resource": "arn:aws:s3:::amzn-s3-demo-bucket",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "account_id"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:sns:us-west-1:123456789012:*"
}
}
}
]
}
```
------
**nota**
É possível publicar relatórios de uso em buckets do Amazon S3 que pertencem à Conta da AWS especificada no elemento `Condition` na política do Amazon S3. Para publicar relatórios de uso em um bucket do Amazon S3 de Conta da AWS propriedade de outra pessoa, consulte [Como posso copiar objetos do Amazon S3](https://aws.amazon.com/premiumsupport/knowledge-center/copy-s3-objects-account/) de outro? Conta da AWS.
### Exemplo de relatório de uso diário
Depois de inscrever-se nos relatórios de uso diários, a cada dia o Amazon SNS coloca um arquivo CSV com os dados de uso no seguinte local:
```
{{}}/SMSUsageReports/{{}}/{{YYYY}}/{{MM}}/{{DD}}/{{00x}}.csv.gz
```
Cada arquivo pode conter até 50.000 registros. Se os registros de um dia excederem essa cota, o Amazon SNS adicionará vários arquivos. A seguir, um exemplo de relatório:
```
PublishTimeUTC,MessageId,DestinationPhoneNumber,MessageType,DeliveryStatus,PriceInUSD,PartNumber,TotalParts
2016-05-10T03:00:29.476Z,96a298ac-1458-4825-a7eb-7330e0720b72,1XXX5550100,Promotional,Message has been accepted by phone carrier,0.90084,0,1
2016-05-10T03:00:29.561Z,1e29d394-d7f4-4dc9-996e-26412032c344,1XXX5550100,Promotional,Message has been accepted by phone carrier,0.34322,0,1
2016-05-10T03:00:30.769Z,98ba941c-afc7-4c51-ba2c-56c6570a6c08,1XXX5550100,Transactional,Message has been accepted by phone carrier,0.27815,0,1
```