Plug-In „http_request“

Gilt für: ✅Microsoft Fabric✅Azure Data Explorer

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

Voraussetzungen

• Ausführen .enable plugin http_request , um das Plug-In zu aktivieren
• Festlegen des URI für den Zugriff als zulässiges Ziel webapi in der Popuprichtlinie

Syntax

evaluate http_request ( Uri [ RequestHeaders,

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Authentifizierung und Autorisierung

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

Gibt zurück

Das Plug-In gibt eine Tabelle mit einem einzelnen Datensatz mit den folgenden dynamischen Spalten zurück:

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

Wenn die HTTP-Antwort (über den Content-Type Antwortheader) angibt, dass der Medientyp lautet application/json, wird der Antworttext automatisch als JSON-Objekt analysiert. Andernfalls wird sie wie folgt zurückgegeben.

Überschriften

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:

Beispiel

Im folgenden Beispiel werden azure-Einzelhandelspreise für Azure Purview in Westeuropa 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