azure-resource-graph
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseAzure Resource Graph Skill
Azure Resource Graph 技能
This skill provides expert guidance for Azure Resource Graph. Covers troubleshooting, best practices, decision making, limits & quotas, configuration, and integrations & coding patterns. It combines local quick-reference content with remote documentation fetching capabilities.
本技能为Azure Resource Graph提供专业指导,涵盖故障排除、最佳实践、决策指导、限制与配额、配置以及集成与编码模式。它结合了本地快速参考内容与远程文档获取能力。
How to Use This Skill
如何使用本技能
IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g.,), useL35-L120with the specified lines. For categories with file links (e.g.,read_file), use[security.md](security.md)on the linked reference fileread_file
IMPORTANT for Agent: Ifis more than 3 months old, suggest the user pull the latest version from the repository. Ifmetadata.generated_attools are not available, suggest the user install it: Installation Guidemcp_microsoftdocs
This skill requires network access to fetch documentation content:
- Preferred: Use with query string
mcp_microsoftdocs:microsoft_docs_fetch. Returns Markdown.from=learn-agent-skill - Fallback: Use with query string
fetch_webpage. Returns Markdown.from=learn-agent-skill&accept=text/markdown
面向Agent的重要提示:使用下方的分类索引查找相关章节。对于带有行范围的分类(如),请使用L35-L120读取指定行内容;对于带有文件链接的分类(如read_file),请使用[security.md](security.md)读取链接的参考文件read_file
面向Agent的重要提示:如果的时间超过3个月,请建议用户从仓库拉取最新版本。如果metadata.generated_at工具不可用,请建议用户安装该工具:安装指南mcp_microsoftdocs
本技能需要网络访问权限来获取文档内容:
- 推荐方式:使用,并携带查询字符串
mcp_microsoftdocs:microsoft_docs_fetch,返回Markdown格式内容。from=learn-agent-skill - 备选方式:使用,并携带查询字符串
fetch_webpage,返回Markdown格式内容。from=learn-agent-skill&accept=text/markdown
Category Index
分类索引
| Category | Lines | Description |
|---|---|---|
| Troubleshooting | L34-L40 | Diagnosing and fixing Azure Resource Graph issues with alerts, query syntax/runtime errors, and Power BI connector connectivity, auth, and data refresh problems. |
| Best Practices | L41-L45 | Guidance on designing Azure Resource Graph queries to avoid throttling, including efficient patterns, batching, pagination, and performance-friendly query structures. |
| Decision Making | L46-L50 | Guidance on when to use Azure Resource Graph GET/LIST REST APIs vs the Query service, comparing capabilities, scenarios, and integration patterns. |
| Limits & Quotas | L51-L58 | Understanding ARG request limits, pagination behavior, handling large result sets, and implementing efficient paging (including with PowerShell) to avoid quota issues. |
| Configuration | L59-L66 | Configuring Resource Graph usage: keyboard shortcuts, supported resource types, and defining/deploying shared queries via Bicep and ARM templates. |
| Integrations & Coding Patterns | L67-L77 | How to run Resource Graph queries via CLI, PowerShell, REST, Power BI, Logic Apps, and create shared queries and alerting/automation patterns using those integrations |
| 分类 | 行范围 | 描述 |
|---|---|---|
| 故障排除 | L34-L40 | 诊断并修复Azure Resource Graph的各类问题,包括警报、查询语法/运行时错误,以及Power BI连接器的连接、认证和数据刷新问题。 |
| 最佳实践 | L41-L45 | 指导如何设计Azure Resource Graph查询以避免限流,包括高效模式、批处理、分页和性能优化的查询结构。 |
| 决策指导 | L46-L50 | 指导何时使用Azure Resource Graph的GET/LIST REST API,何时使用Query服务,对比两者的能力、适用场景和集成模式。 |
| 限制与配额 | L51-L58 | 了解ARG请求限制、分页行为、处理大型结果集,以及实现高效分页(包括使用PowerShell)以避免配额问题。 |
| 配置 | L59-L66 | 配置Resource Graph的使用:键盘快捷键、支持的资源类型,以及通过Bicep和ARM模板定义/部署共享查询。 |
| 集成与编码模式 | L67-L77 | 如何通过CLI、PowerShell、REST、Power BI、Logic Apps运行Resource Graph查询,以及利用这些集成创建共享查询和警报/自动化模式 |
Troubleshooting
故障排除
| Topic | URL |
|---|---|
| Troubleshoot Azure Resource Graph alert integration issues | https://learn.microsoft.com/en-us/azure/governance/resource-graph/troubleshoot/alerts |
| Resolve common Azure Resource Graph query errors | https://learn.microsoft.com/en-us/azure/governance/resource-graph/troubleshoot/general |
| Troubleshoot Azure Resource Graph Power BI connector problems | https://learn.microsoft.com/en-us/azure/governance/resource-graph/troubleshoot/power-bi-connector |
| 主题 | 链接 |
|---|---|
| 排查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 |
Best Practices
最佳实践
| Topic | URL |
|---|---|
| Avoid Azure Resource Graph throttling with query patterns | https://learn.microsoft.com/en-us/azure/governance/resource-graph/concepts/guidance-for-throttled-requests |
| 主题 | 链接 |
|---|---|
| 通过查询模式避免Azure Resource Graph限流 | https://learn.microsoft.com/en-us/azure/governance/resource-graph/concepts/guidance-for-throttled-requests |
Decision Making
决策指导
| Topic | URL |
|---|---|
| Choose between ARG GET/LIST API and Query service | https://learn.microsoft.com/en-us/azure/governance/resource-graph/concepts/get-list-query-service-differences |
| 主题 | 链接 |
|---|---|
| 在ARG GET/LIST API与Query服务之间做选择 | https://learn.microsoft.com/en-us/azure/governance/resource-graph/concepts/get-list-query-service-differences |
Limits & Quotas
限制与配额
| Topic | URL |
|---|---|
| Use Azure Resource Graph GET/LIST API quotas effectively | https://learn.microsoft.com/en-us/azure/governance/resource-graph/concepts/azure-resource-graph-get-list-api |
| Azure Resource Graph pagination behavior and limits | https://learn.microsoft.com/en-us/azure/governance/resource-graph/concepts/paging-results |
| Handle large Azure Resource Graph datasets and limits | https://learn.microsoft.com/en-us/azure/governance/resource-graph/concepts/work-with-data |
| Paginate Azure Resource Graph results with PowerShell | https://learn.microsoft.com/en-us/azure/governance/resource-graph/paginate-powershell |
| 主题 | 链接 |
|---|---|
| 高效使用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 |
Configuration
配置
| Topic | URL |
|---|---|
| Use keyboard shortcuts in Azure Resource Graph Explorer | https://learn.microsoft.com/en-us/azure/governance/resource-graph/reference/keyboard-shortcuts |
| Reference of Azure Resource Graph supported resource types | https://learn.microsoft.com/en-us/azure/governance/resource-graph/reference/supported-tables-resources |
| Define Azure Resource Graph shared queries using Bicep | https://learn.microsoft.com/en-us/azure/governance/resource-graph/shared-query-bicep |
| Deploy Azure Resource Graph shared queries with ARM templates | https://learn.microsoft.com/en-us/azure/governance/resource-graph/shared-query-template |
| 主题 | 链接 |
|---|---|
| 在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 |