演習 - OpenAPI 対応 Web API を Azure API Management と統合する

完了

この演習では、Visual Studio を使用して、Azure App Service で実行されている Web API アプリケーションを Azure API Management と統合します。

Note

前の演習で、OpenAPI 機能が有効になっている ASP.NET Core Web API アプリを既に用意しています。 この演習では、アプリを使用します。

Visual Studio を使用して Web API アプリケーションを Azure API Management と統合する

Web API アプリケーションを公開する準備ができました。 Web API アプリケーションをデプロイするには、次の手順を実行します。

1. ソリューション エクスプローラーで、プロジェクトを右クリックして、[発行] メニューを選択します。 次のメニューが表示されない場合は、[+ 新しいプロファイル] を選択します。

   

2. [発行] ダイアログ モーダルで [Azure] を選択し、[次へ] ボタンを選択します。

   

3. [Azure App Service (Windows)] を選択し、[次へ] ボタンを選択します。

   

4. 以前のユニットで既に Azure App Service インスタンスに Web API アプリを発行しているので、このダイアログ モーダルで確認できます。 App Service インスタンスを選択し、[次へ] ボタンを選択します。

   

5. 既存の Azure API Management インスタンスを使用することもできますが、Visual Studio を使用して新しいインスタンスを作成してみましょう。 ダイアログ モーダルの ➕ ボタンを選択して、新しい Azure API Management インスタンスを作成します。

   

6. 新しい [API Management 内の API] ダイアログ モーダルがポップアップ表示されたときには、ほとんどの必須フィールド値が既に自動的に設定されています。 事前に設定されたものを使用することも、変更することもできます。 すべてのフィールド値を入力します。 ただし、API Management インスタンスはまだありません。 ダイアログ モーダルの [新規...] ボタンを選択します。

   

7. 新しい Azure API Management インスタンスを作成するための別のポップアップ ダイアログ モーダルが表示されます。 すべてのフィールドの値は既に設定されています。 これらを使用することも、変更することもできます。 次に、[OK] ボタンを選択します。

   

8. [Azure API Management] ダイアログ モーダルが閉じると、[API Management 内の API] モーダルに API Management インスタンス名が表示されます。 [作成] ボタンを選択します。

   

9. Azure API Managementインスタンスで、Web API アプリを Azure App Serviceインスタンスに統合する準備ができています。 [完了] ボタンを選択します。

   

10. Web API アプリをデプロイする準備ができました。 Visual Studio ウィンドウの下部にある [サービスの依存関係] メッセージを確認し、Azure API Management インスタンスも統合用に構成されていることを確認します。 Visual Studio で [発行] ボタンを選択します。

    

11. Web API アプリが発行されると、バナーを通じて Visual Studio からユーザーに通知がなされます。

    

また、Azure API Management インスタンスを作成し、Web API アプリをこれに統合したので、Azure portal で確認できるようになっています。

Azure API Management で Web API の統合を確認する

1. Web API が Azure API Management と統合されているかどうかを確認するには、Web ブラウザーを開き、Azure portal にサインインします。 キーワード API management を、Azure portal の上部にある検索バーに入力します。 [API Management サービス] が表示されたら、これを選択します。

   

2. 自分の Azure API Management インスタンスを選択します。

   

3. 左側のメニューの [API] で、[在庫管理] API を選択します。 /api/WarehouseLocations - GET 操作を選択し、ページの中央にある [テスト] タブを選択します。

   

4. [送信] ボタンを選択して、Web API にテスト要求を送信します。

   

5. API 要求からの応答が表示されます。

   

おめでとうございます。 これで、Visual Studio を使用した、Web API アプリと Azure API Management の統合が終わりました。