Partager via

http_request, plug-in

  • Article

S’applique à : ✅Microsoft Fabric✅Azure Data Explorer

Le http_request plug-in envoie une requête HTTP GET et convertit la réponse en une table.

Prérequis

Syntaxe

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

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom Type Requise Description
Uri string ✔️ URI de destination pour la requête HTTP ou HTTPS.
RequestHeaders dynamic Conteneur de propriétés contenant des en-têtes HTTP à envoyer avec la requête.
Options dynamic Conteneur de propriétés contenant des propriétés supplémentaires de la requête.

Remarque

  • Pour spécifier un paramètre facultatif qui suit un paramètre facultatif, veillez à fournir une valeur pour le paramètre facultatif précédent. Pour plus d’informations, consultez Utilisation des paramètres facultatifs.
  • Si vous utilisez l’authentification, utilisez le protocole HTTPS. Les tentatives d’utilisation de HTTP avec l’authentification entraînent une erreur.

Authentification et autorisation

Pour vous authentifier, utilisez l’en-tête standard Authorization HTTP ou tout en-tête personnalisé pris en charge par le service web.

Remarque

Si la requête inclut des informations confidentielles, assurez-vous que les parties pertinentes du texte de la requête sont masquées afin qu’elles soient omises de tout suivi. Pour plus d’informations, consultez littéraux de chaîne obfusqués.

Retours

Le plug-in retourne une table qui a un enregistrement unique avec les colonnes dynamiques suivantes :

  • ResponseHeaders : conteneur de propriétés avec l’en-tête de réponse.
  • ResponseBody : le corps de la réponse analysé en tant que valeur de type dynamic.

Si la réponse HTTP indique (via l’en-tête Content-Type de réponse) que le type de média est application/json, le corps de la réponse est automatiquement analysé comme s’il s’agit d’un objet JSON. Sinon, il est retourné tel qu’il est.

En-têtes

L’argument RequestHeaders peut être utilisé pour ajouter des en-têtes personnalisés à la requête HTTP sortante. Outre les en-têtes de requête HTTP standard et les en-têtes personnalisés fournis par l’utilisateur, le plug-in ajoute également les en-têtes personnalisés suivants :

Nom Description
x-ms-client-request-id ID de corrélation qui identifie la requête. Plusieurs appels du plug-in dans la même requête auront tous le même ID.
x-ms-readonly Indicateur indiquant que le processeur de cette requête ne doit pas apporter de modifications persistantes.

Avertissement

L’indicateur x-ms-readonly est défini pour chaque requête HTTP envoyée par le plug-in déclenché par une requête et non par une commande de gestion. Les services web doivent traiter toutes les demandes avec cet indicateur comme une demande qui n’apporte pas de modifications d’état interne, sinon elles doivent refuser la demande. Cela empêche les utilisateurs d’être envoyés des requêtes apparemment innocentes qui finissent par apporter des modifications indésirables à l’aide d’une requête Kusto comme launchpad pour ces attaques.

Exemple

L’exemple suivant récupère les prix de vente au détail Azure pour Azure Purview en Europe ouest :

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)

Sortie

armRegionName armSkuName currencyCode effectiveStartDate isPrimaryMeterRegion location meterId meterName productId ProductName retailPrice serviceFamily serviceId serviceName skuId skuName tierMinimumUnits type unitOfMeasure unitPrice
westeurope Insights sur les données USD 2022-06-01T00:00:00Z false Europe Ouest 8ce915f7-20db-564d-8cc3-5702a7c952ab Consommation des rapports Data Insights DZH318Z08M22 Azure Purview Data Map 0,21 Analyse DZH318Q66D0F Azure Purview DZH318Z08M22/006C Insights du catalogue 0 Consommation 1 Appels d’API 0,21
westeurope Enrichissement de la carte de données - Génération d’insights de données USD 2022-06-01T00:00:00Z false Europe Ouest 7ce2db1d-59a0-5193-8a57-0431a1062b6 Enrichissement de la carte de données - Génération de données vCore DZH318Z08M22 Azure Purview Data Map 0.82 Analyse DZH318Q66D0F Azure Purview DZH318Z08M22/005C Enrichissement de mappage de données - Génération d’insights 0 Consommation 1 heure 0.82
westeurope USD 2021-09-28T00:00:00Z false Europe Ouest 053e2dcb-82c0-5e50-86cd-1f1c8d803705 Power BI vCore DZH318Z08M23 Ingestion et classification de l’analyse Azure Purview 0 Analyse DZH318Q66D0F Azure Purview DZH318Z08M23/0005 Power BI 0 Consommation 1 heure 0
westeurope USD 2021-09-28T00:00:00Z false Europe Ouest a7f57f26-5f31-51e5-a5ed-ffc2b0da37b9 Jeu de ressources vCore DZH318Z08M22 Azure Purview Data Map 0,21 Analyse DZH318Q66D0F Azure Purview DZH318Z08M22/000X Jeu de ressource 0 Consommation 1 heure 0,21
westeurope USD 2021-09-28T00:00:00Z false Europe Ouest 5d157295-441c-5ea7-ba7c-5083026dc456 SQL Server vCore DZH318Z08M23 Ingestion et classification de l’analyse Azure Purview 0 Analyse DZH318Q66D0F Azure Purview DZH318Z08M23/000F SQL Server 0 Consommation 1 heure 0
westeurope USD 2021-09-28T00:00:00Z false Europe Ouest 0745df0d-ce4f-52db-ac31-ac574d4dcfe5 Unité de capacité standard DZH318Z08M22 Azure Purview Data Map 0.411 Analyse DZH318Q66D0F Azure Purview DZH318Z08M22/0002 Standard 0 Consommation 1 heure 0.411
westeurope USD 2021-09-28T00:00:00Z false Europe Ouest 811e3118-5380-5ee8-a5d9-01d48d0a0627 VCore standard DZH318Z08M23 Ingestion et classification de l’analyse Azure Purview 0,63 Analyse DZH318Q66D0F Azure Purview DZH318Z08M23/0009 Standard 0 Consommation 1 heure 0,63