Szybki start: uruchamianie zapytania usługi Resource Graph przy użyciu interfejsu wiersza polecenia platformy Azure

  • Artykuł

W tym przewodniku Szybki start opisano sposób uruchamiania zapytania usługi Azure Resource Graph przy użyciu rozszerzenia dla interfejsu wiersza polecenia platformy Azure. W tym artykule pokazano również, jak uporządkować (sortować) i ograniczyć wyniki zapytania. Możesz uruchomić zapytanie dotyczące zasobów w dzierżawie, grupach zarządzania lub subskrypcjach. Po zakończeniu możesz usunąć rozszerzenie.

Wymagania wstępne

Łączenie się z platformą Azure

Z poziomu sesji terminalu programu Visual Studio Code nawiąż połączenie z platformą Azure. Jeśli masz więcej niż jedną subskrypcję, uruchom polecenia, aby ustawić kontekst na subskrypcję. Zamień wartość <subscriptionID> na identyfikator swojej subskrypcji platformy Azure.

az login

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

Instalowanie rozszerzenia

Aby umożliwić interfejsowi wiersza polecenia platformy Azure wykonywanie zapytań dotyczących zasobów przy użyciu usługi Azure Resource Graph, należy zainstalować rozszerzenie usługi Resource Graph. Rozszerzenie można zainstalować ręcznie, wykonując następujące kroki. W przeciwnym razie przy pierwszym uruchomieniu zapytania az graph zostanie wyświetlony monit o zainstalowanie rozszerzenia.

  1. Wyświetl listę dostępnych rozszerzeń i wersji:

    az extension list-available --output table

  2. Zainstaluj rozszerzenie:

    az extension add --name resource-graph

  3. Sprawdź, czy rozszerzenie zostało zainstalowane:

    az extension list --output table

  4. Wyświetl składnię rozszerzenia:

    az graph query --help

    Aby uzyskać więcej informacji na temat rozszerzeń interfejsu wiersza polecenia platformy Azure, zobacz Używanie rozszerzeń i zarządzanie nimi za pomocą interfejsu wiersza polecenia platformy Azure.

Uruchamianie zapytania

Po dodaniu rozszerzenia interfejsu wiersza polecenia platformy Azure do środowiska można uruchomić zapytanie oparte na dzierżawie. Zapytanie w tym przykładzie zwraca pięć zasobów platformy Azure z wartościami name i type każdego zasobu. Aby wykonywać zapytania według grupy zarządzania lub subskrypcji, użyj --management-groups argumentów lub --subscriptions .

  1. Uruchom zapytanie usługi Azure Resource Graph:

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

    Ten przykład zapytania nie używa modyfikatora sortowania, takiego jak order by. W przypadku wielokrotnego uruchamiania zapytania może to spowodować uzyskanie innego zestawu zasobów dla każdego żądania.

  2. Zaktualizuj zapytanie do order byname właściwości:

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

    Podobnie jak w przypadku poprzedniego zapytania, jeśli uruchamiasz to zapytanie wielokrotnie, może to spowodować uzyskanie innego zestawu zasobów dla każdego żądania. Kolejność poleceń zapytania jest ważna. W tym przykładzie polecenie order by następuje po poleceniu limit. Zapytanie ogranicza wyniki do pięciu zasobów, a następnie porządkuje te wyniki według nazwy.

  3. Zaktualizuj zapytanie do właściwości, a następnie limit dane wyjściowe do order byname pięciu wyników:

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

    Jeśli to zapytanie jest uruchamiane kilka razy bez zmian w środowisku, wyniki są spójne i uporządkowane według name właściwości, ale nadal ograniczone do pięciu wyników. Zapytanie porządkuje wyniki według nazwy, a następnie ogranicza dane wyjściowe do pięciu zasobów.

Czyszczenie zasobów

Aby usunąć rozszerzenie usługi Resource Graph, uruchom następujące polecenie:

az extension remove --name resource-graph

Aby wylogować się z sesji interfejsu wiersza polecenia platformy Azure:

az logout

Następne kroki

W tym przewodniku Szybki start uruchomiono zapytania usługi Azure Resource Graph przy użyciu rozszerzenia dla interfejsu wiersza polecenia platformy Azure. Aby dowiedzieć się więcej, przejdź do artykułu szczegółów języka zapytań.

Omówienie języka zapytań usługi Azure Resource Graph