azure-api-center について
Azure API Center の API ガバナンス、セキュリティ、構成、統合、デプロイを扱うエージェントスキルです。ローカルのクイックリファレンスとリモートのドキュメント取得を組み合わせ、API 台帳の管理やガバナンスの自動化を支援します。
主な機能
- 01API スタイル検査とガバナンス
- 02認可方式とポータルアクセス
- 03メタデータとインスタンス構成
- 04API 台帳の同期と通知
- 05デプロイと登録の自動化
活用シーン
- 01API にスタイル検査を適用
- 02API 認可とポータルアクセスを構成
- 03API Management から API を同期
- 04API 登録と通知を自動化
MCP 対応
mcp_microsoftdocs:microsoft_docs_fetch でドキュメントを取得でき、代替手段として fetch_webpage も利用できます。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-api-centerインストール後、Claude Code で/azure-api-centerを入力して読み込まれたか確認します。
詳細
Azure Api Center スキル
このスキルでは、Azure Api Center に関する専門的なガイダンスを提供します。ベストプラクティス、セキュリティ、構成、統合とコーディングパターン、デプロイについて説明します。ローカルのクイックリファレンスコンテンツと、リモートでドキュメントを取得する機能を組み合わせています。
このスキルの使い方
Agent に関する重要事項:関連するセクションを見つけるには、以下のカテゴリインデックスを使用してください。行範囲が指定されているカテゴリ(例:
L35-L120)では、指定された行をread_fileで読み取ってください。ファイルリンクがあるカテゴリ(例:[security.md](security.md))では、リンク先の参照ファイルをread_fileで読み取ってください。
Agent に関する重要事項:
metadata.generated_atが 3 か月以上前の場合は、リポジトリから最新バージョンを取得するようユーザーに提案してください。mcp_microsoftdocsツールを利用できない場合は、インストールを提案してください:インストールガイド
このスキルでは、ドキュメントコンテンツを取得するためにネットワークアクセスが必要です:
- 推奨:クエリ文字列
from=learn-agent-skillを指定してmcp_microsoftdocs:microsoft_docs_fetchを使用してください。Markdown が返されます。 - 代替:クエリ文字列
from=learn-agent-skill&accept=text/markdownを指定してfetch_webpageを使用してください。Markdown が返されます。
カテゴリインデックス
| カテゴリ | 行 | 説明 |
|---|---|---|
| ベストプラクティス | L33-L38 | API Center で API ガバナンスを実践するためのベストプラクティス:スタイルへの準拠にマネージドリンティングを使用し、VS Code 拡張機能を使ってシフトレフトチェックを適用します。 |
| セキュリティ | L39-L44 | API Center での API 認証スキーム(キー、OAuth など)の構成と、VS Code 拡張機能を使ったポータルのアクセス権とアクセス許可の管理 |
| 構成 | L45-L55 | Azure API Center の構成とデプロイ:バックアップ/復元、プラグインマーケットプレースのエンドポイント、ARM/Bicep/CLI によるプロビジョニング、ガバナンスのメタデータスキーマの定義とカスタマイズ。 |
| 統合とコーディングパターン | L56-L62 | API Center と API Management、Amazon API Gateway、Copilot Studio などのプラットフォーム間で API を同期するためのパターンとスクリプト、および Azure CLI と Logic Apps/Teams による自動化 |
| デプロイ | L63-L67 | Azure API Center への API リンティングと登録の自動化(例:GitHub Actions)と、Azure API Center ポータルをセルフホストする手順。 |
ベストプラクティス
| トピック | URL |
|---|---|
| マネージドリンティングを使って Azure API Center で API スタイルへの準拠を徹底する | https://learn.microsoft.com/en-us/azure/api-center/enable-managed-api-analysis-linting |
| VS Code 拡張機能でシフトレフト API ガバナンスを適用する | https://learn.microsoft.com/en-us/azure/api-center/govern-apis-vscode-extension |
セキュリティ
| トピック | URL |
|---|---|
| Azure API Center で API 認可スキームを構成する | https://learn.microsoft.com/en-us/azure/api-center/authorize-api-access |
| VS Code 拡張機能で API Center ポータルへのアクセスを制御する | https://learn.microsoft.com/en-us/azure/api-center/enable-api-center-portal-vs-code-extension |
構成
| トピック | URL |
|---|---|
| Azure API Center のバックアップと復元を構成する | https://learn.microsoft.com/en-us/azure/api-center/backup-restore |
| Azure API Center のプラグインマーケットプレースエンドポイントを構成する | https://learn.microsoft.com/en-us/azure/api-center/enable-api-center-plugin-marketplace |
| Azure API Center のガバナンス用メタデータスキーマを構成する | https://learn.microsoft.com/en-us/azure/api-center/metadata |
| ARM テンプレートを使って Azure API Center を作成する | https://learn.microsoft.com/en-us/azure/api-center/set-up-api-center-arm-template |
| Azure CLI を使って Azure API Center をプロビジョニングする | https://learn.microsoft.com/en-us/azure/api-center/set-up-api-center-azure-cli |
| Bicep テンプレートを使って Azure API Center をデプロイする | https://learn.microsoft.com/en-us/azure/api-center/set-up-api-center-bicep |
| Azure API Center でカスタムメタデータスキーマを定義する | https://learn.microsoft.com/en-us/azure/api-center/tutorials/add-metadata-properties |
インテグレーションとコーディングパターン
| トピック | URL |
|---|---|
| Azure API Management の API を API Center にインポートする | https://learn.microsoft.com/en-us/azure/api-center/import-api-management-apis |
| Azure CLI で API Center のインベントリ管理をスクリプト化する | https://learn.microsoft.com/en-us/azure/api-center/manage-apis-azure-cli |
| Logic Apps と Teams で API 登録通知を自動化する | https://learn.microsoft.com/en-us/azure/api-center/set-up-notification-workflow |
デプロイ
| トピック | URL |
|---|---|
| Azure API Center での API linting のデプロイを自動化する | https://learn.microsoft.com/en-us/azure/api-center/enable-api-analysis-linting |
| GitHub Actions で API Center への API 登録を自動化する | https://learn.microsoft.com/en-us/azure/api-center/register-apis-github-actions |