Invoke - AWS Lambda

Invoke

调用 Lambda 函数。您可以同步调用函数(并等待响应),也可以异步调用函数。要异步调用函数,请将 InvocationType 设置为 Event

对于同步调用,有关函数响应的详细信息(包括错误)包含在响应正文和标题中。对于任一调用类型,您可以在执行日志跟踪中找到更多信息。

当发生错误时,您的函数可能会被多次调用。重试行为因错误类型、客户端、事件源和调用类型而异。例如,如果您异步调用函数并返回错误,则 Lambda 最多再执行两次该函数。有关更多信息,请参阅重试行为

对于异步调用,Lambda 会将事件添加到队列,然后将它们发送到函数。如果您的函数没有足够的容量来跟上队列,事件可能会丢失。有时,您的函数可能会多次收到相同的事件,即使没有发生错误。要保留未处理的事件,请使用死信队列配置函数。

API 响应中的状态代码不反映函数错误。错误代码是为阻止函数执行的错误而预留的,例如权限错误、限制错误或与函数的代码和配置有关的问题。例如,如果执行该函数会导致您超过账户级别 (ConcurrentInvocationLimitExceeded) 或函数级别 (ReservedFunctionConcurrentInvocationLimitExceeded) 的并发限制,则 Lambda 将返回 TooManyRequestsException

对于超时很长的函数,在等待响应的同步调用期间,客户端可能会断开连接。配置您的 HTTP 客户端、软件开发工具包、防火墙、代理或操作系统,以允许针对超时或保持活动设置保持长时间的连接。

此操作需要 lambda:InvokeFunction 操作的权限。有关如何设置跨账户调用权限的详细信息,请参阅向其他账户授予函数访问权

请求语法

POST /2015-03-31/functions/FunctionName/invocations?Qualifier=Qualifier HTTP/1.1 X-Amz-Invocation-Type: InvocationType X-Amz-Log-Type: LogType X-Amz-Client-Context: ClientContext Payload

URI 请求参数

请求使用以下 URI 参数。

ClientContext

有关要传递给上下文对象中的函数的调用客户端的 base64 编码数据,最多为 3583 字节。

FunctionName

Lambda 函数的名称、版本或别名。

名称格式

  • 函数名称my-function(仅限名称)、my-function:v1(具有别名)。

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

  • 部分 ARN - 123456789012:function:my-function

您可以将一个版本号或别名附加到任何格式。长度约束仅适用于完整 ARN。如果您仅指定函数名称,它的长度限制为 64 个字符。

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

模式:(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-_]+))?

必需:是

InvocationType

从以下选项中进行选择。

  • RequestResponse(原定设置)– 同步调用函数。保持连接打开,直到函数返回响应或超时。API 响应包括函数响应和其他数据。

  • Event – 异步调用函数。将多次失败的事件发送到函数的死信队列(如果已配置)。API 响应仅包含状态代码。

  • DryRun – 验证参数值并验证用户或角色是否具有调用函数的权限。

有效值: Event | RequestResponse | DryRun

LogType

设置 Tail 以在响应中包含执行日志。仅适用于同步调用的函数。

有效值: None | Tail

Qualifier

指定版本或别名以调用函数的已发布版本。

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

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

请求正文

请求接受以下二进制数据。

Payload

您想要作为输入提供到您的 Lambda 函数的 JSON。

您可以直接输入 JSON。例如:--payload '{ "key": "value" }'。此外,您还可以指定文件路径。例如:--payload file://payload.json

响应语法

HTTP/1.1 StatusCode X-Amz-Function-Error: FunctionError X-Amz-Log-Result: LogResult X-Amz-Executed-Version: ExecutedVersion Payload

响应元素

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

StatusCode

对于成功请求,HTTP 状态代码在 200 范围内。对于 RequestResponse 调用类型,状态代码为 200。对于 Event 调用类型,状态代码为 202。对于 DryRun 调用类型,状态代码为 204。

响应将返回以下 HTTP 标头。

ExecutedVersion

执行的函数的版本。当您调用带有别名的函数时,这将指示别名解析为哪个版本。

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

模式:(\$LATEST|[0-9]+)

FunctionError

如果存在,则表示函数执行过程中发生错误。响应负载中包含有关错误的详细信息。

LogResult

base64 编码执行日志的最后 4KB。

响应将以下内容作为 HTTP 正文返回。

Payload

来自函数或错误对象的响应。

错误

EC2AccessDeniedException

需要额外的权限才能配置 VPC 设置。

HTTP 状态代码:502

EC2ThrottledException

AWS Lambda 是由 Amazon EC2 在 Lambda 函数初始化期间使用为 Lambda 函数提供的执行角色进行节流的。

HTTP 状态代码:502

EC2UnexpectedException

AWS Lambda 在设置 Lambda 函数时收到意外的 EC2 客户端异常。

HTTP 状态代码:502

EFSIOException

从连接的文件系统读取或向其中写入时发生了错误。

HTTP 状态代码:410

EFSMountConnectivityException

该函数无法与配置的文件系统建立网络连接。

HTTP 状态代码:408

EFSMountFailureException

由于权限或配置问题,该函数无法挂载已配置的文件系统。

HTTP 状态代码:403

EFSMountTimeoutException

函数能够连接到配置的文件系统,但挂载操作超时。

HTTP 状态代码:408

ENILimitReachedException

AWS Lambda 无法在 VPC 中创建指定为 Lambda 函数配置的一部分的弹性网络接口,因为已达到网络接口限制。

HTTP 状态代码:502

InvalidParameterValueException

请求中的参数之一无效。

HTTP 状态代码:400

InvalidRequestContentException

请求正文无法解析为 JSON。

HTTP 状态代码:400

InvalidRuntimeException

运行时或运行时版本不受支持。

HTTP 状态代码:502

InvalidSecurityGroupIDException

Lambda 函数 VPC 配置中提供的安全组 ID 无效。

HTTP 状态代码:502

InvalidSubnetIDException

Lambda 函数 VPC 配置中提供的子网 ID 无效。

HTTP 状态代码:502

InvalidZipFileException

AWS Lambda 无法解压缩部署程序包。

HTTP 状态代码:502

KMSAccessDeniedException

Lambda 无法解密环境变量,因为对 KMS 密钥的访问已被拒绝。检查 Lambda 函数的 KMS 权限。

HTTP 状态代码:502

KMSDisabledException

Lambda 无法解密环境变量,因为使用的 KMS 密钥已被禁用。检查 Lambda 函数的 KMS 密钥设置。

HTTP 状态代码:502

KMSInvalidStateException

Lambda 无法解密环境变量,因为所用的 KMS 密钥处于无效的解密状态。检查函数的 KMS 密钥设置。

HTTP 状态代码:502

KMSNotFoundException

Lambda 无法解密环境变量,因为找不到 KMS 密钥。检查函数的 KMS 密钥设置。

HTTP 状态代码:502

RequestTooLargeException

请求负载超过了 Invoke 请求体 JSON 输入限制。有关更多信息,请参阅限制

HTTP 状态代码:413

ResourceConflictException

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

HTTP 状态代码:409

ResourceNotFoundException

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

HTTP 状态代码:404

ResourceNotReadyException

函数处于非活动状态,其 VPC 连接不再可用。等待 VPC 连接重新建立,然后重试。

HTTP 状态代码:502

ServiceException

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

HTTP 状态代码:500

SubnetIPAddressLimitReachedException

由于配置的一个或多个子网没有可用的 IP 地址,因此 AWS Lambda 无法为 Lambda 函数设置 VPC 访问。

HTTP 状态代码:502

TooManyRequestsException

超出了请求吞吐量限制。

HTTP 状态代码:429

UnsupportedMediaTypeException

Invoke 的内容类型请求体不是 JSON。

HTTP 状态代码:415

另请参阅

有关在特定语言的 AWS 软件开发工具包中使用此 API 的更多信息,请参阅以下内容: