共用方式為


快速入門:使用 Azure CLI 執行 Resource Graph 查詢

本快速入門說明如何使用 Azure CLI 和 Resource Graph 延伸模組來執行 Azure Resource Graph 查詢。 本文也會示範如何排序及限制查詢的結果。 您可針對租用戶、管理群組或訂用帳戶中的資源執行查詢。 完成時,您可以移除延伸模組。

必要條件

  • 如果您沒有 Azure 帳戶,請在您開始之前先建立 免費帳戶
  • Azure CLI 必須是 Resource Graph 延伸模組的 2.22.0 版或更高版本。
  • 您可以在其中執行 Azure CLI 命令的 Bash 殼層環境。 例如,Visual Studio Code 終端機工作階段中的 Git Bash。

安裝 擴充功能

若要讓 Azure CLI 使用 Azure Resource Graph 查詢資源,必須安裝 Resource Graph 延伸模組。 第一次使用 az graph 執行查詢時,會顯示提示以安裝延伸模組。 否則,使用下列步驟進行手動安裝。

  1. 列出可用的延伸模組和版本:

    az extension list-available --output table
    
  2. 安裝擴充功能:

    az extension add --name resource-graph
    
  3. 確認已安裝延伸模組:

    az extension list --output table
    
  4. 顯示延伸模組的語法:

    az graph query --help
    

    如需 Azure CLI 延伸模組的詳細資訊,請移至使用和管理 Azure CLI 的延伸模組

連接到 Azure

從 Visual Studio Code 終端機工作階段中連線到 Azure。 如果您有多個訂用帳戶,請執行命令來設定您訂用帳戶的內容。 使用您的 Azure 訂用帳戶識別碼來取代 <subscriptionID>

az login

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

執行查詢

將 Azure CLI 延伸模組新增至您的環境之後,您可以執行租用戶型查詢。 此範例中的查詢會傳回五個 Azure 資源,包含每個資源的 nametype。 若要依管理群組或訂用帳戶進行查詢,請使用 --management-groups--subscriptions 引數。

  1. 執行 Azure Resource Graph 查詢:

    az graph query --graph-query 'Resources | project name, type | limit 5'
    

    此查詢範例不會使用排序修飾元,例如 order by。 如果您多次執行查詢,可能會為每個要求產生一組不同的資源。

  2. 將查詢的 order by 更新為 name 屬性:

    az graph query --graph-query 'Resources | project name, type | limit 5 | order by name asc'
    

    如同先前的查詢,如果您多次執行查詢,可能會為每個要求產生一組不同的資源。 查詢命令的順序很重要。 在此範例中,order by 會出現在 limit 之後。 查詢會將結果限制為五個資源,然後依名稱排序這些結果。

  3. 將查詢的 order by 更新為 name 屬性,然後將輸出 limit 為五個結果:

    az graph query --graph-query 'Resources | project name, type | order by name asc | limit 5'
    

    如果此查詢執行數次,且您的環境沒有任何變更,則結果會一致並依 name 屬性排序,但仍受限於五個結果。 查詢會依名稱排序結果,然後將輸出限制為五個資源。

清除資源

若要移除 Resource Graph 延伸模組,請執行下列命令:

az extension remove --name resource-graph

若要登出您的 Azure CLI 工作階段:

az logout

下一步

在本快速入門中,您已使用 Azure CLI 的延伸模組來執行 Azure Resource Graph 查詢。 若要深入了解 Resource Graph 語言,請繼續前往查詢語言詳細資料頁面。