Share via

Plug-In „http_request“

  • Artikel

Das http_request Plug-In sendet eine HTTP GET-Anforderung und konvertiert die Antwort in eine Tabelle.

Voraussetzungen

Syntax

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

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name Typ Erforderlich BESCHREIBUNG
URI string ✔️ Der Ziel-URI für die HTTP- oder HTTPS-Anforderung.
RequestHeaders dynamic Ein Eigenschaftenbehälter, der HTTP-Header enthält , die mit der Anforderung gesendet werden sollen.
Optionen dynamic Ein Eigenschaftenbehälter, der zusätzliche Eigenschaften der Anforderung enthält.

Hinweis

  • Um einen optionalen Parameter anzugeben, der auf einen optionalen Parameter folgt, stellen Sie sicher, dass Sie einen Wert für den vorherigen optionalen Parameter angeben. Weitere Informationen finden Sie unter Arbeiten mit optionalen Parametern.
  • Wenn Sie die Authentifizierung verwenden, verwenden Sie das HTTPS-Protokoll. Versuche, HTTP mit Authentifizierung zu verwenden, führen zu einem Fehler.

Authentifizierung und Autorisierung

Verwenden Sie zum Authentifizieren den HTTP-Standardheader Authorization oder einen beliebigen benutzerdefinierten Header, der vom Webdienst unterstützt wird.

Hinweis

Wenn die Abfrage vertrauliche Informationen enthält, stellen Sie sicher, dass die relevanten Teile des Abfragetexts verschleiert sind, sodass sie bei jeder Ablaufverfolgung ausgelassen werden. Weitere Informationen finden Sie unter Verschleierte Zeichenfolgenliterale.

Gibt zurück

Das Plug-In gibt eine Tabelle zurück, die einen einzelnen Datensatz mit den folgenden dynamischen Spalten enthält:

  • ResponseHeaders: Ein Eigenschaftenbehälter mit dem Antwortheader.
  • ResponseBody: Der Antworttext, der als Wert vom Typ dynamicanalysiert wird.

Wenn die HTTP-Antwort (über den Content-Type Antwortheader) angibt, dass der Medientyp lautet application/json, wird der Antworttext automatisch analysiert, wenn es sich um ein JSON-Objekt handelt. Andernfalls wird sie unverändert zurückgegeben.

Header

Das Argument RequestHeaders kann verwendet werden, um der ausgehenden HTTP-Anforderung benutzerdefinierte Header hinzuzufügen. Zusätzlich zu den standardmäßigen HTTP-Anforderungsheadern und den vom Benutzer bereitgestellten benutzerdefinierten Headern fügt das Plug-In auch die folgenden benutzerdefinierten Header hinzu:

Name BESCHREIBUNG
x-ms-client-request-id Eine Korrelations-ID, die die Anforderung identifiziert. Mehrere Aufrufe des Plug-Ins in derselben Abfrage weisen alle dieselbe ID auf.
x-ms-readonly Ein Flag, das angibt, dass der Prozessor dieser Anforderung keine dauerhaften Änderungen vornehmen sollte.

Warnung

Das x-ms-readonly Flag wird für jede HTTP-Anforderung festgelegt, die vom Plug-In gesendet wird, das von einer Abfrage und nicht von einem Verwaltungsbefehl ausgelöst wurde. Webdienste sollten alle Anforderungen mit diesem Flag so behandeln, dass keine internen Zustandsänderungen vorgenommen werden. Andernfalls sollten sie die Anforderung ablehnen. Dies schützt Benutzer vor scheinbar unschuldigen Abfragen, die am Ende unerwünschte Änderungen vornehmen, indem eine Kusto-Abfrage als Launchpad für solche Angriffe verwendet wird.

Beispiel

Im folgenden Beispiel werden Die Azure-Einzelhandelspreise für Azure Purview in Europa, Westen abgerufen:

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)

Ausgabe

armRegionName armSkuName currencyCode effectiveStartDate isPrimaryMeterRegion location meterId meterName productId ProductName retailPrice serviceFamily serviceId serviceName skuId skuName tierMinimumUnits Typ unitOfMeasure unitPrice
westeurope Datenerkenntnisse USD 2022-06-01T00:00:00Z false Europa, Westen 8ce915f7-20db-564d-8cc3-5702a7c952ab Data Insights-Berichtsverbrauch DZH318Z08M22 Azure Purview Data Map 0,21 Analyse DZH318Q66D0F Azure Purview DZH318Z08M22/006C Katalogerkenntnisse 0 Nutzung 1 API-Aufrufe 0,21
westeurope Data Map-Anreicherung – Data Insights-Generierung USD 2022-06-01T00:00:00Z false Europa, Westen 7ce2db1d-59a0-5193-8a57-0431a10622b6 Datenzuordnungsanreicherung – Data Insights Generation vCore DZH318Z08M22 Azure Purview Data Map 0,82 Analyse DZH318Q66D0F Azure Purview DZH318Z08M22/005C Anreicherung von Datenzuordnungen – Insight-Generierung 0 Nutzung 1 Stunde 0,82
westeurope USD 2021-09-28T00:00:00Z false Europa, Westen 053e2dcb-82c0-5e50-86cd-1f1c8d803705 Virtuelle Kerne von Power BI DZH318Z08M23 Erfassung und Klassifizierung von Azure Purview Scanning 0 Analyse DZH318Q66D0F Azure Purview DZH318Z08M23/0005 Power BI 0 Nutzung 1 Stunde 0
westeurope USD 2021-09-28T00:00:00Z false Europa, Westen a7f57f26-5f31-51e5-a5ed-ffc2b0da37b9 Virtueller Kern des Ressourcensatzes DZH318Z08M22 Azure Purview Data Map 0,21 Analyse DZH318Q66D0F Azure Purview DZH318Z08M22/000X Ressourcensatz 0 Nutzung 1 Stunde 0,21
westeurope USD 2021-09-28T00:00:00Z false Europa, Westen 5d157295-441c-5ea7-ba7c-5083026dc456 SQL Server vCore DZH318Z08M23 Erfassung und Klassifizierung von Azure Purview Scanning 0 Analyse DZH318Q66D0F Azure Purview DZH318Z08M23/000F SQL Server 0 Nutzung 1 Stunde 0
westeurope USD 2021-09-28T00:00:00Z false Europa, Westen 0745df0d-ce4f-52db-ac31-ac574d4dcfe5 Einheit "Standardkapazität" DZH318Z08M22 Azure Purview Data Map 0.411 Analyse DZH318Q66D0F Azure Purview DZH318Z08M22/0002 Standard 0 Nutzung 1 Stunde 0.411
westeurope USD 2021-09-28T00:00:00Z false Europa, Westen 811e3118-5380-5ee8-a5d9-01d48d0a0627 Standard-vCore DZH318Z08M23 Erfassung und Klassifizierung von Azure Purview Scanning 0,63 Analyse DZH318Q66D0F Azure Purview DZH318Z08M23/0009 Standard 0 Nutzung 1 Stunde 0,63

Diese Funktion wird in Azure Monitor nicht unterstützt.