先週12/17 のJAWS-UGアーキテクチャー専門支部の中でインタラクティブなWEBドキュメントを作成できるSwaggerからAWS APIGateway にインポートするツールを試してみました。

Amazon Swagger Importerは下記で取得します。

git clone https://github.com/awslabs/aws-apigateway-swagger-importer.git

• Apache Maven 3.3.9

mvn assembly:assembly

コマンド自体はこれで実行が可能ですが、credentialsの設定が必要です。

aws-api-import.cmd --create --region ap-northeast-1 path/to/swagger.json

credentialsですが、role_arn、source_profile プロパティは使用することはできません。つまり、STS経由でアクセスすることはできません。

Swaggerでエクスポートしたものをインポートして、同じ状態で復元できました。

Swaggerはswagger-editor等ツールも充実しているので、SwaggerでAPIを設計して、API Gatewayにインポートする使い方もできると思われる。