http_request eklentisi

  • Makale

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

Önkoşullar

  • Eklentiyi etkinleştirmek için komutunu çalıştırın .enable plugin http_request
  • Açıklama Balonu ilkesinde erişim için URI'yi izin verilen hedef webapi olarak ayarlama

Syntax

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

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

Parametreler

Ad Tür Gerekli Açıklama
Urı 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 kullanma girişimleri hatayla sonuçlanır.

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 izlemeden atlanacak şekilde sorgu metninin ilgili bölümlerinin karartılmış olduğundan emin olun. Daha fazla bilgi için bkz. karartılmış 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ünde dynamicbir değer olarak ayrıştırılır.

HTTP yanıtı medya türünün application/jsonolduğunu belirtiyorsa (yanıt üst bilgisi aracılığıylaContent-Type) yanıt gövdesi, bir JSON nesnesi gibi otomatik olarak 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:

Ad Açıklama
x-ms-client-request-id İsteği tanımlayan bağıntı kimliği. Eklentinin aynı sorgudaki 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 etmeli, aksi takdirde isteği reddetmelidir. Bu, kullanıcıları, bu tür saldırılar için başlatma çubuğu olarak kusto sorgusu kullanarak istenmeyen değişiklikler yapan masum görünen 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)

Çıkış

armRegionName armSkuName currencyCode effectiveStartDate isPrimaryMeterRegion location meterId meterName productId Productname retailPrice serviceFamily serviceId Hizmetadı skuId skuName tierMinimumUnits tür unitOfMeasure unitPrice
westeurope Veri İçgörüleri USD 2022-06-01T00:00:00Z yanlış AV Batı 8ce915f7-20db-564d-8cc3-5702a7c952ab Data Insights Rapor Tüketimi DZH318Z08M22 Azure Purview Veri Eşlemesi 0.21 Analiz DZH318Q66D0F Azure Purview DZH318Z08M22/006C Katalog İçgörüleri 0 Tüketim 1 API Çağrısı 0.21
westeurope Veri Haritası Zenginleştirme - Veri İçgörüleri Oluşturma USD 2022-06-01T00:00:00Z yanlış AV Batı 7ce2db1d-59a0-5193-8a57-0431a10622b6 Veri Eşleme zenginleştirmesi - Data Insights Oluşturma sanal çekirdeği DZH318Z08M22 Azure Purview Veri Eşlemesi 0,82 Analiz DZH318Q66D0F Azure Purview DZH318Z08M22/005C Veri Haritası Zenginleştirme - İçgörü Oluşturma 0 Tüketim 1 Saat 0,82
westeurope USD 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 USD 2021-09-28T00:00:00Z yanlış AV Batı a7f57f26-5f31-51e5-a5ed-ffc2b0da37b9 Kaynak Kümesi sanal çekirdeği DZH318Z08M22 Azure Purview Veri Eşlemesi 0.21 Analiz DZH318Q66D0F Azure Purview DZH318Z08M22/000X Kaynak Kümesi 0 Tüketim 1 Saat 0.21
westeurope USD 2021-09-28T00:00:00Z yanlış AV Batı 5d157295-441c-5ea7-ba7c-5083026dc456 sanal çekirdeği SQL Server 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 USD 2021-09-28T00:00:00Z yanlış AV Batı 0745df0d-ce4f-52db-ac31-ac574d4dcfe5 Standart Kapasite Birimi DZH318Z08M22 Azure Purview Veri Eşlemesi 0.411 Analiz DZH318Q66D0F Azure Purview DZH318Z08M22/0002 Standart 0 Tüketim 1 Saat 0.411
westeurope USD 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.