Exporting api definition from AWS API Gateway

Question

I'm creating an entire API in AWS API Gateway. Since I'm using the graphical console, just because I'm in a learning phase, I will need some way to create the same API programmatically or via the CLI. Is there some facilities to do export the current API set in some way I can reproduce the same structure?

Answer 1

this feature is now available via CLI directly from Amazon. It produces the same output as Amazon's gui console.

swagger

aws apigateway get-export --rest-api-id a1b2c3d4e5 --stage-name dev
--export-type swagger /path/to/filename.json

swagger + api gateway extensions

aws apigateway get-export --parameters extensions='integrations'
--rest-api-id a1b2c3d4e5 --stage-name dev --export-type swagger /path/to/filename.json

swagger + postman extensions

aws apigateway get-export --parameters extensions='postman'
--rest-api-id a1b2c3d4e5 --stage-name dev --export-type swagger /path/to/filename.json

For details: http://docs.aws.amazon.com/cli/latest/reference/apigateway/get-export.html

Answer 2

I've just published a tool for exporting existing APIs from Amazon API Gateway:

Amazon API Gateway Swagger Exporter

https://github.com/isabinin/aws-apigateway-swagger-exporter

Hopefully you'll find it useful.