http_request, plug-in

  • Article

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

Prérequis

Syntax

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

Découvrez les conventions de syntaxe.

Paramètres

Nom Type Obligatoire 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.

Notes

  • 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 HTTP standard Authorization ou tout en-tête personnalisé pris en charge par le service web.

Notes

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înes masqués.

Retours

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

  • ResponseHeaders : conteneur de propriétés avec l’en-tête de réponse.
  • ResponseBody : 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, elle est retournée telle qu’elle est.

En-têtes

L’argument RequestHeaders peut être utilisé pour ajouter des en-têtes personnalisés à la requête HTTP sortante. En plus des en-têtes de requête HTTP standard et des 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 demande. 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 qui a été 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 ils doivent refuser la demande. Cela protège les utilisateurs contre l’envoi de requêtes apparemment innocentes qui finissent par apporter des modifications indésirables en utilisant une requête Kusto comme launchpad pour de telles 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 Analytics 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 de Data Insights USD 2022-06-01T00 :00 :00Z false Europe Ouest 7ce2db1d-59a0-5193-8a57-0431a10622b6 Enrichissement de la carte de données - Génération de vCore Data Insights DZH318Z08M22 Azure Purview Data Map 0.82 Analytics DZH318Q66D0F Azure Purview DZH318Z08M22/005C Enrichissement de la carte de données - Génération d’insight 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 Analytics 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 Analytics DZH318Q66D0F Azure Purview DZH318Z08M22/000X Jeu de ressources 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 Analytics 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 Analytics 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 Analytics DZH318Q66D0F Azure Purview DZH318Z08M23/0009 standard 0 Consommation 1 heure 0,63

Cette fonctionnalité n’est pas prise en charge dans Azure Monitor.