

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.

# Suscripción a informes de uso diario de SMS en Amazon SNS
<a name="sms_stats_usage"></a>

Puede monitorear sus entregas de SMS si se suscribe a los informes de uso diarios desde Amazon SNS. Todos los días que envía, como mínimo, un SMS, Amazon SNS entrega un informe de uso en formato CSV al bucket de Amazon S3 especificado. El informe de uso de SMS tarda 24 horas en estar disponible en el bucket de Amazon S3. 

## Información del informe de uso diario
<a name="daily_usage_info"></a>

El informe de uso contiene la siguiente información de cada mensaje SMS que envíe desde su cuenta.

 Tenga en cuenta que el informe no incluye los mensajes que se envían a los destinatarios que han desactivado la recepción de mensajes.
+ Hora de publicación del mensaje (en UTC)
+ Message ID
+ Número de teléfono de destino
+ Tipo de mensaje
+ Estado de entrega.
+ Precio del mensaje (en USD).
+ Número de parte (un mensaje se divide en varias partes si es demasiado largo para un único mensaje).
+ Número total de partes.

**nota**  
Si Amazon SNS no recibió el número de parte, establecemos su valor en cero.

## Suscripción a informes de uso diario
<a name="subscribe-to-daily-usage-reports"></a>

Para suscribirse a informes de uso diario, debe crear un bucket de Amazon S3 con los permisos pertinentes.

**Si quiere crear un bucket de Amazon S3 para sus informes de uso diario, siga estos pasos:**

1. Desde la Cuenta de AWS que envía los mensajes SMS, inicie sesión en la [consola de Amazon S3](https://console.aws.amazon.com/s3/).

1. Seleccione la opción **Crear bucket**.

1. En **Bucket Name (Nombre del bucket)**, le recomendamos que escriba un nombre único para su cuenta y su organización. Por ejemplo, use el patrón `<my-bucket-prefix>-<account_id>-<org-id>`. 

   Para obtener información sobre las convenciones y restricciones de los nombres de bucket, consulte [Reglas para la nomenclatura de bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/BucketRestrictions.html#bucketnamingrules) en la *Guía del usuario de Amazon Simple Storage Service*.

1. Seleccione **Crear**.

1. En la tabla **Todos los buckets**, elija el bucket.

1. En la pestaña **Permisos**, elija **Política de bucket**.

1. En la ventana **Editor de políticas de bucket**, indique una política que permita al principal del servicio de Amazon SNS escribir en el bucket. Para ver un ejemplo, consulta [Ejemplo de política de bucket](#example_bucket_policy).

   Si utilizas la política de ejemplo, recuerda {{my-s3-bucket}} sustituirla por el nombre del bucket que elegiste en el paso 3.

1. Seleccione **Save**.

**Para suscribirse a los informes de uso diario**

1. Inicie sesión en la [consola de Amazon SNS](https://console.aws.amazon.com/sns/).

1. En el panel de navegación, elija **Text messaging (SMS) (Mensajería de texto (SMS))**.

1. En la página **Mensajería de texto (SMS)**, en la sección **Preferencias de mensajería de texto**, elija **Editar**.  
![Sección de preferencias de mensajería de texto en la consola de Amazon SNS](http://docs.aws.amazon.com/es_es/sns/latest/dg/images/daily-usage-report1.png)

1. En la página **Edit text messaging preferences (Editar preferencias de mensajería de texto)**, en la sección **Details (Detalles)**, especifique el **Amazon S3 bucket name for usage reports (Nombre del bucket de Amazon S3 para los informes de uso)**.  
![Sección Detalles de la página Editar preferencias de mensajería de texto en la consola de Amazon SNS](http://docs.aws.amazon.com/es_es/sns/latest/dg/images/daily-usage-report2.png)

1. Seleccione **Save changes (Guardar cambios)**.

### Ejemplo de política de bucket
<a name="example_bucket_policy"></a>

Con la siguiente política, la entidad principal del servicio de Amazon SNS puede ejecutar las acciones `s3:PutObject`, `s3:GetBucketLocation` y `s3:ListBucket`.

AWS proporciona herramientas para todos los servicios con los directores de servicio a los que se les ha dado acceso a los recursos de su cuenta. Cuándo la entidad principal de una instrucción de política de bucket de Amazon S3 es un [problema de suplente confuso](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html). Para limitar la región y la cuenta desde las que el bucket puede recibir informes de uso diarios, utilice `aws:SourceArn` tal como se muestra en el siguiente ejemplo. Si no desea limitar las regiones que pueden generar estos informes, utilice `aws:SourceAccount` para establecer límites en función de qué cuenta esté generando los informes. Si no conoce el ARN del recurso, utilice `aws:SourceAccount`.

Utilice el siguiente ejemplo que incluye protección contra suplente confuso cuando cree un bucket de Amazon S3 para recibir informes de uso diario de SMS desde 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**  
Puede publicar informes de uso en buckets de Amazon S3 que sean propiedad de la Cuenta de AWS que se especifica en el elemento `Condition` en la política de Amazon S3. Para publicar informes de uso en un bucket de Amazon S3 que Cuenta de AWS pertenece a otro, consulte [¿Cómo puedo copiar objetos de Amazon S3 de otro Cuenta de AWS?](https://aws.amazon.com/premiumsupport/knowledge-center/copy-s3-objects-account/) . 

### Ejemplo de informe de uso diario
<a name="example_report"></a>

Después de suscribirse a informes de uso diario, cada día Amazon SNS pone un archivo CSV con datos de uso en la siguiente ubicación:

```
{{<my-s3-bucket>}}/SMSUsageReports/{{<region>}}/{{YYYY}}/{{MM}}/{{DD}}/{{00x}}.csv.gz
```

Cada archivo puede contener hasta 50 000 registros. Si los registros de un día superan esta cuota, Amazon SNS agregará varios archivos. A continuación se muestra un informe de ejemplo:

```
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
```