SMS の毎日の使用状況レポートの表示 - Amazon Simple Notification Service

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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. [] を参照してください。 AWS アカウント で SMS メッセージを送信するには、Amazon S3 コンソール

  2. [Create Bucket] を選択します。

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

    バケット名の規則と制限については、バケット命名規則()Amazon Simple Storage Service 開発者ガイド

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

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

  6. アクセス許可[] タブで []バケットポリシー

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

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

  8. [Save] (保存) をクリックします。

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

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

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

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

    
                                    [テキストメッセージングの設定] セクション
  4. [Edit text messaging preferences (テキストメッセージングの設定の編集)] ページの [Details (詳細)] セクションで、[Amazon S3 bucket name for usage reports (使用状況レポートに使用する Amazon S3 バケット名)] を指定します。

    
                                    [テキストメッセージジング設定の編集] ページの [詳細] セクション
  5. [変更を保存] をクリックします。

バケットポリシーの例

以下のポリシーは、Amazon SNS サービスプリンシパルにs3:PutObject,s3:GetBucketLocation, およびs3:ListBucketのアクション。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" } } }, { "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" } } }, { "Sid": "AllowListBucket", "Effect": "Allow", "Principal": { "Service": "sns.amazonaws.com" }, "Action": "s3:ListBucket", "Resource": "arn:aws:s3:::my-s3-bucket" } ] }
注記

使用状況Amazon S3 は、 AWS アカウント で指定されているConditionAmazon S3 ポリシーの要素を使用します。Amazon S3 バケットに使用状況レポートを発行するには AWS アカウント が所有する詳細については、」S3オブジェクトを別のオブジェクトからコピーする方法 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