Amazon Simple Notification Service
开发人员指南 (API Version 2010-03-31)
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。点 击 Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

查看每日 SMS 使用量报告

您可以通过从 Amazon SNS 订阅每日使用量报告来监控您的 SMS 消息传输。在每个您至少发送了一条 SMS 消息的日子,Amazon SNS 都将向您指定的 Amazon S3 存储桶发送 CSV 文件形式的使用率报告。

每日使用量报告信息

该使用量报告包括通过您的帐户成功传输的每条 SMS 消息的以下信息:

  • 发布消息的时间(UTC 时间)

  • 消息 ID

  • 目标电话号码

  • 消息类型

  • 传输状态

  • 消息价格 (USD)

  • 分段编号(如果一条消息过长,则会拆分为多个分段)

  • 分段总数

订阅每日使用量报告

要订阅每日使用量报告,您必须通过适当的权限创建 Amazon S3 存储桶。

为您的每日使用量报告创建 Amazon S3 存储桶

  1. 登录 AWS 管理控制台并通过以下网址打开 Amazon S3 控制台:https://console.amazonaws.cn/s3/

  2. 选择 Create Bucket

  3. 对于 Bucket Name,请输入名称,例如 sns-sms-daily-usage。有关存储桶命名约定和限制的信息,请参阅 Amazon Simple Storage Service 开发人员指南 中的存储桶命名规则

  4. 选择 Create

  5. All Buckets 表中,选择存储桶,然后选择 Properties

  6. Permissions 部分,选择 Add bucket policy

  7. Bucket Policy Editor 窗口中,提供允许 Amazon SNS 服务委托人写入您的存储桶的策略。有关示例,请参阅存储桶策略的示例

    如果您使用示例策略,请记得使用您的存储桶名称替换 my-s3-bucket

  8. 选择 Save

订阅每日使用量报告

  1. 通过以下网址登录 AWS 管理控制台 并打开 Amazon SNS 控制台:https://console.amazonaws.cn/sns/v2/home

  2. 在导航窗格中,选择 Text messaging (SMS)

  3. Text messaging (SMS) 页面,选择 Manage text messaging preferences

  4. Text messaging preferences 页面上,对于 Reports storage,请输入要用于接收每日 SMS 使用量报告的 Amazon S3 存储桶的名称。

  5. 选择 Update preferences

有关 Text messaging preferences 页面上其他选项的信息,请参阅 设置首选项(控制台)

在您订阅每日使用量报告后,您可以在 Amazon S3 控制台中查看报告。您也可以在 Amazon SNS 控制台中转到 Text messaging (SMS) 页面,然后选择 Usage 按钮。

存储桶策略的示例

以下策略允许 Amazon SNS 服务委托人执行 s3:PutObjects3:GetBucketLocation 操作。在创建从 Amazon SNS 接收每日 SMS 使用量报告的 Amazon S3 存储桶时,您可以使用本示例。

Copy
{ "Version": "2012-10-17", "Id": "sns-sms-daily-usage-policy", "Statement": [ { "Sid": "AllowPutObject", "Effect": "Allow", "Principal": { "Service": "sns.amazonaws.com" }, "Action": "s3:PutObject", "Resource": "arn:aws:s3:::my-s3-bucket/*" }, { "Sid": "AllowGetBucketLocation", "Effect": "Allow", "Principal": { "Service": "sns.amazonaws.com" }, "Action": "s3:GetBucketLocation", "Resource": "arn:aws:s3:::my-s3-bucket" } ] }

每日使用量报告的示例

在您订阅每日使用量报告后,Amazon SNS 会每天将包含使用量数据的 CSV 文件放在以下位置:

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

每个文件可包含最多 50000 条记录。如果一天内的记录超出此限制,则 Amazon SNS 会添加多个文件。

下面显示了一个示例报告:

Copy
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,1,1 2016-05-10T03:00:29.561Z,1e29d394-d7f4-4dc9-996e-26412032c344,1XXX5550100,Promotional,Message has been accepted by phone carrier,0.34322,1,1 2016-05-10T03:00:30.769Z,98ba941c-afc7-4c51-ba2c-56c6570a6c08,1XXX5550100,Transactional,Message has been accepted by phone carrier,0.27815,1,1 . . .