modul plug-in http_request

Článek
11/23/2024

Platí pro: ✅Microsoft Fabric✅Azure Data Explorer

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

Požadavky

Spuštěním .enable plugin http_request povolte modul plug-in .
Nastavení identifikátoru URI pro přístup jako povoleného cíle webapi v zásadách popisku

Syntaxe

evaluatehttp_request ( Identifikátor URI [, RequestHeaders [, Options]])

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

Parametry

Název	Type	Požadováno	Popis
Identifikátor URI	`string`	✔️	Cílový identifikátor URI požadavku HTTP nebo HTTPS.
RequestHeaders	`dynamic`		Taška vlastností obsahující hlavičky HTTP, které se mají odeslat s požadavkem.
Možnosti	`dynamic`		Taška 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 naleznete 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 způsobí 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 jakéhokoli trasování vynechaly. Další informace najdete v obfuskovaných řetězcových literálech.

Návraty

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

ResponseHeaders: Taška 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, pokud 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 do odchozího požadavku HTTP. Kromě standardních hlaviček požadavků HTTP a vlastních hlaviček poskytovaných uživatelem přidá modul plug-in také následující vlastní hlavičky:

Název	Popis
`x-ms-client-request-id`	ID korelace, které identifikuje požadavek. Více vyvolá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.

Upozorňující

Příznak x-ms-readonly je nastavený pro každý požadavek HTTP odeslaný modulem plug-in, který aktivoval dotaz, a ne příkazem pro správu. Webové služby by měly s tímto příznakem zacházet jako s požadavky, které neprovádí interní změny stavu, jinak by měly požadavek odmítnout. To chrání uživatele před posíláním zdánlivě nevinných dotazů, které nakonec dělají nežádoucí změny pomocí dotazu Kusto jako spouštěcího panelu pro takové útoky.

Příklad

Následující příklad načte maloobchodní ceny Azure pro Azure Purview v západní Evropě:

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	serviceId	serviceName	skuId	skuName	type	unitOfMeasure	unitPrice
westeurope	Přehledy dat	USD	2022-06-01T00:00:00Z	false (nepravda)	Evropa – západ	8ce915f7-20db-564d-8cc3-5702a7c952ab	Spotřeba sestav Data Insights	DZH318Z08M22	Azure Purview Data Map	0.21	Analýzy	DZH318Q66D0F	Azure Purview	DZH318Z08M22/006C	Přehledy katalogu	Využití	1 Volání rozhraní API	0.21
westeurope	Rozšiřování map dat – Generování přehledů dat	USD	2022-06-01T00:00:00Z	false (nepravda)	Evropa – západ	7ce2db1d-59a0-5193-8a57-0431a10622b6	Obohacení map dat – virtuální jádro generování přehledů dat	DZH318Z08M22	Azure Purview Data Map	0.82	Analýzy	DZH318Q66D0F	Azure Purview	DZH318Z08M22/005C	Rozšiřování map dat – generování přehledů	Využití	1 hodina	0.82
westeurope		USD	2021-09-28T00:00:00Z	false (nepravda)	Evropa – západ	053e2dcb-82c0-5e50-86cd-1f1c8d803705	Virtuální jádro Power BI	DZH318Z08M23	Příjem a klasifikace vyhledávání v Azure Purview	0	Analýzy	DZH318Q66D0F	Azure Purview	DZH318Z08M23/0005	Power BI	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	Azure Purview Data Map	0.21	Analýzy	DZH318Q66D0F	Azure Purview	DZH318Z08M22/000X	Sada prostředků	Využití	1 hodina	0.21
westeurope		USD	2021-09-28T00:00:00Z	false (nepravda)	Evropa – západ	5d157295-441c-5ea7-ba7c-5083026dc456	Virtuální jádro SQL Serveru	DZH318Z08M23	Příjem a klasifikace vyhledávání v Azure Purview	0	Analýzy	DZH318Q66D0F	Azure Purview	DZH318Z08M23/000F	SQL Server	Využití	1 hodina	0
westeurope		USD	2021-09-28T00:00:00Z	false (nepravda)	Evropa – západ	0745df0d-ce4f-52db-ac31-ac574d4dcfe5	Jednotka standardní kapacity	DZH318Z08M22	Azure Purview Data Map	0.411	Analýzy	DZH318Q66D0F	Azure Purview	DZH318Z08M22/0002	Standard	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	Příjem a klasifikace vyhledávání v Azure Purview	0.63	Analýzy	DZH318Q66D0F	Azure Purview	DZH318Z08M23/0009	Standard	Využití	1 hodina	0.63

Sdílet prostřednictvím