本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
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 的詳細資訊,請參閱下列說明: