Exécuter une fonction Azure avec une requête HTTP
Une requête HTTP est une opération courante sur la plupart des plateformes et des appareils. Qu’il s’agisse de rechercher un mot dans un dictionnaire ou d’obtenir les prévisions météo locales, nous envoyons des requêtes HTTP en permanence. La solution Azure Functions nous permet de créer rapidement un élément logique à exécuter lors de la réception d’une requête HTTP.
Dans cette unité, vous allez apprendre à créer et à appeler une fonction avec un déclencheur HTTP. Vous allez également explorer certaines des options de personnalisation disponibles pou les déclencheurs HTTP.
Qu’est-ce qu’un déclencheur HTTP ?
Un déclencheur HTTP est un déclencheur qui exécute du code quand il reçoit une requête HTTP. Les déclencheurs HTTP ont de nombreuses fonctionnalités et personnalisations, à savoir :
- Donner un accès autorisé en fournissant des clés.
- Restreindre les verbes HTTP pris en charge.
- Retourner des données à l’appelant.
- Recevoir des données via des paramètres de chaîne de requête ou le corps d’une requête.
- Prendre en charge les modèles de routage d’URL pour modifier l’URL de la fonction.
Lorsque vous créez un déclencheur HTTP, vous devez lui donner un nom et choisir un niveau d’autorisation.
Qu’est-ce qu’un niveau d’autorisation de déclencheur HTTP ?
Un niveau d’autorisation de déclencheur HTTP est un indicateur qui montre si une requête HTTP entrante a besoin d’une clé API à des fins d’autorisation.
Il existe trois niveaux d’autorisation :
- Fonction
- Anonyme
- Administrateur
Les niveaux Fonction et Admin sont basés sur une « clé ». Pour envoyer une requête HTTP, vous devez fournir une clé pour à des fins d’autorisation. Il existe deux types de clés : Fonction et Hôte. La différence entre les deux clés réside dans leur étendue. Les clés Fonction sont spécifiques à une fonction. Les clés Hôte s’appliquent à toutes les fonctions à l’intérieur de l’application de fonction. Si votre niveau d’autorisation est défini sur Fonction, vous pouvez utiliser une clé Fonction ou Hôte. Si votre niveau d’autorisation est défini sur Admin, vous devez fournir une clé Hôte.
Important
Étant donné que les clés d’hôte fournissent un accès avec des privilèges élevés à votre application de fonction, vous devez les transporter et les stocker en toute sécurité.
Le niveau Anonyme signifie que l’autorisation n’est pas requise. Cet exercice utilise le niveau d’autorisation Anonyme.
Comment créer un déclencheur HTTP
Vous pouvez créer un déclencheur HTTP via le portail Azure, tout comme un déclencheur de minuteur. Dans votre fonction Azure, sélectionnez Déclencheur HTTP dans la liste des types de déclencheurs prédéfinis, puis entrez la logique que vous souhaitez exécuter et effectuez les personnalisations, telles que la restriction de l’utilisation de certains verbes HTTP.
Un paramètre qu’il est important de comprendre est Nom de paramètre de requête. Ce paramètre est une chaîne représentant le nom du paramètre contenant les informations relatives à une requête HTTP entrante. Par défaut, le nom du paramètre est req.
Comment appeler un déclencheur HTTP
Pour appeler un déclencheur HTTP, vous envoyez une requête HTTP à l’URL de votre fonction. Pour obtenir cette URL, accédez à la page de codes de votre fonction, puis sélectionnez le lien Obtenir l’URL de la fonction.
Lorsque vous avez l’URL de votre fonction, vous pouvez envoyer des requêtes HTTP. Si votre fonction reçoit des données, n’oubliez pas que vous pouvez utiliser des paramètres de chaîne de requête ou fournir les données par le biais du corps de la demande.
Un déclencheur HTTP s’exécute quand il reçoit une requête HTTP adressée à l’URL de sa fonction. Les déclencheurs HTTP vous permettent de recevoir des données, d’exécuter une logique et d’éventuellement renvoyer les données à l’appelant.