Plug-in http_request

Articolo
11/23/2024

Si applica a: ✅Microsoft Fabric✅Azure Esplora dati

Il http_request plug-in 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 l'accesso come destinazione consentita per webapi nei criteri di callout

Sintassi

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

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome	Digita	Obbligatorio	Descrizione
URI	`string`	✔️	URI di destinazione per la richiesta HTTP o HTTPS.
RequestHeaders	`dynamic`		Contenitore delle proprietà contenente le 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 fornire 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.

Valori restituiti

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 qualsiasi richiesta con questo flag come una che non apporta modifiche dello stato interno, altrimenti devono rifiutare la richiesta. Ciò protegge gli utenti dall'invio di 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 in 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	location	meterId	meterName	productId	productName	retailPrice	serviceFamily	serviceId	serviceName	skuId	skuName	type	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 Data Insights	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 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	Inserimento e classificazione di Analisi 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	VCore del set di risorse	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	VCore di SQL Server	DZH318Z08M23	Inserimento e classificazione di Analisi 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	Inserimento e classificazione di Analisi di Azure Purview	0,63	Analisi	DZH318Q66D0F	Azure Purview	DZH318Z08M23/0009	Standard	Consumo	1 ora	0,63

Condividi tramite