http_request plugin-program

  • Artikel

Plugin-programmet http_request skickar en HTTP GET-begäran och konverterar svaret till en tabell.

Förutsättningar

Syntax

evaluatehttp_request(Uri [,RequestHeaders [,alternativ]] )

Läs mer om syntaxkonventioner.

Parametrar

Namn Typ Obligatorisk Beskrivning
Uri string ✔️ Mål-URI:n för HTTP- eller HTTPS-begäran.
RequestHeaders dynamic En egenskapsuppsättning som innehåller HTTP-huvuden att skicka med begäran.
Alternativ dynamic En egenskapsuppsättning som innehåller ytterligare egenskaper för begäran.

Anteckning

  • Om du vill ange en valfri parameter som följer en valfri parameter måste du ange ett värde för den föregående valfria parametern. Mer information finns i Arbeta med valfria parametrar.
  • Om du använder autentisering använder du HTTPS-protokollet. Försök att använda HTTP med autentisering resulterar i ett fel.

Autentisering och auktorisering

Om du vill autentisera använder du HTTP-standardrubriken Authorization eller ett anpassat huvud som stöds av webbtjänsten.

Anteckning

Om frågan innehåller konfidentiell information kontrollerar du att relevanta delar av frågetexten är dolda så att de utelämnas från spårning. Mer information finns i dolda strängliteraler.

Returer

Plugin-programmet returnerar en tabell som har en enda post med följande dynamiska kolumner:

  • ResponseHeaders: En egenskapsuppsättning med svarshuvudet.
  • ResponseBody: Svarstexten tolkas som ett värde av typen dynamic.

Om HTTP-svaret anger (via Content-Type svarshuvudet) att medietypen är application/jsontolkas svarstexten automatiskt som om det är ett JSON-objekt. Annars returneras den som den är.

Sidhuvuden

Argumentet RequestHeaders kan användas för att lägga till anpassade rubriker i den utgående HTTP-begäran. Utöver standardhuvudena för HTTP-begäran och anpassade sidhuvuden som tillhandahålls av användaren lägger plugin-programmet även till följande anpassade rubriker:

Name Beskrivning
x-ms-client-request-id Ett korrelations-ID som identifierar begäran. Flera anrop av plugin-programmet i samma fråga har samma ID.
x-ms-readonly En flagga som anger att processorn för den här begäran inte ska göra några beständiga ändringar.

Varning

Flaggan x-ms-readonly anges för varje HTTP-begäran som skickas av plugin-programmet som utlöstes av en fråga och inte ett hanteringskommando. Webbtjänster bör behandla alla begäranden med den här flaggan som en begäran som inte gör ändringar i det interna tillståndet, annars bör de avvisa begäran. Detta skyddar användare från att skickas till synes oskyldiga frågor som i slutändan gör oönskade ändringar med hjälp av en Kusto-fråga som startpunkt för sådana attacker.

Exempel

I följande exempel hämtas Priser för Azure-återförsäljare för Azure Purview i Europa, västra:

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)

Resultat

armRegionName armSkuName currencyCode effectiveStartDate isPrimaryMeterRegion location meterId meterName productId Productname retailPrice serviceFamily serviceId Tjänstnamn skuId skuName tierMinimumUnits typ unitOfMeasure unitPrice
Europa, västra Data Insights USD 2022-06-01T00:00:00Z falskt Europa, västra 8ce915f7-20db-564d-8cc3-5702a7c952ab Data Insights-rapportförbrukning DZH318Z08M22 Datakarta för Azure Purview 0.21 Analys DZH318Q66D0F Azure Purview DZH318Z08M22/006C Kataloginsikter 0 Förbrukning 1 API-anrop 0.21
Europa, västra Data Map Enrichment – Data Insights-generering USD 2022-06-01T00:00:00Z falskt Europa, västra 7ce2db1d-59a0-5193-8a57-0431a10622b6 Data Map Enrichment – Data Insights Generation vCore DZH318Z08M22 Datakarta för Azure Purview 0,82 Analys DZH318Q66D0F Azure Purview DZH318Z08M22/005C Berikande av datakarta – Insiktsgenerering 0 Förbrukning 1 timme 0,82
Europa, västra USD 2021-09-28T00:00:00Z falskt Europa, västra 053e2dcb-82c0-5e50-86cd-1f1c8d803705 Virtuell Power BI-kärna DZH318Z08M23 Azure Purview-genomsökningsinmatning och -klassificering 0 Analys DZH318Q66D0F Azure Purview DZH318Z08M23/0005 Power BI 0 Förbrukning 1 timme 0
Europa, västra USD 2021-09-28T00:00:00Z falskt Europa, västra a7f57f26-5f31-51e5-a5ed-ffc2b0da37b9 Virtuell kärna för resursuppsättning DZH318Z08M22 Datakarta för Azure Purview 0.21 Analys DZH318Q66D0F Azure Purview DZH318Z08M22/000X Resursuppsättning 0 Förbrukning 1 timme 0.21
Europa, västra USD 2021-09-28T00:00:00Z falskt Europa, västra 5d157295-441c-5ea7-ba7c-5083026dc456 SQL Server virtuell kärna DZH318Z08M23 Azure Purview-genomsökningsinmatning och -klassificering 0 Analys DZH318Q66D0F Azure Purview DZH318Z08M23/000F SQL Server 0 Förbrukning 1 timme 0
Europa, västra USD 2021-09-28T00:00:00Z falskt Europa, västra 0745df0d-ce4f-52db-ac31-ac574d4dcfe5 Standardkapacitetsenhet DZH318Z08M22 Datakarta för Azure Purview 0.411 Analys DZH318Q66D0F Azure Purview DZH318Z08M22/0002 Standard 0 Förbrukning 1 timme 0.411
Europa, västra USD 2021-09-28T00:00:00Z falskt Europa, västra 811e3118-5380-5ee8-a5d9-01d48d0a0627 Virtuell standardkärn DZH318Z08M23 Azure Purview-genomsökningsinmatning och -klassificering 0.63 Analys DZH318Q66D0F Azure Purview DZH318Z08M23/0009 Standard 0 Förbrukning 1 timme 0.63

Den här funktionen stöds inte i Azure Monitor.