设置后端 Lambda 函数的异步调用 - Amazon API Gateway
在 API Gateway 控制台中配置 Lambda 异步调用使用 OpenAPI 配置 Lambda 异步调用
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

设置后端 Lambda 函数的异步调用

在 Lambda 非代理（自定义）集成中，默认情况下后端 Lambda 函数是同步调用的。这是大多数 REST API 操作的预期行为。但是，某些应用程序通常需要由某个单独的后端组件进行异步执行（如分批操作或长延迟操作）才能运行。在这种情况下，后端 Lambda 函数将进行异步调用，而且前端 REST API 方法不会返回结果。

您可以通过将 'Event' 指定为 Lambda 调用类型，为要异步调用的 Lambda 非代理集成配置 Lambda 函数。按如下所示完成此操作：

在 API Gateway 控制台中配置 Lambda 异步调用

要使所有调用均为异步，请执行以下操作：

  • 在集成请求中，添加使用静态值 'Event' 的 X-Amz-Invocation-Type 标头。

要让客户端决定调用为异步还是同步，请执行以下操作：

  1. 在方法请求中，添加 InvocationType 标头。

  2. 在集成请求中，添加使用映射表达式 method.request.header.InvocationType 的 X-Amz-Invocation-Type 标头。

  3. 在 API 请求中，对于异步调用，客户端可以包含 InvocationType: Event 标头，对于同步调用则可以包含 InvocationType: RequestResponse。

使用 OpenAPI 配置 Lambda 异步调用

要使所有调用均为异步，请执行以下操作：

  • 将标X-Amz-Invocation-Type题添加到该x-amazon-apigateway-integration部分。

    "x-amazon-apigateway-integration" : {
          "type" : "aws",
          "httpMethod" : "POST",
          "uri" : "arn:aws:apigateway:us-east-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-east-2:123456789012:function:my-function/invocations",
          "responses" : {
            "default" : {
              "statusCode" : "200"
            }
          },
          "requestParameters" : {
            "integration.request.header.X-Amz-Invocation-Type" : "'Event'"
          },
          "passthroughBehavior" : "when_no_match",
          "contentHandling" : "CONVERT_TO_TEXT"
        }

要让客户端决定调用为异步还是同步，请执行以下操作：

  1. 在任何 OpenAPI 路径项对象上添加以下标头。

    "parameters" : [ {
"name" : "InvocationType",
"in" : "header",
"schema" : {
  "type" : "string"
}
} ]

  2. 将标X-Amz-Invocation-Type题添加到x-amazon-apigateway-integration分区。

    "x-amazon-apigateway-integration" : {
          "type" : "aws",
          "httpMethod" : "POST",
          "uri" : "arn:aws:apigateway:us-east-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-east-2:123456789012:function:my-function/invocations",
          "responses" : {
            "default" : {
              "statusCode" : "200"
            }
          },
          "requestParameters" : {
            "integration.request.header.X-Amz-Invocation-Type" : "method.request.header.InvocationType"
          },
          "passthroughBehavior" : "when_no_match",
          "contentHandling" : "CONVERT_TO_TEXT"
        }

  3. 在 API 请求中，对于异步调用，客户端可以包含 InvocationType: Event 标头，对于同步调用则可以包含 InvocationType: RequestResponse。