Hızlı Başlangıç: REST API kullanarak Kaynak Grafı sorgu çalıştırma

Bu hızlı başlangıçta REST API ile Azure Kaynak Grafı sorgusu çalıştırma ve sonuçları görüntüleme işlemleri açıklanmaktadır. REST API öğeleri API sürümünü ve sorguyu içeren istek gövdesini içeren bir URI'dir. Örneklerde Azure'da oturum açmak için Azure CLI kullanılır ve komut çalıştırmak az rest için hesabınızın kimliğini doğrular.

REST API konusunda bilginiz yoksa özellikle istek URI'si ve istek gövdesi olmak üzere REST API hakkında genel bilgi edinmek için Azure REST API Başvurusu sayfasını inceleyerek başlayın. Azure Kaynak Grafı belirtimleri için bkz. Azure Kaynak Grafı REST API.

Önkoşullar

• Azure hesabınız yoksa, başlamadan önce ücretsiz hesap oluşturun.
• PowerShell veya Bash kabuğunun Git Bash gibi en son sürümü.
• Azure CLI'nın en son sürümü.
• 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}

Örneklerde Azure CLI az rest komutları kullanıldığından PowerShell kullanıyor olsanız bile kullanınaz login.

REST API söz dizimini gözden geçirin

REST API komutlarını çalıştırmak için iki öğe vardır: REST API URI'si ve istek gövdesi. Bilgi için Kaynaklar'a gidin. Yönetim grubuna göre sorgulamak için yerine subscriptionskullanınmanagementGroups. Kiracının tamamını sorgulamak için istek gövdesinden managementGroups hem ve subscriptions özelliklerini atlar.

Aşağıdaki örnekte, Azure aboneliği için sorgu çalıştırmaya yönelik REST API URI söz dizimi gösterilmektedir.

POST https://management.azure.com/providers/Microsoft.ResourceGraph/resources?api-version=2022-10-01

REST API ile sorgu çalıştırmak için istek gövdesi gerekir. Aşağıdaki örnek, bir istek gövdesi dosyası oluşturmak için JSON'dır.

{
  "subscriptions": [
    "{subscriptionID}"
  ],
  "query": "Resources | project name, type | limit 5"
}

Kaynak Grafı sorguyu çalıştırma

Örneklerde aynı az rest komut kullanılır, ancak farklı sonuçlar elde etmek için istek gövdesini değiştirirsiniz. Örnekler kaynakları listeler, kaynakları özelliğe göre sıralar name ve kaynakları özelliğe göre name sıralar ve sonuç sayısını sınırlar.

Tüm sorgu örneklerini çalıştırmak için kabuk ortamınız için aşağıdaki az rest komutu kullanın:

az rest --method post --uri https://management.azure.com/providers/Microsoft.ResourceGraph/resources?api-version=2022-10-01 --body `@request-body.json

az rest --method post --uri https://management.azure.com/providers/Microsoft.ResourceGraph/resources?api-version=2022-10-01 --body @request-body.json

Her istek gövdesi örneğinde değerini Azure abonelik kimliğiniz ile değiştirin {subscriptionID} . İstek gövdesi için Azure abonelik kimliğinizi almak için aşağıdaki komutu çalıştırın:

az account show --query id --output tsv

Kaynakları listeleme

Visual Studio Code'da request-body.json adlı yeni bir dosya oluşturun. Aşağıdaki JSON dosyasını kopyalayıp dosyaya yapıştırın ve dosyayı kaydedin.

Sorgu, her kaynağın ve resource type değerini içeren name beş Azure kaynağı döndürür.

{
  "subscriptions": [
    "{subscriptionID}"
  ],
  "query": "Resources | project name, type | limit 5"
}

Bu sorgu örneği gibi order bybir sıralama değiştirici sağlamadığından, bu sorguyu birden çok kez çalıştırmak, istek başına farklı bir kaynak kümesi oluşturur.

Ada göre sıralama özelliği

request-body.json, sorguyu order by özelliğine değiştiren aşağıdaki kodla güncelleştirin.name Dosyayı kaydedin ve komutunu kullanarak az rest sorguyu çalıştırın.

{
  "subscriptions": [
    "{subscriptionID}"
  ],
  "query": "Resources | project name, type | limit 5 | order by name asc"
}

Bu sorguyu birden çok kez çalıştırırsanız, istek başına farklı bir kaynak kümesi verir.

Sorgu komutlarının düzeni önemlidir. Bu örnekte order by, limit’den sonra gelmektedir. Bu komut sırası, sorgu sonuçlarını beş kaynakla sınırlar ve sonra bunları sıralar.

Ada göre sıralama özelliği ve sınır sonuçları

request-body.json aşağıdaki kodla name order by özelliğini ve ardından limit ilk beş sonucu güncelleştirin. Dosyayı kaydedin ve sorguyu çalıştırmak için aynı az rest komutu kullanın.

{
  "subscriptions": [
    "{subscriptionID}"
  ],
  "query": "Resources | project name, type | order by name asc | limit 5"
}

Sorgu birkaç kez çalıştırılırsa, ortamınızdaki hiçbir şeyin değişmediğini varsayarsak, döndürülen sonuçlar özellik tarafından name tutarlıdır ve sıralanır, ancak ilk beş sonuçla sınırlıdır.

Kaynakları temizleme

Azure CLI oturumunuzun oturumunu kapatın.

az logout

Sonraki adımlar

Bu hızlı başlangıçta, sorgu çalıştırmak için Azure Kaynak Grafı REST API uç noktasını kullandınız. Kaynak Grafı dili hakkında daha fazla bilgi edinmek için sorgu dili ayrıntıları sayfasına geçin.