注意
この記事は、Azure Logic Apps、Microsoft Power Automate、Microsoft Power Apps でのカスタム コネクタの作成と使用、および Microsoft Copilot Studio でのツールとしてのコネクタの呼び出しに関するチュートリアル シリーズの一部です。 カスタム コネクタの概要 を必ず読んで、プロセスを理解してください。
API と OpenAPI
Q: コネクタと API 要求にはどのような制限がありますか
A: 次の表に制限を示します。
| Azure Logic Apps | 制限 |
|---|---|
| 作成できるカスタム コネクタの数 | Azure サブスクリプションあたり 1,000 |
| カスタム コネクタによって作成された接続ごとの 1 分あたりの要求数 | コネクタによって作成された接続ごとに 500 要求 |
| Swagger ファイルで許可されるボディあたりの最大スキーマ数 | 512 |
| Swagger ファイルで許可されている操作の最大数 | 256 |
| Swagger ファイルで許可されている操作あたりのスキーマの最大数 | 16,384 |
| Swagger ファイルで許可されているスキーマの最大数 | Swaggerファイルで許可される操作の最大数* Swaggerファイルで許可される操作ごとのスキーマの最大数 |
| ゲートウェイに送信できるリクエストの最大コンテンツ長 | 3,182,218 |
| Power Automate および Power Apps | 制限 |
|---|---|
| 作成できるカスタム コネクタの数 | 無料プラン: 一つの 1 Office 365 と Dynamics 365 プラン: 一つの ユーザーごとのプラン: 50 |
| カスタム コネクタによって作成された接続ごとの 1 分あたりの要求数 | コネクタによって作成された接続ごとに 10000 要求 |
| ゲートウェイに送信できるリクエストの最大コンテンツ長 | 3,182,218 |
1 無料プランでは、接続やカスタム コネクタを社内の他のユーザーと共有することはできません。 従量課金制の環境はコネクタの動的なスケーリングに対応していないため、作成できるカスタム コネクタの数は 1 つです。
OpenAPI 概要または Postman コレクションを使用してカスタム コネクタを記述する場合、ファイルは 1 MB 未満である必要があります。
Q: コネクタとゲートウェイ経由の操作のサイズ制限はどれくらいですか
A: 制限は ゲートウェイのドキュメントに記載されています。
Q: 私の API では、動的ホストを使用します。 OpenAPI でこれらを実装するにはどうすればよいですか?
A: ポリシー テンプレートを使用して、実行時にホストを動的に変更できます。 詳細については、ホスト URL を設定する を参照してください。
認定資格です
Q: 質問API を所有しておらず、API を使用する明示的な権利もありません。 コネクタを作成できますか?
A: はい、これらのコネクタは、組織内で内部使用するために登録して共有することも、独立した発行元コネクタとして公開することもできます。 コネクタを独立した発行元として認定および一般公開するには、基になるサービスを所有したり、API を使用する明示的な権限を提示する必要は ありません。
Q: 認定はどれくらいの時間がかかりますか?
A: 認定の所要時間は、提出物の品質とテストのスピードによって大きく異なります。 プロセスの問題がなければ、通常 3 〜 5 営業日かかります。 認定後、すべてのリージョンへのデプロイには、さらに 7 から 10 営業日かかります。
Q: 質問提出手順がよくわからない場合や手順の実行に問題がある場合は、どこでサポートを受けることができますか?
A: ヘルプはマイクロソフトの連絡先に接続してください。 また、ドキュメントに対するフィードバックをいただければ、より良いものに改善していくことができます。
Q: コネクタを Premium ではなく Standard コネクタとして認定することはできますか?
A:いいえ。 残念ながら、現時点ではプレミアムとして認定されたコネクタだけがリリースされます。 Power Automate ライセンスをお持ちのユーザーであれば、スタンダードとプレミアムの両方のコネクタをご利用いただけます。
Q: プレビュー タグをコネクタから削除できますか?
A: プレビュー タグを削除する前に、コネクタが特定の要件を満たしている必要があります。 ご利用のコネクタが十分に使用されており、信頼性が高いことを確認してから、マイクロソフトの担当者にお問い合わせください。
Q: コネクタのスロットル制限を調整できますか
A: スロットル制限の調整はケースバイケースで対応します。 コネクタの制限の調整をご希望の場合は、マイクロソフトの担当者にお問い合わせください。
要件
Q: REST API を使用せずにコネクタを構築できますか
A: Power AppsとPower Automateのために、サービスで安定した HTTP REST API をサポートする必要があります。 Logic Apps については、SOAP API を使用するオプションもあります。
Q: API の公開にはどのようなツールを使用できますか?*
A: Azure には、API としてサービスを公開するために使用できる機能やサービスがあります。これには、ホスト用の Azure App Service や API Management などが含まれます。
Q: どのような認証の種類がサポートされています
A: サポートされている次の認証標準を使用できます。
- Microsoft Entra ID、Facebook、Dropbox、GitHub、SalesForce などの特定サービスの OAuth 2.0
- 汎用 OAuth 2.0
- 基本認証
- API キー (オンプレミス データ ゲートウェイを除く)
Q: バックエンド サービスのコネクタでは、どのようなヘッダーを使用できますか?
A: マイクロソフトの次の 4 つのヘッダーを使用できます。
- x-ms-workflow-name
- x-ms-environment-id
- x-ms-workflow-version
- x-ms-workflow-run-id
これらのヘッダーは変更されることがあります。 コネクタを作成する前に、更新プログラムを確認することをお勧めします。
注意
クライアント資格情報付与タイプはサポートしていません。
サポート
Q: コネクタ開発に関する技術的な質問があります。 サポートはどこで得られますか?
A:Power Automate フォーラムのコネクタ開発フォーラム に質問を追加してください。 私たちのチームまたはコミュニティ メンバーが回答します。 同様の問題を検索することもできます。 質問を投稿すると、より広いコミュニティから回答を得ることができ、フォーラムのサポート情報が向上します。
Q: Postman Collection V2 はサポートされています
A: はい、Postman Collection v2 のサポートは 2021 年 10 月の時点で利用できます。
Q: OpenAPI 3.0 をサポートしていますか?
A: いいえ、OpenAPI 2.0 のみが現在サポートされています。 OpenAPI 3 へのサポートはバックログにあります。
Q: コネクタ開発作業に使用できる開発者プランはありますか?
A: はい、Power Apps コミュニティプラン は Power Apps と Power Automate で無料でご利用いただけます。
トリガー
Q: webhook なしでトリガーを構築できますか?
A: Azure Logic Apps と Power Automate のカスタム コネクタでサポートされるのは、Webhook ベースのトリガーとポーリング トリガーです。 Webhook ベースのトリガーはイベントの発生を待機しますが、ポーリング トリガーは指定された頻度でサービスを呼び出して新しいデータをチェックします。 他の実装パターンが必要な場合は、API の詳細を添えて condevhelp@microsoft.com にお問い合わせください。
関連情報
フィードバックを提供する
コネクタ プラットフォームの問題点や新機能のアイデアなど、フィードバックをお待ちしています。 フィードバックを提供するには、「問題を送信するか、コネクタに関するヘルプを入手する」にアクセスし、フィードバックの種類を選択します。