Amazon SNS メッセージ配信の再試行

Amazon は、各配信プロトコルの配信ポリシーSNSを定義します。配信ポリシーは、サーバー側のエラーが発生したとき (サブスクライブされたエンドポイントをホストするシステムが使用できなくなったとき) SNS に Amazon がメッセージの配信を再試行する方法を定義します。配信ポリシーを使い果たすと、Amazon は配信の再試行SNSを停止し、デッドレターキューがサブスクリプションにアタッチされていない限り、メッセージを破棄します。詳細については、「Amazon SNSデッドレターキュー」を参照してください。

配信プロトコルとポリシー

1 Firehose プロトコルのスロットリングエラーの場合、Amazon はカスタマーマネージドエンドポイントと同じ配信ポリシーSNSを使用します。

配信ポリシーの段階

次の図は、配信ポリシーの段階を示しています。

各配信ポリシーは、4 つの段階で構成されます。

HTTP/S 配信ポリシーの作成

配信ポリシーとその 4 SNS つのフェーズを使用して、Amazon が HTTP/S エンドポイントへのメッセージの配信を再試行する方法を定義できます。Amazon SNS では、HTTPサーバーの容量に基づいてポリシーをカスタマイズする場合などに、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::Subscription リソースを使用することもできます。

ポリシーがターゲットとする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 はコンテンツタイプを に設定して、すべての通知を HTTP/S エンドポイントSNSに送信しますtext/plain; charset=UTF-8。Amazon SNS では、デフォルトのリクエストポリシーを上書きできます。サポート対象の headerContentType と制約事項については、次の表を参照してください。

次のJSONオブジェクトは、失敗した HTTP/S 配信試行を再試行SNSするように Amazon に指示する配信ポリシーを表しています。

このサンプル配信ポリシーでは、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

3 つのパラメータを使用して、バックオフ段階での再試行の頻度を制御できます。

次の図は、各再試行バックオフ関数が、バックオフ段階での再試行に関連する遅延にどのように影響するかを示しています。再試行の合計回数を 10、最小遅延を 5 秒、最大遅延を 260 秒に設定した配信ポリシーです。縦軸は、10 回ごとの再試行に関連する遅延時間を秒単位で表します。横軸は、最初の試行から 10 回目の試行までの再試行回数を表します。