关于 azure-resource-graph
面向使用 Azure Resource Graph 的 Agent,提供查询、配置与运维指导,结合本地参考内容和联网获取的文档。
主要功能
- 01排查查询与集成问题
- 02查询设计与限流指导
- 03限制、配额与分页
- 04配置及共享查询
- 05CLI、PowerShell、REST 与报告模式
适用场景
- 01诊断查询错误或连接器问题
- 02规划高效查询与分页
- 03通过 CLI 或 Logic Apps 自动执行查询
MCP 相关
可使用 mcp_microsoftdocs 工具获取 Microsoft 文档;若不可用,说明了网页抓取的备用方式。
安装
复制下面的命令,在终端中运行。
$
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](security.md)),使用read_file读取链接的参考文件
IMPORTANT for Agent:如果
metadata.generated_at距今已超过 3 个月,请建议用户从仓库拉取最新版本。如果无法使用mcp_microsoftdocs工具,请建议用户安装: 安装指南
此技能需要网络访问才能获取文档内容:
- 首选:使用
mcp_microsoftdocs:microsoft_docs_fetch,并将查询字符串设为from=learn-agent-skill。返回 Markdown。 - 备用:使用
fetch_webpage,并将查询字符串设为from=learn-agent-skill&accept=text/markdown。返回 Markdown。
类别索引
| 类别 | 行 | 描述 |
|---|---|---|
| 故障排除 | L34-L40 | 诊断和修复 Azure Resource Graph 问题,包括警报、查询语法/运行时错误,以及 Power BI 连接器的连接、身份验证和数据刷新问题。 |
| 最佳实践 | L41-L45 | 关于设计 Azure Resource Graph 查询以避免限流的指导,包括高效模式、批处理、分页,以及有利于性能的查询结构。 |
| 决策 | L46-L51 | 关于选择高效 Azure Resource Graph 查询模式的指导,以及针对不同场景决定使用 GET/LIST API 还是 Query 服务。 |
| 限制与配额 | L52-L59 | 了解 ARG 请求限制、分页行为、大型结果集处理,以及实现高效分页(包括使用 PowerShell),以避免配额问题。 |
| 配置 | L60-L67 | 配置 Resource Graph 用法:键盘快捷键、支持的资源类型,以及通过 Bicep 和 ARM 模板定义/部署共享查询。 |
| 集成与编码模式 | 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 |
集成与编码模式
评论
支持 Markdown