Tentativas de entrega de SNS mensagens da Amazon

A Amazon SNS define uma política de entrega para cada protocolo de entrega. A política de entrega define como a Amazon SNS tenta novamente a entrega de mensagens quando ocorrem erros do lado do servidor (quando o sistema que hospeda o endpoint inscrito fica indisponível). Quando a política de entrega se esgota, a Amazon SNS para de repetir a entrega e descarta a mensagem, a menos que uma fila de mensagens mortas seja anexada à assinatura. Para obter mais informações, consulte Filas de SNS cartas mortas da Amazon.

Protocolos e políticas de entrega

¹ Para erros de limitação com o protocolo Firehose, a Amazon SNS usa a mesma política de entrega dos endpoints gerenciados pelo cliente.

Estágios da política de entrega

O diagrama a seguir mostra as fases de uma política de entrega.

Cada política de entrega é composta por quatro fases.

Criação de uma política de entrega de HTTP /S

Você pode usar uma política de entrega e suas quatro fases para definir como a Amazon SNS tenta novamente a entrega de mensagens para endpoints HTTP /S. A Amazon SNS permite que você substitua a política de repetição padrão para HTTP endpoints quando você pode, por exemplo, querer personalizar a política com base na capacidade do seu HTTP servidor.

Você pode definir suas 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 assinaturas associadas ao tópico. Para definir a política de entrega no nível da assinatura, você pode usar a SetSubscriptionAttributesAPIação Subscribeou. Para definir a política de entrega no nível do tópico, você pode usar a SetTopicAttributesAPIação CreateTopicou. Como alternativa, você também pode usar o recurso AWS::SNS: :Subscription em seus AWS CloudFormation modelos.

Você deve personalizar sua política de entrega de acordo com o 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 servidor que a política visa.

Também é possível definir o cabeçalho Content-Type na política de solicitação para especificar o tipo de mídia da notificação. Por padrão, a Amazon SNS envia todas as notificações para endpoints HTTP /S com o tipo de conteúdo definido como. text/plain; charset=UTF-8 A Amazon SNS permite que você substitua a política de solicitação padrão. Consulte a tabela a seguir para obter detalhes sobre headerContentType compatíveis e restrições.

O JSON objeto a seguir representa uma política de entrega que instrui SNS a Amazon a repetir uma tentativa fracassada de entrega de HTTP /S, da seguinte forma:

Neste exemplo de política de entrega, a Amazon SNS faz um total de 50 tentativas antes de descartar a mensagem. Para manter a mensagem após o esgotamento das novas tentativas especificadas na política de entrega, configure sua assinatura para mover as mensagens não entregues para uma fila de mensagens não entregues (). DLQ Para obter mais informações, consulte Filas de SNS cartas mortas da Amazon.

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

A política de entrega é composta por uma política de novas tentativas, uma política de controle de utilização e uma política de solicitação. No total, há nove atributos em uma política de entrega.

A Amazon SNS usa a seguinte fórmula para calcular o número de novas tentativas na fase de recuo:

numRetries - numNoDelayRetries - numMinDelayRetries - numMaxDelayRetries

É possível usar três parâmetros para controlar a frequência de tentativas na fase de recuo.

O diagrama a seguir mostra como cada função de tentativa de recuo afeta o atraso associado a novas tentativas durante a fase de recuo: Uma política de entrega com o número total de tentativas definido como 10, o atraso mínimo definido como 5 segundos e o atraso máximo definido como 260 segundos. O eixo vertical representa o atraso em segundos associado a cada uma das 10 novas tentativas. O eixo horizontal representa o número de novas tentativas, da primeira à décima.