OnSuccess - AWS Serverless Application Model
명령문속성예시

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

OnSuccess

성공적으로 처리된 이벤트의 대상입니다.

명령문

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

YAML

  Destination: String
  Type: String

속성

Destination

대상 리소스의 Amazon 리소스 이름(ARN)입니다.

유형: 문자열

필수 항목 여부: 조건부

CloudFormation호환성: 이 속성은 OnSuccess 리소스의 AWS::Lambda::EventInvokeConfig 속성과 유사합니다. SAM은 이 속성에서 참조되는 리소스에 액세스하는 데 필요한 권한을 이 함수와 관련된 자동 생성 IAM 역할에 추가합니다.

추가 참고 사항: 유형이 Lambda/EventBridge인 경우 대상이 필요합니다.

Type

대상에서 참조되는 리소스의 유형입니다. 지원되는 유형은 SQS, SNS, S3, Lambda 및 EventBridge입니다.

유형: 문자열

필수 항목 여부: 아니요

CloudFormation호환성: 이 속성은 AWS SAM에 고유하며 CloudFormation 동등한 속성이 없습니다.

추가 참고 사항: 유형이 SQS/SNS이고 Destination 속성이 비어 있는 경우 SAM이 SQS/SNS 리소스를 자동 생성합니다. 리소스를 참조하려면 SQS의 경우 <function-logical-id>.DestinationQueue를, SNS의 경우 <function-logical-id>.DestinationTopic를 사용합니다. 유형이 Lambda/EventBridge인 경우 Destination이 필수입니다.

예시

SQS 및 Lambda 대상을 사용한 EventInvoke 구성 예제

이 예제에서는 SQS OnSuccess 구성에 대해 대상이 제공되지 않으므로 SAM은 묵시적으로 SQS 대기열을 생성하고 필요한 권한을 추가합니다. 또한 이 예제에서는 템플릿 파일에 선언된 Lambda 리소스에 대한 대상 람다 함수가 OnFailure 구성에 지정되어 있으므로 SAM은 대상 Lambda 함수를 직접 호출하는 데 필요한 권한을 이 Lambda 함수에 추가합니다.

YAML

EventInvokeConfig:
  DestinationConfig:
    OnSuccess:
      Type: SQS
    OnFailure:
      Type: Lambda
      Destination: !GetAtt DestinationLambda.Arn  # Arn of a Lambda function declared in the template file.

SNS 대상을 사용한 EventInvoke 구성 예제

이 예제에서는 OnSuccess 구성의 템플릿 파일에 선언된 SNS 주제에 대하여 대상이 제공됩니다.

YAML

EventInvokeConfig:
  DestinationConfig:
    OnSuccess:
      Type: SNS
      Destination:
        Ref: DestinationSNS       # Arn of an SNS topic declared in the tempate file