使用移动推送通知的 Amazon SNS 生存时间消息属性

聚焦模式

使用移动推送通知的 Amazon SNS 生存时间消息属性 - Amazon Simple Notification Service

推送通知服务的 TTL 消息属性决定 TTL 的优先顺序使用指定 TTL AWS Management Console

Amazon Simple Notification Service (Amazon SNS) 支持设置移动推送通知消息的生存时间 (TTL) 消息属性。该功能不同于在移动推送通知服务的 Amazon SNS 消息正文中设置 TTL（如果该推送通知服务支持的话）的功能，如发送到 Android 时的 Amazon Device Messaging（ADM）和 Firebase Cloud Messaging（FCM）。

TTL 消息属性用于指定有关消息的过期元数据。这允许您指定推送通知服务（例如 Apple 推送通知服务 (APNs) 或 FCM）将消息传送到端点所需的时间。如果因为某种原因（如移动设备已关闭），消息无法在指定的 TTL 内传达，则系统将丢弃该消息，且不再尝试传送它。要在消息属性中指定 TTL，可以使用 AWS Management Console、 AWS 软件开发套件 (SDKs) 或查询 API。

以下是推送通知服务的 TTL 消息属性列表，您可以使用这些属性在使用 AWS SDKs 或查询 API 时进行设置：

推送通知服务	TTL 消息属性
Amazon Device Messaging（ADM）	`AWS.SNS.MOBILE.ADM.TTL`
苹果推送通知服务 (APNs)	`AWS.SNS.MOBILE.APNS.TTL`
Apple 推送通知服务沙盒 (APNs_SANDBOX)	`AWS.SNS.MOBILE.APNS_SANDBOX.TTL`
百度云推送（百度）	`AWS.SNS.MOBILE.BAIDU.TTL`
Firebase Cloud Messaging（FCM，发送到 Android 时）	`AWS.SNS.MOBILE.FCM.TTL`
Windows 推送通知服务（WNS）	`AWS.SNS.MOBILE.WNS.TTL`

每个推送通知服务以不同的方式处理 TTL。Amazon SNS 提供了涵盖所有推送通知服务的 TTL 抽象视图，使您能够更方便地指定 TTL。当您使用指定 TTL（ AWS Management Console 以秒为单位）时，您只需输入一次 TTL 值，然后 Amazon SNS 将在发布消息时计算每种选定推送通知服务的 TTL。

TTL 是相对于发布时间的。在将推送通知消息转交给特定的推送通知服务之前，Amazon SNS 会计算该推送通知的停留时间（发布时间戳与将消息转交给推送通知服务之间的时间差），并将剩余的 TTL 传递给特定的推送通知服务。如果 TTL 短于停留时间，Amazon SNS 不会尝试发布。

如果您为推送通知消息指定 TTL，则 TTL 值必须为正整数，除非的值对推送通知服务0有特定的含义，例如 with APNs 和 FCM（发送到 Android 时）。如果 TTL 值设为 0，但该推送通知服务对 0 无具体意义，则 Amazon SNS 将丢弃该消息。有关使用0时设置为的 TTL 参数的更多信息 APNs，请参阅 B inary Provider API 文档中远程通知的表 A-3 项目标识符。