Share via

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

  • Статья

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

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

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

  • Создание и удаление закрытого запроса
  • Создание общего запроса
  • Поиск общих запросов
  • Удаление общего запроса

Необходимые компоненты

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

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

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

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

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

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

    Щелкните Выполнить запрос и просмотрите результаты запроса на панели внизу.

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

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

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

    Save the new query using the save button

  4. На панели Сохранить запрос введите имя Число виртуальных машин по ОС.

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

  6. Сохраните установленный флажок Опубликовать в группе ресурсов resource-graph-queries, а в поле Расположение группы ресурсов оставьте значение (США) Центрально-западная часть США.

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

    Save the new query as a Shared query

    Примечание.

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

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

  9. Щелкните Открыть запрос. Убедитесь, что здесь выбран типОбщий запрос, а сочетание параметров Подписка и Группа ресурсов совпадают с реальным расположением запроса. Сохраненный элемент Число виртуальных машин по ОС теперь отображается в списке Имя запроса. Щелчок по ссылке в заголовке сохраненного запроса загружает этот запрос на новую вкладку, имя которой совпадает с именем запроса. Для общего запроса на вкладке рядом с заголовком отображается значок, обозначающий тип общего запроса.

    Show the Shared Query with icon

    Примечание.

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

Поиск общих запросов

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

  • Получить в обозревателе Resource Graph. Выбрать действие Открыть запрос и задать тип Общий запрос.
  • Через страницу портала с запросами Resource Graph.
  • Из группы ресурсов, в которой был сохранен этот общий запрос.
  • С помощью запроса к Resource Graph.

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

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

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

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

Вывода списка ресурсов групп ресурсов

Запрос Resource Graph включается в список вместе с другими ресурсами, которые входят в группу ресурсов. Выбор любого из запросов 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;
  • страница групп ресурсов.

Очистка ресурсов

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

Следующие шаги

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

Получите более подробную информацию о языке запросов.