modul plug-in http_request

  • Článek

Modul http_request plug-in odešle požadavek HTTP GET a převede odpověď na tabulku.

Požadavky

Syntax

evaluatehttp_request(URI [,RequestHeaders [,Možnosti]] )

Přečtěte si další informace o konvencích syntaxe.

Parametry

Název Typ Vyžadováno Popis
Uri string ✔️ Cílový identifikátor URI pro požadavek HTTP nebo HTTPS.
RequestHeaders dynamic Kontejner vlastností obsahující hlavičky HTTP , které se mají odeslat spolu s požadavkem.
Možnosti dynamic Kontejner vlastností obsahující další vlastnosti požadavku.

Poznámka

  • Pokud chcete zadat volitelný parametr, který následuje za volitelným parametrem, nezapomeňte zadat hodnotu pro předchozí volitelný parametr. Další informace najdete v tématu Práce s volitelnými parametry.
  • Pokud používáte ověřování, použijte protokol HTTPS. Pokusy o použití protokolu HTTP s ověřováním mají za následek chybu.

Ověřování a autorizace

K ověření použijte standardní Authorization hlavičku HTTP nebo jakoukoli vlastní hlavičku podporovanou webovou službou.

Poznámka

Pokud dotaz obsahuje důvěrné informace, ujistěte se, že jsou příslušné části textu dotazu obfuskované, aby se z trasování vynechaly. Další informace najdete v tématu obfuskované řetězcové literály.

Návraty

Modul plug-in vrátí tabulku s jedním záznamem s následujícími dynamickými sloupci:

  • ResponseHeaders: Kontejner vlastností s hlavičkou odpovědi.
  • ResponseBody: Tělo odpovědi parsované jako hodnota typu dynamic.

Pokud odpověď HTTP indikuje (prostřednictvím Content-Type hlavičky odpovědi), že typ média je application/json, text odpovědi se automaticky parsuje, jako kdyby se jedná o objekt JSON. V opačném případě se vrátí tak, jak je.

Hlavičky

Argument RequestHeaders lze použít k přidání vlastních hlaviček k odchozímu požadavku HTTP. Kromě standardních hlaviček požadavků HTTP a vlastních hlaviček zadaných uživatelem přidá modul plug-in také následující vlastní hlavičky:

Název Description
x-ms-client-request-id ID korelace, které identifikuje požadavek. Více volání modulu plug-in ve stejném dotazu bude mít stejné ID.
x-ms-readonly Příznak označující, že procesor tohoto požadavku by neměl provádět žádné trvalé změny.

Upozornění

Příznak x-ms-readonly se nastavuje pro každý požadavek HTTP odeslaný modulem plug-in, který se aktivoval dotazem, a ne pro příkaz pro správu. Webové služby by měly se všemi požadavky s tímto příznakem zacházet jako s požadavky, které neprovádí vnitřní změny stavu, jinak by měly žádost odmítnout. To chrání uživatele před odesíláním zdánlivě nevinných dotazů, které nakonec projdou nežádoucími změnami pomocí dotazu Kusto jako hlavního panelu pro takové útoky.

Příklad

Následující příklad načte maloobchodní ceny Azure pro Azure Purview v oblasti Západní Evropa:

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)

Výstup

armRegionName armSkuName currencyCode effectiveStartDate isPrimaryMeterRegion location meterId meterName productId Productname retailPrice serviceFamily ID služby Název_služby skuId skuName tierMinimumUnits typ unitOfMeasure unitPrice
westeurope Přehledy dat USD 2022-06-01T0:00:00Z false (nepravda) Evropa – západ 8ce915f7-20db-564d-8cc3-5702a7c952ab Využití sestavy Data Insights DZH318Z08M22 Mapa dat Azure Purview 0.21 Analýzy DZH318Q66D0F Azure Purview DZH318Z08M22/006C Přehledy katalogu 0 Využití 1 Volání rozhraní API 0.21
westeurope Rozšiřování map dat – Generování přehledů dat USD 2022-06-01T0:00:00Z false (nepravda) Evropa – západ 7ce2db1d-59a0-5193-8a57-0431a10622b6 Rozšiřování map dat – Generování virtuálních jader služby Data Insights DZH318Z08M22 Mapa dat Azure Purview 0,82 Analýzy DZH318Q66D0F Azure Purview DZH318Z08M22/005C Rozšiřování map dat – generování přehledů 0 Využití 1 hodina 0,82
westeurope USD 2021-09-28T00:00:00Z false (nepravda) Evropa – západ 053e2dcb-82c0-5e50-86cd-1f1c8d803705 Power BI vCore DZH318Z08M23 Azure Purview – Příjem a klasifikace prohledávání 0 Analýzy DZH318Q66D0F Azure Purview DZH318Z08M23/0005 Power BI 0 Využití 1 hodina 0
westeurope USD 2021-09-28T00:00:00Z false (nepravda) Evropa – západ a7f57f26-5f31-51e5-a5ed-ffc2b0da37b9 Virtuální jádro sady prostředků DZH318Z08M22 Mapa dat Azure Purview 0.21 Analýzy DZH318Q66D0F Azure Purview DZH318Z08M22/000X Sada prostředků 0 Využití 1 hodina 0.21
westeurope USD 2021-09-28T00:00:00Z false (nepravda) Evropa – západ 5d157295-441c-5ea7-ba7c-5083026dc456 SQL Server virtuálních jader DZH318Z08M23 Azure Purview – Příjem a klasifikace prohledávání 0 Analýzy DZH318Q66D0F Azure Purview DZH318Z08M23/000F SQL Server 0 Využití 1 hodina 0
westeurope USD 2021-09-28T00:00:00Z false (nepravda) Evropa – západ 0745df0d-ce4f-52db-ac31-ac574d4dcfe5 Jednotka kapacity Standard DZH318Z08M22 Mapa dat Azure Purview 0.411 Analýzy DZH318Q66D0F Azure Purview DZH318Z08M22/0002 Standard 0 Využití 1 hodina 0.411
westeurope USD 2021-09-28T00:00:00Z false (nepravda) Evropa – západ 811e3118-5380-5ee8-a5d9-01d48d0a0627 Standardní virtuální jádro DZH318Z08M23 Azure Purview – Příjem a klasifikace prohledávání 0.63 Analýzy DZH318Q66D0F Azure Purview DZH318Z08M23/0009 Standard 0 Využití 1 hodina 0.63

Tato funkce není ve službě Azure Monitor podporovaná.