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

При использовании Azure Resource Graph в первую очередь необходимо проверить, установлено ли расширение для Azure CLI. В этом кратком руководстве описывается процесс добавления расширения к установке Azure CLI. Можно использовать расширение Azure CLI, установленное локально или через Azure Cloud Shell.

В конце этого процесса будет добавлено расширение к установке Azure CLI по выбору и выполнен первого запрос графа ресурсов.

Предварительные требования

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

Добавление расширения "Граф ресурсов"

Чтобы позволить Azure CLI выполнять запрос графических ресурсов Azure, необходимо добавить расширение. Это расширение работает везде, где может использоваться оболочка Azure CLI, включая bash на операционной системе Windows 10, Cloud Shell (как автономно, так и внутри портала), образ Azure CLI Docker или установленную локально.

1. Убедитесь, что установлена последняя версия Azure CLI (не ниже 2.0.76). Если она еще не установлена, выполните эти инструкции.

2. В выбранной вами среде Azure CLI импортируйте ее с помощью следующей команды:

   # Add the Resource Graph extension to the Azure CLI environment
   az extension add --name resource-graph
   

3. Проверьте установку расширения и номер версии (по крайней мере 1.0.0):

   # Check the extension list (note that you may have other extensions installed)
   az extension list
   
   # Run help for graph query options
   az graph query -h
   

Выполните первый запрос график ресурсов

Теперь, когда расширение для Azure CLI добавлено в выбранную среду, попробуем выполнить простой, основанный на клиенте, запрос к Resource Graph. Запрос возвращает первые пять ресурсов Azure с указанными значениями Имя и Тип ресурса для каждого ресурса. Чтобы выполнить запрос по группе управления или подписке, используйте аргумент --managementgroups или --subscriptions.

1. Запустите ваш первый запрос графа ресурсов Azure, используя graph расширение и query команду :

   # Login first with az login if not using Cloud Shell
   
   # Run Azure Resource Graph query
   az graph query -q 'Resources | project name, type | limit 5'
   

   Примечание

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

2. Обновите запрос свойством order byИмя:

   # Run Azure Resource Graph query with 'order by'
   az graph query -q 'Resources | project name, type | limit 5 | order by name asc'
   

   Примечание

   Как и с первым запросом, выполнение этого запроса несколько раз может получить различные наборы ресурсов для каждого запроса. Важен порядок команд запроса. В этом примере order by следует после limit. Эта последовательность команд сначала ограничивает результаты запроса, а затем упорядочивает их.

3. Обновите запрос, чтобы сначала выполнить сортировку (order by) по свойству Имя, а затем ограничить (limit) вывод пятью первыми результатами:

   # Run Azure Resource Graph query with `order by` first, then with `limit`
   az graph query -q 'Resources | project name, type | order by name asc | limit 5'
   

Повторные выполнения последней версии запроса, если ничего не изменяется в самой среде, возвращают стабильные результаты, отсортированные по свойству Name и ограниченные пятью первыми результатами.

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

Если вы хотите удалить расширение "Граф ресурсов" из среды Azure CLI, это можно сделать с помощью следующей команды:

# Remove the Resource Graph extension from the Azure CLI environment
az extension remove -n resource-graph

Дальнейшие действия

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

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