从 Swagger 设置 APIgateway |以编程方式

Question

我正在尝试使用 Swagger 文件在 APIGateway 中创建多个 API。

现在，当我使用 AWS 控制台时，我手动导入 swagger 文件，然后在创建的每个 API 中添加端点/身份验证。

我想使用 AWS Lambda (Node JS) 完成相同的任务，这样我就可以：

1. 使用 Swagger 创建 API
2. 添加端点（自定义服务器）
3. 添加授权人（cognito）

我查看了AWS documentation，但无法以正确的方式理解它。 如何完成这项任务？

Answer 1

如果你真的必须使用swagger，我会说

• 以swagger json 格式编写您的 API
• 解析它以添加您的API gateway 扩展（端点/授权者/角色）
• 发布它

或者

• 使用给定的swagger 文档创建您的 API
• 将restapi id 传递给lambda 函数
• 使用apigateway SDK（例如NodeJS SDK for APIGateway）获取restapi的资源和方法，并为其添加集成。

但是您考虑过AWS Cloudformation 脚本吗？在我目前的项目中，我已经考虑过您想要做什么，但不是swagger 的专家，我选择了Cloudformation。 （也考虑AWS SAM 和serverless）。它有点重复，但更容易编写和理解。这是 CFN yaml 格式的端点示例 -

ResourceUserActions:
  Type: AWS::ApiGateway::Resource
  DeletionPolicy: Delete
  Properties:
    RestApiId: !Ref RestAPI
    ParentId: !Ref ResourceUser
    PathPart: "{action+}"
UserActionsMethod:
Type: AWS::ApiGateway::Method
Properties:
  RestApiId: !Ref RestAPI
  ResourceId: !Ref ResourceUserActions
  HttpMethod: ANY
  AuthorizationType: COGNITO_USER_POOLS
  AuthorizerId: !Ref ApiAuthorizer
  Integration:
    Type: AWS_PROXY
    IntegrationHttpMethod: POST
    Uri: !Sub arn:aws:apigateway:${AWS::Region}:lambda:path/2015-03-31/functions/${HandlerFunction.Arn}/invocations
    Credentials: !GetAtt ApiGatewayRole.Arn

类型AWS::ApiGateway::Resource 定义一个资源，AWS::ApiGateway::Method 将方法、授权者、集成类型详细信息添加到资源。更多详情请见AWS CFN for APIGateway