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 DLQ(Dead Letter Queue)로 보냅니다. 클라이언트 오류(예: 구독 엔드포인트에 연결할 수 없는 경우) 또는 서버 오류(예: 구독 엔드포인트에 전원을 공급하는 서비스를 사용할 수 없게 된 경우)로 인해 전송할 수 없는 메시지는 추가 분석 또는 재처리를 위해 DLQ(Dead Letter Queue)에 보관됩니다.

리드라이브 정책 및 DLQ(Dead Letter Queue)에 대한 자세한 내용은 Amazon Simple Queue Service 개발자 가이드의 Amazon SQS DLQ를 참조하세요.

유형: 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