Mulai cepat: Menjalankan kueri Resource Graph menggunakan Azure CLI
Mulai cepat ini menjelaskan cara menjalankan kueri Azure Resource Graph menggunakan Azure CLI dan ekstensi Resource Graph. 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.
- Lingkungan shell Bash tempat Anda dapat menjalankan perintah Azure CLI. Misalnya, Git Bash dalam sesi terminal Visual Studio Code .
Menginstal ekstensi
Untuk mengaktifkan Azure CLI untuk mengkueri sumber daya menggunakan Azure Resource Graph, ekstensi Resource Graph harus diinstal. Pertama kali Anda menjalankan kueri dengan az graph
perintah ditampilkan untuk menginstal ekstensi. Jika tidak, gunakan langkah-langkah berikut untuk melakukan penginstalan manual.
Cantumkan ekstensi dan versi yang tersedia:
az extension list-available --output table
Instal ekstensi:
az extension add --name resource-graph
Pastikan ekstensi telah diinstal:
az extension list --output table
Tampilkan sintaks ekstensi:
az graph query --help
Untuk informasi selengkapnya tentang ekstensi Azure CLI, buka Menggunakan dan mengelola ekstensi dengan Azure CLI.
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>
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
.
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.Perbarui kueri ke
order by
name
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 setelahlimit
. Kueri membatasi hasil ke lima sumber daya lalu mengurutkan hasil tersebut berdasarkan nama.Perbarui kueri ke
order by
name
properti lalulimit
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 tentang bahasa Resource Graph, lanjutkan ke halaman detail bahasa kueri.
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk