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

W tym przewodniku Szybki start opisano sposób uruchamiania zapytania usługi Azure Resource Graph przy użyciu interfejsu wiersza polecenia platformy Azure i rozszerzenia usługi Resource Graph. 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

• Jeśli nie masz jeszcze konta platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.
• Interfejs wiersza polecenia platformy Azure musi być w wersji 2.22.0 lub nowszej dla rozszerzenia usługi Resource Graph.
• Środowisko powłoki Bash, w którym można uruchamiać polecenia interfejsu wiersza polecenia platformy Azure. Na przykład powłoka Git Bash w sesji terminalu programu Visual Studio Code .

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. Przy pierwszym uruchomieniu zapytania z az graph monitem zostanie wyświetlony monit o zainstalowanie rozszerzenia. W przeciwnym razie wykonaj poniższe kroki, aby przeprowadzić instalację ręczną.

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.

Łą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>

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 by name 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 by name 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 na temat języka usługi Resource Graph, przejdź do strony szczegółów języka zapytań.