Szybki start: tworzenie zapytania udostępnionego usługi Resource Graph przy użyciu interfejsu wiersza polecenia platformy Azure

W tym szybkim starcie opisano, jak utworzyć udostępnione zapytanie Azure Resource Graph przy użyciu Azure CLI i rozszerzenia Resource Graph. Polecenia az graph shared-query są funkcją eksperymentalną w ramach az graph query.

Zapytanie udostępnione można uruchomić z poziomu Azure CLI za pomocą poleceń funkcji eksperymentalnych lub uruchomić zapytanie udostępnione w portalu Azure. Zapytanie udostępnione to obiekt usługi Azure Resource Manager, który można udzielić uprawnień lub uruchomić w Eksploratorze usługi Azure Resource Graph. Po zakończeniu możesz usunąć rozszerzenie usługi Resource Graph.

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 Git Bash w sesji terminala 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 swoją 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>

Tworzenie udostępnionego zapytania

Utwórz grupę zasobów i wspólną sumę, która podsumowuje liczbę wszystkich zasobów pogrupowanych według lokalizacji.

1. Utwórz grupę zasobów do przechowywania udostępnionego zapytania usługi Azure Resource Graph.

   az group create --name "demoSharedQuery" --location westus2
   

2. Utwórz udostępnione zapytanie.

   az graph shared-query create --name "Summarize resources by location" \
     --description "This shared query summarizes resources by location for a pinnable map graphic." \
     --graph-query "Resources | summarize count() by location" \
     --resource-group demoSharedQuery
   

3. Wyświetl listę wszystkich udostępnionych zapytań w grupie zasobów.

   az graph shared-query list --resource-group demoSharedQuery
   

4. Ogranicz wyniki do określonego udostępnionego zapytania.

   az graph shared-query show --resource-group "demoSharedQuery" \
     --name "Summarize resources by location"
   

Uruchamianie udostępnionego zapytania

Aby uruchomić udostępnione zapytanie, możesz użyć składni funkcji eksperymentalnej interfejsu wiersza polecenia platformy Azure lub witryny Azure Portal.

Uruchamianie zapytania udostępnionego przy użyciu funkcji eksperymentalnej

Uruchom zapytanie udostępnione w Azure CLI, używając składni {{shared-query-uri}} w poleceniu az graph query. Otrzymasz identyfikator zasobu udostępnionego zapytania i zapiszesz go w zmiennej. Zmienna jest używana podczas uruchamiania udostępnionego zapytania.

sharedqueryid=$(az graph shared-query show --resource-group "demoSharedQuery" \
  --name "Summarize resources by location" \
  --query id \
  --output tsv)

az graph query --graph-query "{{$sharedqueryid}}"

Możesz użyć parametru subscriptions , aby ograniczyć wyniki.

az graph query --graph-query "{{$sharedqueryid}}" --subscriptions 11111111-1111-1111-1111-111111111111

Uruchamianie udostępnionego zapytania z portalu

Możesz sprawdzić, czy udostępnione zapytanie działa przy użyciu Eksploratora usługi Azure Resource Graph. Aby zmienić zakres, użyj menu Zakres po lewej stronie.

1. Zaloguj się do Portalu Azure.
2. Wprowadź graf zasobów w polu wyszukiwania znajdującym się w górnej części strony.
3. Wybierz Eksplorator Resource Graph.
4. Wybierz pozycję Otwarte zapytanie.
5. Zmień typ na Udostępnione zapytania.
6. Wybierz zapytanie Podsumuj zasoby według lokalizacji.
7. Wybierz pozycję Uruchom zapytanie i wyświetl dane wyjściowe na karcie Wyniki .
8. Wybierz pozycję Wykresy , a następnie wybierz pozycję Mapa , aby wyświetlić mapę lokalizacji.

Możesz również uruchomić zapytanie z grupy zasobów.

1. Na platformie Azure przejdź do grupy zasobów demoSharedQuery.
2. Na karcie Przegląd wybierz zapytanie Podsumuj zasoby według lokalizacji.
3. Wybierz kartę Wyniki .
4. Wybierz pozycję Wykresy , a następnie wybierz pozycję Mapa , aby wyświetlić mapę lokalizacji.

Czyszczenie zasobów

Aby usunąć udostępnione zapytanie:

az graph shared-query delete --name "Summarize resources by location" --resource-group demoSharedQuery

Gdy grupa zasobów zostanie usunięta, grupa zasobów i wszystkie jej zasoby zostaną usunięte. Aby usunąć grupę zasobów:

az group delete --name demoSharedQuery

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 dodano rozszerzenie usługi Resource Graph do środowiska interfejsu wiersza polecenia platformy Azure i utworzono udostępnione zapytanie. Aby dowiedzieć się więcej na temat języka usługi Resource Graph, przejdź do strony szczegółów języka zapytań.