我花了一天时间来了解 SAM,尤其是 HttpApi,但遇到了障碍。这是我想要实现的(梦想):
- 在 Open API 3(合约)中创建一个 REST API
- 将 api.yaml 传递给 HttpApi 并让它为 api 生成所有样板文件
- 现在我的 api 文档和我的 api 路由总是相同的(根据合同),感觉温暖的光芒
- 将 Open API 规范交给前端人员和后端人员,让他们在中间很好地见面
我很确定无论如何它应该是这样工作的。但这就是让我感到困惑的地方。我将集成添加到我的 api.yaml 例如:
get:
summary: get item
tags:
- Items
responses:
'200':
description: Item returned successfully
content:
application/json:
schema:
$ref: '#/components/schemas/ItemResource'
'404':
$ref: '#/components/responses/NotFound'
x-amazon-apigateway-integration:
payloadFormatVersion: "2.0"
type: "aws_proxy"
httpMethod: "POST"
uri:
Fn::GetAtt [GetItemFunction, Arn]
connectionType: "INTERNET"
现在我期待通过这个 HttpApi 将我的 OpenApi 文件中的路由与我在集成“GetItemFunction”中指向的 Lambda 连接起来。所以我可以像这样定义我的 Lambda:
GetItemFunction:
Type: AWS::Serverless::Function
Properties:
CodeUri: src/
Handler: get-item.handler
Runtime: nodejs12.x
但这似乎并没有按预期设置路线(我正在使用“sam local start-api”进行测试)。为了让它工作,我需要这样做:
GetItemFunction:
Type: AWS::Serverless::Function
Properties:
CodeUri: src/
Handler: get-item.handler
Runtime: nodejs12.x
Events:
GetAllItems:
Type: HttpApi
Properties:
ApiId: !Ref MyHttpApi
Path: /items/{id}
Method: get
这行得通,但现在我在 template.yaml 文件中定义路由,而不是在 api.yaml 文件中定义,因为我的用例没有达到目的。无论我是否在 api.yaml 中添加“x-amazon-apigateway-integration”,它的行为似乎也完全相同。
我确定我在这里遗漏了一些东西,如果有人能让我走上正确的道路,我将不胜感激!