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

# OnFailure
<a name="sam-property-function-onfailure"></a>

처리에 실패한 이벤트의 대상입니다.

## 구문
<a name="sam-property-function-onfailure-syntax"></a>

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

### YAML
<a name="sam-property-function-onfailure-syntax.yaml"></a>

```
  [Destination](#sam-function-onfailure-destination): String
  [Type](#sam-function-onfailure-type): String
```

## 속성
<a name="sam-property-function-onfailure-properties"></a>

 `Destination`   <a name="sam-function-onfailure-destination"></a>
대상 리소스의 Amazon 리소스 이름(ARN)입니다.  
*유형*: 문자열  
*필수 항목 여부*: 조건부  
*CloudFormation 호환성*:이 속성은 `AWS::Lambda::EventInvokeConfig` 리소스의 `[OnFailure](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-eventinvokeconfig-onfailure.html)` 속성과 유사합니다. SAM은 이 속성에서 참조되는 리소스에 액세스하는 데 필요한 권한을 이 함수와 관련된 자동 생성 IAM 역할에 추가합니다.  
*추가 참고 사항*: 유형이 Lambda/EventBridge인 경우 대상이 필요합니다.

 `Type`   <a name="sam-function-onfailure-type"></a>
대상에서 참조되는 리소스의 유형입니다. 지원되는 유형은 `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`이 필수입니다.

## 예제
<a name="sam-property-function-onfailure--examples"></a>

### SQS 및 Lambda 대상을 사용한 EventInvoke 구성 예제
<a name="sam-property-function-onfailure--examples--eventinvoke-configuration-example-with-sqs-and-lambda-destinations"></a>

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

#### YAML
<a name="sam-property-function-onfailure--examples--eventinvoke-configuration-example-with-sqs-and-lambda-destinations--yaml"></a>

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

### SNS 대상을 사용한 EventInvoke 구성 예제
<a name="sam-property-function-onfailure--examples--eventinvoke-configuration-example-with-sns-destination"></a>

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

#### YAML
<a name="sam-property-function-onfailure--examples--eventinvoke-configuration-example-with-sns-destination--yaml"></a>

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