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 essa entidade em seu modelo AWS Serverless Application Model (AWS SAM), use a sintaxe a seguir.

YAML

  FilterPolicy: SnsFilterPolicy
  FilterPolicyScope: String
  RedrivePolicy: Json
  Region: String
  SqsSubscription: Boolean | SqsSubscriptionObject
  Topic: String

Propriedades

FilterPolicy

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

Tipo: SnsFilterPolicy

Obrigatório: não

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

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

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

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

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

Region

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

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

Tipo: string

Obrigatório: não

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

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

AWS CloudFormation compatibilidade: essa propriedade é exclusiva AWS SAM e não tem AWS CloudFormation equivalente.

Topic

O ARN do tópico que deseja assinar

Tipo: string

Obrigatório: Sim

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

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