Azure API Center (プレビュー) とは何か?
API Center は、検出、再利用、ガバナンスのために、一元化された場所ですべての API を追跡することを可能にします。 API Center を使用して、種類、ライフサイクル ステージ、デプロイの場所に関係なく、組織の API の構造化され整理されたインベントリを、関連情報 (バージョンの詳細、API 定義ファイル、共通メタデータなど) と合わせて開発および管理します。
API Center を使用すると、API プログラム マネージャー、IT 管理者、アプリケーション開発者、API 開発者などの組織全体の関係者が API を検出、再利用、管理できます。
重要
- API Center はプレビュー段階です。 このプレビュー バージョンは、サービス レベル アグリーメントなしで提供されます。プレビュー中に、破壊的変更が行われることがあります。 API Center プレビュー データ モデルを変更すると、データが失われる可能性があります。 詳しくは、Microsoft Azure プレビューの追加使用条件に関するページをご覧ください。
- プレビュー期間中は、この GitHub リポジトリで機能の要求、バグの報告、またはその他のフィードバックの提供を行ってください。
Note
API Center は、組織が API インベントリをカタログ化して管理するためのソリューションです。 Azure には、API Management サービスも用意されています。これは、API ゲートウェイを介して組織の API バックエンドを管理、セキュリティ保護、発行するためのソリューションです。 違いについて詳しくはこちらをご覧ください。
メリット
組織のインベントリを作成して維持する - 組織は、組織内で使用可能な API の完全なインベントリを構築できます。 コミュニケーションを促進し、API プログラム マネージャーと開発者が協力して、API の再利用、品質、セキュリティ、コンプライアンス、開発者の生産性を促進できるようにします。
組織の API を管理する - 組織内で作成および使用されている API をより完全に可視化できるため、API プログラム マネージャーと IT 管理者は、API スタイル ガイドラインに準拠するためのカスタム メタデータを定義し、API 定義を分析することで、このインベントリを管理し、組織の標準を確実に満たすことができます。
簡単な API 検出 - 組織は、API の再利用を促進して開発者の生産性を最大化し、開発者が適切な API を確実に使用できるようにしたいと考えています。 API Center を使用すると、プログラム マネージャーと開発者は API インベントリを検出し、組み込みおよびカスタムのメタデータ プロパティを使用してフィルター処理を行うことができます。
API の使用を促進する - API を使用する際の開発者の生産性を最大化し、組織の標準に準拠した安全な方法で API が使用されるようにします。
主な機能
プレビューでは、次の目的のために、Azure portal で API Center を作成して使用します。
API インベントリ管理 - 一元化されたインベントリ内に含めるために、組織のすべての API を登録します。
実際的な API 表現 - OpenAPI 定義などのバージョンと定義を含む各 API に関する実際的な情報を追加します。 API デプロイを一覧表示し、それらをランタイム環境に関連付けます。たとえば、Azure API Management やその他の API 管理ソリューションを表します。
API ガバナンス - 組み込みとカスタムのメタデータ プロパティを使用して API と関連リソースを整理およびフィルター処理し、API ガバナンスと API コンシューマーによる検出を支援します。 API 定義の品質を適用するようにリンティングと分析を設定します。
API の検出と再利用 - 開発者と API プログラム マネージャーが、Azure portal、API Center ポータル、および GitHub Copilot と統合された Visual Studio Code 拡張機能を含む開発者ツールを使用して API を検出できるようにします。
管理できるエンティティと API Center の機能の詳細については、「主要な概念」を参照してください。
対応リージョン
API Center は現在、次の Azure リージョンで使用できます。
- オーストラリア東部
- インド中部
- 米国東部
- 英国南部
- 西ヨーロッパ
API Center と API エコシステム
API Center は、組織の API エコシステムにおいて重要な役割を果たすことができます。 架空の Contoso 組織について考えてみましょう。この組織は、自社のソフトウェア開発と統合における API の重要性を重視し、API ファースト戦略を採用しています。
Contoso の API 開発者、アプリ開発者、API プログラム マネージャー、API マネージャーは、Azure API Center を通じて協力し、組織の API インベントリを開発して使用しています。 次の図と説明をご覧ください。
Contoso の API エコシステムには、次のものが含まれています。
API 開発 - Contoso の開発者は、ASP.NET Web API を定期的にビルドします。 また、HTTP トリガーを使用して Azure Functions も作成します。
API デプロイ環境 - Contoso は、その API の一部を Azure App Service にデプロイします。 別の API のサブセットが Azure 関数アプリにデプロイされます。
API 管理 - Contoso は Azure API Management を使用して、API の管理、発行、セキュリティ保護を行います。 開発、テスト、運用には、それぞれ APIM-DEV、APIM-TEST、APIM-PROD という個別の名前が付いた、個別のインスタンスを使用します。
API Center - Contoso は、API の検出、ガバナンス、使用のための一元化されたハブとして Azure API Center を採用しました。 API Center は、すべての組織 API に関する包括的な情報を提供し、バージョンや関連するデプロイなどの関連情報を維持する、構造化され整理された API ハブとして機能します。
よく寄せられる質問
Q: Azure API Management と Azure API Center の違いは何ですか?
A: Azure API Management は、組織が外部および内部の顧客に API を安全に公開できるようにするフル マネージドの Azure サービスです。 API の作成、公開、管理、および API の使用のセキュリティ、スケーリング、監視を実施するための一連のツールとサービスが用意されています。
一方、Azure API Center は、組織内で使用できる API のカタログを組織が作成するのを支援します。 Azure API Center では、API に関する基本情報 (名前、説明、バージョンなど) が提供されますが、カスタム メタデータを使用すると、これらの API にさらに情報を追加できます。 Azure API Center は、API マネージャーや API 開発者などのさまざまな関係者が組織内の既存の API を検出して再利用できるように支援します。
どちらのサービスでも API を管理するためのツールが提供されますが、目的が異なります。 Azure API Management は API を作成、公開、管理するためのプラットフォームですが、API Center は組織内の既存の API を検出して再利用するための一元的な場所を提供します。
Q: API Management ソリューションで API センターを使用するにはどうすればよいですか?
A: API Center は、Azure API Management や他のプロバイダーからの API 管理サービスを補完するスタンドアロンの Azure サービスです。 API Center は、API ゲートウェイで実行されない API (まだ設計段階の API など) や、別の API 管理ソリューションで管理されている API を含む組織内のすべての API のための統合 API インベントリを提供します。
API Management ソリューションを使用して管理される API の場合、API Center はランタイム環境やデプロイの詳細などのメタデータを保存できます。
Q: データは API Center で暗号化されますか?
A: はい。API センター内のすべてのデータは保存時に暗号化されます。