azure-resource-graph について
Azure Resource Graphを扱うエージェント向けのガイダンススキルです。ローカルの参照情報とネットワーク経由で取得するドキュメントを組み合わせています。
主な機能
- 01クエリと連携の問題のトラブルシューティング
- 02クエリ設計とスロットリング対策
- 03制限、クォータ、ページネーション
- 04設定と共有クエリ
- 05CLI、PowerShell、REST、レポートのパターン
活用シーン
- 01クエリエラーやコネクターの問題の診断
- 02効率的なクエリとページネーションの計画
- 03CLIやLogic Appsによるクエリの自動化
MCP 対応
利用可能な場合はmcp_microsoftdocsツールでMicrosoftのドキュメントを取得し、利用できない場合のWebページ取得方法も示します。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-resource-graphインストール後、Claude Code で/azure-resource-graphを入力して読み込まれたか確認します。
詳細
Azure Resource Graph スキル
このスキルでは、Azure Resource Graph に関する専門的なガイダンスを提供します。トラブルシューティング、ベストプラクティス、意思決定、制限とクォータ、構成、統合とコーディングパターンを扱います。ローカルのクイックリファレンスコンテンツと、リモートでドキュメントを取得する機能を組み合わせています。
このスキルの使い方
IMPORTANT for Agent: 関連するセクションを探すには、以下のカテゴリインデックスを使用してください。行範囲が示されているカテゴリ(例:
L35-L120)では、指定された行をread_fileで読み取ってください。ファイルへのリンクがあるカテゴリ(例:security.md)では、リンク先の参照ファイルをread_fileで読み取ってください。
IMPORTANT for 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 が返されます。
カテゴリインデックス
| カテゴリ | 行 | 説明 |
|---|---|---|
| トラブルシューティング | L34-L40 | アラート、クエリの構文や実行時エラー、Power BI コネクタの接続、認証、データ更新の問題について、Azure Resource Graph の問題を診断し、解決します。 |
| ベストプラクティス | L41-L45 | 効率的なパターン、バッチ処理、ページネーション、パフォーマンスに配慮したクエリ構造など、スロットリングを避ける Azure Resource Graph クエリの設計に関するガイダンスです。 |
| 意思決定 | L46-L51 | 効率的な Azure Resource Graph クエリパターンの選択や、さまざまなシナリオで GET/LIST API と Query サービスのどちらを使うかを判断するためのガイダンスです。 |
| 制限とクォータ | L52-L59 | ARG のリクエスト制限、ページネーションの動作、大規模な結果セットの処理、クォータの問題を避ける効率的なページング(PowerShell を使用する方法を含む)について説明します。 |
| 構成 | L60-L67 | キーボードショートカット、サポートされるリソースの種類、Bicep と ARM テンプレートを使用した共有クエリの定義とデプロイなど、Resource Graph の使用方法を構成します。 |
| 統合とコーディングパターン | L68-L79 | CLI、PowerShell、REST、Logic Apps、Power BI を使用した Resource Graph クエリの実行、共有クエリとアラートの作成、自動化やレポート作成のためのリソース変更履歴の取得について説明します。 |
トラブルシューティング
| トピック | URL |
|---|---|
| Azure Resource Graph のアラート統合に関する問題のトラブルシューティング | https://learn.microsoft.com/en-us/azure/governance/resource-graph/troubleshoot/alerts |
| Azure Resource Graph の一般的なクエリエラーの解決 | https://learn.microsoft.com/en-us/azure/governance/resource-graph/troubleshoot/general |
| Azure Resource Graph Power BI コネクタの問題のトラブルシューティング | https://learn.microsoft.com/en-us/azure/governance/resource-graph/troubleshoot/power-bi-connector |
ベストプラクティス
| トピック | URL |
|---|---|
| クエリパターンを使用して Azure Resource Graph のスロットリングを回避する | https://learn.microsoft.com/en-us/azure/governance/resource-graph/concepts/guidance-for-throttled-requests |
意思決定
| トピック | URL |
|---|---|
| 適切な Azure Resource Graph クエリ戦略の選択 | https://learn.microsoft.com/en-us/azure/governance/resource-graph/choose-query-strategy |
| ARG GET/LIST API と Query サービスの選択 | https://learn.microsoft.com/en-us/azure/governance/resource-graph/concepts/get-list-query-service-differences |
制限とクォータ
| トピック | URL |
|---|---|
| Azure Resource Graph の GET/LIST API クォータを効果的に利用する | https://learn.microsoft.com/en-us/azure/governance/resource-graph/concepts/azure-resource-graph-get-list-api |
| Azure Resource Graph のページネーションの動作と制限 | https://learn.microsoft.com/en-us/azure/governance/resource-graph/concepts/paging-results |
| 大規模な Azure Resource Graph データセットと制限に対処する | https://learn.microsoft.com/en-us/azure/governance/resource-graph/concepts/work-with-data |
| PowerShell で Azure Resource Graph の結果をページ分割する | https://learn.microsoft.com/en-us/azure/governance/resource-graph/paginate-powershell |
構成
| トピック | URL |
|---|---|
| Azure Resource Graph Explorer でキーボードショートカットを使用する | https://learn.microsoft.com/en-us/azure/governance/resource-graph/reference/keyboard-shortcuts |
| Azure Resource Graph がサポートするリソースの種類のリファレンス | https://learn.microsoft.com/en-us/azure/governance/resource-graph/reference/supported-tables-resources |
| Bicep で Azure Resource Graph の共有クエリを定義する | https://learn.microsoft.com/en-us/azure/governance/resource-graph/shared-query-bicep |
| ARM テンプレートで Azure Resource Graph の共有クエリをデプロイする | https://learn.microsoft.com/en-us/azure/governance/resource-graph/shared-query-template |