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
-
Amazon Lambda 服务遇到了内部错误。
HTTP 状态代码:500
- TooManyRequestsException
-
超出了请求吞吐量限制。有关更多信息,请参阅 Lambda 限额。
HTTP 状态代码:429
另请参阅
有关在特定语言的 Amazon SDK 中使用此 API 的更多信息,请参阅以下内容: