Split large Amazon API Gateway specs up for easier management

Let’s look at some ways you can create APIs.

Vanilla Cloudformation

You can create API Gateway deployments with vanilla CloudFormation. The resources are AWS::ApiGateway::RestApi and AWS:ApiGateway::HttpApi. This is my least favorite way to create APIs. You have to define every method, permission, integration, and route. It’s extremely verbose and difficult to manage. Generally, I recommend avoiding this method.

Serverless Application Model (SAM)