A tool to create or update Amazon API Gateway APIs from Swagger or RAML definitions.
Amazon API Gateway Importer is a command-line tool that allows developers to create and update APIs on Amazon API Gateway using Swagger or RAML API definition files. It automates the process of importing API specifications into AWS, enabling infrastructure-as-code workflows for API management. The tool was particularly useful before AWS natively supported Swagger import in its standard tools.
Developers and DevOps engineers working with Amazon API Gateway who need to manage APIs programmatically using Swagger or RAML definitions, especially those using RAML which lacks native AWS support.
It provides a scriptable way to import and update API Gateway configurations, supporting both Swagger and RAML formats with AWS-specific extensions. While AWS now offers native Swagger import, this tool remains valuable for RAML users and those who prefer a standalone CLI workflow.
Tools to work with Amazon API Gateway, Swagger, and RAML
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Provides import functionality for RAML API definitions, which AWS's native tools do not support, as explicitly noted in the README's updates section.
Enables scriptable API creation and updates with single commands, ideal for CI/CD pipelines, such as updating and deploying to a stage in one step.
Fully supports API Gateway-specific extensions like x-amazon-apigateway-auth and x-amazon-apigateway-integration, allowing detailed configuration directly in definition files.
Maintains a standalone workflow for teams accustomed to pre-2016 AWS tooling, avoiding immediate migration overhead for existing setups.
The README states the tool receives minimal support from AWS and encourages migration to official tools, risking bugs and compatibility issues with newer AWS services.
Requires building from source with Maven, adding setup steps compared to pre-packaged AWS CLI or SDKs that are easier to install and use.
Likely lacks support for newer API Gateway features introduced after 2016, and for Swagger users, it's redundant since AWS now offers native import.