azure-api-management
Azure API Managementの開発全般において、トラブルシューティングからセキュリティ、デプロイまで、最適な設計と運用を支援するSkill。
📜 元の英語説明(参考)
Expert knowledge for Azure API Management development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when integrating APIM with LLMs/Event Hubs, securing with OAuth2/JWT/mTLS, or deploying self-hosted gateways, and other Azure API Management related development tasks. Not for Azure Application Gateway (use azure-application-gateway), Azure Front Door (use azure-front-door), Azure Api Center (use azure-api-center), Azure Web Application Firewall (use azure-web-application-firewall).
🇯🇵 日本人クリエイター向け解説
Azure API Managementの開発全般において、トラブルシューティングからセキュリティ、デプロイまで、最適な設計と運用を支援するSkill。
※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。
⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。
🎯 このSkillでできること
下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。
📦 インストール方法 (3ステップ)
- 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
- 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
- 3. 展開してできたフォルダを、ホームフォルダの
.claude/skills/に置く- · macOS / Linux:
~/.claude/skills/ - · Windows:
%USERPROFILE%\.claude\skills\
- · macOS / Linux:
Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。
詳しい使い方ガイドを見る →- 最終更新
- 2026-05-17
- 取得日時
- 2026-05-17
- 同梱ファイル
- 1
📖 Skill本文(日本語訳)
※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。
Azure API Management スキル
このスキルは、Azure API Management に関する専門的なガイダンスを提供します。トラブルシューティング、ベストプラクティス、意思決定、アーキテクチャと設計パターン、制限とクォータ、セキュリティ、構成、統合とコーディングパターン、デプロイメントを網羅しています。ローカルのクイックリファレンスコンテンツとリモートドキュメント取得機能を組み合わせています。
このスキルの使い方
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 を返します。
カテゴリインデックス
| カテゴリ | 行 | 説明 |
|---|---|---|
| トラブルシューティング | L37-L45 | APIM の問題の診断と修正: ポリシーとエラー処理、リクエストのトレース/デバッグ、カスタムドメイン/Key Vault 証明書の失敗、SNAT タイムアウト、ポータルの問題、診断と解決の使用。 |
| ベストプラクティス | L46-L55 | キャッシュ、スロットリング、セキュリティ (OWASP API Top 10)、SSE セットアップ、および Azure API Management の本番環境で Kubernetes 上でセルフホステッドゲートウェイを実行するためのベストプラクティス。 |
| 意思決定 | L56-L76 | APIM のティア/ネットワークの選択、スケーリングとコスト計画、DevOps/CI/CD、移行 (ポータル、ワークスペース、ARM、Amazon API Gateway)、および収益化戦略に関するガイダンス。 |
| アーキテクチャと設計パターン | L77-L83 | App Gateway/WAF、Azure Front Door、または AKS の背後に API Management を配置するためのパターン。ルーティング、セキュリティ、高可用性の参照アーキテクチャを含む。 |
| 制限とクォータ | L84-L101 | API Management の制限、クォータ、および検証ルール: リクエスト/同時実行数の上限、キーごとの帯域幅クォータ、LLM トークン制限、SOAP/WSDL/WebSocket の制約、および validate-* ポリシー。 |
| セキュリティ | L102-L142 | API と開発者ポータルのセキュリティ保護: 認証/認可 (OAuth2、JWT、Entra ID/B2C、mTLS、基本認証)、証明書、RBAC、マネージド ID、セルフホステッドゲートウェイのセキュリティ、およびコンプライアンス/保護制御。 |
| 構成 | L143-L237 | Azure API Management サービス、ゲートウェイ、ポリシー、キャッシュ、ネットワーク、監視、ドメイン、ワークスペース、および開発者ポータルの動作を構成し、ランタイムと運用を制御します。 |
| 統合とコーディングパターン | L238-L269 | API Management を外部サービス (LLM、Event Hubs、Service Bus、Graph、GitHub、Dapr) と統合するためのパターンとサンプル、API のインポート (OpenAPI、SAP、Web アプリ)、およびポリシー/コールアウトの使用。 |
| デプロイメント | L270-L289 | APIM のデプロイとスケーリング: マルチリージョン、VNet とゾーンのセットアップ、セルフホステッドゲートウェイ (AKS/K8s/Docker/Arc)、バックアップ/復元、移行、自動化、およびポータルデプロイメント。 |
トラブルシューティング
| トピック | URL |
|---|---|
| Azure API Management で API リクエストをトレースおよびデバッグする | https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-api-inspector |
| Key Vault 証明書による API Management カスタムドメインの失敗を修正する | https://learn.microsoft.com/en-us/azure/api-management/api-management-troubleshoot-cannot-add-custom-domain |
| API Management の開発者ポータルの FAQ とトラブルシューティング | https://learn.microsoft.com/en-us/azure/api-management/developer-portal-faq |
| Azure API Management API の診断と解決の問題を使用する | https://learn.microsoft.com/en-us/azure/api-management/diagnose-solve-problems |
| Azure API Management での SNAT ポート枯渇とタイムアウトのトラブルシューティング | https://learn.microsoft.com/en-us/azure/api-management/troubleshoot-response-timeout-and-errors |
ベストプラクティス
| トピック | URL |
|---|---|
| Azure API Management で API の応答キャッシュを構成する | https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-cache |
| API Management でカスタムキーベースのキャッシュを実装する | https://learn.microsoft.com/en-us/azure/api-management/api-management-sample-cache-by-key |
| API Management で柔軟なスロットリングポリシーを実装する | https://learn.microsoft.com/en-us/azure/api-management/api-management-sample-flexible-throttling |
| API Management セルフホステッドゲートウェイを Kubernetes 上で本番環境で実行する | https://learn.microsoft.com/en-us/azure/api-management/how-to-self-hosted-gateway-on-kubernetes-in-production |
| Azure API Management API のサーバー送信イベントを構成する | https://learn.microsoft.com/en-us/azure/api-management/how-to-server-sent-events |
| API Management で OWASP API Top 10 の脅威を軽減する | https://learn.microsoft.com/en-us/azure/api-management/mitigate-owasp-api-threats |
意思決定
| トピック | URL |
|---|---|
| スケーリングの決定に API Management の容量メトリックを使用する | https://learn.microsoft.com/en-us/azure/api-management/api-management-capacity |
| 適切な Azure API Management ティアを選択する | https://learn.microsoft.com/en-us/azure/api-management/api-management-features |
| 組み込みの API Management 分析ダッシュボードから Azure Monitor への移行 | https://learn.microsoft.com/en-us/azure/api-management/breaking-changes/analytics-dashboard-retirement-march-2027 |
| 廃止前に Azure API Management ARM API バージョンを移行する | https://learn.microsoft.com/en-us/azure/api-management/breaking-changes/api-version-retirement-sep-2023 |
| API Management で直接管理 API から ARM ベースの API に移行する | https://learn.microsoft.com/en-us/azure/api-management/breaking-chang |
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開
Azure API Management Skill
This skill provides expert guidance for Azure API Management. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.
How to Use This Skill
IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g.,
L35-L120), useread_filewith the specified lines. For categories with file links (e.g.,[security.md](security.md)), useread_fileon the linked reference file
IMPORTANT for Agent: If
metadata.generated_atis more than 3 months old, suggest the user pull the latest version from the repository. Ifmcp_microsoftdocstools are not available, suggest the user install it: Installation Guide
This skill requires network access to fetch documentation content:
- Preferred: Use
mcp_microsoftdocs:microsoft_docs_fetchwith query stringfrom=learn-agent-skill. Returns Markdown. - Fallback: Use
fetch_webpagewith query stringfrom=learn-agent-skill&accept=text/markdown. Returns Markdown.
Category Index
| Category | Lines | Description |
|---|---|---|
| Troubleshooting | L37-L45 | Diagnosing and fixing APIM issues: policies and error handling, request tracing/debugging, custom domain/Key Vault cert failures, SNAT timeouts, portal problems, and using Diagnose and Solve. |
| Best Practices | L46-L55 | Best practices for caching, throttling, security (OWASP API Top 10), SSE setup, and running the self-hosted gateway on Kubernetes in production for Azure API Management. |
| Decision Making | L56-L76 | Guidance on choosing APIM tiers/networking, scaling and cost planning, DevOps/CI/CD, migrations (portals, workspaces, ARM, Amazon API Gateway), and monetization strategies. |
| Architecture & Design Patterns | L77-L83 | Patterns for placing API Management behind App Gateway/WAF, Azure Front Door, or AKS, including routing, security, and high‑availability reference architectures. |
| Limits & Quotas | L84-L101 | Limits, quotas, and validation rules in API Management: request/concurrency caps, per-key and bandwidth quotas, LLM token limits, SOAP/WSDL/WebSocket constraints, and validate-* policies. |
| Security | L102-L142 | Securing APIs and the developer portal: authN/Z (OAuth2, JWT, Entra ID/B2C, mTLS, basic), certificates, RBAC, managed identity, self-hosted gateway security, and compliance/protection controls. |
| Configuration | L143-L237 | Configuring Azure API Management services, gateways, policies, caching, networking, monitoring, domains, workspaces, and developer portal behavior for runtime and operational control. |
| Integrations & Coding Patterns | L238-L269 | Patterns and samples for integrating API Management with external services (LLMs, Event Hubs, Service Bus, Graph, GitHub, Dapr), importing APIs (OpenAPI, SAP, web apps), and using policies/callouts. |
| Deployment | L270-L289 | Deploying and scaling APIM: multi-region, VNet and zone setups, self-hosted gateways (AKS/K8s/Docker/Arc), backup/restore, migration, automation, and portal deployment. |
Troubleshooting
| Topic | URL |
|---|---|
| Trace and debug API requests in Azure API Management | https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-api-inspector |
| Fix API Management custom domain failures with Key Vault certificates | https://learn.microsoft.com/en-us/azure/api-management/api-management-troubleshoot-cannot-add-custom-domain |
| Developer portal FAQ and troubleshooting for API Management | https://learn.microsoft.com/en-us/azure/api-management/developer-portal-faq |
| Use Diagnose and Solve Problems for Azure API Management APIs | https://learn.microsoft.com/en-us/azure/api-management/diagnose-solve-problems |
| Troubleshoot SNAT port exhaustion and timeouts in Azure API Management | https://learn.microsoft.com/en-us/azure/api-management/troubleshoot-response-timeout-and-errors |
Best Practices
| Topic | URL |
|---|---|
| Configure response caching for APIs in Azure API Management | https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-cache |
| Implement custom key-based caching in API Management | https://learn.microsoft.com/en-us/azure/api-management/api-management-sample-cache-by-key |
| Implement flexible throttling policies in API Management | https://learn.microsoft.com/en-us/azure/api-management/api-management-sample-flexible-throttling |
| Run API Management self-hosted gateway on Kubernetes in production | https://learn.microsoft.com/en-us/azure/api-management/how-to-self-hosted-gateway-on-kubernetes-in-production |
| Configure server-sent events for Azure API Management APIs | https://learn.microsoft.com/en-us/azure/api-management/how-to-server-sent-events |
| Mitigate OWASP API Top 10 threats with API Management | https://learn.microsoft.com/en-us/azure/api-management/mitigate-owasp-api-threats |
Decision Making
Architecture & Design Patterns
| Topic | URL |
|---|---|
| Front internal API Management with Application Gateway and WAF | https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-integrate-internal-vnet-appgateway |
| Use API Management with AKS microservices architectures | https://learn.microsoft.com/en-us/azure/api-management/api-management-kubernetes |
| Front Azure API Management with Azure Front Door | https://learn.microsoft.com/en-us/azure/api-management/front-door-api-management |