次の方法で共有

Azure API Management の FAQ

Azure API Management に関する一般的な質問に対する回答を取得します。

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

機能がプレビュー段階にあるとき、Microsoft ではその機能がユーザーにどのように役立っているかについてフィードバックを積極的に求めています。 プレビューの機能は機能的に完了していますが、お客様からのフィードバックに応じて破壊的変更が行われる可能性があります。 運用環境でプレビュー段階にある機能に依存することはお勧めしません。

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

次の場所で発表されている更新情報について通知を購読します。

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

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

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

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

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

あるサブスクリプションから別のサブスクリプションに 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 Functions、Azure Logic Apps、Azure Container Apps、Azure Web Apps など、Azure での API の構築とホストに一般的に使用される Azure コンピューティング サービスとも統合されます。

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 をデプロイするときに必要な最小サブネット サイズは何ですか?

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 では、バックエンド サービスの呼び出し時、末尾のスラッシュがどのように処理されますか?

従来および慣例により、末尾のスラッシュ ( https://contoso.com/sample/ など) で終わる URL はディレクトリとして扱われますが、末尾のスラッシュ (https://contoso.com/sample) のない同じ URL はファイルを示します。 この規則は必須ではありません。 これらの 2 つの URL は一意であると見なされるシステムもあれば、同じものと見なされるシステムもあります。 API Management では区別されないため、1 つの操作resourceresourceまたはresource/を受け入れます。 ただし、バックエンド ホストの区別は重要な場合があります。 一部の Web サーバーでは、末尾のスラッシュで終わらない URL が、末尾のスラッシュで終わる同じ URL に自動的にリダイレクトされます。 API Management はバックエンド (サーバー) へのクライアントであるため、自動リダイレクトは常に望ましいとは限りません。 必要に応じて、 書き換え URL ポリシー を作成して、末尾のスラッシュが常に送信バックエンド呼び出しに追加されるようにします。

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

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

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

API Management を Azure データベース ソリューションと直接統合することはできますか?

はい。仲介者なしで、API Management を他の Azure サービスと直接統合できます。 たとえば、API Management は CRUD 操作用の Azure Cosmos DB REST API と直接統合できるため、Azure Functions などの中間サービスが不要になります。