SNS - AWS Serverless Application Model
구문속성예시

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

SNS

SNS 이벤트 소스 유형을 설명하는 객체.

SAM은 이 이벤트 유형이 설정되면 AWS::SNS::Subscription 리소스를 생성합니다.

구문

AWS Serverless Application Model (AWS SAM) 템플릿에서이 개체를 선언하려면 다음 구문을 사용합니다.

속성

FilterPolicy

구독에 할당된 필터 정책 JSON입니다. 자세한 내용은 Amazon Simple Notification Service 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 대기열이 사용됩니다.

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