Amazon SNS 訊息交付重試

Amazon 會為每個交付通訊協定SNS定義交付政策。 交付政策定義 Amazon SNS 如何在發生伺服器端錯誤 （託管訂閱端點的系統無法使用） 時重試訊息交付。交付政策用盡時，Amazon 會SNS停止重試交付並捨棄訊息，除非無效字母佇列已連接至訂閱。如需詳細資訊，請參閱Amazon SNS無效字母佇列。

傳遞通訊協定和政策

1 對於 Firehose 通訊協定的限流錯誤，Amazon SNS會使用與客戶受管端點相同的交付政策。

傳遞政策階段

下圖顯示傳遞政策的各個階段。

每個傳遞政策都是由四個階段組成。

建立 HTTP/S 交付政策

您可以使用交付政策及其四個階段來定義 Amazon SNS 如何重試將訊息交付至 HTTP/S 端點。例如，當您可能想要根據HTTP伺服器容量自訂政策時，Amazon SNS可讓您覆寫HTTP端點的預設重試政策。

您可以設定與主題相關聯的HTTP/S delivery policy as a JSON object at the subscription or topic level. When you define the policy at the topic level, it applies to all HTTP/S訂閱。若要在訂閱層級設定交付政策，您可以使用 Subscribe或 SetSubscriptionAttributesAPI動作。若要在主題層級設定交付政策，您可以使用 CreateTopic或 SetTopicAttributesAPI動作。或者，您也可以在 AWS CloudFormation 範本中使用 AWS：：SNS：：訂閱資源。

您應該根據政策目標的HTTP/S server's capacity. You can set the policy as a topic attribute or a subscription attribute. If all HTTP/S subscriptions in your topic target the same HTTP/S server, we recommend that you set the delivery policy as a topic attribute, so that it remains valid for all HTTP/S subscriptions in the topic. Otherwise, you must compose a delivery policy for each HTTP/S subscription in your topic, according the capacity of the 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 次重試的每一次相關的延遲 (以秒為單位)。水平軸代表重試次數，從第一次到第十次嘗試。