Azure API Management を使用して HTTP エンドポイントからサーバーレス API を公開する

[アーティクル]
12/21/2023

ポータル内で Azure Functions を Azure API Management と統合し、HTTP トリガー関数エンドポイントを REST API として公開できます。これらの API は、OpenAPI 定義を使用して記述されます。この JSON (または YAML) ファイルには、API で使用できる操作に関する情報が含まれています。これには、API の要求と応答のデータを構造化する方法に関する詳細が含まれます。関数アプリを統合することで、API Management はこれらの OpenAPI 定義を生成することができます。

この記事には、関数アプリと API Management を統合する方法が記載されています。この統合は、サポートされている任意の言語で開発された関数アプリに対して機能します。また、Azure API Management から関数アプリをインポートすることもできます。

C# クラスライブラリ関数の場合、Visual Studio を使用して API Management と統合するサーバーレス API を作成および発行することもできます。

API Management インスタンスを作成する

関数アプリにリンクする API Management インスタンスを作成するには:

関数アプリを選択した後、左側のメニューから [API Management] を選択し、 [API Management] で [新規作成] を選択します。

次の表に指定されている API Management の設定を使用してください。

設定	提案された値	Description
名前	グローバルに一意の名前	お使いの関数アプリの名前に基づいて名前が生成されます。
サブスクリプション	該当するサブスクリプション	この新しいリソースが作成されるサブスクリプション。
リソースグループ	myResourceGroup	お使いの関数アプリと同じリソース。自動的に設定されます。
場所	サービスの場所	関数アプリと同じ場所を選択してください。
組織名	Contoso	開発者ポータルとメール通知で使用する組織の名前。
管理者のメールアドレス	ご自分のメールアドレス	API Management からのシステム通知を受信したメールアドレス。
価格レベル	従量課金	従量課金レベルはすべてのリージョンで利用できるわけではありません。価格の詳細については、API Management の価格に関するページを参照してください。

Create new API Management service

[作成] を選択して、API Management インスタンスを作成します。これには数分かかる場合があります。
Azure によってインスタンスが作成されると、ページ上の [Application Insights を有効にする] オプションが有効になります。これを選択してログを関数アプリと同じ場所に送信します。

関数のインポート

API Management インスタンスが作成されると、HTTP によってトリガーされる関数エンドポイントをインポートできます。この例では、TurbineRepair という名前のエンドポイントをインポートします。

[API Management] ページで、 [Link API](API をリンク) を選択します。
[Azure Functions のインポート] が開き、TurbineRepair 関数が強調表示されます。 [選択] を選択して続行します。
[関数アプリから作成する] ページで、既定値をそのまま使用して [作成] を選択します。

Azure によって、関数の API が作成されます。