Amazon SNS 消息传输重试

Amazon SNS 为每个传输协议定义了一个传输策略。传输策略定义了在发生服务器端错误时（当承载已订阅终端节点的系统变得不可用时），Amazon SNS 如何重试消息传输。当传输策略用尽时，Amazon SNS 将停止重试传输并丢弃邮件——除非已将死信队列附加到订阅。有关更多信息，请参阅 Amazon SNS 死信队列。

传输协议和策略

¹ 对于 Firehose 协议的节流错误，Amazon SNS 使用与客户托管端点相同的传输策略。

传输策略阶段

下图显示了传输策略的各个阶段。

每个传输策略包含四个阶段。

创建 HTTP/S 传输策略

您可以使用传输策略及其四个阶段来定义 Amazon SNS 如何重试将消息传输到 HTTP/S 端点的操作。Amazon SNS 允许您在可能需要根据 HTTP 服务器的容量自定义策略时覆盖 HTTP 端点的原定设置重试策略。

您可以在订阅或主题级别将 HTTP/S 传输策略设置为 JSON 对象。在主题级别定义策略时，它将应用于与主题关联的所有 HTTP/S 订阅。要在订阅级别设置传送策略，您可以使用 Subscribe 或 SetSubscriptionAttributes API 操作。要在主题级别设置传送策略，您可以使用 CreateTopic 或 SetTopicAttributes API 操作。或者，您也可以在 Amazon CloudFormation 模板中使用 AWS::SNS::Subscription 资源。

您应根据 HTTP/S 服务器的容量来自定义您的传输策略。可以将策略设置为主题属性或订阅属性。如果主题中的所有 HTTP/S 订阅都针对相同的 HTTP/S 服务器，我们建议您将传输策略设置为主题属性，以使其对主题中的所有 HTTP/S 订阅保持有效。否则，您必须根据策略所针对的 HTTP/S 服务器的容量，为主题中的每个 HTTP/S 订阅编写传输策略。

您还可以在请求策略中设置 Content-Type 标头，以指定通知的媒体类型。原定设置情况下，Amazon SNS 会将所有通知发送到 HTTP/S 端点，内容类型设置为 text/plain; charset=UTF-8。Amazon SNS 允许您覆盖原定设置的请求策略。有关支持的 headerContentType 和约束，请参阅下表。

以下 JSON 对象表示一个传输策略，该策略指示 Amazon SNS 重试失败的 HTTP/S 传输尝试，如下所示：

在此示例传输策略中，Amazon SNS 在丢弃消息之前，总共会尝试 50 次。要在传输策略中指定的重试用尽后保留消息，请配置您的订阅以将无法交付的消息移动到死信队列 (DLQ)。有关更多信息，请参阅 Amazon SNS 死信队列。

{
    "healthyRetryPolicy": {
        "minDelayTarget": 1,
        "maxDelayTarget": 60,
        "numRetries": 50,
        "numNoDelayRetries": 3,
        "numMinDelayRetries": 2,
        "numMaxDelayRetries": 35,
        "backoffFunction": "exponential"
    },
    "throttlePolicy": {
        "maxReceivesPerSecond": 10
    },
    "requestPolicy": {
        "headerContentType": "application/json"
    }
}

传送策略包含重试策略、节流策略和请求策略。传送策略共有 9 个属性。

Amazon SNS 使用以下公式计算退避阶段的重试次数：

numRetries - numNoDelayRetries - numMinDelayRetries - numMaxDelayRetries

您可以使用三个参数来控制退避阶段的重试频率。

下图显示了每个重试退避函数如何影响退避阶段中与重试关联的延迟时间：一种传输策略，其重试总数设置为 10，最短延迟时间设置为 5 秒，最长延迟时间设置为 260 秒。纵轴以秒为单位表示与 10 次重试中的每个重试相关的延迟。水平轴表示从第 1 次尝试到第 10 次尝试的重试次数。