教程：在 Azure 门户中管理查询 - Azure Resource Graph

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

2025-10-08

Azure Resource Graph 资源管理器允许直接在 Azure 门户中保存 Resource Graph 查询。有两种类型的查询：专用和共享。专用查询保存在 Azure 门户设置中。而共享查询是 Azure 资源管理器资源，可以使用 Azure 基于角色的访问控制（Azure RBAC）进行管理，并使用资源锁进行保护。这两种类型的查询都是静态加密的。

通过在 Azure 门户中保存查询，可以节省查找偏好的查询或常用查询所花的时间。共享查询时，通过重复帮助团队实现一致性和效率的目标。

在本教程中，你将完成以下任务：

创建和删除专用查询
创建共享查询
识别已共享的查询
删除共享查询

先决条件

若要完成本教程，需要一个 Azure 订阅。如果没有帐户，请在开始之前创建一个免费帐户。

创建和删除专用查询

专用查询可访问且仅对创建专用查询的帐户可见。由于它们保存在帐户的 Azure 门户设置中，因此只能从 Azure 门户中创建、使用和删除它们。专用查询不是资源管理器资源。若要创建新的专用查询，请执行以下步骤：

在门户菜单中，选择 “所有服务 ”或使用所有页面顶部的 Azure 搜索框。搜索并选择 Resource Graph Explorer。
在 Azure Resource Graph 资源管理器页上的 “查询 1 ”选项卡上，输入以下查询：
```
Resources
| where type =~ 'Microsoft.Compute/virtualMachines'
| summarize count() by tostring(properties.storageProfile.osDisk.osType)
```
选择 “运行查询 ”以查看底部窗格中的查询结果。

有关此查询的详细信息，请参阅示例 - 按 OS 类型对虚拟机进行计数。
选择“保存”或“另存为”，输入按操作系统计数虚拟机作为名称，将类型保留为专用查询，然后在保存查询窗格底部选择“保存”。选项卡标题从 查询 1 更改为 按 OS 对 VM 进行计数。
从 Azure 门户中的 Azure Resource Graph Explorer 离开，然后返回。请注意，已保存的查询不再显示，并且“查询 1”选项卡已重新显示。
选择 “打开查询”。确保类型为 专用查询。已保存的名称“按 OS 对 VM 进行计数”现在会显示在“查询名称”列表中。选择已保存查询的标题链接时，它将加载到具有该查询名称的新选项卡中。

注释

当一个保存的查询已打开并且选项卡显示其名称时，选择“保存”按钮将用已进行的更改更新该查询。若要从此打开的查询创建新的已保存查询，请选择“ 另存为 ”并继续作，就像保存全新的查询一样。
若要删除保存的查询，请再次选择 “打开查询 ”，并验证 “类型” 字段是否设置为 “专用”查询。在保存 Count VMs by OS 的查询行上，选择“ 删除 ”（回收站图标）。在确认对话框中，选择“ 是 ”以完成删除查询。然后，关闭 “打开查询 ”窗格。

创建共享查询

与专用查询不同，共享查询是资源管理器资源。此事实意味着查询将保存到资源组，可以使用 Azure RBAC 进行管理和控制，甚至可以使用资源锁进行保护。作为资源，具有相应权限的任何人都可以查看和使用它。若要创建新的共享查询，请执行以下步骤：

在门户菜单中，选择 “所有服务”，或使用所有页面顶部的 Azure 搜索框搜索并选择 Resource Graph 资源管理器。
在 Azure Resource Graph 资源管理器页上的 “查询 1 ”选项卡上，输入以下查询：
```
Resources
| where type =~ 'Microsoft.Compute/virtualMachines'
| summarize count() by tostring(properties.storageProfile.osDisk.osType)
```
选择 “运行查询 ”以查看底部窗格中的查询结果。

有关此查询的详细信息，请参阅示例 - 按 OS 类型对虚拟机进行计数。
选择“ 保存 ”或 “另存为”。
在“保存查询”窗格中，输入“按 OS 对 VM 进行计数”作为名称。
将类型更改为 共享查询，将说明设置为 按操作系统类型计算虚拟机数量，并将订阅设置为指定查询资源的创建位置。
选中“发布到 resource-graph-queries 资源组”复选框，并将“资源组位置”设置为“(美国)美国中西部”。
选择“保存查询”窗格底部的“保存”。选项卡标题从 查询 1 更改为 按 OS 对 VM 进行计数。首次使用 resource-graph-queries 资源组时，保存时间比创建资源组所需的时间长。

注释

如果您希望提供现有资源组的名称以便将共享查询保存到其中，可以清除 “发布到 resource-graph-queries 资源组” 复选框。使用默认命名资源组进行查询可使共享查询更易于发现。它还使该资源组的用途更加明显。但是，出于安全原因，可以选择根据现有权限选择现有资源组。
离开 Azure 门户中的 Azure Resource Graph 资源管理器，然后返回到该资源管理器。请注意，已保存的查询不再显示，因而“查询 1”选项卡已恢复。
选择 “打开查询”。验证类型是否设置为 “共享查询 ”，以及 “订阅 ”和 “资源组 ”组合是否与保存查询的位置匹配。保存的按操作系统计数 VM 项现在显示在“查询名称”列表中。选择保存的查询的标题链接，将其加载到具有该查询名称的新选项卡中。作为共享查询，它会在标题旁边的选项卡中显示一个图标，将其表示为共享。

注释

当保存的查询打开并且选项卡显示其名称时， “保存 ”按钮会用已做的任何更改更新它。若要创建新的保存的查询，请选择“ 另存为 ”并继续作，就像保存全新的查询一样。

发现共享查询

由于共享查询是资源管理器资源，因此可通过多种方式查找一个资源：

从 Resource Graph 资源管理器，选择 “打开查询 ”，并将类型设置为 “共享查询”。
通过 Resource Graph 查询门户页。
通过保存共享查询的资源组。
通过查询 Resource Graph。

查看资源图形查询

在 Azure 门户中，Resource Graph 查询页显示已登录帐户有权访问的共享查询。此页面允许按 Resource Graph 查询的名称、订阅、资源组和其他属性进行筛选。还可以使用此接口标记、导出和删除 Resource Graph 查询。

选择其中一个查询将打开 Resource Graph 查询页。与其他资源管理器资源一样，此页面提供交互式概述以及活动日志、访问控制和标记。也可以直接从此页面应用资源锁。

通过选择 “所有服务 ”或使用所有页面顶部的 Azure 搜索框，从门户菜单中转到 Resource Graph 查询页。搜索并选择 Resource Graph Explorer。

列出资源组资源

Resource Graph 查询与其他属于资源组一部分的资源一起列出。选择 Resource Graph 查询将打开该查询的页面。省略号和快捷菜单选项可以通过选择并按住（或右键单击）来触发，其工作方式与在 Resource Graph 查询页面上的操作相同。

查询资源图

可以通过查询 Resource Graph 来查找 Resource Graph 查询。以下的 Resource Graph 查询按类型 Microsoft.ResourceGraph/queries 进行限制，然后通过 project 仅列出名称、修改时间以及查询本身：

Resources
| where type == "microsoft.resourcegraph/queries"
| project name, properties.timeModified, properties.query

运行共享查询

可以使用 {{shared-query-uri}} 语法（预览版）运行 Resource Graph 共享查询。有关详细信息，请参阅共享查询语法。

删除共享查询

如果不再需要共享查询，请将其删除。通过删除共享查询，可以删除相应的资源管理器资源。结果图表固定到的任何仪表板现在都会显示错误消息。显示该错误消息时，请使用“ 从仪表板中删除 ”按钮清理仪表板。

可以通过以下接口删除共享查询：

Resource Graph 查询页
Resource Graph 查询页面
在 Resource Graph Explorer 中的打开查询页面
“资源组”页

清理资源

完成本教程后，如果不再需要专用查询和共享查询，请将其删除。

后续步骤

在本教程中，你已创建专用查询和共享查询。若要了解有关 Resource Graph 语言的详细信息，请继续阅读查询语言详细信息页。

获取有关查询语言的详细信息

反馈

此页面是否有帮助？