Partager via

http_request, plug-in

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

evaluate http_request ( Uri [,RequestHeaders [,Options]])

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom Catégorie Requise Descriptif
URI string ✔️ URI de destination de la requête HTTPS.
En-têtes de demande 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.
  • Utilisez toujours 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 Descriptif
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 code de devise date de début effective isPrimaryMeterRegion lieu meterId meterName ID de produit ProductName prix de détail serviceFamille serviceId nomService skuId skuName tierMinimumUnits type unité de mesure prix unitaire
Europe de l’Ouest Insights sur les données USD 2022-06-01T00:00:00Z faux Europe Ouest 8CE915F7-20DB-564D-8CC3-5702A7C952AB Consommation des rapports Data Insights DZH318Z08M22 Mappage des données Azure Purview 0,21 Analyse DZH318Q66D0F Azure Purview DZH318Z08M22/006C Insights du catalogue 0 Consommation 1 Appels d’API 0,21
Europe de l’Ouest Enrichissement de la carte de données - Génération d’insights de données USD 2022-06-01T00:00:00Z faux Europe Ouest 7ce2db1d-59a0-5193-8a57-0431a1062b6 Enrichissement de la carte de données - Génération de données vCore DZH318Z08M22 Mappage des données Azure Purview 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
Europe de l’Ouest USD 2021-09-28T00:00:00Z faux 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
Europe de l’Ouest USD 2021-09-28T00:00:00Z faux Europe Ouest A7F57F26-5F31-51E5-A5ED-FFC2B0DA37B9 Jeu de ressources vCore DZH318Z08M22 Mappage des données Azure Purview 0,21 Analyse DZH318Q66D0F Azure Purview DZH318Z08M22/000X Jeu de ressource 0 Consommation 1 heure 0,21
Europe de l’Ouest USD 2021-09-28T00:00:00Z faux Europe Ouest Référence 5D157295-441C-5EA7-BA7C-5083026DC456 SQL Server vCore DZH318Z08M23 Ingestion et classification de l’analyse Azure Purview 0 Analyse DZH318Q66D0F Azure Purview DZH318Z08M23/000F Serveur SQL 0 Consommation 1 heure 0
Europe de l’Ouest USD 2021-09-28T00:00:00Z faux Europe Ouest 0745DF0D-CE4F-52DB-AC31-AC574D4DCFE5 Unité de capacité standard DZH318Z08M22 Mappage des données Azure Purview 0.411 Analyse DZH318Q66D0F Azure Purview DZH318Z08M22/0002 Norme 0 Consommation 1 heure 0.411
Europe de l’Ouest USD 2021-09-28T00:00:00Z faux Europe Ouest Référence 811E3118-5380-5EE8-A5D9-01D48D0A0627 VCore standard DZH318Z08M23 Ingestion et classification de l’analyse Azure Purview 0,63 Analyse DZH318Q66D0F Azure Purview DZH318Z08M23/0009 Norme 0 Consommation 1 heure 0,63
  • Last updated on