Plug-In „http_request“

Artikel
11/23/2024

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

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

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name	Type	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 mit zusätzlichen Eigenschaften der Anforderung.

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 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 werden, damit sie von jeder Ablaufverfolgung weggelassen werden. Weitere Informationen finden Sie unter verschleierten Zeichenfolgenliteralen.

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.

Headers

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 haben alle dieselbe ID.
`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 wurde, das von einer Abfrage ausgelöst wurde und nicht für einen Verwaltungsbefehl. Webdienste sollten alle Anforderungen mit dieser Kennzeichnung behandeln, da sie keine internen Zustandsänderungen vornehmen, andernfalls sollten sie die Anforderung ablehnen. Dadurch wird verhindert, dass Benutzer scheinbar unschuldige Abfragen gesendet werden, die zu unerwünschten Änderungen führen, indem sie eine Kusto-Abfrage als Startpad für solche Angriffe verwenden.

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)

Output

armRegionName	armSkuName	currencyCode	effectiveStartDate	isPrimaryMeterRegion	location	meterId	meterName	productId	ProductName	Einzelhandelspreis	serviceFamily	serviceId	serviceName	skuId	skuName	Typ	unitOfMeasure	unitPrice
westeurope	Datenerkenntnisse	USD	2022-06-01T00:00:00Z	false	Europa, Westen	8ce915f7-20db-564d-8cc3-5702a7c952ab	Dateneinblick-Berichtsverbrauch	DZH318Z08M22	Azure Purview Data Map	0,21	Analyse	DZH318Q66D0F	Azure Purview	DZH318Z08M22/006C	Catalog Insights	Verbrauch	1 API-Aufrufe	0,21
westeurope	Datenkartenanreicherung – Datenerkenntnisse generation	USD	2022-06-01T00:00:00Z	false	Europa, Westen	7ce2db1d-59a0-5193-8a57-0431a10622b6	Datenzuordnungserweiterung – vCore der Datenerkenntnisse-Generation	DZH318Z08M22	Azure Purview Data Map	0.82	Analyse	DZH318Q66D0F	Azure Purview	DZH318Z08M22/005C	Datenzuordnung anreichern - Insight Generation	Verbrauch	1 Stunde	0.82
westeurope		USD	2021-09-28T00:00:00Z	false	Europa, Westen	053e2dcb-82c0-5e50-86cd-1f1c8d803705	Power BI vCore	DZH318Z08M23	Azure Purview Scanning Ingestion und Klassifizierung	0	Analyse	DZH318Q66D0F	Azure Purview	DZH318Z08M23/0005	Power BI	Verbrauch	1 Stunde	0
westeurope		USD	2021-09-28T00:00:00Z	false	Europa, Westen	a7f57f26-5f31-51e5-a5ed-ffc2b0da37b9	Ressourcensatz vCore	DZH318Z08M22	Azure Purview Data Map	0,21	Analyse	DZH318Q66D0F	Azure Purview	DZH318Z08M22/000X	Resource Set	Verbrauch	1 Stunde	0,21
westeurope		USD	2021-09-28T00:00:00Z	false	Europa, Westen	5d157295-441c-5ea7-ba7c-5083026dc456	SQL Server vCore	DZH318Z08M23	Azure Purview Scanning Ingestion und Klassifizierung	0	Analyse	DZH318Q66D0F	Azure Purview	DZH318Z08M23/000F	SQL Server	Verbrauch	1 Stunde	0
westeurope		USD	2021-09-28T00:00:00Z	false	Europa, Westen	0745df0d-ce4f-52db-ac31-ac574d4dcfe5	Standardkapazitätseinheit	DZH318Z08M22	Azure Purview Data Map	0.411	Analyse	DZH318Q66D0F	Azure Purview	DZH318Z08M22/0002	Standard	Verbrauch	1 Stunde	0.411
westeurope		USD	2021-09-28T00:00:00Z	false	Europa, Westen	811e3118-5380-5ee8-a5d9-01d48d0a0627	Standard vCore	DZH318Z08M23	Azure Purview Scanning Ingestion und Klassifizierung	0,63	Analyse	DZH318Q66D0F	Azure Purview	DZH318Z08M23/0009	Standard	Verbrauch	1 Stunde	0,63

Freigeben über