Arquivamento de mensagens do Amazon SNS para proprietários de tópicos FIFO

O arquivamento de mensagens oferece a capacidade de arquivar uma única cópia de todas as mensagens publicadas no tópico. É possível armazenar mensagens publicadas no tópico habilitando a política de arquivamento de mensagens no tópico, o que permite o arquivamento de mensagens para todas as assinaturas vinculadas a esse tópico. As mensagens podem ser arquivadas por um período mínimo de 1 dia a, no máximo, 365 dias.

Há cobranças adicionais ao definir uma política de arquivamento. Para obter informações sobre preços, consulte Definição de preço do Amazon SNS.

Criar uma política de arquivamento de mensagens usando o AWS Management Console

Como visualizar, editar e desativar uma política de tópico de arquivamento de mensagens

Criar uma política de arquivamento de mensagens usando a API

Para criar uma política de arquivamento de mensagens com a API, é necessário adicionar o atributo ArchivePolicy ao tópico. É possível definir uma ArchivePolicy usando as ações da API CreateTopic e SetTopicAttributes. A ArchivePolicy tem um valor único, MessageRetentionPeriod, que representa o número de dias pelos quais o Amazon SNS retém as mensagens. Para ativar o arquivamento de mensagens para o tópico, defina o MessageRetentionPeriod como um valor inteiro maior que zero. Por exemplo, para reter mensagens em seu arquivo por 30 dias, defina a ArchivePolicy como:

{
    "ArchivePolicy": {
        "MessageRetentionPeriod": "30"
    }
}

Para desativar o arquivamento de mensagens do tópico e limpar o arquivo, cancele a definição da ArchivePolicy da seguinte forma:

{}

Criar uma política de arquivamento de mensagens usando o SDK

Para usar um AWS SDK, configure-o com suas credenciais. Para obter mais informações, consulte Arquivos config e credentials compartilhados no Guia de referência de AWS SDKs e ferramentas.

O exemplo de código a seguir mostra como definir a ArchivePolicy para um tópico do Amazon SNS com o objetivo de reter todas as mensagens publicadas no tópico por 30 dias.

// Specify the ARN of the Amazon SNS topic to set the ArchivePolicy for.
String topicArn =
    "arn:aws:sns:us-east-2:123456789012:MyArchiveTopic.fifo";

// Set the MessageRetentionPeriod to 30 days for the ArchivePolicy.
String archivePolicy =
    "{\"MessageRetentionPeriod\":\"30\"}";

// Set the ArchivePolicy for the Amazon SNS topic
SetTopicAttributesRequest request = new SetTopicAttributesRequest()
    .withTopicArn(topicArn)
    .withAttributeName("ArchivePolicy")
    .withAttributeValue(archivePolicy);
sns.setTopicAttributes(request);

Criar uma política de arquivamento de mensagens com o AWS CloudFormation

Para criar uma política de arquivamento usando o AWS CloudFormation, consulte AWS::SNS::Topic no Guia do usuário do AWS CloudFormation.

Conceder acesso a um arquivo criptografado

Para que um assinante possa começar a reproduzir mensagens de um tópico criptografado, siga as etapas abaixo. Como as mensagens passadas são reproduzidas, o Amazon SNS precisa ter acesso Decrypt provisionado à chave do KMS que foi usada para criptografar as mensagens no arquivo.

Conceder permissões de descriptografia ao Amazon SNS

Para que o Amazon SNS acesse mensagens criptografadas de dentro do arquivo do tópico e as reproduza nos endpoints inscritos, é necessário habilitar o princípio de serviço do Amazon SNS para descriptografar essas mensagens.

Veja a seguir um exemplo da política que é necessária para permitir que a entidade principal do serviço do Amazon SNS descriptografe mensagens armazenadas durante uma reprodução de mensagens históricas do tópico.

{
    "Sid": "Allow SNS to decrypt archived messages",
    "Effect": "Allow",
    "Principal": {
        "Service": "sns.amazonaws.com"
    },
    "Action": [
        "kms:Decrypt",
        "kms:GenerateDataKey"
    ],
    "Resource": "*"
}

Monitorar métricas de arquivo de mensagens com o Amazon CloudWatch

É possível monitorar mensagens arquivadas com o Amazon CloudWatch usando as métricas a seguir. Para receber notificação sobre anomalias nas workloads e ajudar a evitar impactos, é possível configurar os alarmes do Amazon CloudWatch com base nessas métricas. Para obter mais detalhes, consulte Registrar em log e monitorar no Amazon SNS.

A API GetTopicAttributes tem uma propriedade BeginningArchiveTime, que representa o carimbo de data e hora mais antigo no qual um assinante pode iniciar uma reprodução. O seguinte exemplo representa uma resposta para essa ação de API:

{
 "ArchivePolicy": {
    "MessageRetentionPeriod": "<integer>"
  },
  "BeginningArchiveTime": "<timestamp>",
  ...
}