SNS - AWS Serverless Application Model
SintaxePropriedadesExemplos

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á.

SNS

O objeto que descreve um tipo de fonte de evento SNS.

O SAM gera recursos AWS::SNS::Subscription quando esse tipo de evento é definido

Sintaxe

Para declarar esta entidade no modelo do AWS Serverless Application Model (AWS SAM), use a seguinte sintaxe:

Propriedades

FilterPolicy

O JSON da política de filtros atribuído à assinatura. Para obter mais informações, consulte GetSubscriptionAttributes na Referência da API do Amazon Simple Notification Service.

Tipo: SNSFilterPolicy

Obrigatório: não

Compatibilidade AWS CloudFormation: essa propriedade é passada diretamente para a propriedade FilterPolicy de um recurso AWS::SNS::Subscription.

FilterPolicyScope

Esse atributo permite que você escolha o escopo da filtragem usando um dos seguintes tipos de valor de string:

  • MessageAttributes – O filtro é aplicado aos atributos de mensagem.

  • MessageBody – O filtro é aplicado ao corpo da mensagem.

Tipo: string

Obrigatório: não

Padrão: MessageAttributes

Compatibilidade AWS CloudFormation: essa propriedade é passada diretamente para a propriedade FilterPolicyScope de um recurso AWS::SNS::Subscription.

RedrivePolicy

Quando especificado, envia mensagens não entregues para a fila de mensagens não entregues do Amazon SQS especificada. As mensagens que não podem ser entregues devido a erros do cliente (por exemplo, quando o endpoint inscrito está inacessível) ou erros do servidor (por exemplo, quando o serviço que ativa o endpoint inscrito se torna indisponível) são mantidas na fila de mensagens não entregues para análise ou reprocessamento adicionais.

Para obter mais informações sobre a política de redirecionamento e filas de mensagens não entregues, consulte Filas de mensagens não entregues do Amazon SQS no Guia do desenvolvedor do Amazon Simple Queue Service.

Tipo: Json

Obrigatório: não

Compatibilidade AWS CloudFormation: essa propriedade é passada diretamente para a propriedade RedrivePolicy de um recurso AWS::SNS::Subscription.

Region

Para assinaturas entre regiões, a região em que o tópico reside.

Se nenhuma região for especificada, o CloudFormation usará a região do chamador como o padrão.

Tipo: string

Obrigatório: não

Compatibilidade AWS CloudFormation: essa propriedade é passada diretamente para a propriedade Region de um recurso AWS::SNS::Subscription.

SqsSubscription

Defina essa propriedade como verdadeira ou especifique SqsSubscriptionObject para habilitar notificações de tópicos do SNS em lotes em uma fila SQS. Definir essa propriedade para true cria uma nova fila SQS, enquanto especificar um SqsSubscriptionObject usa uma fila SQS existente.

Tipo: Boolean | SQSSubscriptionObject

Obrigatório: não

Compatibilidade AWS CloudFormation: Essa propriedade é exclusiva do AWS SAM e não tem AWS CloudFormation equivalente.

Topic

O ARN do tópico que deseja assinar

Tipo: string

Obrigatório: Sim

Compatibilidade AWS CloudFormation: essa propriedade é passada diretamente para a propriedade TopicArn de um recurso AWS::SNS::Subscription.

Exemplos

Exemplo de origem do evento do SNS

Exemplo de origem do evento do SNS

YAML

Events:
  SNSEvent:
    Type: SNS
    Properties:
      Topic: arn:aws:sns:us-east-1:123456789012:my_topic
      SqsSubscription: true
      FilterPolicy:
        store:
          - example_corp
        price_usd:
          - numeric:
              - ">="
              - 100