Abonnement aux rapports d'SMSutilisation SNS quotidiens d'Amazon

Vous pouvez suivre vos SMS livraisons en vous abonnant aux rapports d'utilisation quotidiens d'AmazonSNS. Pour chaque jour où vous envoyez au moins un SMS message, Amazon SNS envoie un rapport d'utilisation sous forme de CSV fichier au compartiment Amazon S3 spécifié. 24 heures sont nécessaires pour que le rapport SMS d'utilisation soit disponible dans le compartiment S3.

Informations sur le rapport d'utilisation quotidien

Le rapport d'utilisation inclut les informations suivantes pour chaque SMS message que vous envoyez depuis votre compte.

Le rapport n'inclut pas les messages envoyés aux destinataires qui se sont désabonnés.

• Heure de publication du message (enUTC)

• ID de message

• Numéro de téléphone de destination

• Type de message

• Statut de distribution

• Prix du message (enUSD)

• Référence (un message est fractionné en plusieurs parties s'il est trop long pour constituer un seul message)

• Nombre total de parties

Note

Si Amazon SNS n'a pas reçu le numéro de pièce, nous avons défini sa valeur à zéro.

Abonnement à des rapports d'utilisation quotidiens

Pour vous abonner à des rapports d'utilisation quotidiens, vous devez créer un compartiment Amazon S3 avec les autorisations appropriées.

Pour créer un compartiment Amazon S3 pour vos rapports d'utilisation quotidiens

1. À partir de la console Compte AWS qui envoie SMS des messages, connectez-vous à la console Amazon S3.

2. Choisissez Créer un compartiment.

3. Pour Nom du compartiment, nous vous recommandons de saisir un nom unique pour votre compte et votre organisation. Par exemple, utilisez le modèle <my-bucket-prefix>-<account_id>-<org-id>.

   Pour de plus amples informations sur les conventions et les restrictions pour les noms de compartiments, consultez Règles relatives à l'attribution des noms de compartiments dans le Guide de l’utilisateur du service d’Amazon Simple Storage.

4. Sélectionnez Create (Créer).

5. Dans le tableau Tous les compartiments, sélectionnez le compartiment.

6. Dans l'onglet Autorisations, sélectionnez politique de compartiment.

7. Dans la fenêtre Bucket Policy Editor, indiquez une politique permettant au responsable du SNS service Amazon d'écrire dans votre compartiment. Pour obtenir un exemple, consultez Exemple de politique de compartiment.

   Si vous utilisez l'exemple de politique, n'oubliez pas de remplacer amzn-s3-demo-bucket avec le nom du bucket que vous avez choisi à l'étape 3.

8. Choisissez Save (Enregistrer).

Pour vous abonner à des rapports d'utilisation quotidiens

1. Connectez-vous à la SNSconsole Amazon.

2. Dans le panneau de navigation, choisissez Messagerie texte (SMS).

3. Sur la page Messagerie texte (SMS), dans la section des préférences de messagerie texte, choisissez Modifier.

   

4. Sur la page Edit text messaging preferences (Modifier les préférences de SMS) dans la section Details (Détails), spécifiez le Amazon S3 bucket name for usage reports (Nom du compartiment Amazon S3 pour les rapports d'utilisation).

   

5. Sélectionnez Enregistrer les modifications.

Exemple de politique de compartiment

La politique suivante autorise le principal du SNS service Amazon à effectuer les s3:ListBucket actions s3:PutObjects3:GetBucketLocation, et.

AWS fournit des outils pour tous les services dont les principaux responsables ont eu accès aux ressources de votre compte. Lorsque le principal dans une déclaration de politique d'un compartiment Amazon S3 est un principal de service AWS, vous pouvez utiliser les clés de condition globales aws:SourceArn ou aws:SourceAccount pour vous protéger contre le problème de député confus. Pour limiter la région et le compte à partir desquels le compartiment peut recevoir des rapports d'utilisation quotidiens, utilisez aws:SourceArn comme indiqué dans l'exemple ci-dessous. Si vous ne souhaitez pas limiter les régions qui peuvent générer ces rapports, utilisez aws:SourceAccount pour limiter en fonction du compte qui génère les rapports. Si vous ne connaissez pas ARN la ressource, utilisezaws:SourceAccount.

Utilisez l'exemple suivant qui inclut une protection adjointe confuse lorsque vous créez un compartiment Amazon S3 pour recevoir des rapports SMS d'utilisation quotidiens d'AmazonSNS.

{
	"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:*"
				}
			}
		}
	]
}

Note

Vous pouvez publier des rapports d'utilisation sur des compartiments Amazon S3 appartenant au Compte AWS qui est spécifié dans l'élément Condition de la politique Amazon S3. Pour publier des rapports d'utilisation dans un compartiment Amazon S3 appartenant à Compte AWS un autre, consultez Comment copier des objets S3 d'un autre compartiment Compte AWS ? .

Exemple de rapport d'utilisation quotidien

Une fois que vous vous êtes abonné aux rapports d'utilisation quotidiens, Amazon SNS place chaque jour un CSV fichier contenant les données d'utilisation à l'emplacement suivant :

<amzn-s3-demo-bucket>/SMSUsageReports/<region>/YYYY/MM/DD/00x.csv.gz

Chaque fichier peut contenir jusqu'à 50 000 enregistrements. Si le nombre d'enregistrements d'une journée dépasse ce quota, Amazon SNS ajoutera plusieurs fichiers.

L'illustration suivante présente un exemple de rapport :

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