Dataverse for Teams環境からカスタムコネクタを使ってAPI Management経由で自前のAzure Functionsを呼び出す方法の覚え書きです。

この記事の方法は古いやり方です。
現在はもっと簡単になっています。
https://docs.microsoft.com/ja-jp/azure/api-management/export-api-power-platform

概要

PowerAppsでカスタムコネクタを使って自前/外部APIを呼び出す場合、有償プランかコミュニティプランが必要です。
ただし、Dataverse for Teams環境であればfor Office365プランでもAzure API Managementを経由してAPIに接続可能です。
個人の検証用としてAzureの各サービスは従量課金プランで作成しているので無料枠の範囲内で実現できました。

手順

AzureFunctionsにAPIを発行する。
API ManagementにFunctionsAPIをインポートする
API Managementでテストを実行して定義を作成する
API ManagementからPowerAppsのコネクタをエクスポートする
PowerAppsのコネクタを修正する
PowerAppsからコネクタを呼び出す

Azure FunctionsにAPIを発行する

詳細は割愛します。
Azure上から空の関数アプリを作成しておき、VisualStudioなどお好きな環境、お好きな言語でFunctionsAPIを作成して発行します。
AuthorizationLevelはFunctionにしておきます。

発行された関数

今回のリクエスト、レスポンスの例は以下のようなものです。
PowerAppsで塗り絵アプリを作るため、画像とペン入力画像を合成するAPIのつもりです。

リクエスト

Content-type:application/json
{
    "image_fg_datauri":"data:image/png;base64,iVBORw0KGgoAAAmM～",
    "image_bg_datauri":"data:image/png;base64,iVBORw0KGgoAAAAN～",
    "crop_fg_image":"true",
}

レスポンス

Content-type:application/json
{
"data":"data:image/png～"
}

API ManagementにFunctionsAPIをリンクする

こちらはMSLearnに沿ってやると分かりやすいです。
https://docs.microsoft.com/ja-jp/learn/modules/build-serverless-api-with-functions-api-management/1-introduction

先程の関数アプリの画面に移動し左のブレード→APIセクション→API Managementを選択する
API Managementリソースの新規作成を行う。
- 価格レベルは従量課金プランを選択します。日本リージョンでは利用できないので東アジアリージョンで。
デプロイに時間がかかるので待機し完了するとインスタンスにリンクされている表示がでる。
「APIをリンク」をクリックしてリンクするAPIを選択。
リンクが完了したら、API Managementの画面に移動します

API Managementでテストを実行して定義を作成する

これはAPI Managementサービスの画面からやったほうが操作しやすかったです。
リンクされたAPIをテストして、リクエストやレスポンスの定義を作成します。

サービス画面から先程作成したリソースを開きます。
API→関数アプリ名(先程リンクした)の画面を開きます。
今回はPOSTメソッドしか使わないのでそれ以外のメソッドは…から削除しておきます。
POSTメソッドのAPIをクリックして設計画面を開きます。
Frontendは空白で詳細な定義がまだ追加されていない状態です。
ここで一旦テストを行います。Testタブに移動します。
HeaderやRequestbodyに値を入れて、テストを通過させます。
成功したら、テスト画面のRequestBodyとResponseBodyの右上の「Generate definition」をクリックして定義を作成します。
「Save as definition for this request?」にチェックを入れ、「CreateDefinition」をクリックして定義を作成します。