Mulai cepat: Menjalankan kueri Resource Graph menggunakan Azure CLI

Mulai cepat ini menjelaskan cara menjalankan kueri Azure Resource Graph menggunakan ekstensi untuk Azure CLI. Artikel ini juga memperlihatkan cara mengurutkan (mengurutkan) dan membatasi hasil kueri. Anda bisa menjalankan kueri untuk sumber daya di penyewa, grup manajemen, atau langganan Anda. Setelah selesai, Anda dapat menghapus ekstensi.

Prasyarat

• Jika Anda tidak memiliki akun Azure, buat akun gratis sebelum memulai.
• Azure CLI harus versi 2.22.0 atau lebih tinggi untuk ekstensi Resource Graph.
• Visual Studio Code.

Hubungkan ke Azure

Dari sesi terminal Visual Studio Code, sambungkan ke Azure. Jika Anda memiliki lebih dari satu langganan, jalankan perintah untuk mengatur konteks ke langganan Anda. Ganti <subscriptionID> dengan ID langganan Azure Anda.

az login

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

Menginstal ekstensi

Untuk mengaktifkan Azure CLI untuk mengkueri sumber daya menggunakan Azure Resource Graph, ekstensi Resource Graph harus diinstal. Anda dapat menginstal ekstensi secara manual dengan langkah-langkah berikut. Jika tidak, pertama kali Anda menjalankan kueri dengan az graph Anda diminta untuk menginstal ekstensi.

1. Cantumkan ekstensi dan versi yang tersedia:

   az extension list-available --output table
   

2. Instal ekstensi:

   az extension add --name resource-graph
   

3. Pastikan ekstensi telah diinstal:

   az extension list --output table
   

4. Tampilkan sintaks ekstensi:

   az graph query --help
   

   Untuk informasi selengkapnya tentang ekstensi Azure CLI, buka Menggunakan dan mengelola ekstensi dengan Azure CLI.

Menjalankan kueri

Setelah ekstensi Azure CLI ditambahkan ke lingkungan Anda, Anda bisa menjalankan kueri berbasis penyewa. Kueri dalam contoh ini mengembalikan lima sumber daya Azure dengan name dan type dari setiap sumber daya. Untuk membuat kueri menurut grup manajemen atau langganan, gunakan argumen --management-groups atau --subscriptions.

1. Jalankan kueri Azure Resource Graph:

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

   Contoh kueri ini tidak menggunakan pengubah pengurutan seperti order by. Jika Anda menjalankan kueri beberapa kali, kueri mungkin menghasilkan sekumpulan sumber daya yang berbeda untuk setiap permintaan.

2. Perbarui kueri ke order byname properti :

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

   Seperti kueri sebelumnya, jika Anda menjalankan kueri ini beberapa kali, kueri ini mungkin menghasilkan sekumpulan sumber daya yang berbeda untuk setiap permintaan. Urutan perintah kueri adalah hal yang penting. Dalam contoh ini, order by muncul setelah limit. Kueri membatasi hasil ke lima sumber daya lalu mengurutkan hasil tersebut berdasarkan nama.

3. Perbarui kueri ke order byname properti lalu limit output ke lima hasil:

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

   Jika kueri ini dijalankan beberapa kali tanpa perubahan pada lingkungan Anda, hasilnya konsisten dan diurutkan oleh properti, tetapi masih terbatas pada name lima hasil. Kueri mengurutkan hasil berdasarkan nama lalu membatasi output ke lima sumber daya.

Membersihkan sumber daya

Untuk menghapus ekstensi Resource Graph, jalankan perintah berikut:

az extension remove --name resource-graph

Untuk keluar dari sesi Azure CLI Anda:

az logout

Langkah berikutnya

Dalam mulai cepat ini, Anda menjalankan kueri Azure Resource Graph menggunakan ekstensi untuk Azure CLI. Untuk mempelajari selengkapnya, buka artikel detail bahasa kueri.

Memahami bahasa kueri Azure Resource Graph