DeadLetterConfig

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

참고

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 호환성: 이 속성은 AWS::Events::Rule DeadLetterConfig 데이터 유형의 Arn 속성으로 직접 전달됩니다.

QueueLogicalId

if를 AWS SAM 생성하는 데드레터 대기열의 사용자 지정 Type 이름이 지정되었습니다.

참고

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

타입: 문자열

필수 항목 여부: 아니요

AWS CloudFormation 호환성: 이 속성은 AWS SAM 고유하며 AWS CloudFormation 이에 상응하는 속성이 없습니다.

Type

대기열 유형. 이 속성을 설정하면 데드레터 큐를 AWS SAM 자동으로 만들고 필요한 리소스 기반 정책을 첨부하여 이벤트를 큐로 보내는 규칙 리소스에 권한을 부여하는 데 필요한 리소스 기반 정책을 연결합니다.

참고

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

유효한 값: SQS

타입: 문자열

필수 항목 여부: 아니요

AWS CloudFormation 호환성: 이 속성은 AWS SAM 고유하며 이에 상응하는 속성이 없습니다. AWS CloudFormation

예

DeadLetterConfig

DeadLetterConfig

YAML

DeadLetterConfig:
  Type: SQS
  QueueLogicalId: MyDLQ