使用 SAM 将 lambda 集成添加到 HttpApi 路由

Question

我目前正在尝试AWS::Serverless::HttpApi与一群AWS::Serverless::Function人进行整合。目标是在 SAM 模板中定义这些资源，并使用 swagger 文件定义实际的 API。

我的 SAM 模板定义如下：

Resources:
  apiPing:
    Type: AWS::Serverless::Function
    Properties:
      Description: 'Ping'
      CodeUri: ../bin/cmd-api-ping.zip
      Handler: cmd-api-ping
      Runtime: go1.x
      Role:
        Fn::GetAtt: apiLambdaRole.Arn
      Events:
        PingEvent:
          Type: HttpApi
          Properties:
            ApiId: !Ref api
            Path: /ping
            Method: post
  api:
    Type: AWS::Serverless::HttpApi
    Properties:
      StageName: prod
      DefinitionBody:
        Fn::Transform:
          Name: AWS::Include
          Parameters:
            Location: swagger.yaml
      AccessLogSettings:
        DestinationArn: !GetAtt accessLogs.Arn
        Format: $context.requestId

还有我的招摇文件：

openapi: 3.0.1
info:
  title: 'API'
  version: 2019-10-13

paths:
  /ping:
    post:
      summary: 'invoke ping'
      operationId: 'apiPing'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PingRequest'
        required: true
      responses:
        '200':
          description: 'Successful'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PongResponse'
      x-amazon-apigateway-integration:
        httpMethod: "POST"
        type: aws_proxy
        uri:
          Fn::Sub: arn:aws:apigateway:${AWS::Region}:lambda:path/2015-03-31/functions/${apiPing.Arn}/invocations
        responses:
          default:
            statusCode: "200"
        contentHandling: "CONVERT_TO_TEXT"
        passthroughBehavior: "when_no_match"
components:
  schemas:
    PingRequest:
      description: 'a ping request'
      type: object
      properties:
        ping:
          description: 'some text'
          type: string
    PongResponse:
      description: 'a pong response'
      type: object
      properties:
        pong:
          description: 'some text'
          type: string

该模板部署时没有任何错误，但是没有附加到/ping POST路由的集成。

CloudFormation 中转换后的模板确实显示了加载的 swagger 文件：

    "api": {
      "Type": "AWS::ApiGatewayV2::Api",
      "Properties": {
        "Body": {
          "info": {
            "version": 1570924800000,
            "title": "API"
          },
          "paths": {
            "/ping": {
              "post": {
                "requestBody": {
                  "content": {
                    "application/json": {
                      "schema": {
                        "$ref": "#/components/schemas/PingRequest"
                      }
                    }
                  },
                  "required": true
                },
                "x-amazon-apigateway-integration": {
                  "contentHandling": "CONVERT_TO_TEXT",
                  "responses": {
                    "default": {
                      "statusCode": "200"
                    }
                  },
                  "uri": {
                    "Fn::Sub": "arn:aws:apigateway:${AWS::Region}:lambda:path/2015-03-31/functions/${apiPing.Arn}/invocations"
                  },
                  "httpMethod": "POST",
                  "passthroughBehavior": "when_no_match",
                  "type": "aws_proxy"
                },
                "summary": "invoke ping",
                "responses": {
                  "200": {
                    "content": {
                      "application/json": {
                        "schema": {
                          "$ref": "#/components/schemas/PongResponse"
                        }
                      }
                    },
                    "description": "Successful"
                  }
                },
                "operationId": "apiPing"
              }
            }
          },
          "openapi": "3.0.1",
          "components": {
            "schemas": {
              "PingRequest": {
                "type": "object",
                "description": "a ping request",
                "properties": {
                  "ping": {
                    "type": "string",
                    "description": "some text"
                  }
                }
              },
              "PongResponse": {
                "type": "object",
                "description": "a pong response",
                "properties": {
                  "pong": {
                    "type": "string",
                    "description": "some text"
                  }
                }
              }
            }
          },
          "tags": [
            {
              "name": "httpapi:createdBy",
              "x-amazon-apigateway-tag-value": "SAM"
            }
          ]
        }
      }
    }

我试图了解我可能需要更改或添加哪些内容才能将集成添加到 http api。我在aws文档中找不到任何明确的解释。

Answer 1

我已经设法解决了这个问题。aws::serverless::httpapi创建AWS::ApiGatewayV2::Api资源。这需要与之前版本的 ApiGateway 不同的集成。

x-amazon-apigateway-integration定义了一个键，payloadFormatVersion. 尽管文档表明 1.0 和 2.0 都受支持，但似乎必须使用 2.0。因此，我的x-amazon-apigateway-integration变成了以下内容（我确实清理了一下）：

x-amazon-apigateway-integration:
  payloadFormatVersion: "2.0"
  httpMethod: "POST"
  type: "aws_proxy"
  uri:
    Fn::Sub: arn:aws:apigateway:${AWS::Region}:lambda:path/2015-03-31/functions/${apiPing.Arn}/invocations
  responses:
    default:
      statusCode: "200"
  connectionType: "INTERNET"

这样，集成就可以在部署时应用。