Azure API Management に関する FAQ

機能がプレビュー段階にある場合は、機能の動作に関するフィードバックを積極的に求めていることを意味します。 プレビュー段階の機能は機能的に完了していますが、お客様からのフィードバックに応じて破壊的変更を加える可能性があります。 運用環境でプレビュー段階にある機能に依存しないことをお勧めします。

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

• Azure API Management リリース ノート。
• Azure の更新プログラム

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

• サブスクリプション キー認証を使用します。 サブスクリプション キー自体は強力な認証形式ではありませんが、多くの場合、別の方法と共に使用されます。 詳細については、「 API Management の認証と承認」を参照してください。
• 「Azure API Management でクライアント証明書認証を使用してバックエンド サービスをセキュリティで保護する方法」の説明に従って、TLS 相互認証を使用します。
• バックエンド サービスで IP フィルタリングを使用します。 従量課金レベルを除く API Management のすべての層では、ゲートウェイの IP アドレスは一定のままです。 詳細については、 Azure API Management の IP アドレスに関するページを参照してください。
• API Management インスタンスを Azure 仮想ネットワークに接続します。
• OAuth 2.0 承認を構成します。 詳細については、「 API Management の認証と承認」を参照してください。

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

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

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

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

• API Management REST API
• .NET、JavaScript、Java、およびその他の言語用の Azure クライアント SDK
• Azure PowerShell と Azure CLI
• Azure Resource Manager ファイルと Bicep ファイル。 クイック スタート テンプレートの例を参照してください。
• Terraform

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

追加するポリシーがポリシー エディターで灰色または網かけで表示される場合は、ポリシーのスコープが正しいことを確認してください。 各ポリシー ステートメントは、特定の スコープとポリシー セクションで使用するように設計されています。 ポリシーのポリシー セクションとスコープを確認するには、ポリシー リファレンスのポリシーの [使用状況] セクションを 参照してください。

テスト環境や運用環境など、複数の環境を 1 つの API で設定するには、2 つのオプションがあります。 次のようにすることができます。

• 同じ API Management インスタンスで異なる API をホストします。
• 異なるインスタンスで同じ API をホストします。

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

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

OpenAPI (Swagger)、WSDL、 WADL 形式の API インポート制限と既知の問題 を参照してください。

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

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

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

はい。

API Management のデプロイに必要な最小サブネット サイズは /29 です。 仮想ネットワークでの API Management の使用の詳細について説明します。

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

詳細については、 API Management の API ゲートウェイ と セルフホステッド ゲートウェイの概要に関するページを参照してください。

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

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

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

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