編集

Azure API Management の FAQ

  • よく寄せられる質問

Azure API Management についてよく寄せられる質問について回答します。

機能がプレビュー段階とはどういう意味ですか。

機能がプレビュー段階にあるとき、Microsoft ではその機能がユーザーにどのように役立っているかについてフィードバックを積極的に求めています。 プレビュー段階の機能は機能的に完成していますが、お客様からのフィードバックに応じて大きな変更を加える可能性があります。 そのため、プレビュー段階にある機能は運用環境では使用しないことをお勧めします。

API Management の更新と変更について知るにはどうすればよいですか?

次の場所で公開されている更新プログラムのお知らせをサブスクライブします。

API Management ゲートウェイとバックエンド サービス間の接続をセキュリティで保護するにはどうすればよいですか?

API Management ゲートウェイとバックエンド サービス間の接続をセキュリティで保護するには、次のようないくつかのオプションがあります。

新しいインスタンスに API Management サービス インスタンスをコピーするにはどうすればよいですか。

次のようないくつかのオプションがあります:

  • API Management のバックアップと復元の機能を使用します。
  • API Management REST API を使用して独自のバックアップと復元の機能を作成し、目的のサービス インスタンスからのエンティティの保存および復元を行います。
  • Git を使用してサービス構成をダウンロードして、新しいインスタンスにアップロードします。

あるサブスクリプションから別のサブスクリプションに API Management インスタンスを移動できますか?

はい。 方法の詳細については、「Move resources to a new resource group or subscription (新しいリソース グループまたはサブスクリプションへのリソースの移動)」を参照してください。

API Management インスタンスはプログラムで管理できますか。

はい。次のようなさまざまなツールを使用して、プログラムで API Management を管理することができます。

ユーザーを Administrators グループに追加するにはどうすればよいですか。

管理者グループは、Azure サブスクリプション管理者を含む不変のシステム グループです。 このグループにユーザーを追加することはできません。 詳細については、「 Azure API Management でグループを作成および使用して開発者アカウントを管理する方法」をご覧ください。

追加するポリシーがポリシー エディターで利用できないのはなぜですか。

追加するポリシーがポリシー エディターで灰色表示されたり網掛けになったりしている場合は、そのポリシー用の正しいスコープが選択されていることを確認してください。 各ポリシー ステートメントは、特定のスコープおよびポリシー セクションで使用するように設計されています。 ポリシーのセクションとポリシーのスコープを確認するには、ポリシー リファレンスのポリシーの使用方法に関するセクションを参照してください。

1 つの API で複数の環境をセットアップするにはどうすればよいですか。

テスト環境と運用環境など、複数の環境を 1 つの API でセットアップする方法は 2 つあります。 次のようにすることができます。

  • 同じ API Management インスタンス上でさまざまな API をホストします。
  • さまざまなインスタンス上で同じ API をホストします。

API Management でサポートされるのは REST API バックエンドのみですか?

API Management では、REST API と共に、SOAP、WebSocket、GraphQL API へのパススルーがサポートされます。 API Management では、合成 GraphQL API もサポートされます。

API Management は、Azure 上で API を構築およびホスティングするのに一般的に使用される Azure コンピューティング オファリング (Functions、Logic Apps、Container Apps、Web Apps など) とも統合されます。

API のインポートには制限事項や既知の問題はありますか?

OpenAPI (Swagger)、WSDL、および WADL 形式については、「API のインポートに関する制限事項と既知の問題」を参照してください。

API 開発に CI/CD を使用できますか?

はい。 詳細については、「DevOps と CI/CD を使って API を発行する」を参照してください。

アーキテクチャのガイダンスについては、「Azure API Management ランディング ゾーン アクセラレータ」を参照してください。

複数の地理的な場所へのデプロイでは、API Management はどのようなルーティング方法を使用しますか。

API Management では、複数の地理的な場所へのデプロイでパフォーマンス トラフィック ルーティング方法 (最短待機時間) を使用します。 詳細については、「複数の Azure リージョンに Azure API Management サービス インスタンスをデプロイする方法」を参照してください。

API Management は Azure ExpressRoute と共に使用できますか。

はい。

API Management を VNET にデプロイする場合に必要な最小サブネット サイズはどれくらいですか?

API Management をデプロイする場合に必要な最小サブネット サイズは /29 です。 仮想ネットワークで API Management を使用する方法の詳細をご覧ください。

API Management によって Web アプリケーション ファイアウォール (WAF) は提供されますか?

API Management には WAF コンポーネントはありませんが、API Management インスタンスの WAF 上流 (前) をデプロイすることをお勧めします。 たとえば、Azure Application Gateway や Azure Front Door を使います。

マネージド ゲートウェイとセルフホステッド ゲートウェイの違いは何ですか?

詳細については、「API Management の API ゲートウェイ」および「セルフホステッド ゲートウェイの概要」を参照してください。

API Management では、バックエンド サービスの呼び出し時、末尾のスラッシュがどのように処理されますか?

歴史的そして慣例的に、末尾にスラッシュが付く URL、たとえば https://contoso.com/sample/ はディレクトリとして扱われます。一方、末尾のスラッシュがない同じ URL (https://contoso.com/sample) はファイルを表します。 これは必須ではありません。この 2 つの URL を一意と見なすシステムもあれば、同じと見なすものもあります。 API Management では区別されません。したがって resource という 1 つの操作には、resource または resource/ を使用できます。 ただし、その区別がバックエンド ホストでは問題になる可能性があります。 一部の Web サーバーでは、URL の末尾にスラッシュがない場合、同じ URL に末尾のスラッシュが付加されて自動的にリダイレクトされます。 API Management はバックエンド (サーバー) にとってクライアントであるため、自動リダイレクトは必ずしも望ましくありません。 必要であれば、アウトバウンド バックエンド呼び出しに末尾のスラッシュが常に追加されるよう、URL の書き換えポリシーを作成してください。

API Management API の名前は変更できますか?

いいえ。作成後に Azure API Management で API の名前 (または ID) を変更することはできません。 ただし、表示名は変更できます。

API を複製すると、名前に対してシステムで生成された値を使用して新しいインスタンスが作成されますが、これは変更できません。 API の名前を指定するには、手動で新しい API を作成し、API 定義をインポートします。 詳細については、API のインポートに関する記事を参照してください。