Краткое руководство. Выполнение запроса Graph ресурсов с помощью Azure CLI

Статья
04/25/2024

В этом кратком руководстве описывается запуск запроса Azure Resource Graph с помощью расширения для Azure CLI. В статье также показано, как упорядочивать (сортировать) и ограничивать результаты запроса. Вы можете выполнить запрос к ресурсам в клиенте, группах управления или подписках. По завершении можно удалить расширение.

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

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

Подключение к 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 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 CLI в среду можно выполнить запрос на основе клиента. Запрос в этом примере возвращает пять ресурсов Azure с каждым ресурсом nametype . Чтобы выполнить запрос по группе управления или подписке, используйте аргумент --management-groups или --subscriptions.

Запустите запрос Azure Resource Graph:
```
az graph query --graph-query 'Resources | project name, type | limit 5'
```
В этом примере запроса не используется модификатор сортировки, например order by. При выполнении запроса несколько раз он может дать другой набор ресурсов для каждого запроса.
Обновите запрос к order by свойству name :
```
az graph query --graph-query 'Resources | project name, type | limit 5 | order by name asc'
```
Как и в предыдущем запросе, если этот запрос выполняется несколько раз, он может дать другой набор ресурсов для каждого запроса. Важен порядок команд запроса. В этом примере order by следует после limit. Запрос ограничивает результаты пятью ресурсами, а затем упорядочивает эти результаты по имени.
Обновите запрос к order byname свойству, а затем limit выходные данные до пяти результатов:
```
az graph query --graph-query 'Resources | project name, type | order by name asc | limit 5'
```
Если этот запрос выполняется несколько раз без изменений в вашей среде, результаты согласованы и упорядочены свойством name , но по-прежнему ограничены пятью результатами. Запрос упорядочивает результаты по имени, а затем ограничивает выходные данные пятью ресурсами.

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

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

az extension remove --name resource-graph

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

az logout

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

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

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