Azure API センター とは？
Azure API Center は、検出、再利用、ガバナンスのために、一元化された場所ですべての API を追跡することを可能にします。 API Center を使用して、種類、ライフサイクル ステージ、デプロイの場所に関係なく、関連情報 (バージョンの詳細、API 定義ファイル、共通メタデータなど) とともに、組織の API の構造化され組織化されたインベントリを開発および管理します。
API Center を使用すると、API プログラム マネージャー、IT 管理者、アプリケーション開発者、API 開発者などの組織全体の関係者が API を検出、再利用、管理できます。
Note
Azure API Center は、設計時の API ガバナンスと一元化された API 検出のためのソリューションです。 Azure には、API ゲートウェイを使用したランタイム API ガバナンスと監視用のソリューションである Azure API Management など、補完的なサービスも用意されています。 Azure API Center と API Management の違いと、それらがどのように連携するかについてご確認ください。
メリット
組織のインベントリを作成して維持する - 組織は、組織内で使用可能な API の完全なインベントリを構築できます。 Azure API Management や他のプロバイダーのプラットフォームなど、すべての API 管理ソリューションで管理されている API を登録します。 また、管理されていない API や開発中の API も含めます。 コミュニケーションを促進し、API プログラム マネージャーと開発者が協力して、API の再利用、品質、セキュリティ、コンプライアンス、開発者の生産性を促進できるようにします。
組織の API を管理する - 組織内で作成および使用されている API をより完全に可視化できるため、API プログラム マネージャーと IT 管理者は、API スタイル ガイドラインに準拠するためのカスタム メタデータを定義し、API 定義を分析することで、このインベントリを管理し、組織の標準を確実に満たすことができます。
簡単な API 検出 - 組織は、API の再利用を促進して開発者の生産性を最大化し、開発者が適切な API を確実に使用できるようにしたいと考えています。 Azure API Center を使用すると、プログラム マネージャーと開発者は API インベントリを検出し、組み込みおよびカスタムのメタデータを使用してフィルター処理を行うことができます。
API の使用を促進する - API を使用する際の開発者の生産性を最大化し、組織の標準に準拠した安全な方法で API が使用されるようにします。
主な機能
次の目的のために、 API Center を作成して使用します。
API インベントリ管理 - API 開発者と API プログラム マネージャーは、Azure portal、Azure CLI、CI/CD パイプラインなどの開発者ツール、Azure API Management サービスなどの API ソースへのリンクを使用し、組織のすべての API を登録して一元的なインベントリ内に含めることができます。
API の設計と開発 - Azure API Center for Visual Studio Code 拡張機能を使用して、開発者は API とアプリを作成するのと同じ開発環境から直接 API を登録できます。 開発者は、この拡張機能の GitHub Copilot および GitHub Copilot for Azure との統合を活用して、コードまたは自然言語の記述から API 定義を作成できます。
実際的な API 表現 - OpenAPI 定義などのバージョンと定義を含む各 API に関する実際的な情報を追加します。 API のデプロイを一覧表示し、それらをランタイム環境に関連付けます。たとえば、Azure API Management やその他の API 管理ソリューションを表します。
API ガバナンス - 組み込みとカスタムのメタデータを使用して API と関連リソースを整理およびフィルター処理し、API ガバナンスと API コンシューマーによる検出を支援します。 API 定義の品質を適用するようにリンティングと分析を設定します。
API 開発者は、統合されたリンティング サポートと破壊的変更の検出を使用して、API 設計の適合性チェックのシフトレフトを Visual Studio Code で実施できます。 Dev Proxy などのツールと統合して、アプリが未登録の shadow API または組織の標準を満たしていない API を使用しないようにします。
API の検索と再利用 - エンタープライズ開発者や API プログラム マネージャーが、API Center ポータルか、Azure API Center の Visual Studio Code 拡張機能を使用してアクセスされる API プラットフォーム カタログを介して API を検索できるようにします。
管理できるエンティティと Azure API Center の機能の詳細については、「主要な概念」を参照してください。
対応リージョン
Azure API Center は現在、次の Azure リージョンで使用できます。
- オーストラリア東部
- インド中部
- 米国東部
- 英国南部
- 西ヨーロッパ
API Center は Free プランと Standard プランで提供されます。 詳細情報。
Azure API Center と API エコシステム
Azure 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 関数アプリにデプロイされます。
Azure API Management - Contoso は Azure API Management サービスを使用して、API の管理、発行、セキュリティ保護を行います。 開発、テスト、運用向けに個別のインスタンスを使用し、それぞれに個別の名前を付けます。
Azure API Center - Contoso は、API の検出、ガバナンス、使用のための一元化されたハブとして Azure API Center を採用しました。 API Center は、すべての組織 API に関する包括的な情報を提供し、バージョンや関連するデプロイなどの関連情報を維持する、構造化され整理された API ハブとして機能します。