PutRuntimeManagementConfig - AWS Lambda
Request SyntaxURI 요청 파라미터요청 본문응답 구문응답 요소Errors참고

PutRuntimeManagementConfig

특정 함수 버전의 런타임 관리 구성을 설정합니다. 자세한 내용은 런타임 업데이트를 참조하세요.

Request Syntax

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

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

URI 요청 파라미터

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

FunctionName

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

이 함수의 버전을 지정합니다. 이 값은 $LATEST 또는 게시된 버전 번호일 수 있습니다. 값을 지정하지 않으면 $LATEST 버전의 구성이 반환됩니다.

길이 제약: 최소 길이 1자. 최대 길이 128.

Pattern: (|[a-zA-Z0-9$_-]+)

요청 본문

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

RuntimeVersionArn

함수에 사용할 런타임 버전의 ARN입니다.

참고

이 값은 수동 런타임 업데이트 모드를 사용하는 경우에만 필요합니다.

유형: 문자열

길이 제약: 최소 길이는 26입니다. 최대 길이는 2,048입니다.

패턴: ^arn:(aws[a-zA-Z-]*):lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}::runtime:.+$

필수 항목 여부: 아니요

UpdateRuntimeOn

런타임 업데이트 모드를 지정합니다.

  • 자동(기본값) - 2단계 런타임 버전 롤아웃을 사용하여 가장 최신의 안전한 런타임 버전으로 자동 업데이트합니다. 이 설정은 대부분의 고객에게 있어 항상 런타임 업데이트의 이점을 누릴 수 있는 최선의 옵션입니다.

  • 함수 업데이트 - 함수를 업데이트하면 Lambda가 함수의 런타임을 가장 최신의 안전한 런타임 버전으로 업데이트합니다. 이 접근 방식은 런타임 업데이트를 함수 배포와 동기화함으로써, 사용자가 런타임 업데이트가 적용되는 시점을 제어하고 드물게 발생하는 런타임 업데이트 비호환성을 조기에 감지하여 해결할 수 있게 합니다. 이 설정을 사용하는 경우 런타임을 최신 상태로 유지하려면 함수를 정기적으로 업데이트해야 합니다.

  • 수동 - 사용자가 함수 구성에서 런타임 버전을 지정합니다. 이 런타임 버전이 함수에 무기한으로 사용됩니다. 드문 경우지만 새 런타임 버전이 기존 함수와 호환되지 않는 경우 함수를 이전 런타임 버전으로 롤백할 수 있습니다. 자세한 내용은 런타임 버전 롤백 섹션을 참조하세요.

유형: 문자열

유효 값: Auto | Manual | FunctionUpdate

필수 여부: 예

응답 구문

HTTP/1.1 200
Content-type: application/json

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

응답 요소

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

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

FunctionArn

함수의 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

함수에 사용하도록 구성된 런타임의 ARN입니다. 런타임 업데이트 모드가 수동이면 ARN이 반환되고 그렇지 않으면 null이 반환됩니다.

유형: 문자열

길이 제약: 최소 길이는 26입니다. 최대 길이는 2,048입니다.

패턴: ^arn:(aws[a-zA-Z-]*):lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}::runtime:.+$

UpdateRuntimeOn

런타임 업데이트 모드입니다.

유형: 문자열

유효 값: Auto | Manual | FunctionUpdate

Errors

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

InvalidParameterValueException

요청의 파라미터 중 하나가 유효하지 않습니다.

HTTP 상태 코드: 400

ResourceConflictException

리소스가 이미 있거나 다른 작업이 진행 중입니다.

HTTP 상태 코드: 409

ResourceNotFoundException

요청에 지정된 리소스가 없습니다.

HTTP 상태 코드: 404

ServiceException

AWS Lambda 서비스에 내부 오류가 발생했습니다.

HTTP 상태 코드: 500

TooManyRequestsException

요청 처리량 제한을 초과했습니다. 자세한 내용은 Lambda 할당량을 참조하세요.

HTTP Status Code: 429

참고

이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 설명은 다음을 참조하세요.