Hızlı Başlangıç: REST API kullanarak ilk Kaynak Grafı sorgunuzu çalıştırma
Azure Kaynak Grafı'ı REST API ile kullanmanın ilk adımı, REST API'lerini çağırmak için kullanabileceğiniz bir araç olup olmadığını denetlemektir. Bu hızlı başlangıç, Azure Kaynak Grafı REST API uç noktasını çağırarak sorgu çalıştırma ve sonuçları alma işleminde size yol gösterir.
Bu işlemin sonunda REST API uç noktalarını çağırmak ve ilk Kaynak Grafı sorgunuzu çalıştırmak için araçlara sahip olacaksınız.
Önkoşullar
Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.
Azure Cloud Shell
Azure, tarayıcınız aracılığıyla kullanabileceğiniz etkileşimli bir kabuk ortamı olan Azure Cloud Shell'i barındırıyor. Azure hizmetleriyle çalışmak için Cloud Shell ile Bash veya PowerShell kullanabilirsiniz. Yerel ortamınıza herhangi bir şey yüklemek zorunda kalmadan bu makaledeki kodu çalıştırmak için Cloud Shell önceden yüklenmiş komutlarını kullanabilirsiniz.
Azure Cloud Shell'i başlatmak için:
Seçenek | Örnek/Bağlantı |
---|---|
Kodun veya komut bloğunun sağ üst köşesindeki Deneyin'i seçin. Deneyin seçildiğinde kod veya komut otomatik olarak Cloud Shell'e kopyalanmaz. | |
https://shell.azure.comadresine gidin veya Cloud Shell'i tarayıcınızda açmak için Cloud Shell'i Başlat düğmesini seçin. | |
Azure portalının sağ üst kısmındaki menü çubuğunda Cloud Shell düğmesini seçin. |
Azure Cloud Shell'i kullanmak için:
Cloud Shell'i başlatın.
Kodu veya komutu kopyalamak için kod bloğundaki (veya komut bloğundaki) Kopyala düğmesini seçin.
Windows ve Linux'ta Ctrl+Shift V'yi seçerek veya macOS üzerinde Cmd+Shift++V'yi seçerek kodu veya komutu Cloud Shell oturumuna yapıştırın.
Kodu veya komutu çalıştırmak için Enter'ı seçin.
REST API'sini kullanmaya başlama
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. Bu makalede, Azure Kaynak Grafı ile çalışmaya yönelik yönergeler sağlamak için bu kavramlar kullanılır ve bunlar hakkında çalışan bir bilgi olduğu varsayılır. ARMClient gibi araçlar yetkilendirme adımlarını otomatik olarak gerçekleştirebilir ve bu nedenle yeni başlayanlar için önerilir.
Azure Kaynak Grafı özellikleri için bkz. Azure Kaynak Grafı REST API.
REST API ve PowerShell
REST API çağrısı yapmak için bir aracınız yoksa bu yönergeleri PowerShell kullanarak gerçekleştirebilirsiniz. Aşağıdaki kod örneği, Azure'da kimlik doğrulaması için bir üst bilgi alır. Bir kimlik doğrulaması üst bilgisi (bazen Taşıyıcı belirteç olarak da adlandırılır) oluşturun ve bağlanılacak REST API URI'sini herhangi bir parametre ya da İstek Gövdesi ile sağlayın:
# Log in first with Connect-AzAccount if not using Cloud Shell
$azContext = Get-AzContext
$azProfile = [Microsoft.Azure.Commands.Common.Authentication.Abstractions.AzureRmProfileProvider]::Instance.Profile
$profileClient = New-Object -TypeName Microsoft.Azure.Commands.ResourceManager.Common.RMProfileClient -ArgumentList ($azProfile)
$token = $profileClient.AcquireAccessToken($azContext.Subscription.TenantId)
$authHeader = @{
'Content-Type'='application/json'
'Authorization'='Bearer ' + $token.AccessToken
}
# Invoke the REST API
$restUri = "https://management.azure.com/subscriptions/$($azContext.Subscription.Id)?api-version=2020-01-01"
$response = Invoke-RestMethod -Uri $restUri -Method Get -Headers $authHeader
$response
değişkeni, ConvertFrom-Json gibi cmdlet'lerle ayrıştırılabilir cmdlet'in sonucunu Invoke-RestMethod
tutar. REST API hizmet uç noktası bir İstek Gövdesi bekliyorsa Invoke-RestMethod
öğesinin -Body
parametresine JSON biçiminde bir değişken sağlayın.
İlk Kaynak Grafiği sorgunuzu çalıştırma
REST API araçları seçtiğiniz ortamınıza eklendiğinde, abonelik tabanlı basit bir Kaynak Grafı sorgusunu denemenin zamanı geldi. Sorgu, her kaynağın Ad ve Kaynak Türü ile ilk beş Azure kaynağını döndürür. Yönetim grubuna göre sorgulamak için yerine subscriptions
kullanınmanagementgroups
. Kiracının tamamını sorgulamak için istek gövdesinden managementgroups
hem ve subscriptions
özelliklerini atlar.
Her REST API çağrısının istek gövdesinde, kendi değerinizle değiştirmeniz gereken bir değişken vardır:
{subscriptionID}
- Abonelik kimliğinizle değiştirin
REST API'sini ve
resources
uç noktayı kullanarak ilk Azure Kaynak Grafı sorgunuzu çalıştırın:REST API URI'si
POST https://management.azure.com/providers/Microsoft.ResourceGraph/resources?api-version=2021-03-01
İstek Gövdesi
{ "subscriptions": [ "{subscriptionID}" ], "query": "Resources | project name, type | limit 5" }
Not
Bu sorgu örneği gibi
order by
bir sıralama değiştirici sağlamadığından, bu sorguyu birden çok kez çalıştırmak, istek başına farklı bir kaynak kümesi verebilir.Uç noktaya yapılan çağrıyı güncelleştirin
resouces
ve sorguyuorder by
Name özelliğiyle değiştirin:REST API URI'si
POST https://management.azure.com/providers/Microsoft.ResourceGraph/resources?api-version=2021-03-01
İstek Gövdesi
{ "subscriptions": [ "{subscriptionID}" ], "query": "Resources | project name, type | limit 5 | order by name asc" }
Not
İlk sorguda olduğu gibi, bu sorguyu birden çok kez çalıştırmak, muhtemelen istek başına farklı bir kaynak kümesi sunacaktır. Sorgu komutlarının düzeni önemlidir. Bu örnekte
order by
,limit
’den sonra gelmektedir. Bu komut sırası önce sorgu sonuçlarını sınırlar ve ardından bunları sıralar.Çağrıyı uç noktaya güncelleştirin
resources
ve sorguyu önceorder by
Name özelliğine ve ardındanlimit
ilk beş sonuçla değiştirin:REST API URI'si
POST https://management.azure.com/providers/Microsoft.ResourceGraph/resources?api-version=2021-03-01
İstek Gövdesi
{ "subscriptions": [ "{subscriptionID}" ], "query": "Resources | project name, type | order by name asc | limit 5" }
Son sorgu birkaç kez çalıştırıldığında, ortamınızdaki hiçbir şeyin değişmediğini varsayarsak, döndürülen sonuçlar Name özelliği tarafından tutarlı ve sıralı olur, ancak yine de ilk beş sonuçla sınırlıdır.
Azure Kaynak Grafı için REST API çağrılarına daha fazla örnek için bkz. Azure Kaynak Grafı REST Örnekleri.
Kaynakları temizleme
REST API'nin kaldıracak kitaplığı veya modülü yoktur. Çağrıları yapmak için ARMClient gibi bir araç yüklediyseniz ve artık buna ihtiyacınız yoksa, aracı şimdi kaldırabilirsiniz.
Sonraki adımlar
Bu hızlı başlangıçta, Kaynak Grafı REST API uç noktasını çağırdınız ve ilk sorgunuzu çalıştıracaksınız. Kaynak Grafı dili hakkında daha fazla bilgi edinmek için sorgu dili ayrıntıları sayfasına geçin.
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin