plug-in http_request

Articolo
01/23/2024

Il plug-in http_request invia una richiesta HTTP GET e converte la risposta in una tabella.

Prerequisiti

Eseguire .enable plugin http_request per abilitare il plug-in
Impostare l'URI per accedere come destinazione consentita per webapi nei criteri callout

Sintassi

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

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome	Tipo	Obbligatoria	Descrizione
Uri	`string`	✔️	URI di destinazione per la richiesta HTTP o HTTPS.
RequestHeaders	`dynamic`		Contenitore di proprietà contenente intestazioni HTTP da inviare con la richiesta.
Opzioni	`dynamic`		Contenitore delle proprietà contenente proprietà aggiuntive della richiesta.

Nota

Per specificare un parametro facoltativo che segue un parametro facoltativo, assicurarsi di specificare un valore per il parametro facoltativo precedente. Per altre informazioni, vedere Uso dei parametri facoltativi.
Se si usa l'autenticazione, usare il protocollo HTTPS. I tentativi di usare HTTP con l'autenticazione generano un errore.

Autenticazione e autorizzazione

Per eseguire l'autenticazione, usare l'intestazione standard Authorization HTTP o qualsiasi intestazione personalizzata supportata dal servizio Web.

Nota

Se la query include informazioni riservate, assicurarsi che le parti pertinenti del testo della query siano offuscate in modo che vengano omesse da qualsiasi traccia. Per altre informazioni, vedere Valori letterali stringa offuscati.

Restituisce

Il plug-in restituisce una tabella con un singolo record con le colonne dinamiche seguenti:

ResponseHeaders: contenitore di proprietà con l'intestazione della risposta.
ResponseBody: corpo della risposta analizzato come valore di tipo dynamic.

Se la risposta HTTP indica (tramite l'intestazione della Content-Type risposta) che il tipo di supporto è application/json, il corpo della risposta viene analizzato automaticamente come se si tratta di un oggetto JSON. In caso contrario, viene restituito così come è.

Intestazioni

L'argomento RequestHeaders può essere usato per aggiungere intestazioni personalizzate alla richiesta HTTP in uscita. Oltre alle intestazioni di richiesta HTTP standard e alle intestazioni personalizzate fornite dall'utente, il plug-in aggiunge anche le intestazioni personalizzate seguenti:

Nome	Descrizione
`x-ms-client-request-id`	ID di correlazione che identifica la richiesta. Più chiamate del plug-in nella stessa query avranno tutti lo stesso ID.
`x-ms-readonly`	Flag che indica che il processore di questa richiesta non deve apportare modifiche persistenti.

Avviso

Il x-ms-readonly flag viene impostato per ogni richiesta HTTP inviata dal plug-in attivato da una query e non per un comando di gestione. I servizi Web devono considerare le richieste con questo flag come una che non apporta modifiche dello stato interno, altrimenti devono rifiutare la richiesta. In questo modo gli utenti non vengono inviate query apparentemente innocenti che finiscono per apportare modifiche indesiderate usando una query Kusto come launchpad per tali attacchi.

Esempio

L'esempio seguente recupera i prezzi delle vendite al dettaglio di Azure per Azure Purview nell'Europa occidentale:

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	posizione	meterId	meterName	productId	productName	retailPrice	serviceFamily	serviceId	serviceName	skuId	skuName	tipo	unitOfMeasure	unitPrice
westeurope	Informazioni dettagliate sui dati	USD	2022-06-01T00:00:00Z	false	Europa occidentale	8ce915f7-20db-564d-8cc3-5702a7c952ab	Utilizzo dei report di Informazioni dettagliate dati	DZH318Z08M22	Data Map di Azure Purview	0.21	Analisi	DZH318Q66D0F	Azure Purview	DZH318Z08M22/006C	Informazioni dettagliate sul catalogo	Consumo	1 Chiamate API	0.21
westeurope	Arricchimento della mappa dati - Generazione di informazioni dettagliate sui dati	USD	2022-06-01T00:00:00Z	false	Europa occidentale	7ce2db1d-59a0-5193-8a57-0431a10622b6	Arricchimento mappa dati - Data Insights Generation vCore	DZH318Z08M22	Data Map di Azure Purview	0.82	Analisi	DZH318Q66D0F	Azure Purview	DZH318Z08M22/005C	Arricchimento mappa dati - Generazione di informazioni dettagliate	Consumo	1 ora	0.82
westeurope		USD	2021-09-28T00:00:00Z	false	Europa occidentale	053e2dcb-82c0-5e50-86cd-1f1c8d803705	Power BI vCore	DZH318Z08M23	Analisi e classificazione di Azure Purview	0	Analisi	DZH318Q66D0F	Azure Purview	DZH318Z08M23/0005	Power BI	Consumo	1 ora	0
westeurope		USD	2021-09-28T00:00:00Z	false	Europa occidentale	a7f57f26-5f31-51e5-a5ed-ffc2b0da37b9	Set di risorse vCore	DZH318Z08M22	Data Map di Azure Purview	0.21	Analisi	DZH318Q66D0F	Azure Purview	DZH318Z08M22/000X	Set di risorse	Consumo	1 ora	0.21
westeurope		USD	2021-09-28T00:00:00Z	false	Europa occidentale	5d157295-441c-5ea7-ba7c-5083026dc456	SQL Server vCore	DZH318Z08M23	Analisi e classificazione di Azure Purview	0	Analisi	DZH318Q66D0F	Azure Purview	DZH318Z08M23/000F	SQL Server	Consumo	1 ora	0
westeurope		USD	2021-09-28T00:00:00Z	false	Europa occidentale	0745df0d-ce4f-52db-ac31-ac574d4dcfe5	Unità di capacità standard	DZH318Z08M22	Data Map di Azure Purview	0.411	Analisi	DZH318Q66D0F	Azure Purview	DZH318Z08M22/0002	Standard	Consumo	1 ora	0.411
westeurope		USD	2021-09-28T00:00:00Z	false	Europa occidentale	811e3118-5380-5ee8-a5d9-01d48d0a0627	VCore standard	DZH318Z08M23	Analisi e classificazione di Azure Purview	0.63	Analisi	DZH318Q66D0F	Azure Purview	DZH318Z08M23/0009	Standard	Consumo	1 ora	0.63

Questa funzionalità non è supportata in Monitoraggio di Azure.

Share via