PutFunctionConcurrency - AWS Lambda

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

PutFunctionConcurrency

設定函數的並行執行數上限,並預留該並行層級的容量。

並行設定會套用至整個函數,包括所有已發佈的版本和未發佈的版本。保留並行可確保您的函數有能力同時處理指定數量的事件,並防止它擴展超出該級別。使用 GetFunction 查看函數的目前設定。

使用 GetAccountSettings 查看您的區域並行限制。您可以根據需要為盡可能多的函數保留並行,只要對未設定每個函數限制的函數維持至少 100 個同時執行處於未預留狀態。如需詳細資訊,請參閱 Lambda 函數擴展

請求語法

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。

模式:(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

要為函數預留的同時執行數。

類型:整數

有效範圍:最小值為 0。

必要:是

回應語法

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

回應元素

如果動作成功,則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

ReservedConcurrentExecutions

為此函數保留的並行執行數目。如需詳細資訊,請參閱管理 Lambda 預留並行

類型:整數

有效範圍:最小值為 0。

錯誤

如需所有動作常見錯誤的資訊,請參閱常見錯誤

InvalidParameterValueException

請求中的其中一個參數無效。

HTTP 狀態碼:400

ResourceConflictException

資源已存在,或另一個操作正在進行中。

HTTP 狀態碼:409

ResourceNotFoundException

請求中指定的資源不存在。

HTTP 狀態碼:404

ServiceException

AWS Lambda 服務發生內部錯誤。

HTTP 狀態碼:500

TooManyRequestsException

超出請求輸送量限制。如需詳細資訊,請參閱 Lambda 配額

HTTP 狀態碼:429

另請參閱

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊,請參閱下列說明: