PutFunctionConcurrency - AWS Lambda

PutFunctionConcurrency

함수에 대한 최대 동시 실행 횟수를 설정하고 해당 동시성 수준에 대한 용량을 예약합니다.

동시성 설정은 게시된 모든 버전과 게시되지 않은 버전을 포함해 함수 전체에 적용됩니다. 동시성을 예약하면 함수가 지정된 수의 이벤트를 동시에 처리할 수 있는 용량을 갖게 되며 해당 수준 이상으로 확장되지 않습니다. 함수의 현재 설정을 확인하려면 GetFunction을(를) 사용합니다.

리전별 동시성 한도를 확인하려면 GetAccountSettings을(를) 사용합니다. 함수당 한도를 사용해 구성되지 않은 함수에 대해 100개 이상의 동시 실행을 예약되지 않은 상태로 두면 원하는 만큼의 함수에 대해 동시성을 예약할 수 있습니다. 자세한 내용은 Lambda 함수 크기 조정을 참조하세요.

Request Syntax

PUT /2017-10-31/functions/FunctionName/concurrency HTTP/1.1 Content-type: application/json { "ReservedConcurrentExecutions": number }

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-_]+))?

필수 항목 여부: 예

요청 본문

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

ReservedConcurrentExecutions

함수에 대해 예약할 동시 실행의 수입니다.

Type: 정수

유효한 범위: 최소값 0.

Required: Yes

응답 구문

HTTP/1.1 200 Content-type: application/json { "ReservedConcurrentExecutions": number }

응답 요소

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

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

ReservedConcurrentExecutions

이 함수에 예약된 동시 실행 수입니다. 자세한 내용은 Lambda 예약 동시성 관리를 참조하세요.

유형: 정수

유효 범위: 최소값은 0입니다.

Errors

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

InvalidParameterValueException

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

HTTP 상태 코드: 400

ResourceConflictException

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

HTTP 상태 코드: 409

ResourceNotFoundException

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

HTTP 상태 코드: 404

ServiceException

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

HTTP 상태 코드: 500

TooManyRequestsException

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

HTTP Status Code: 429

참고

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