# PutRuntimeManagementConfig
<a name="API_PutRuntimeManagementConfig"></a>

특정 함수 버전의 런타임 관리 구성을 설정합니다. 자세한 내용은 [런타임 업데이트](https://docs.aws.amazon.com/lambda/latest/dg/runtimes-update.html)를 참조하세요.

## Request Syntax
<a name="API_PutRuntimeManagementConfig_RequestSyntax"></a>

```
PUT /2021-07-20/functions/FunctionName/runtime-management-config?Qualifier=Qualifier HTTP/1.1
Content-type: application/json

{
   "RuntimeVersionArn": "string",
   "UpdateRuntimeOn": "string"
}
```

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

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

 ** [FunctionName](#API_PutRuntimeManagementConfig_RequestSyntax) **   <a name="lambda-PutRuntimeManagementConfig-request-FunctionName"></a>
Lambda 함수의 이름입니다.  

**이름 형식**
+  **함수 이름** - `my-function`.
+  **함수 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_PutRuntimeManagementConfig_RequestSyntax) **   <a name="lambda-PutRuntimeManagementConfig-request-Qualifier"></a>
이 함수의 버전을 지정합니다. 이 값은 `$LATEST` 또는 게시된 버전 번호일 수 있습니다. 값을 지정하지 않으면 `$LATEST` 버전의 구성이 반환됩니다.  
길이 제약: 최소 길이 1자. 최대 길이 128.  
Pattern: `(|[a-zA-Z0-9$_-]+)` 

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

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

 ** [RuntimeVersionArn](#API_PutRuntimeManagementConfig_RequestSyntax) **   <a name="lambda-PutRuntimeManagementConfig-request-RuntimeVersionArn"></a>
함수에 사용할 런타임 버전의 ARN입니다.  
이 값은 **수동** 런타임 업데이트 모드를 사용하는 경우에만 필요합니다.
유형: 문자열  
길이 제약: 최소 길이는 26입니다. 최대 길이는 2,048입니다.  
패턴: `^arn:(aws[a-zA-Z-]*):lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}::runtime:.+$`   
필수 항목 여부: 아니요

 ** [UpdateRuntimeOn](#API_PutRuntimeManagementConfig_RequestSyntax) **   <a name="lambda-PutRuntimeManagementConfig-request-UpdateRuntimeOn"></a>
런타임 업데이트 모드를 지정합니다.  
+  **자동(기본값)** - [2단계 런타임 버전 롤아웃](https://docs.aws.amazon.com/lambda/latest/dg/runtimes-update.html#runtime-management-two-phase)을 사용하여 가장 최신의 안전한 런타임 버전으로 자동 업데이트합니다. 이 설정은 대부분의 고객에게 있어 항상 런타임 업데이트의 이점을 누릴 수 있는 최선의 옵션입니다.
+  **함수 업데이트** - 함수를 업데이트하면 Lambda가 함수의 런타임을 가장 최신의 안전한 런타임 버전으로 업데이트합니다. 이 접근 방식은 런타임 업데이트를 함수 배포와 동기화함으로써, 사용자가 런타임 업데이트가 적용되는 시점을 제어하고 드물게 발생하는 런타임 업데이트 비호환성을 조기에 감지하여 해결할 수 있게 합니다. 이 설정을 사용하는 경우 런타임을 최신 상태로 유지하려면 함수를 정기적으로 업데이트해야 합니다.
+  **수동** - 사용자가 함수 구성에서 런타임 버전을 지정합니다. 이 런타임 버전이 함수에 무기한으로 사용됩니다. 드문 경우지만 새 런타임 버전이 기존 함수와 호환되지 않는 경우 함수를 이전 런타임 버전으로 롤백할 수 있습니다. 자세한 내용은 [런타임 버전 롤백](https://docs.aws.amazon.com/lambda/latest/dg/runtimes-update.html#runtime-management-rollback) 섹션을 참조하세요.
유형: 문자열  
유효 값: `Auto | Manual | FunctionUpdate`   
필수 여부: 예

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

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

{
   "FunctionArn": "string",
   "RuntimeVersionArn": "string",
   "UpdateRuntimeOn": "string"
}
```

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

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

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

 ** [FunctionArn](#API_PutRuntimeManagementConfig_ResponseSyntax) **   <a name="lambda-PutRuntimeManagementConfig-response-FunctionArn"></a>
함수의 ARN  
유형: 문자열  
패턴: `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-_]+))?` 

 ** [RuntimeVersionArn](#API_PutRuntimeManagementConfig_ResponseSyntax) **   <a name="lambda-PutRuntimeManagementConfig-response-RuntimeVersionArn"></a>
함수에 사용하도록 구성된 런타임의 ARN입니다. 런타임 업데이트 모드가 **수동**이면 ARN이 반환되고 그렇지 않으면 `null`이 반환됩니다.  
유형: 문자열  
길이 제약: 최소 길이는 26입니다. 최대 길이는 2,048입니다.  
패턴: `^arn:(aws[a-zA-Z-]*):lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}::runtime:.+$` 

 ** [UpdateRuntimeOn](#API_PutRuntimeManagementConfig_ResponseSyntax) **   <a name="lambda-PutRuntimeManagementConfig-response-UpdateRuntimeOn"></a>
런타임 업데이트 모드입니다.  
유형: 문자열  
유효 값: `Auto | Manual | FunctionUpdate` 

## Errors
<a name="API_PutRuntimeManagementConfig_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_PutRuntimeManagementConfig_SeeAlso"></a>

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