今年初，Amazon Web Services (AWS) 推出了 Amazon API Gateway，這是一項功能齊全的產品，用於管理在雲端多個平台上執行的 API。API Gateway 讓您可以管理 API 的各個方面，包括定義和更新由 Amazon API Gateway 管理的 API 定義。作為發佈的一部分，AWS 也建立了一個命令列工具，讓您可以使用 Swagger 定義在 Amazon API Gateway 中建立或更新 API。Swagger 匯入工具可在 GitHub 上供任何擁有 AWS 帳戶的人使用。
「為客戶以大規模建立和執行穩固的 API 是一項重大挑戰。然而，這是建置和操作透過多種裝置使用的現代應用程式的最重要要素之一。為了協助客戶克服此問題，我們推出了 Amazon API Gateway」，AWS 副總裁 Marco Argenti 表示。「發佈 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 Proxy）的資訊：http://docs.aws.amazon.com/apigateway/latest/developerguide/getting-started.html
步驟 5 - 深入研究！
就是這樣，實際上相當簡單，但畢竟我們談論的是 Swagger 和 AWS，所以您還期望什麼呢？盡情享受！