# PutFunctionEventInvokeConfig
<a name="API_PutFunctionEventInvokeConfig"></a>

함수, 버전 또는 별칭에 대한 [비동기식 호출](https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html) 옵션을 구성합니다. 함수, 버전 또는 별칭에 대한 구성이 이미 있는 경우 이 작업으로 구성을 덮어씁니다. 설정을 제외하면 해당 설정이 제거됩니다. 다른 옵션의 기존 설정에 영향을 주지 않고 한 옵션을 설정하려면 [UpdateFunctionEventInvokeConfig](API_UpdateFunctionEventInvokeConfig.md)을(를) 사용합니다.

기본적으로 Lambda는 함수가 오류를 반환하는 경우 비동기식 호출을 두 번 재시도합니다. 최대 6시간 동안 대기열에 이벤트를 보관합니다. 이벤트가 모든 처리 시도에 실패하거나 비동기식 호출 대기열에 너무 오래 머무르면 Lambda는 이러한 이벤트를 삭제합니다. 삭제된 이벤트를 유지하려면 [UpdateFunctionConfiguration](API_UpdateFunctionConfiguration.md)(으)로 배달 못한 편지 대기열을 구성합니다.

호출 레코드를 대기열, 주제, 함수 또는 이벤트 버스에 보내려면 [대상](https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html#invocation-async-destinations)을 지정합니다. 성공적인 호출(성공 시)과 모든 처리 시도에 실패한 이벤트(실패 시)에 대해 별도의 대상을 구성할 수 있습니다. 배달 못한 편지 대기열 대신에, 또는 이에 더하여 배달 못한 편지 대기열을 구성할 수 있습니다.

## 요청 구문
<a name="API_PutFunctionEventInvokeConfig_RequestSyntax"></a>

```
PUT /2019-09-25/functions/FunctionName/event-invoke-config?Qualifier=Qualifier HTTP/1.1
Content-type: application/json

{
   "DestinationConfig": { 
      "OnFailure": { 
         "Destination": "string"
      },
      "OnSuccess": { 
         "Destination": "string"
      }
   },
   "MaximumEventAgeInSeconds": number,
   "MaximumRetryAttempts": number
}
```

## URI 요청 파라미터
<a name="API_PutFunctionEventInvokeConfig_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [FunctionName](#API_PutFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-request-FunctionName"></a>
Lambda 함수, 버전 또는 별칭의 이름입니다.  

**이름 형식**
+  **함수 이름** - `my-function`(이름만), `my-function:v1`(별칭 포함).
+  **함수 ARN** - `arn:aws:lambda:us-west-2:123456789012:function:my-function`.
+  **부분적 ARN** - `123456789012:function:my-function`.
모든 형식에 버전 번호 또는 별칭을 추가할 수 있습니다. 길이 제한은 전체 ARN에만 적용됩니다. 함수 이름만 지정하는 경우, 길이가 64자로 제한됩니다.  
길이 제약: 최소 길이는 1입니다. 최대 길이는 140입니다.  
Pattern: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}(-gov)?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?`   
필수 항목 여부: 예

 ** [Qualifier](#API_PutFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-request-Qualifier"></a>
버전 번호 또는 별칭 이름입니다.  
길이 제약: 최소 길이는 1입니다. 최대 길이 128.  
Pattern: `(|[a-zA-Z0-9$_-]+)` 

## 요청 본문
<a name="API_PutFunctionEventInvokeConfig_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [DestinationConfig](#API_PutFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-request-DestinationConfig"></a>
처리를 위해 함수로 보낸 후 이벤트의 대상입니다.  

**대상**
+  **Function(함수)** - Lambda 함수의 Amazon 리소스 이름(ARN)입니다.
+  **대기열** - 표준 SQS 대기열의 ARN.
+  **주제** - 표준 SNS 주제의 ARN.
+  **Event Bus(이벤트 버스)** - Amazon EventBridge 이벤트 버스의 ARN입니다.
유형: [DestinationConfig](API_DestinationConfig.md) 객체  
필수 항목 여부: 아니요

 ** [MaximumEventAgeInSeconds](#API_PutFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-request-MaximumEventAgeInSeconds"></a>
Lambda가 처리를 위해 함수에 보내는 요청의 최대 사용 기간입니다.  
유형: Integer  
유효한 범위: 최소값은 60이고 최대값은 21,600입니다.  
필수 항목 여부: 아니요

 ** [MaximumRetryAttempts](#API_PutFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-request-MaximumRetryAttempts"></a>
함수가 오류를 반환할 때 재시도하는 최대 횟수입니다.  
유형: Integer  
유효한 범위: 최소값 0. 최대값은 2입니다.  
Required: No

## 응답 구문
<a name="API_PutFunctionEventInvokeConfig_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "DestinationConfig": { 
      "OnFailure": { 
         "Destination": "string"
      },
      "OnSuccess": { 
         "Destination": "string"
      }
   },
   "FunctionArn": "string",
   "LastModified": number,
   "MaximumEventAgeInSeconds": number,
   "MaximumRetryAttempts": number
}
```

## 응답 요소
<a name="API_PutFunctionEventInvokeConfig_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [DestinationConfig](#API_PutFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-response-DestinationConfig"></a>
처리를 위해 함수로 보낸 후 이벤트의 대상입니다.  

**대상**
+  **Function(함수)** - Lambda 함수의 Amazon 리소스 이름(ARN)입니다.
+  **대기열** - 표준 SQS 대기열의 ARN.
+  **주제** - 표준 SNS 주제의 ARN.
+  **Event Bus(이벤트 버스)** - Amazon EventBridge 이벤트 버스의 ARN입니다.
유형: [DestinationConfig](API_DestinationConfig.md) 객체

 ** [FunctionArn](#API_PutFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-response-FunctionArn"></a>
함수의 Amazon 리소스 이름(ARN)입니다.  
유형: String  
패턴: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}(-gov)?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?` 

 ** [LastModified](#API_PutFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-response-LastModified"></a>
구성이 마지막으로 업데이트된 날짜와 시간(Unix 시간 초)입니다.  
Type: Timestamp

 ** [MaximumEventAgeInSeconds](#API_PutFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-response-MaximumEventAgeInSeconds"></a>
Lambda가 처리를 위해 함수에 보내는 요청의 최대 사용 기간입니다.  
유형: Integer  
유효한 범위: 최소값은 60이고 최대값은 21,600입니다.

 ** [MaximumRetryAttempts](#API_PutFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-response-MaximumRetryAttempts"></a>
함수가 오류를 반환할 때 재시도하는 최대 횟수입니다.  
유형: Integer  
유효한 범위: 최소값 0. 최대값은 2입니다.

## Errors
<a name="API_PutFunctionEventInvokeConfig_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterValueException **   
요청의 파라미터 중 하나가 유효하지 않습니다.  
HTTP 상태 코드: 400

 ** ResourceConflictException **   
리소스가 이미 있거나 다른 작업이 진행 중입니다.  
HTTP 상태 코드: 409

 ** ResourceNotFoundException **   
요청에 지정된 리소스가 없습니다.  
HTTP 상태 코드: 404

 ** ServiceException **   
AWS Lambda 서비스에 내부 오류가 발생했습니다.  
HTTP 상태 코드: 500

 ** TooManyRequestsException **   
요청 처리량 제한을 초과했습니다. 자세한 내용은 [Lambda 할당량](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)을 참조하세요.  
HTTP Status Code: 429

## 참고
<a name="API_PutFunctionEventInvokeConfig_SeeAlso"></a>

이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 설명은 다음을 참조하세요.
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [JavaScript V3용 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/PutFunctionEventInvokeConfig)