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

Artykuł
06/28/2024

W tym przewodniku Szybki start opisano sposób tworzenia udostępnionego zapytania usługi Azure Resource Graph za pomocą interfejsu wiersza polecenia platformy Azure i rozszerzenia usługi Resource Graph. Polecenia az graph shared-query to eksperymentalna funkcja polecenia az graph query.

Zapytanie udostępnione można uruchomić z poziomu interfejsu wiersza polecenia platformy Azure za pomocą poleceń funkcji eksperymentalnych lub uruchomić zapytanie udostępnione w witrynie Azure Portal. 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 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ą.

Wyświetl listę dostępnych rozszerzeń i wersji:
```
az extension list-available --output table
```
Zainstaluj rozszerzenie:
```
az extension add --name resource-graph
```
Sprawdź, czy rozszerzenie zostało zainstalowane:
```
az extension list --output table
```
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>

Tworzenie udostępnionego zapytania

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

Utwórz grupę zasobów do przechowywania udostępnionego zapytania usługi Azure Resource Graph.
```
az group create --name "demoSharedQuery" --location westus2
```

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

Wyświetl listę wszystkich udostępnionych zapytań w grupie zasobów.
```
az graph shared-query list --resource-group demoSharedQuery
```

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 interfejsie wiersza polecenia platformy Azure przy użyciu {{shared-query-uri}} składni 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.

Zaloguj się do Portalu Azure.
Wprowadź wykres zasobów w polu wyszukiwania w górnej części strony.
Wybierz pozycję Eksplorator usługi Resource Graph.
Wybierz pozycję Otwarte zapytanie.
Zmień typ na Udostępnione zapytania.
Wybierz zapytanie Liczba maszyn wirtualnych według systemu operacyjnego.
Wybierz pozycję Uruchom zapytanie i wyświetl dane wyjściowe na karcie Wyniki .
Wybierz pozycję Wykresy , a następnie wybierz pozycję Mapa , aby wyświetlić mapę lokalizacji.

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

Na platformie Azure przejdź do grupy zasobów demoSharedQuery.
Na karcie Przegląd wybierz zapytanie Liczba maszyn wirtualnych według systemu operacyjnego.
Wybierz kartę Wyniki .
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ń.

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

Udostępnij za pośrednictwem