Aracılığıyla paylaş

http_request eklentisi

  • Makale

Eklenti http_request bir HTTP GET isteği gönderir ve yanıtı bir tabloya dönüştürür.

Önkoşullar

Sözdizimi

evaluatehttp_request ( Uri [ , RequestHeaders [, Seçenekler]])

Söz dizimi kuralları hakkında daha fazla bilgi edinin.

Parametreler

Ad Tür Zorunlu Açıklama
Uri string ✔️ HTTP veya HTTPS isteği için hedef URI.
RequestHeaders dynamic İstekle birlikte gönderilecek HTTP üst bilgilerini içeren bir özellik paketi.
Seçenekler dynamic İsteğin ek özelliklerini içeren bir özellik paketi.

Not

  • İsteğe bağlı parametreyi izleyen isteğe bağlı bir parametre belirtmek için, önceki isteğe bağlı parametre için bir değer sağladığından emin olun. Daha fazla bilgi için bkz . İsteğe bağlı parametrelerle çalışma.
  • Kimlik doğrulaması kullanıyorsanız HTTPS protokolunu kullanın. Kimlik doğrulamasıyla HTTP'yi kullanmaya çalıştığınızda hata oluşur.

Kimlik doğrulaması ve yetkilendirme

Kimlik doğrulaması yapmak için HTTP standart Authorization üst bilgisini veya web hizmeti tarafından desteklenen herhangi bir özel üst bilgiyi kullanın.

Not

Sorgu gizli bilgiler içeriyorsa, herhangi bir izlemenin atlanması için sorgu metninin ilgili bölümlerinin gizlendiğinden emin olun. Daha fazla bilgi için bkz . belirsiz dize değişmez değerleri.

Döndürülenler

Eklenti, aşağıdaki dinamik sütunlara sahip tek bir kaydı olan bir tablo döndürür:

  • ResponseHeaders: Yanıt üst bilgisini içeren bir özellik paketi.
  • ResponseBody: Yanıt gövdesi türündeki dynamicbir değer olarak ayrıştırılır.

HTTP yanıtı medya türünün application/jsonolduğunu belirtirse (yanıt üst bilgisi aracılığıylaContent-Type), yanıt gövdesi otomatik olarak bir JSON nesnesi gibi ayrıştırılır. Aksi takdirde olduğu gibi döndürülür.

Üst Bilgiler

RequestHeaders bağımsız değişkeni, giden HTTP isteğine özel üst bilgiler eklemek için kullanılabilir. Eklenti, standart HTTP isteği üst bilgilerine ve kullanıcı tarafından sağlanan özel üst bilgilerine ek olarak aşağıdaki özel üst bilgileri de ekler:

Veri Akışı Adı Açıklama
x-ms-client-request-id İsteği tanımlayan bağıntı kimliği. Aynı sorgudaki eklentinin birden çok çağrısının tümü aynı kimlikte olur.
x-ms-readonly Bu isteğin işlemcisinin kalıcı bir değişiklik yapmaması gerektiğini belirten bir bayrak.

Uyarı

Bayrağı x-ms-readonly , yönetim komutu değil, sorgu tarafından tetiklenen eklenti tarafından gönderilen her HTTP isteği için ayarlanır. Web hizmetleri, bu bayrakla yapılan tüm istekleri iç durum değişiklikleri yapmayan istekler olarak kabul etmelidir, aksi takdirde isteği reddetmelidir. Bu, kullanıcıların bu tür saldırılar için başlatma çubuğu olarak kusto sorgusu kullanarak istenmeyen değişiklikler yapan görünüşte masum sorgular gönderilmesini engeller.

Örnek

Aşağıdaki örnek, Batı Avrupa'daki Azure Purview için Azure perakende satış fiyatlarını alır:

let Uri = "https://prices.azure.com/api/retail/prices?$filter=serviceName eq 'Azure Purview' and location eq 'EU West'";
evaluate http_request(Uri)
| project ResponseBody.Items
| mv-expand ResponseBody_Items
| evaluate bag_unpack(ResponseBody_Items)

Çıktı

armRegionName armSkuName currencyCode effectiveStartDate isPrimaryMeterRegion konum meterId meterName productId productName retailPrice serviceFamily serviceId serviceName skuId skuName tierMinimumUnits Tür unitOfMeasure unitPrice
westeurope Veri İçgörüleri ABD Doları 2022-06-01T00:00:00Z yanlış AV Batı 8ce915f7-20db-564d-8cc3-5702a7c952ab Data Insights Rapor Tüketimi DZH318Z08M22 Azure Purview Veri Haritası 0.21 Analiz DZH318Q66D0F Azure Purview DZH318Z08M22/006C Katalog İçgörüleri 0 Tüketim 1 API Çağrısı 0.21
westeurope Veri Eşlemesi Zenginleştirme - Data Insights Oluşturma ABD Doları 2022-06-01T00:00:00Z yanlış AV Batı 7ce2db1d-59a0-5193-8a57-0431a10622b6 Veri Eşlemesi Zenginleştirme - Data Insights Oluşturma sanal çekirdeği DZH318Z08M22 Azure Purview Veri Haritası 0.82 Analiz DZH318Q66D0F Azure Purview DZH318Z08M22/005C Veri Eşlemesi Zenginleştirme - İçgörü Oluşturma 0 Tüketim 1 Saat 0.82
westeurope ABD Doları 2021-09-28T00:00:00Z yanlış AV Batı 053e2dcb-82c0-5e50-86cd-1f1c8d803705 Power BI sanal çekirdeği DZH318Z08M23 Azure Purview Tarama Alımı ve Sınıflandırması 0 Analiz DZH318Q66D0F Azure Purview DZH318Z08M23/0005 Power BI 0 Tüketim 1 Saat 0
westeurope ABD Doları 2021-09-28T00:00:00Z yanlış AV Batı a7f57f26-5f31-51e5-a5ed-ffc2b0da37b9 Kaynak Kümesi sanal çekirdeği DZH318Z08M22 Azure Purview Veri Haritası 0.21 Analiz DZH318Q66D0F Azure Purview DZH318Z08M22/000X Kaynak Kümesi 0 Tüketim 1 Saat 0.21
westeurope ABD Doları 2021-09-28T00:00:00Z yanlış AV Batı 5d157295-441c-5ea7-ba7c-5083026dc456 SQL Server sanal çekirdeği DZH318Z08M23 Azure Purview Tarama Alımı ve Sınıflandırması 0 Analiz DZH318Q66D0F Azure Purview DZH318Z08M23/000F SQL Server 0 Tüketim 1 Saat 0
westeurope ABD Doları 2021-09-28T00:00:00Z yanlış AV Batı 0745df0d-ce4f-52db-ac31-ac574d4dcfe5 Standart Kapasite Birimi DZH318Z08M22 Azure Purview Veri Haritası 0.411 Analiz DZH318Q66D0F Azure Purview DZH318Z08M22/0002 Standart 0 Tüketim 1 Saat 0.411
westeurope ABD Doları 2021-09-28T00:00:00Z yanlış AV Batı 811e3118-5380-5ee8-a5d9-01d48d0a0627 Standart sanal çekirdek DZH318Z08M23 Azure Purview Tarama Alımı ve Sınıflandırması 0.63 Analiz DZH318Q66D0F Azure Purview DZH318Z08M23/0009 Standart 0 Tüketim 1 Saat 0.63

Bu özellik Azure İzleyici'de desteklenmez.