Olvasás angol nyelven

Megosztás a következőn keresztül:

Rövid útmutató: Megosztott Resource Graph-lekérdezés létrehozása az Azure CLI használatával

  • Cikk

Ez a rövid útmutató bemutatja, hogyan hozhat létre megosztott Azure Resource Graph-lekérdezést az Azure CLI-vel és a Resource Graph-bővítménysel. Az az graph shared-query parancs az az graph query kísérleti funkciója.

A megosztott lekérdezések futtathatók az Azure CLI-ből a kísérleti funkció parancsaival, vagy futtathatja a megosztott lekérdezést az Azure Portalon. A megosztott lekérdezés egy Azure Resource Manager-objektum, amely engedélyt adhat az Azure Resource Graph Explorerben való futtatásra vagy annak futtatására. Ha végzett, eltávolíthatja a Resource Graph-bővítményt.

Előfeltételek

  • Ha még nem rendelkezik Azure-fiókkal, első lépésként hozzon létre egy ingyenes fiókot.
  • Az Azure CLI-nek a Resource Graph-bővítmény 2.22.0-s vagy újabb verziójának kell lennie.
  • Egy Bash-rendszerhéj-környezet, ahol Azure CLI-parancsokat futtathat. Például a Git Bash egy Visual Studio Code-terminál munkamenetben.

A bővítmény telepítése

Ahhoz, hogy az Azure CLI lekérdezhesse az erőforrásokat az Azure Resource Graph használatával, telepíteni kell a Resource Graph-bővítményt. Amikor első alkalommal futtat egy lekérdezést egy kéréssel az graph , megjelenik a bővítmény telepítéséhez. Ellenkező esetben a következő lépésekkel végezhet manuális telepítést.

  1. Az elérhető bővítmények és verziók listázása:

    Azure CLI 
    az extension list-available --output table

  2. A bővítmény telepítése:

    Azure CLI 
    az extension add --name resource-graph

  3. Ellenőrizze, hogy a bővítmény telepítve van-e:

    Azure CLI 
    az extension list --output table

  4. A bővítmény szintaxisának megjelenítése:

    Azure CLI 
    az graph query --help

Az Azure CLI-bővítményekkel kapcsolatos további információkért tekintse meg a bővítmények használatát és kezelését az Azure CLI-vel.

Csatlakozás az Azure szolgáltatáshoz

Egy Visual Studio Code-terminál munkamenetből csatlakozzon az Azure-hoz. Ha több előfizetéssel rendelkezik, futtassa a parancsokat az előfizetés környezetének beállításához. Cserélje le a <subscriptionID> értékét a saját Azure-előfizetése azonosítójára.

Azure CLI 
az login

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

Megosztott lekérdezés létrehozása

Hozzon létre egy erőforráscsoportot és egy megosztott csoportot, amely a hely szerint csoportosított összes erőforrás számát összegzi.

  1. Hozzon létre egy erőforráscsoportot az Azure Resource Graph megosztott lekérdezésének tárolásához.

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

  2. Hozza létre a megosztott lekérdezést.

    Azure CLI 
    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. Az erőforráscsoport összes megosztott lekérdezésének listázása.

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

  4. Az eredmények korlátozása egy adott megosztott lekérdezésre.

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

A megosztott lekérdezés futtatása

A megosztott lekérdezés futtatásához használhatja az Azure CLI kísérleti funkciószintaxisát vagy az Azure Portalt.

Kísérleti funkció használata megosztott lekérdezés futtatásához

Futtassa a megosztott lekérdezést az Azure CLI-ben egy {{shared-query-uri}} az graph query parancs szintaxisával. Lekérheti a megosztott lekérdezés erőforrás-azonosítóját, és egy változóban tárolhatja. A változót a rendszer a megosztott lekérdezés futtatásakor használja.

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

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

A paraméter használatával subscriptions korlátozhatja az eredményeket.

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

A megosztott lekérdezés futtatása a portálról

Az Azure Resource Graph Explorerrel ellenőrizheti, hogy a megosztott lekérdezés működik-e. A hatókör módosításához használja a lap bal oldalán található Hatókör menüt.

  1. Jelentkezzen be az Azure Portalra.
  2. Írja be az erőforrásdiagramot a lap tetején található keresőmezőbe.
  3. Válassza a Resource Graph Explorer lehetőséget.
  4. Válassza a Lekérdezés megnyitása lehetőséget.
  5. Típus módosítása megosztott lekérdezésekre.
  6. Válassza ki a virtuális gépek számának lekérdezését operációs rendszer szerint.
  7. Válassza a Lekérdezés futtatása és a nézet kimenete lehetőséget az Eredmények lapon.
  8. Válassza a Diagramok lehetőséget, majd a Térkép lehetőséget a helytérkép megtekintéséhez.

A lekérdezést az erőforráscsoportból is futtathatja.

  1. Az Azure-ban nyissa meg a demoSharedQuery erőforráscsoportot.
  2. Az Áttekintés lapon válassza ki a virtuális gépek száma operációs rendszer szerinti lekérdezést.
  3. Válassza az Eredmények lapot.
  4. Válassza a Diagramok lehetőséget, majd a Térkép lehetőséget a helytérkép megtekintéséhez.

Az erőforrások eltávolítása

A megosztott lekérdezés eltávolítása:

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

Egy erőforráscsoport törlésekor az erőforráscsoport és annak összes erőforrása törlődik. Az erőforráscsoport eltávolítása:

Azure CLI 
az group delete --name demoSharedQuery

A Resource Graph-bővítmény eltávolításához futtassa a következő parancsot:

Azure CLI 
az extension remove --name resource-graph

Kijelentkezés az Azure CLI-munkamenetből:

Azure CLI 
az logout

Következő lépések

Ebben a rövid útmutatóban hozzáadta a Resource Graph-bővítményt az Azure CLI-környezethez, és létrehozott egy megosztott lekérdezést. A Resource Graph nyelvével kapcsolatos további információkért lépjen a lekérdezés nyelvének részleteit tartalmazó oldalra.

Az Azure Resource Graph lekérdezési nyelvének ismertetése