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

Makale
03/05/2024

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 subscriptionskullanı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 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 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 önce order byName özelliğine ve ardından limit 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.

Sorgu dili hakkında daha fazla bilgi edinin