SMS の毎日の使用状況レポートを表示する

Amazon SNS から毎日の使用状況レポートにサブスクライブすることによって、SMS 配信をモニタリングできます。1 つ以上の SMS メッセージを送信する日ごとに、Amazon SNS は、指定した Amazon S3 バケットに CSV ファイルとして使用状況レポートを配信します。SMS 使用状況レポートが S3 バケットで利用可能になるまでに、24 時間かかります。

毎日の使用状況レポートの情報

使用状況レポートには、アカウントから正常に配信した各 SMS メッセージに関する以下の情報が含まれています。

このレポートには、オプトアウトした受取人に送信されるメッセージは含まれない点に注意してください。

• メッセージの発行時間 (UTC)

• メッセージ ID

• 送信先の電話番号

• メッセージの種類

• 配信ステータス

• メッセージの価格 (USD)

• パート番号 (1 通のメッセージとして長すぎる場合、メッセージは複数のパートに分割されます)

• パートの総数

注記

Amazon SNS がパート番号を受け取らなかった場合は、その値をゼロに設定します。

毎日の使用状況レポートにサブスクライブする

毎日の使用状況レポートにサブスクライブするには、適切なアクセス権限を持つ Amazon S3 バケットを作成する必要があります。

毎日の使用状況レポート用の Amazon S3 バケットを作成するには

1. SMS メッセージを送信する AWS アカウント から、Amazon S3 コンソールにサインインします。

2. [バケットの作成] を選択します。

3. [バケット名] には、アカウントと組織で一意の名前を入力することをお勧めします。例えば、パターン <my-bucket-prefix>-<account_id>-<org-id> を使用します。

   バケット名に関する規則と制限については、『Amazon Simple Storage Service ユーザーガイド』の「バケットの命名規則」を参照してください。

4. [Create] を選択します。

5. [すべてのバケット]テーブルでバケットを選択します。

6. [Permissions] セクションで、[バケットポリシー] を選択します。

7. [バケットポリシーエディター] ウィンドウで、Amazon SNS サービスプリンシパルをバケットに書き込むことを許可するポリシーを指定します。例については、バケットポリシーの例 を参照してください。

   サンプルポリシーを使用する場合は、my-s3-bucket をステップ 3 で選択したバケット名に置き換えてください。

8. [Save] を選択します。

毎日の使用状況レポートにサブスクライブするには

1. Amazon SNS コンソールにサインインします。

2. ナビゲーションパネルで、[テキストメッセージング (SMS)] を選択します。

3. [テキストメッセージング (SMS)] ページの [テキストメッセージングの設定] セクションで、[編集] を選択します。

   

4. [テキストメッセージングの設定の編集] ページの [詳細] セクションで、[使用状況レポートに使用する Amazon S3 バケット名] を指定します。

   

5. [Save changes] (変更の保存) をクリックします。

バケットポリシーの例

以下のポリシーは、Amazon SNS サービスプリンシパルにs3:PutObject、s3:GetBucketLocation および s3:ListBucket アクションの実行を許可します。

AWS は、お客様のアカウントのリソースへのアクセスを与えられたサービスプリンシパルを持つすべてのサービスを目的としたツールを提供します。Amazon S3 バケットポリシーステートメントのプリンシパルが AWS service principal (AWS のサービスプリンシパル) である場合、aws:SourceArn または aws:SourceAccount のグローバル条件キーを使用して、confused deputy problem (混乱した代理の問題) から保護することができます。バケットが毎日の使用状況レポートを受信できるリージョンとアカウントを制限するには、以下の例のように aws:SourceArn を使用します。これらのレポートを生成できるリージョンを制限したくない場合は、aws:SourceAccount を使用して、レポートを生成しているアカウントに基づいて制限します。リソースの ARN が不明の場合は、aws:SourceAccount を使用してください。

Amazon S3 バケットを作成して、Amazon SNS から毎日の SMS 使用状況レポートを受信する際に、混乱した代理保護を含む次の例を使用します。

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

注記

Amazon S3 ポリシーの Condition エレメントで指定される AWS アカウント に所有される Amazon S3 バケットに使用状況レポートを発行できます。他の AWS アカウント が所有する Amazon S3 バケットに使用状況レポートを発行するには、「How can I copy S3 objects from another AWS アカウント?」を参照してください。

毎日の使用状況レポートの例

毎日の使用状況レポートにサブスクライブすると、Amazon SNS は毎日、以下の場所に使用状況データを使用して CSV ファイルを配置します。

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

各ファイルには、最大 50,000 のレコードを含めることができます。1 日のレコードがこの限度を超えると、Amazon SNS は複数のファイルを追加します。

レポートの例を以下に示します。

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