Mulai Cepat: Menjalankan kueri Azure Resource Graph pertama Anda menggunakan Azure CLI

Langkah pertama untuk menggunakan Azure Resource Graph adalah memeriksa apakah ekstensi untuk Azure CLI diinstal. Mulai cepat ini memandu Anda melalui proses penambahan ekstensi ke penginstalan Azure CLI Anda. Anda dapat menggunakan ekstensi dengan Azure CLI yang diinstal secara lokal atau melalui Azure Cloud Shell.

Pada akhir proses ini, Anda akan menambahkan ekstensi ke penginstalan pilihan Azure CLI Anda dan menjalankan kueri Azure Resource Graph pertama Anda.

Prasyarat

Jika Anda tidak memiliki langganan Azure, buat akun gratis sebelum Anda memulai.

Menambahkan ekstensi Azure Resource Graph

Untuk mengaktifkan Azure CLI dalam mengkueri Azure Resource Graph, ekstensi harus ditambahkan. Ekstensi ini berfungsi di mana pun yang dapat menggunakan Azure CLI, termasuk bash pada Windows 10, Cloud Shell (baik mandiri maupun di dalam portal), gambar Azure CLI Docker, atau diinstal secara lokal.

  1. Periksa apakah Azure CLI terbaru terinstal (setidaknya 2.0.76). Jika belum diinstal, ikuti petunjuk ini.

  2. Di lingkungan Azure CLI yang Anda pilih, impor dengan perintah berikut:

    # Add the Resource Graph extension to the Azure CLI environment
    az extension add --name resource-graph
    
  3. Validasi apakah ekstensi telah dipasang dan merupakan versi yang diharapkan (setidaknya 1.0.0):

    # Check the extension list (note that you may have other extensions installed)
    az extension list
    
    # Run help for graph query options
    az graph query -h
    

Menjalankan kueri Azure Resource Graph pertama Anda

Dengan ekstensi Azure CLI ditambahkan ke lingkungan pilihan Anda, saatnya untuk mencoba kueri sederhana Azure Resource Graph sederhana-berbasis penyewa. Kuerinya menampilkan lima sumber daya Azure pertama dengan Nama dan Jenis Sumber Daya setiap sumber daya. Untuk membuat kueri menurut grup manajemen atau langganan, gunakan argumen --managementgroups atau --subscriptions.

  1. Jalankan kueri Azure Resource Graph pertama Anda menggunakan ekstensi graph dan perintah query:

    # Login first with az login if not using Cloud Shell
    
    # Run Azure Resource Graph query
    az graph query -q 'Resources | project name, type | limit 5'
    

    Catatan

    Karena contoh kueri ini tidak menyediakan pengubah pengurutan seperti order by, menjalankan kueri ini beberapa kali kemungkinan akan menghasilkan serangkaian sumber daya yang berbeda per permintaan.

  2. Perbarui kueri ke properti order byNama:

    # Run Azure Resource Graph query with 'order by'
    az graph query -q 'Resources | project name, type | limit 5 | order by name asc'
    

    Catatan

    Sama seperti kueri pertama, menjalankan kueri ini beberapa kali kemungkinan akan menghasilkan kumpulan sumber daya yang berbeda per permintaan. Urutan perintah kueri adalah hal yang penting. Dalam contoh ini, order by muncul setelah limit. Urutan perintah ini terlebih dahulu membatasi hasil kueri lalu mengurutkannya.

  3. Perbarui kueri ke properti order byNama terlebih dahulu, lalu limit ke lima hasil teratas:

    # Run Azure Resource Graph query with `order by` first, then with `limit`
    az graph query -q 'Resources | project name, type | order by name asc | limit 5'
    

Ketika kueri akhir dijalankan beberapa kali, dengan asumsi bahwa tidak ada yang berubah di lingkungan Anda, hasil yang ditampilkan konsisten dan diurutkan berdasarkan properti Nama, tetapi masih terbatas pada lima hasil teratas.

Membersihkan sumber daya

Jika Anda ingin menghapus ekstensi Azure Resource Graph dari lingkungan Azure CLI, Anda bisa melakukannya dengan menggunakan perintah berikut:

# Remove the Resource Graph extension from the Azure CLI environment
az extension remove -n resource-graph

Langkah berikutnya

Dalam mulai cepat ini, Anda telah menambahkan paket Azure Resource Graph ke lingkungan Azure CLI dan menjalankan kueri pertama Anda. Untuk mempelajari selengkapnya tentang bahasa Azure Resource Graph, lanjutkan ke halaman detail bahasa kueri.