Краткое руководство. Создание общего запроса Resource Graph с помощью Azure CLI

Статья
06/27/2024

В этом кратком руководстве описывается создание общего запроса Azure Resource Graph с помощью Azure CLI и расширения Resource Graph. Команды az graph shared-query являются экспериментальной функцией az graph query.

Общий запрос можно запустить из Azure CLI с помощью команд экспериментальной функции или выполнить общий запрос из портал Azure. Общий запрос — это объект Azure Resource Manager, который можно предоставить разрешение или запустить в обозревателе ресурсов Azure. По завершении можно удалить расширение Resource Graph.

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

Если у вас нет учетной записи Azure, создайте бесплатную учетную запись, прежде чем начинать работу.
Azure CLI должен быть версии 2.22.0 или выше для расширения Resource Graph.
Среда оболочки Bash, в которой можно выполнять команды Azure CLI. Например, Git Bash в сеансе терминала Visual Studio Code .

Установка расширения

Чтобы разрешить Azure CLI запрашивать ресурсы с помощью Azure Resource Graph, необходимо установить расширение Resource Graph. При первом запуске запроса с az graph запросом отображается запрос для установки расширения. В противном случае выполните следующие действия, чтобы выполнить установку вручную.

Список доступных расширений и версий:
```
az extension list-available --output table
```
Установите расширение :
```
az extension add --name resource-graph
```
Убедитесь, что расширение установлено:
```
az extension list --output table
```
Отображение синтаксиса расширения:
```
az graph query --help
```

Дополнительные сведения о расширениях Azure CLI см. в описании использования расширений Azure CLI и управления ими.

Подключение к Azure

Из сеанса терминала Visual Studio Code подключитесь к Azure. Если у вас несколько подписок, выполните команды, чтобы задать контекст для подписки. Замените <subscriptionID> идентификатором своей подписки Azure.

az login

# Run these commands if you have multiple subscriptions
az account list --output table
az account set --subscription <subscriptionID>

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

Создайте группу ресурсов и общую папку, которая суммирует количество всех ресурсов, сгруппированных по расположению.

Создайте группу ресурсов для хранения общего запроса Azure Resource Graph.
```
az group create --name "demoSharedQuery" --location westus2
```

Создайте общий запрос.

az graph shared-query create --name "Summarize resources by location" \
  --description "This shared query summarizes resources by location for a pinnable map graphic." \
  --graph-query "Resources | summarize count() by location" \
  --resource-group demoSharedQuery

Вывод списка всех общих запросов в группе ресурсов.
```
az graph shared-query list --resource-group demoSharedQuery
```

Ограничить результаты определенным общим запросом.

az graph shared-query show --resource-group "demoSharedQuery" \
  --name "Summarize resources by location"

Запуск общего запроса

Для выполнения общего запроса можно использовать экспериментальный синтаксис функции Azure CLI или портал Azure.

Использование экспериментальной функции для выполнения общего запроса

Запустите общий запрос в Azure CLI с синтаксисом {{shared-query-uri}} в команде az graph query . Вы получите идентификатор ресурса общего запроса и сохраните его в переменной. Переменная используется при выполнении общего запроса.

sharedqueryid=$(az graph shared-query show --resource-group "demoSharedQuery" \
  --name "Summarize resources by location" \
  --query id \
  --output tsv)

az graph query --graph-query "{{$sharedqueryid}}"

Параметр можно использовать subscriptions для ограничения результатов.

az graph query --graph-query "{{$sharedqueryid}}" --subscriptions 11111111-1111-1111-1111-111111111111

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

Вы можете проверить, работает ли общий запрос с помощью обозревателя Azure Resource Graph. Чтобы изменить область, используйте меню "Область " в левой части страницы.

Войдите на портал Azure.
Введите граф ресурсов в поле поиска в верхней части страницы.
Выберите обозреватель Resource Graph.
Выберите Открыть запрос.
Измените Тип на Общие запросы.
Выберите виртуальные машины подсчета запросов по ОС.
Выберите "Выполнить запрос" и выходные данные представления на вкладке "Результаты ".
Выберите диаграммы и выберите "Карта ", чтобы просмотреть карту расположения.

Вы также можете запустить запрос из группы ресурсов.

В Azure перейдите в группу ресурсов demoSharedQuery.
На вкладке "Обзор" выберите виртуальные машины счетчика запросов по ОС.
Перейдите на вкладку "Результаты ".
Выберите диаграммы и выберите "Карта ", чтобы просмотреть карту расположения.

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

Чтобы удалить общий запрос, выполните следующие действия.

az graph shared-query delete --name "Summarize resources by location" --resource-group demoSharedQuery

При удалении группы ресурсов группа ресурсов и все ее ресурсы удаляются. Чтобы удалить группу ресурсов:

az group delete --name demoSharedQuery

Чтобы удалить расширение Resource Graph, выполните следующую команду:

az extension remove --name resource-graph

Чтобы выйти из сеанса Azure CLI, выполните приведенные действия.

az logout

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

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

Общие сведения о языке запросов графика ресурсов Azure

Поделиться через