Hızlı Başlangıç: Azure CLI kullanarak Kaynak Grafı sorgu çalıştırma

Bu hızlı başlangıçta, Azure CLI uzantısını kullanarak bir Azure Kaynak Grafı sorgusunun nasıl çalıştırıldığı açıklanmaktadır. Makalede ayrıca sorgu sonuçlarını sıralama (sıralama) ve sınırlama da gösterilmektedir. Kiracınızdaki, yönetim gruplarınızdaki veya aboneliklerinizdeki kaynaklar için bir sorgu çalıştırabilirsiniz. İşiniz bittiğinde uzantıyı kaldırabilirsiniz.

Önkoşullar

• Azure hesabınız yoksa, başlamadan önce ücretsiz hesap oluşturun.
• Kaynak Grafı uzantısı için Azure CLI 2.22.0 veya üzeri bir sürüm olmalıdır.
• Visual Studio Code.

Azure'a bağlanma

Visual Studio Code terminal oturumundan Azure'a bağlanın. Birden fazla aboneliğiniz varsa, aboneliğinize bağlam ayarlamak için komutları çalıştırın. <subscriptionID> öğesini Azure abonelik kimliğinizle değiştirin.

az login

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

Uzantıyı yükleme

Azure CLI'nın Azure Kaynak Grafı kullanarak kaynakları sorgulamasını sağlamak için Kaynak Grafı uzantısının yüklenmesi gerekir. Uzantıyı aşağıdaki adımlarla el ile yükleyebilirsiniz. Aksi takdirde, ile az graph ilk kez sorgu çalıştırdığınızda uzantıyı yüklemeniz istenir.

1. Kullanılabilir uzantıları ve sürümleri listeleyin:

   az extension list-available --output table
   

2. Uzantıyı yükleyin:

   az extension add --name resource-graph
   

3. Uzantının yüklendiğini doğrulayın:

   az extension list --output table
   

4. Uzantının söz dizimini görüntüleyin:

   az graph query --help
   

   Azure CLI uzantıları hakkında daha fazla bilgi için Azure CLI ile uzantıları kullanma ve yönetme bölümüne gidin.

Sorgu çalıştırma

Azure CLI uzantısı ortamınıza eklendikten sonra kiracı tabanlı bir sorgu çalıştırabilirsiniz. Bu örnekteki sorgu, her kaynağın ve type değerini içeren name beş Azure kaynağı döndürür. Yönetim grubuna veya aboneliğe göre sorgulamak için veya --subscriptions bağımsız değişkenlerini kullanın--management-groups.

1. Azure Kaynak Grafı sorgusu çalıştırın:

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

   Bu sorgu örneği gibi order bybir sıralama değiştirici kullanmaz. Sorguyu birden çok kez çalıştırırsanız, her istek için farklı bir kaynak kümesi verebilir.

2. Sorguyu order by şu özelliğe güncelleştirin name :

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

   Önceki sorguda olduğu gibi, bu sorguyu birden çok kez çalıştırırsanız, her istek için farklı bir kaynak kümesi verebilir. Sorgu komutlarının düzeni önemlidir. Bu örnekte order by, limit’den sonra gelmektedir. Sorgu sonuçları beş kaynakla sınırlar ve ardından bu sonuçları ada göre sıralar.

3. Sorguyu özelliğine order byname ve ardından limit çıkışı beş sonuçla güncelleştirin:

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

   Bu sorgu ortamınızda değişiklik yapılmadan birkaç kez çalıştırılırsa, sonuçlar özellik tarafından name tutarlı ve sıralı olur, ancak yine de beş sonuçla sınırlıdır. Sorgu sonuçları ada göre sıralar ve ardından çıkışı beş kaynakla sınırlar.

Kaynakları temizleme

Kaynak Grafı uzantısını kaldırmak için aşağıdaki komutu çalıştırın:

az extension remove --name resource-graph

Azure CLI oturumunuzun oturumunu kapatmak için:

az logout

Sonraki adımlar

Bu hızlı başlangıçta, Azure CLI uzantısını kullanarak Azure Kaynak Grafı sorguları çalıştırmıştınız. Daha fazla bilgi edinmek için sorgu dili ayrıntıları makalesine gidin.

Azure Kaynak Grafı sorgu dilini anlama