PutProvisionedConcurrencyConfig - AWS Lambda

PutProvisionedConcurrencyConfig

将预置的并发配置添加到函数的别名或版本。

请求语法

PUT /2019-09-30/functions/FunctionName/provisioned-concurrency?Qualifier=Qualifier HTTP/1.1 Content-type: application/json { "ProvisionedConcurrentExecutions": number }

URI 请求参数

请求使用以下 URI 参数。

FunctionName

Lambda 函数的名称。

名称格式
  • 函数名称my-function

  • 函数 ARNarn:aws:lambda:us-west-2:123456789012:function:my-function

  • 部分 ARN123456789012: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-_]+))?

必需:是

Qualifier

版本号或别名。

长度限制:最小长度为 1。长度上限为 128。

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

必需:是

请求体

请求接受采用 JSON 格式的以下数据。

ProvisionedConcurrentExecutions

要为版本或别名分配的预置并发数量。

类型:整数

有效范围:最小值为 1。

必需:是

响应语法

HTTP/1.1 202 Content-type: application/json { "AllocatedProvisionedConcurrentExecutions": number, "AvailableProvisionedConcurrentExecutions": number, "LastModified": "string", "RequestedProvisionedConcurrentExecutions": number, "Status": "string", "StatusReason": "string" }

响应元素

如果此操作成功,则该服务将会发送回 HTTP 202 响应。

服务以 JSON 格式返回以下数据。

AllocatedProvisionedConcurrentExecutions

输入要分配的预置并发数量。在线性部署和金丝雀部署期间使用加权别名时,该值会根据为函数版本预配置的并发量而波动。

类型:整数

有效范围:最小值为 0。

AvailableProvisionedConcurrentExecutions

可用的预置并发数量。

类型:整数

有效范围:最小值为 0。

LastModified

用户上次更新配置的日期和时间,格式为 ISO 8601

类型:字符串

RequestedProvisionedConcurrentExecutions

请求的预置并发数量。

类型:整数

有效范围:最小值为 1。

Status

分配过程的状态。

类型:字符串

有效值:IN_PROGRESS | READY | FAILED

StatusReason

分配失败的原因,即无法分配预置并发的原因。

类型:字符串

错误

有关所有操作返回的常见错误的信息,请参阅 常见错误

InvalidParameterValueException

请求中的参数之一无效。

HTTP 状态代码:400

ResourceConflictException

资源已存在,或者其他操作正在进行中。

HTTP 状态代码:409

ResourceNotFoundException

请求中指定的资源不存在。

HTTP 状态代码:404

ServiceException

AWS Lambda 服务遇到了内部错误。

HTTP 状态代码:500

TooManyRequestsException

超出了请求吞吐量限制。有关更多信息,请参阅 Lambda 限额

HTTP 状态代码:429

另请参阅

有关在特定语言的 AWS SDK 中使用此 API 的更多信息,请参阅以下内容: