SNS

描述SNS事件來源類型的物件。

SAM 在設置此事件類型時生成AWS::SNS::Subscription資源

語法

若要在 AWS Serverless Application Model (AWS SAM) 範本中宣告此實體，請使用下列語法。

YAML

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

屬性

FilterPolicy

指派給訂閱的篩選條件政策 JSON。如需詳細資訊，請參閱 Amazon 簡單通知服務 API 參考GetSubscriptionAttributes中的。

類型:SnsFilterPolicy

必要：否

AWS CloudFormation 兼容性：此屬性直接傳遞給AWS::SNS::Subscription資源的FilterPolicy屬性。

FilterPolicyScope

此屬性可讓您使用下列其中一種字串值類型來選擇篩選範圍：

• MessageAttributes— 篩選器會套用至郵件屬性。

• MessageBody— 篩選器會套用至郵件內文。

類型：字串

必要：否

預設：MessageAttributes

AWS CloudFormation 兼容性：此屬性直接傳遞給AWS::SNS::Subscription資源的 FilterPolicyScope屬性。

RedrivePolicy

如果指定，則會將無法傳遞的訊息傳送到指定的 Amazon SQS 無效信件佇列。由於用戶端錯誤 (例如當訂閱的端點無法連線時) 或伺服器錯誤 (例如提供訂閱端點的服務無法使用) 而無法傳遞的訊息，會保留在無效信件佇列，以供進一步分析或重新處理。

如需重新磁碟原則和無效字母佇列的詳細資訊，請參閱 Amazon SQS 無效字母佇列 (英文) 中的 Amazon SQS 無效字母佇列 (英文)。

類型：Json

必要：否

AWS CloudFormation 兼容性：此屬性直接傳遞給AWS::SNS::Subscription資源的 RedrivePolicy屬性。

Region

針對跨區域訂閱，為主題所在的區域。

如果未指定區域，則 CloudFormation 使用呼叫者的區域作為預設值。

類型：字串

必要：否

AWS CloudFormation 兼容性：此屬性直接傳遞給AWS::SNS::Subscription資源的Region屬性。

SqsSubscription

將此屬性設定為 true，或指定啟SqsSubscriptionObject用 SQS 佇列中的批次處理 SNS 主題通知。將此屬性設定為true建立新的 SQS 佇列，而指定會SqsSubscriptionObject使用現有的 SQS 佇列。

類型：布爾 | SqsSubscriptionObject

必要：否

AWS CloudFormation 兼容性：此屬性是唯一的， AWS SAM 並且沒有相 AWS CloudFormation 等的屬性。

Topic

要訂閱的主題 ARN。

類型：字串

必要：是

AWS CloudFormation 兼容性：此屬性直接傳遞給AWS::SNS::Subscription資源的TopicArn屬性。

範例

SNS 事件來源範例

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