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

  • Artykuł

Pierwszym krokiem do korzystania z usługi Azure Resource Graph za pomocą interfejsu wiersza polecenia platformy Azure jest sprawdzenie, czy rozszerzenie jest zainstalowane. Ten przewodnik Szybki start przeprowadzi Cię przez proces dodawania rozszerzenia do instalacji interfejsu wiersza polecenia platformy Azure. Rozszerzenia można używać z interfejsem wiersza polecenia platformy Azure zainstalowanym lokalnie lub za pośrednictwem usługi Azure Cloud Shell.

Na końcu tego procesu dodano rozszerzenie do wybranej instalacji interfejsu wiersza polecenia platformy Azure i utworzysz Resource Graph udostępnione zapytanie.

Wymagania wstępne

Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.

Dodawanie rozszerzenia usługi Resource Graph

Aby umożliwić pracę interfejsu wiersza polecenia platformy Azure z usługą Azure Resource Graph, należy dodać rozszerzenie. To rozszerzenie działa wszędzie tam, gdzie interfejs wiersza polecenia platformy Azure może być używany, w tym w funkcji bash w systemie Windows 10, usłudze Cloud Shell (autonomicznej i wewnątrz portalu), obrazie platformy Docker interfejsu wiersza polecenia platformy Azure, lub zainstalowany lokalnie.

  1. Sprawdź, czy zainstalowano najnowszy interfejs wiersza polecenia platformy Azure (co najmniej 2.8.0). Jeśli jeszcze go nie zainstalowano, postępuj zgodnie z tymi instrukcjami.

  2. W wybranym środowisku interfejsu wiersza polecenia platformy Azure użyj polecenia az extension add, aby zaimportować rozszerzenie Resource Graph za pomocą następującego polecenia:

    # Add the Resource Graph extension to the Azure CLI environment
az extension add --name resource-graph

  3. Sprawdź, czy rozszerzenie zostało zainstalowane i czy jest to oczekiwana wersja (co najmniej 1.1.0) za pomocą polecenia az extension list:

    # Check the extension list (note that you may have other extensions installed)
az extension list

# Run help for graph query options
az graph query -h

Tworzenie Resource Graph udostępnionego zapytania

Po dodaniu rozszerzenia interfejsu wiersza polecenia platformy Azure do wybranego środowiska nadszedł czas na Resource Graph udostępnione zapytanie. Zapytanie udostępnione jest obiektem usługi Azure Resource Manager, którego można udzielić lub uruchomić w Eksploratorze usługi Azure Resource Graph. Zapytanie podsumowuje liczbę wszystkich zasobów pogrupowanych według lokalizacji.

  1. Utwórz grupę zasobów za pomocą polecenia az group create w celu przechowywania udostępnionego zapytania usługi Azure Resource Graph. Ta grupa zasobów ma nazwę resource-graph-queries , a lokalizacja to westus2.

    # Login first with az login if not using Cloud Shell

# Create the resource group
az group create --name 'resource-graph-queries' --location 'westus2'

  2. Utwórz zapytanie udostępnione usługi Azure Resource Graph przy użyciu graph rozszerzenia i polecenia az graph shared-query create:

    # Create the Azure Resource Graph shared query
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 'resource-graph-queries'

  3. Wyświetl listę zapytań udostępnionych w nowej grupie zasobów. Polecenie az graph shared-query list zwraca tablicę wartości.

    # List all the Azure Resource Graph shared queries in a resource group
az graph shared-query list --resource-group 'resource-graph-queries'

  4. Aby uzyskać tylko jeden udostępniony wynik zapytania, użyj polecenia az graph shared-query show .

    # Show a specific Azure Resource Graph shared query
az graph shared-query show --resource-group 'resource-graph-queries' \
   --name 'Summarize resources by location'

  5. Uruchom zapytanie udostępnione w interfejsie wiersza polecenia platformy Azure przy użyciu {{shared-query-uri}} składni w poleceniu az graph query . Najpierw skopiuj id pole z wyniku poprzedniego show polecenia. Zastąp shared-query-uri tekst w przykładzie wartością z id pola, ale pozostaw otaczające znaki {{ i }} .

    # Run a Azure Resource Graph shared query
az graph query --graph-query "{{shared-query-uri}}"

    Uwaga

    Składnia {{shared-query-uri}} jest funkcją w wersji zapoznawczej .

Innym sposobem znajdowania zapytań udostępnionych Resource Graph jest Azure Portal. W portalu użyj paska wyszukiwania, aby wyszukać frazę "Resource Graph zapytania". Wybierz zapytanie udostępnione. Na stronie Przegląd na karcie Zapytanie zostanie wyświetlone zapisane zapytanie. Przycisk Edytuj otwiera go w eksploratorze Resource Graph.

Czyszczenie zasobów

Jeśli chcesz usunąć Resource Graph udostępnione zapytanie, grupę zasobów i rozszerzenie ze środowiska interfejsu wiersza polecenia platformy Azure, możesz to zrobić przy użyciu następujących poleceń:

# Delete the Azure Resource Graph shared query
az graph shared-query delete --resource-group 'resource-graph-queries' \
   --name 'Summarize resources by location'

# Remove the resource group
# WARNING: This command deletes ALL resources you've added to this resource group without prompting for confirmation
az group delete --resource-group 'resource-graph-queries' --yes

# Remove the Azure Resource Graph extension from the Azure CLI environment
az extension remove -n resource-graph

Następne kroki

W tym przewodniku Szybki start dodano rozszerzenie Resource Graph do środowiska interfejsu wiersza polecenia platformy Azure i utworzono udostępnione zapytanie. Aby dowiedzieć się więcej na temat języka Resource Graph, przejdź do strony szczegółów języka zapytań.

Uzyskaj więcej informacji na temat języka zapytań