Anzeigen von täglichen SMS-Nutzungsberichten

Sie können Ihre SMS-Zustellungen überwachen, indem Sie tägliche Nutzungsberichte von Amazon SNS abonnieren. Für jeden Tag, an dem Sie mindestens eine SMS-Nachricht senden, sendet Amazon SNS einen Nutzungsbericht als CSV-Datei an den angegebenen Amazon S3-Bucket. Es dauert 24 Stunden, bis der SMS-Nutzungsbericht im S3-Bucket verfügbar ist.

Informationen im täglichen Nutzungsbericht

Der Nutzungsbericht umfasst die folgenden Informationen für jede SMS-Nachricht, die Sie von Ihrem Konto senden.

Beachten Sie, dass der Bericht keine Nachrichten enthält, die an Empfänger gesendet werden, die sich vom Nachrichtenempfang abgemeldet haben.

• Zeitpunkt der Veröffentlichung für die Nachricht (in UTC)

• Nachrichten-ID

• Zieltelefonnummer

• Nachrichtentyp

• Zustellungsstatus

• Kosten für die Nachricht (in US-Dollar)

• Segmentnummer (eine Nachricht wird in mehrere Segmente aufgeteilt, wenn sie für eine einzelne Nachricht zu lang ist)

• Gesamtanzahl der Segmente

Anmerkung

Wenn Amazon SNS die Segmentnummer nicht erhalten hat, setzen wir deren Wert auf Null.

Abonnieren der täglichen Nutzungsberichte

Um tägliche Nutzungsberichte zu abonnieren, müssen Sie einen Amazon S3-Bucket mit den entsprechenden Berechtigungen erstellen.

So erstellen Sie einen Amazon-S3-Bucket für Ihre täglichen Nutzungsberichte

1. Melden Sie sich vom AWS-Konto, der SMS-Nachrichten sendet, in der Amazon S3-Konsole an.

2. Wählen Sie Create Bucket (Bucket erstellen) aus.

3. Unter Bucket Name (Bucket-Name) empfiehlt es sich, einen für Ihr Konto und Ihre Organisation eindeutigen Namen einzugeben. Verwenden Sie zum Beispiel das Muster <my-bucket-prefix>-<account_id>-<org-id>.

   Weitere Informationen über Konventionen und Einschränkungen für Bucket-Namen finden Sie unter Regeln für die Bucket-Benennung im Benutzerhandbuch zu Amazon Simple Storage Service.

4. Wählen Sie Create (Erstellen) aus.

5. Wählen Sie in der Tabelle Alle Buckets den Bucket aus.

6. Wählen Sie in der Registerkarte Genehmigungen Bucket-Richtlinie.

7. Geben Sie im Fenster Bucket Policy Editor (Bucket-Richtlinieneditor) eine Richtlinie ein, die den Amazon SNS-Serviceprinzipal berechtigt, in Ihren Bucket zu schreiben. Ein Beispiel finden Sie unter Beispiel einer Bucket-Richtlinie.

   Wenn Sie die Beispielrichtlinie verwenden, denken Sie daran, my-s3-bucket durch den Bucket-Namen zu ersetzen, den Sie in Schritt 3 gewählt haben.

8. Wählen Sie Save (Speichern) aus.

So abonnieren Sie tägliche Nutzungsberichte

1. Melden Sie sich bei der Amazon SNS-Konsole an.

2. Wählen Sie im Navigationsbereich Text messaging (SMS) (Textnachrichten (SMS)) aus.

3. Wählen Sie auf der Seite Text messaging (SMS) (Textnachrichten (SMS)) im Abschnitt Text messaging preferences (Textnachrichteneinstellungen) die Option Edit (Bearbeiten) aus.

   

4. Geben Sie auf der Seite Edit text messaging preferences (Textnachrichteneinstellungen bearbeiten) im Abschnitt Details Amazon S3 bucket name for usage reports (Amazon S3-Bucket-Name für Nutzungsberichte) an.

   

5. Wählen Sie Save Changes (Änderungen speichern) aus.

Beispiel einer Bucket-Richtlinie

Die folgende Richtlinie berechtigt den Amazon SNS-Service, die Aktionen s3:PutObject, s3:GetBucketLocation und s3:ListBucket durchzuführen.

AWS bietet Tools für alle Services mit Serviceprinzipalen, die Zugriff auf Ressourcen in Ihrem Konto erhalten haben. Wenn der Prinzipal in einer Amazon-S3-Bucket-Richtlinie ein AWS-Service-Prinzipal ist, können Sie aws:SourceArn oder den globalen Zustandsschlüssel aws:SourceAccount zum Schutz vor dem Problem des verwirrten Stellvertreters verwenden. Um zu begrenzen, welche Region und welches Konto der Bucket tägliche Nutzungsberichte erhalten kann, verwenden Sie aws:SourceArn, wie im folgenden Beispiel gezeigt. Wenn Sie die Regionen, die diese Berichte genieren können, nicht einschränken wollen, können Sie mit aws:SourceAccount einschränken, welche Konten die Berichte generieren. Wenn Sie den ARN der Ressource nicht kennen, verwenden Sie aws:SourceAccount.

Verwenden Sie das folgende Beispiel, das einen Schutz vor dem Problem des verwirrten Stellvertreters enthält, um eine Amazon-S3-Bucket für den Empfang von täglichen SMS-Nutzungsberichten von Amazon SNS zu erstellen.

{
	"Version": "2008-10-17",
	"Statement": [{
			"Sid": "AllowPutObject",
			"Effect": "Allow",
			"Principal": {
				"Service": "sns.amazonaws.com"
			},
			"Action": "s3:PutObject",
			"Resource": "arn:aws:s3:::my-s3-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:::my-s3-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:::my-s3-bucket",
			"Condition": {
				"StringEquals": {
					"aws:SourceAccount": "account_id"
				},
				"ArnLike": {
					"aws:SourceArn": "arn:aws:sns:region:account_id:*"
				}
			}
		}
	]
}

Anmerkung

Sie können Nutzungsberichte in Amazon-S3-Buckets veröffentlichen, die sich im Besitz von AWS-Konto befinden, die in der Amazon S3-Richtlinie im Condition-Element festgelegt sind. Für die Veröffentlichung von Nutzungsberichten an einen Amazon S3-Bucket, die einem anderen AWS-Konto gehören, siehe Wie kann ich S3-Objekte von einem anderen AWS-Konto kopieren?.

Beispiel eines täglichen Nutzungsberichts

Nachdem Sie die täglichen Nutzungsberichte abonniert haben, speichert Amazon SNS jeden Tag eine CSV-Datei mit Nutzungsdaten am folgenden Speicherort:

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

Jede Datei kann bis zu 50.000 Datensätze enthalten. Wenn die Berichte für einen Tag dieses Kontingent übersteigen, fügt Amazon SNS mehrere Dateien hinzu.

Nachstehend finden Sie einen Beispielbericht:

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