分享方式:


快速入門:使用 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

從 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 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 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 查詢。 若要深入了解,請移至查詢語言詳細資料一文。