DeadLetterConfig - AWS Serverless Application Model
구문속성예제

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

DeadLetterConfig

대상 호출 실패 후 EventBridge가 이벤트를 전송하는 Amazon Simple Queue Service(Amazon SQS) 대기열을 지정하는 데 사용되는 객체입니다. 예를 들어 존재하지 않는 Lambda 함수로 이벤트를 전송하거나 Lambda 함수를 호출할 권한이 충분하지 않은 경우 간접 호출이 실패할 수 있습니다. 자세한 내용은 Amazon EventBridge 사용자 가이드의 이벤트 재시도 정책 및 DLQ(Dead Letter Queue) 사용을 참조하세요.

참고

AWS::Serverless::Function 리소스 유형에는 유사한 데이터 유형인DeadLetterQueue가 있으며, 이는 대상 Lambda 함수를 성공적으로 호출한 후 발생하는 장애를 처리합니다. 이러한 유형의 실패의 예로는 Lambda 제한 또는 Lambda 대상 함수에서 반환되는 오류가 있습니다. 함수 DeadLetterQueue 속성에 대한 자세한 내용은 AWS Lambda 개발자 가이드의 DLQ(Dead Letter Queue)를 참조하세요.

구문

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

YAML

  Arn: String
  QueueLogicalId: String
  Type: String

속성

Arn

DLQ(Dead Letter Queue)의 대상으로 지정된 Amazon SQS 대기열의 Amazon 리소스 이름(ARN)입니다.

참고

Type 속성 또는 Arn 속성 중 하나만 지정해야 하며, 둘 다 지정할 수는 없습니다.

유형: 문자열

필수 항목 여부: 아니요

AWS CloudFormation호환성: 이 속성은 Arn AWS::Events::Rule 데이터 유형의 DeadLetterConfig 속성에 직접 전달됩니다.

QueueLogicalId

Type가 지정된 경우 AWS SAM이 생성하는 DLQ의 사용자 지정 이름입니다.

참고

Type 속성이 설정되지 않은 경우 이 속성은 무시됩니다.

유형: 문자열

필수 항목 여부: 아니요

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

Type

대기열 유형. 이 속성이 설정되면 AWS SAM은 DLQ를 자동으로 만들고 허가를 부여하기 위해 필요한 리소스 기반 정책을 규칙 리소스에 첨부하여 해당 큐에 이벤트를 전송합니다.

참고

Type 속성 또는 Arn 속성 중 하나만 지정해야 하며, 둘 다 지정할 수는 없습니다.

유효한 값: SQS

유형: 문자열

필수 항목 여부: 아니요

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

예제

DeadLetterConfig

DeadLetterConfig

YAML

DeadLetterConfig:
  Type: SQS
  QueueLogicalId: MyDLQ