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

Мақала
06/27/2024

В этом кратком руководстве описывается выполнение запроса Azure Resource Graph с помощью Azure CLI и расширения 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 CLI в среду можно выполнить запрос на основе клиента. Запрос в этом примере возвращает пять ресурсов Azure с каждым ресурсом name type . Чтобы выполнить запрос по группе управления или подписке, используйте аргумент --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 by name свойству, а затем 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. Чтобы узнать больше о языке Resource Graph, перейдите на страницу сведений о языке запросов.

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

Бөлісу құралы: