Configurar uma fila de mensagens não entregues do Amazon SNS para uma assinatura - Amazon Simple Notification Service
Pré-requisitosAWS Management ConsoleAWS SDKsAWS CLIAWS CloudFormation

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Configurar uma fila de mensagens não entregues do Amazon SNS para uma assinatura

Uma fila de mensagens mortas é uma fila do Amazon SQS para a qual uma assinatura do Amazon SNS pode enviar mensagens que não podem ser entregues aos assinantes com êxito. As mensagens que não podem ser entregues devido a erros do cliente ou erros do servidor são mantidas na fila de mensagens mortas para análise ou reprocessamento adicionais. Para ter mais informações, consulte Filas de mensagens não entregues do Amazon SNS e Novas tentativas de entrega de mensagens do Amazon SNS.

Esta página mostra como você pode usar o AWS Management Console, um AWS SDK AWS CLI, o e AWS CloudFormation para configurar uma fila de mensagens mortas para uma assinatura do Amazon SNS.

nota

Em um tópico FIFO, você pode usar uma fila do Amazon SQS como uma fila de mensagens não entregues para a assinatura do Amazon SNS. As assinaturas de tópicos FIFO usam filas FIFO e as de tópicos padrão usam filas padrão.

Pré-requisitos

Antes de configurar uma fila de mensagens não entregues, complete os seguintes pré-requisitos:

  1. Crie um tópico do Amazon SNS chamado MyTopic.

  2. Crie uma fila do Amazon SQS chamada MyEndpoint, para ser usada como endpoint para a assinatura do Amazon SNS.

  3. (Ignorar para AWS CloudFormation) Inscreva-se na fila do tópico.

  4. Crie outra fila do Amazon SQS chamada MyDeadLetterQueue, para ser usada como a fila de mensagens mortas para a assinatura do Amazon SNS.

  5. Para conceder à entidade principal do Amazon SNS acesso à ação da API do Amazon SQS, defina a seguinte política de fila para MyDeadLetterQueue.

    {
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "sns.amazonaws.com"
      },
      "Action": "SQS:SendMessage",
      "Resource": "arn:aws:sqs:us-east-2:123456789012:MyDeadLetterQueue",
      "Condition": {
        "ArnEquals": {
          "aws:SourceArn": "arn:aws:sns:us-east-2:123456789012:MyTopic"
        }
      }
    }
  ]
}

Para configurar uma fila de mensagens mortas para uma assinatura do Amazon SNS usando o AWS Management Console

Verifique os pré-requisitos antes de começar este tutorial.

  1. Faça login no console do Amazon SQS.

  2. Crie uma fila do Amazon SQS ou use uma fila existente e anote o ARN da fila na guia Detalhes da fila, por exemplo:

    arn:aws:sqs:us-east-2:123456789012:MyDeadLetterQueue

  3. Faça login no console do Amazon SNS.

  4. No painel de navegação, escolha Subscriptions (Assinaturas).

  5. Na página Assinaturas selecione uma inscrição existente e escolha Editar.

  6. Na 1234a567-bc89-012d-3e45-6fg7h890123i página Editar, expanda a seção Política do Redrive (fila de mensagens mortas) e faça o seguinte:

    1. Selecione Ativado.

    2. Especifique o ARN de uma fila do Amazon SQS.

  7. Escolha Salvar alterações.

    A inscrição estará configurada para usar uma fila de mensagens não entregues.

Para configurar uma fila de mensagens mortas para uma assinatura do Amazon SNS usando um SDK AWS

Antes de executar este exemplo, verifique se você preencheu os pré-requisitos.

Para usar um AWS SDK, você deve configurá-lo com suas credenciais. Para obter mais informações, consulte Os arquivos compartilhados de configuração e credenciais no Guia de referência de ferramentas AWS SDKs e ferramentas.

O código de exemplo a seguir mostra como usar SetSubscriptionAttributesRedrivePolicy.

Java
SDK para Java 1.x
nota

Tem mais sobre GitHub. Encontre o exemplo completo e saiba como configurar e executar no Repositório de exemplos de código da AWS. 

// Specify the ARN of the Amazon SNS subscription.
String subscriptionArn =
    "arn:aws:sns:us-east-2:123456789012:MyEndpoint:1234a567-bc89-012d-3e45-6fg7h890123i";

// Specify the ARN of the Amazon SQS queue to use as a dead-letter queue.
String redrivePolicy =
    "{\"deadLetterTargetArn\":\"arn:aws:sqs:us-east-2:123456789012:MyDeadLetterQueue\"}";

// Set the specified Amazon SQS queue as a dead-letter queue
// of the specified Amazon SNS subscription by setting the RedrivePolicy attribute.
SetSubscriptionAttributesRequest request = new SetSubscriptionAttributesRequest()
    .withSubscriptionArn(subscriptionArn)
    .withAttributeName("RedrivePolicy")
    .withAttributeValue(redrivePolicy);
sns.setSubscriptionAttributes(request);

Para configurar uma fila de mensagens mortas para uma assinatura do Amazon SNS usando o AWS CLI

Verifique os pré-requisitos antes de começar este tutorial.

  1. Instale e configure a AWS CLI. Para obter mais informações, consulte o Guia do usuário do AWS Command Line Interface .

  2. Use o seguinte comando.

    aws sns set-subscription-attributes \
--subscription-arn arn:aws:sns:us-east-2:123456789012:MyEndpoint:1234a567-bc89-012d-3e45-6fg7h890123i
--attribute-name RedrivePolicy
--attribute-value "{\"deadLetterTargetArn\": \"arn:aws:sqs:us-east-2:123456789012:MyDeadLetterQueue\"}"

Para configurar uma fila de mensagens mortas para uma assinatura do Amazon SNS usando AWS CloudFormation

Verifique os pré-requisitos antes de começar este tutorial.

  1. Copie o seguinte código JSON em um arquivo denominado MyDeadLetterQueue.json.

    {
  "Resources": {
    "mySubscription": {
      "Type" : "AWS::SNS::Subscription",
      "Properties" : {
        "Protocol": "sqs",
        "Endpoint": "arn:aws:sqs:us-east-2:123456789012:MyEndpoint",
        "TopicArn": "arn:aws:sns:us-east-2:123456789012:MyTopic",
        "RedrivePolicy": {
          "deadLetterTargetArn":
            "arn:aws:sqs:us-east-2:123456789012:MyDeadLetterQueue"
        }
      }
    }
  }
}

  2. Faça login no console do AWS CloudFormation.

  3. Na página Selecionar modelo, selecione Fazer upload de um modelo no Amazon S3, selecione o arquivo MyDeadLetterQueue.json e escolha Próximo.

  4. Na página Especificar detalhes, digite MyDeadLetterQueue em Nome da pilha e escolha Próximo.

  5. Na página Options (Opções), escolha Next (Avançar).

  6. Na página Revisar, escolha Criar.

    AWS CloudFormation começa a criar a MyDeadLetterQueue pilha e exibe o status CREATE_IN_PROGRESS. Quando o processo estiver concluído, AWS CloudFormation exibirá o status CREATE_COMPLETE.