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

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

  • Мақала

В этом кратком руководстве описывается выполнение запроса 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 запросом отображается запрос для установки расширения. В противном случае выполните следующие действия, чтобы выполнить установку вручную.

  1. Список доступных расширений и версий:

    az extension list-available --output table

  2. Установите расширение :

    az extension add --name resource-graph

  3. Убедитесь, что расширение установлено:

    az extension list --output table

  4. Отображение синтаксиса расширения:

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

  1. Запустите запрос Azure Resource Graph:

    az graph query --graph-query 'Resources | project name, type | limit 5'

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

  2. Обновите запрос к order by свойству name :

    az graph query --graph-query 'Resources | project name, type | limit 5 | order by name asc'

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

  3. Обновите запрос к 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. Чтобы узнать больше о языке Resource Graph, перейдите на страницу сведений о языке запросов.

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