Suscripción a informes de uso diario de SMS en Amazon SNS

Modo de enfoque

Suscripción a informes de uso diario de SMS en Amazon SNS - Amazon Simple Notification Service

Información del informe de uso diario Suscripción a informes de uso diario

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

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.

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:

Desde la Cuenta de AWS que envía los mensajes SMS, inicie sesión en la consola de Amazon S3.
Seleccione la opción Crear bucket.
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 en la Guía del usuario de Amazon Simple Storage Service.
Seleccione Crear.
En la tabla Todos los buckets, elija el bucket.
En la pestaña Permisos, elija Política de bucket.
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.

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

Para suscribirse a los informes de uso diario

Inicie sesión en la consola de Amazon SNS.
En el panel de navegación, elija Text messaging (SMS) (Mensajería de texto (SMS)).
En la página Mensajería de texto (SMS), en la sección Preferencias de mensajería de texto, elija Editar.
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).
Seleccione Save changes (Guardar cambios).

Ejemplo de política de bucket

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


{
    "Version": "2008-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:region:account_id:*"
                }
            }
        },
        {
            "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:region:account_id:*"
                }
            }
        },
        {
            "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:region:account_id:*"
                }
            }
        }
    ]
}

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? .

Ejemplo de informe de uso diario

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