Руководство. Создание и предоставление общего доступа к запросу Azure Resource Graph на портале Azure

Обозреватель Azure Resource Graph позволяет сохранять запросы Resource Graph непосредственно на портале Azure. Существует два типа запросов: частный и общий. Частный запрос сохраняется в параметрах портала Azure. В то время как общий запрос — это ресурс Azure Resource Manager, который можно управлять с помощью управления доступом на основе ролей Azure (Azure RBAC) и защищен с помощью блокировок ресурсов. Оба типа запросов шифруются в состоянии покоя.

Сохраняя запросы на портале Azure, вы можете сэкономить время, которое может потребоваться для поиска избранных или часто используемых запросов. При совместном использовании запросов вы помогаете команде реализовать цели согласованности и эффективности путем повторения.

В этом руководстве вы выполните следующие задачи:

Предпосылки

Для работы с этим руководством вам потребуется подписка Azure. Если у вас еще нет аккаунта, создайте бесплатную учетную запись, прежде чем начать.

Создание и удаление закрытого запроса

Частные запросы доступны и видны только для учетной записи, которая создает их. Так как они сохраняются в параметрах портала Azure учетной записи, их можно создавать, использовать и удалять только на портале Azure. Закрытый запрос не является ресурсом Resource Manager. Чтобы создать частный запрос, выполните следующие действия.

1. В меню портала выберите все службы или используйте поле поиска Azure в верхней части всех страниц. Найдите и выберите Resource Graph Explorer.

2. На вкладке "Запрос 1 " на странице обозревателя Azure Resource Graph введите следующий запрос:

   Resources
   | where type =~ 'Microsoft.Compute/virtualMachines'
   | summarize count() by tostring(properties.storageProfile.osDisk.osType)
   

   Выберите "Выполнить запрос" , чтобы просмотреть результаты запроса в нижней области.

   Дополнительные сведения об этом запросе см. в разделе "Примеры— подсчет виртуальных машин по типу ОС".

3. Выберите "Сохранить " или " Сохранить как", введите число виртуальных машин по ОС в качестве имени, оставьте тип в качестве закрытого запроса и нажмите кнопку "Сохранить " в нижней части области "Сохранить запрос ". Заголовок вкладки изменяется с запроса 1 на подсчет виртуальных машин по ОС.

4. Перейдите от обозревателя Azure Resource Graph на портале Azure, а затем вернитесь к нему. Обратите внимание, что сохраненный запрос больше не отображается, а вкладка "Запрос 1 " возвращается.

5. Выберите "Открыть запрос". Убедитесь, что тип является частным запросом. Теперь сохранённое название Считать ВМ по ОС отображается в списке имён запросов. При выборе ссылки заголовка сохраненного запроса она загружается на новую вкладку с именем этого запроса.

   Замечание

   Когда сохраненный запрос открыт, а на вкладке отображается его имя, нажмите кнопку "Сохранить " с изменениями, внесенными. Чтобы создать новый сохраненный запрос из этого открытого запроса, нажмите кнопку Сохранить как и продолжить, как если бы вы сохранили новый запрос.

6. Чтобы удалить сохраненный запрос, снова нажмите кнопку "Открыть запрос " и убедитесь, что поле "Тип " имеет значение "Закрытый запрос". В строке сохраненного Count VMs by OS запроса нажмите кнопку "Удалить " (значок корзины). В диалоговом окне подтверждения нажмите кнопку "Да ", чтобы завершить удаление запроса. Затем закройте область "Открыть запрос ".

Создание общего запроса

В отличие от закрытого запроса, общий запрос является ресурсом Resource Manager. Это означает, что запрос сохраняется в группе ресурсов, может управляться с помощью Azure RBAC и даже защищаться с помощью блокировок ресурсов. В качестве ресурса любой пользователь, имеющий соответствующие разрешения, может видеть и использовать его. Чтобы создать общий запрос, выполните следующие действия.

1. В меню портала выберите "Все службы" или используйте поле поиска Azure в верхней части всех страниц для поиска и выбора обозревателя resource Graph.

2. На вкладке "Запрос 1 " на странице обозревателя Azure Resource Graph введите следующий запрос:

   Resources
   | where type =~ 'Microsoft.Compute/virtualMachines'
   | summarize count() by tostring(properties.storageProfile.osDisk.osType)
   

   Выберите "Выполнить запрос" , чтобы просмотреть результаты запроса в нижней области.

   Дополнительные сведения об этом запросе см. в разделе "Примеры— подсчет виртуальных машин по типу ОС".

3. Нажмите кнопку "Сохранить " или "Сохранить как".

   

4. В области Сохранить запрос введите Подсчет ВМ по ОС в качестве имени.

5. Измените тип на общий запрос, задайте для описания количество виртуальных машин по типу ОС и задайте подписку , чтобы указать, где создается ресурс запроса.

6. Оставьте флажок «Опубликовать в группе ресурсов resource-graph-queries» , а расположение группы ресурсов установлено на (США) Центрально-Запад США.

7. Нажмите Сохранить внизу панели Сохранить запрос. Заголовок вкладки изменяется с запроса 1 на подсчет виртуальных машин по ОС. При первом использовании группы ресурсов resource-graph-queries сохранение занимает больше времени, чем ожидалось, так как группа ресурсов создается.

   

   Замечание

   Снимите флажок "Опубликовать в группе ресурсов resource-graph-queries", если вы хотите указать имя существующей группы ресурсов для сохранения общего запроса. Использование именованной группы ресурсов по умолчанию для запросов упрощает обнаружение общих запросов. Она также делает цель этой группы ресурсов более очевидной. Однако вы можете выбрать существующую группу ресурсов по соображениям безопасности в зависимости от существующих разрешений.

8. Перейдите от обозревателя Azure Resource Graph на портале Azure, а затем вернитесь к нему. Обратите внимание, что сохраненный запрос больше не отображается, а вкладка "Запрос 1 " возвращается.

9. Выберите "Открыть запрос". Убедитесь, что для типа задан общий запрос , а сочетание подписки и группы ресурсов совпадает с сохраненным запросом. Сохраненный элемент Счетчик виртуальных машин по ОС теперь появляется в списке имён запросов. Выберите ссылку заголовка сохраненного запроса, чтобы загрузить его на новую вкладку с именем этого запроса. В качестве общего запроса на вкладке рядом с заголовком отображается значок, обозначающий его как общий.

   

   Замечание

   Когда сохраненный запрос открыт, а на вкладке отображается его имя, кнопка "Сохранить " обновляет ее с изменениями, внесенными. Чтобы создать сохраненный запрос, нажмите кнопку "Сохранить как " и будто вы сохранили новый запрос.

Обнаружение общих запросов

Поскольку общий запрос является ресурсом Resource Manager, существует несколько способов найти его.

• Из обозревателя Resource Graph. Выберите "Открыть запрос" и задайте для типа общий запрос.
• С страницы портала запросов Графа ресурсов.
• Из группы ресурсов, в которой был сохранен общий запрос.
• Через запрос к Resource Graph.

Просмотр запросов Resource Graph

На портале Azure на странице запросов Resource Graph отображаются общие запросы, к которым имеет доступ учетная запись входа. Эта страница включает фильтрацию по имени, подписке, группе ресурсов и другим свойствам запроса Resource Graph. Вы также можете пометить, экспортировать и удалить запросы Resource Graph с помощью этого интерфейса.

При выборе одного из запросов откроется страница запроса Resource Graph. Как и другие ресурсы Resource Manager, эта страница предоставляет интерактивный обзор вместе с журналом действий, контролем доступа и тегами. Вы также можете применить блокировку ресурсов непосредственно на этой странице.

Перейдите на страницу запросов Resource Graph из меню портала, выбрав все службы или используя поле поиска Azure в верхней части всех страниц. Найдите и выберите 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

Выполнение общего запроса

Общий запрос Resource Graph можно запустить с помощью синтаксиса {{shared-query-uri}} (предварительная версия). Дополнительные сведения см. в синтаксисе общего запроса.

Удаление общего запроса

Если общий запрос больше не нужен, удалите его. Удалив общий запрос, удалите соответствующий ресурс Resource Manager. Теперь на всех панелях мониторинга, к которым была прикреплена диаграмма результатов, отображается сообщение об ошибке. При отображении этого сообщения об ошибке используйте кнопку "Удалить из панели мониторинга ", чтобы очистить панель мониторинга.

Общий запрос можно удалить с помощью следующих интерфейсов:

• Страница запросов в Resource Graph
• Страница запроса Resource Graph
• Откройте страницу запроса в Обозревателе Resource Graph
• Страница групп ресурсов

Очистите ресурсы

После завершения работы с этим руководством удалите созданные частные и общие запросы, если они больше не нужны.

Дальнейшие шаги

В этом руководстве вы создали частные и общие запросы. Чтобы узнать больше о языке ресурсов Graph, перейдите на страницу с подробной информацией о языке запросов.