# UpdateFunctionEventInvokeConfig
<a name="API_UpdateFunctionEventInvokeConfig"></a>

함수, 버전 또는 별칭에 대한 비동기식 호출의 구성을 업데이트합니다.

비동기식 호출에 대한 옵션을 구성하려면 [PutFunctionEventInvokeConfig](API_PutFunctionEventInvokeConfig.md)을(를) 사용합니다.

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

```
POST /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_UpdateFunctionEventInvokeConfig_RequestParameters"></a>

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

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

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

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

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

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

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

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

## 응답 구문
<a name="API_UpdateFunctionEventInvokeConfig_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_UpdateFunctionEventInvokeConfig_ResponseElements"></a>

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

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

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

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

 ** [FunctionArn](#API_UpdateFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-UpdateFunctionEventInvokeConfig-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_UpdateFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-UpdateFunctionEventInvokeConfig-response-LastModified"></a>
구성이 마지막으로 업데이트된 날짜와 시간(Unix 시간 초)입니다.  
Type: Timestamp

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

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

## Errors
<a name="API_UpdateFunctionEventInvokeConfig_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_UpdateFunctionEventInvokeConfig_SeeAlso"></a>

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