http_request-invoegtoepassing

  • Artikel

De http_request invoegtoepassing verzendt een HTTP GET-aanvraag en converteert het antwoord naar een tabel.

Vereisten

Syntax

evaluatehttp_request(URI [,RequestHeaders [,Opties]] )

Meer informatie over syntaxisconventies.

Parameters

Naam Type Vereist Beschrijving
Uri string ✔️ De doel-URI voor de HTTP- of HTTPS-aanvraag.
RequestHeaders dynamic Een eigenschappenverzameling met HTTP-headers die moeten worden verzonden met de aanvraag.
Opties dynamic Een eigenschappenverzameling met aanvullende eigenschappen van de aanvraag.

Notitie

  • Als u een optionele parameter wilt opgeven die volgt op een optionele parameter, moet u een waarde opgeven voor de voorgaande optionele parameter. Zie Werken met optionele parameters voor meer informatie.
  • Als u verificatie gebruikt, gebruikt u het HTTPS-protocol. Pogingen om HTTP met verificatie te gebruiken, resulteert in een fout.

Verificatie en autorisatie

Voor verificatie gebruikt u de standaard Authorization HTTP-header of een aangepaste header die wordt ondersteund door de webservice.

Notitie

Als de query vertrouwelijke informatie bevat, moet u ervoor zorgen dat de relevante delen van de querytekst worden verborgen, zodat ze worden weggelaten uit tracering. Zie Verborgen letterlijke tekenreeksen voor meer informatie.

Retouren

De invoegtoepassing retourneert een tabel met één record met de volgende dynamische kolommen:

  • ResponseHeaders: een eigenschappenverzameling met de antwoordheader.
  • ResponseBody: de antwoordtekst geparseerd als een waarde van het type dynamic.

Als het HTTP-antwoord aangeeft (via de Content-Type antwoordheader) dat het mediatype is, wordt application/jsonde antwoordtekst automatisch geparseerd alsof het een JSON-object is. Anders wordt het geretourneerd zoals het is.

Kopteksten

Het argument RequestHeaders kan worden gebruikt om aangepaste headers toe te voegen aan de uitgaande HTTP-aanvraag. Naast de standaard HTTP-aanvraagheaders en de door de gebruiker opgegeven aangepaste headers, voegt de invoegtoepassing ook de volgende aangepaste headers toe:

Naam Beschrijving
x-ms-client-request-id Een correlatie-id die de aanvraag identificeert. Meerdere aanroepen van de invoegtoepassing in dezelfde query hebben allemaal dezelfde id.
x-ms-readonly Een vlag die aangeeft dat de verwerker van deze aanvraag geen permanente wijzigingen mag aanbrengen.

Waarschuwing

De x-ms-readonly vlag wordt ingesteld voor elke HTTP-aanvraag die wordt verzonden door de invoegtoepassing die is geactiveerd door een query en niet voor een beheeropdracht. Webservices moeten alle aanvragen met deze vlag behandelen als een aanvraag die geen interne statuswijzigingen aanbrengt, anders moeten ze de aanvraag weigeren. Dit beschermt gebruikers tegen schijnbaar onschuldige query's die uiteindelijk ongewenste wijzigingen aanbrengen door een Kusto-query te gebruiken als launchpad voor dergelijke aanvallen.

Voorbeeld

In het volgende voorbeeld worden de detailhandelsprijzen voor Azure Purview in Europa - west opgehaald:

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)

Uitvoer

armRegionName armSkuName currencyCode effectiveStartDate isPrimaryMeterRegion location meterId meterName productId Productnaam retailPrice serviceFamily serviceId Servicenaam skuId skuName tierMinimumUnits type unitOfMeasure unitPrice
westeurope Data Insights USD 2022-06-01T00:00:00Z onjuist EU - west 8ce915f7-20db-564d-8cc3-5702a7c952ab Verbruik van Data Insights-rapporten DZH318Z08M22 Azure Purview-gegevenstoewijzing 0.21 Analyse DZH318Q66D0F Azure Purview DZH318Z08M22/006C Catalogus-inzichten 0 Verbruik 1 API-aanroepen 0.21
westeurope Gegevenstoewijzingsverrijking - Gegevensinzichten genereren USD 2022-06-01T00:00:00Z onjuist EU - west 7ce2db1d-59a0-5193-8a57-0431a10622b6 Data Map Enrichment - Data Insights Generation vCore DZH318Z08M22 Azure Purview-gegevenstoewijzing 0,82 Analyse DZH318Q66D0F Azure Purview DZH318Z08M22/005C Verrijking van gegevenstoewijzing - Inzicht genereren 0 Verbruik 1 uur 0,82
westeurope USD 2021-09-28T00:00:00Z onjuist EU - west 053e2dcb-82c0-5e50-86cd-1f1c8d803705 Power BI vCore DZH318Z08M23 Opname en classificatie van Scannen in Azure Purview 0 Analyse DZH318Q66D0F Azure Purview DZH318Z08M23/0005 Power BI 0 Verbruik 1 uur 0
westeurope USD 2021-09-28T00:00:00Z onjuist EU - west a7f57f26-5f31-51e5-a5ed-ffc2b0da37b9 Resource set vCore DZH318Z08M22 Azure Purview-gegevenstoewijzing 0.21 Analyse DZH318Q66D0F Azure Purview DZH318Z08M22/000X Resourceset 0 Verbruik 1 uur 0.21
westeurope USD 2021-09-28T00:00:00Z onjuist EU - west 5d157295-441c-5ea7-ba7c-5083026dc456 SQL Server vCore DZH318Z08M23 Opname en classificatie van Scannen in Azure Purview 0 Analyse DZH318Q66D0F Azure Purview DZH318Z08M23/000F SQL Server 0 Verbruik 1 uur 0
westeurope USD 2021-09-28T00:00:00Z onjuist EU - west 0745df0d-ce4f-52db-ac31-ac574d4dcfe5 Standaardcapaciteitseenheid DZH318Z08M22 Azure Purview-gegevenstoewijzing 0.411 Analyse DZH318Q66D0F Azure Purview DZH318Z08M22/0002 Standard 0 Verbruik 1 uur 0.411
westeurope USD 2021-09-28T00:00:00Z onjuist EU - west 811e3118-5380-5ee8-a5d9-01d48d0a0627 Standaard vCore DZH318Z08M23 Opname en classificatie van Scannen in Azure Purview 0.63 Analyse DZH318Q66D0F Azure Purview DZH318Z08M23/0009 Standard 0 Verbruik 1 uur 0.63

Deze mogelijkheid wordt niet ondersteund in Azure Monitor.