今年早些时候，亚马逊网络服务 (AWS) 推出了 Amazon API Gateway - 一种用于管理在云中多个平台上运行的 API 的全面产品。API Gateway 使您能够管理 API 的所有方面，包括定义和更新 Amazon API Gateway 管理的 API 定义的可能性。作为发布的一部分，AWS 还创建了一个命令行工具，使您可以使用 Swagger 定义在 Amazon API Gateway 中创建或更新 API。Swagger 导入器在 GitHub 上可用，任何拥有 AWS 帐户的人都可以使用它。
AWS 副总裁 Marco Argenti 说：“对于客户而言，以大规模构建和运行可靠的 API 是一项重大挑战。然而，这是构建和运营通过多种设备使用的现代应用程序的最重要因素之一。为了帮助客户克服这一难题，我们推出了 Amazon API Gateway。发布 Swagger 导入工具是 Amazon API Gateway 的一个重要里程碑，因为它允许我们的客户与该服务进行交互，而无需以任何重大方式更改其现有工作流程。通过使用 Swagger 进行 API 定义，AWS 客户还可以利用 Swagger 已经可用的所有开源工具，例如文档生成。”
让我们快速逐步演练一下如何使用此工具将 Swagger 定义导入到 Amazon API Gateway 中。
步骤 1 - 创建 AWS 帐户
如果您还没有 AWS 帐户，现在是时候创建一个了。注册后，您可以从 AWS 控制面板访问 API 管理器
步骤 2 - 克隆包含导入器的 GitHub 存储库并在本地构建它
这需要您具备一定的技术能力；您需要在本地安装 git 客户端、java 8 和 maven。首先在您的计算机上创建一个空目录，并在其中运行以下命令
git clone https://github.com/awslabs/aws-apigateway-swagger-importer.git
克隆存储库后，使用以下命令构建该工具。
mvn assembly:assembly
这将运行一段时间，并希望以如下输出结束
步骤 3 - 安装和配置 Amazon 命令行界面 (CLI)
从 http://aws.amazon.com/cli/ 为您的操作系统下载，并按照 http://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html 中的描述进行配置，以便您的系统设置为访问您的 AWS 帐户。
现在您已准备好导入您的 Swagger 定义！
步骤 4 - 导入您的 Swagger！
导入很简单 - 确保您可以访问 Swagger 2.0 定义的本地路径，并运行以下命令（仍在您上面构建的 aws 导入器的文件夹中）
/aws-api-import.sh --create <本地 swagger json 路径>
如果一切顺利，您应该会得到类似于以下内容的输出
（导入的文件是 https://github.com/swagger-api/swagger-spec/blob/master/examples/v2.0/json/petstore-minimal.json 中提供的 swagger 示例）
切换回 AWS 上的 API 管理器控制台，应该会显示您的 API
向下钻取到导入的方法会将您带到
太棒了 - 现在您已准备好通过 Amazon 开始管理您的 API - 请继续阅读有关 Lambda 函数（或 HTTP 代理）的信息：http://docs.aws.amazon.com/apigateway/latest/developerguide/getting-started.html
步骤 5 - 深入了解！
就是这样 - 实际上相当轻松 - 但我们毕竟是在谈论 Swagger 和 AWS，所以您期望什么呢？尽情享受吧！