Démarrage rapide : Créer une fonction dans Azure à l’aide de Visual Studio CodeQuickstart: Create a function in Azure using Visual Studio Code

Dans cet article, vous allez utiliser Visual Studio Code pour créer une fonction basée sur une bibliothèque de classes C# qui répond aux requêtes HTTP.In this article, you use Visual Studio Code to create a C# class library-based function that responds to HTTP requests. Après avoir testé le code localement, vous le déployez dans l’environnement serverless d’Azure Functions.After testing the code locally, you deploy it to the serverless environment of Azure Functions.

Dans cet article, vous allez utiliser Visual Studio Code pour créer une fonction JavaScript qui répond aux requêtes HTTP.In this article, you use Visual Studio Code to create a JavaScript function that responds to HTTP requests. Après avoir testé le code localement, vous le déployez dans l’environnement serverless d’Azure Functions.After testing the code locally, you deploy it to the serverless environment of Azure Functions.

Dans cet article, vous allez utiliser Visual Studio Code pour créer une fonction TypeScript qui répond aux requêtes HTTP.In this article, you use Visual Studio Code to create a TypeScript function that responds to HTTP requests. Après avoir testé le code localement, vous le déployez dans l’environnement serverless d’Azure Functions.After testing the code locally, you deploy it to the serverless environment of Azure Functions.

Dans cet article, vous allez utiliser Visual Studio Code pour créer une fonction PowerShell qui répond aux requêtes HTTP.In this article, you use Visual Studio Code to create a PowerShell function that responds to HTTP requests. Après avoir testé le code localement, vous le déployez dans l’environnement serverless d’Azure Functions.After testing the code locally, you deploy it to the serverless environment of Azure Functions.

Dans cet article, vous allez utiliser Visual Studio Code pour créer une fonction Python qui répond aux requêtes HTTP.In this article, you use Visual Studio Code to create a Python function that responds to HTTP requests. Après avoir testé le code localement, vous le déployez dans l’environnement serverless d’Azure Functions.After testing the code locally, you deploy it to the serverless environment of Azure Functions.

Dans cet article, vous allez utiliser Visual Studio Code pour créer une fonction Java qui répond aux requêtes HTTP.In this article, you use Visual Studio Code to create a Java function that responds to HTTP requests. Après avoir testé le code localement, vous le déployez dans l’environnement serverless d’Azure Functions.After testing the code locally, you deploy it to the serverless environment of Azure Functions.

Le fait de suivre ce guide de démarrage rapide entraîne une petite dépense de quelques cents USD tout au plus dans votre compte Azure.Completing this quickstart incurs a small cost of a few USD cents or less in your Azure account.

Il existe également une version basée sur l’interface CLI de cet article.There's also a CLI-based version of this article.

Notes

Si Visual Studio Code n’est pas votre outil de développement préféré, consultez nos tutoriels similaires destinés aux développeurs Java utilisant Maven, Gradle et IntelliJ IDEA.If Visual Studio Code isn't your prefered development tool, check out our similar tutorials for Java developers using Maven, Gradle and IntelliJ IDEA.

Configurer votre environnementConfigure your environment

Avant de commencer, veillez à disposer des éléments suivants :Before you get started, make sure you have the following requirements in place:

  • Node.js, Active LTS et Maintenance LTS (version 10.14.1 recommandée).Node.js, Active LTS and Maintenance LTS versions (10.14.1 recommended). Utilisez la commande node --version pour vérifier la version que vous utilisez.Use the node --version command to check your version.

Créer votre projet localCreate your local project

Dans cette section, vous utilisez Visual Studio Code pour créer un projet Azure Functions local dans le langage de votre choix.In this section, you use Visual Studio Code to create a local Azure Functions project in your chosen language. Plus loin dans cet article, vous allez publier votre code de fonction sur Azure.Later in this article, you'll publish your function code to Azure.

  1. Choisissez l’icône Azure dans la barre d’activité, puis dans la zone Azure : Fonctions, sélectionnez l’icône Créer un projet.Choose the Azure icon in the Activity bar, then in the Azure: Functions area, select the Create new project... icon.

    Choisir Créer un projet

  2. Choisissez un emplacement de répertoire pour votre espace de travail de projet et optez pour Sélectionner.Choose a directory location for your project workspace and choose Select.

    Notes

    Ces étapes ont été conçues pour être terminées en dehors d’un espace de travail.These steps were designed to be completed outside of a workspace. Dans ce cas, ne sélectionnez pas de dossier de projet qui fait partie d’un espace de travail.In this case, do not select a project folder that is part of a workspace.

  3. Quand vous y êtes invité, indiquez les informations suivantes :Provide the following information at the prompts:

    • Sélectionner un langage pour votre projet de fonction : Choisissez C#.Select a language for your function project: Choose C#.
    • Sélectionner un langage pour votre projet de fonction : Choisissez JavaScript.Select a language for your function project: Choose JavaScript.
    • Sélectionner un langage pour votre projet de fonction : Choisissez TypeScript.Select a language for your function project: Choose TypeScript.
    • Sélectionner un langage pour votre projet de fonction : Choisissez PowerShell.Select a language for your function project: Choose PowerShell.
    • Sélectionner un langage pour votre projet de fonction : Choisissez Python.Select a language for your function project: Choose Python.

    • Sélectionner un alias Python pour créer un environnement virtuel : Choisissez l’emplacement de votre interpréteur Python.Select a Python alias to create a virtual environment: Choose the location of your Python interpreter. Si l’emplacement n’est pas affiché, tapez le chemin complet de votre fichier binaire Python.If the location isn't shown, type in the full path to your Python binary.

    • Sélectionner un langage pour votre projet de fonction : Choisissez Java.Select a language for your function project: Choose Java.

    • Fournir un ID de groupe : Choisissez com.function.Provide a group ID: Choose com.function.

    • Fournir un ID d’artefact : Choisissez myFunction.Provide an artifact ID: Choose myFunction.

    • Fournir une version : Choisissez 1.0-SNAPSHOT.Provide a version: Choose 1.0-SNAPSHOT.

    • Fournir un nom de package : Choisissez com.function.Provide a package name: Choose com.function.

    • Fournir un nom d’application : Choisissez myFunction-12345.Provide an app name: Choose myFunction-12345.

    • Sélectionner un modèle pour la première fonction de votre projet : Choisissez HTTP trigger.Select a template for your project's first function: Choose HTTP trigger.

    • Fournir un nom de fonction : Tapez HttpExample.Provide a function name: Type HttpExample.

    • Fournir un espace de noms : Tapez My.Functions.Provide a namespace: Type My.Functions.
    • Niveau d’autorisation : Choisissez l’option Anonymous, qui permet à quiconque d’appeler le point de terminaison de votre fonction.Authorization level: Choose Anonymous, which enables anyone to call your function endpoint. Pour en savoir plus sur le niveau d’autorisation, consultez Clés d’autorisation.To learn about authorization level, see Authorization keys.
    • Sélectionner la façon dont vous souhaitez ouvrir votre projet : Choisissez Add to workspace.Select how you would like to open your project: Choose Add to workspace.
  4. À l’aide de ces informations, Visual Studio Code génère un projet Azure Functions avec un déclencheur HTTP.Using this information, Visual Studio Code generates an Azure Functions project with an HTTP trigger. Vous pouvez voir les fichiers de projet locaux dans l’Explorateur.You can view the local project files in the Explorer. Pour en savoir plus sur les fichiers créés, consultez Fichiers projet générés.To learn more about files that are created, see Generated project files.

Exécuter la fonction localementRun the function locally

Visual Studio Code s’intègre à Azure Functions Core Tools pour vous permettre d’exécuter ce projet sur votre ordinateur de développement local avant toute publication sur Azure.Visual Studio Code integrates with Azure Functions Core Tools to let you run this project on your local development computer before you publish to Azure.

  1. Pour appeler votre fonction, appuyez sur F5 pour démarrer le projet d’application de fonction.To call your function, press F5 to start the function app project. La sortie de Core Tools est affichée dans le panneau Terminal.Output from Core Tools is displayed in the Terminal panel.

  2. Si vous n’avez pas encore installé Azure Functions Core Tools, sélectionnez Installer à l’invite.If you haven't already installed Azure Functions Core Tools, select Install at the prompt. Quand Core Tools est installé, votre application démarre dans le panneau Terminal.When the Core Tools are installed, your app starts in the Terminal panel. Vous pouvez voir le point de terminaison de l’URL de votre fonction déclenchée par HTTP en cours d’exécution localement.You can see the URL endpoint of your HTTP-triggered function running locally.

    Sortie Azure locale

  3. Avec Core Tools en cours d’exécution, accédez à l’URL suivante pour exécuter une requête GET, qui inclut la chaîne de requête ?name=Functions.With Core Tools running, navigate to the following URL to execute a GET request, which includes ?name=Functions query string.

    http://localhost:7071/api/HttpExample?name=Functions

  4. Une réponse est retournée, semblable à celle-ci dans un navigateur :A response is returned, which looks like the following in a browser:

    Réponse de la fonction localhost dans le navigateur

  5. Les informations relatives à la requête s’affichent dans le panneau Terminal.Information about the request is shown in Terminal panel.

    Exécution de fonctions dans le panneau Terminal

  6. Appuyez sur Ctrl+C pour arrêter Core Tools et déconnecter le débogueur.Press Ctrl + C to stop Core Tools and disconnect the debugger.

Exécuter la fonction localementRun the function locally

Azure Functions Core Tools s’intègre à Visual Studio Code pour vous permettre d’exécuter et de déboguer un projet Azure Functions localement.Azure Functions Core Tools integrates with Visual Studio Code to let you run and debug an Azure Functions project locally. Pour plus d’informations sur le débogage dans Visual Studio Code, consultez Déboguer localement des fonctions PowerShell Azure.For details on how to debug in Visual Studio Code, see Debug PowerShell Azure Functions locally.

  1. Appuyez sur F5 pour démarrer le projet d’application de fonction.Press F5 to start the function app project. La sortie de Core Tools est affichée dans le panneau Terminal.Output from Core Tools is displayed in the Terminal panel.

  2. Dans le panneau Terminal, copiez le point de terminaison de l’URL de votre fonction déclenchée via HTTP.In the Terminal panel, copy the URL endpoint of your HTTP-triggered function.

    Sortie Azure locale

  3. Ajoutez la chaîne de requête ?name=<yourname> à cette URL, puis utilisez Invoke-RestMethod dans une deuxième invite de commandes PowerShell pour exécuter la requête, comme suit :Append the query string ?name=<yourname> to this URL, and then use Invoke-RestMethod in a second PowerShell command prompt to execute the request, as follows:

    PS > Invoke-RestMethod -Method Get -Uri http://localhost:7071/api/HttpTrigger?name=PowerShell
    Hello PowerShell
    

    Vous pouvez également exécuter la requête GET depuis un navigateur avec l’URL suivante :You can also execute the GET request from a browser from the following URL:

    http://localhost:7071/api/HttpExample?name=PowerShell

    Quand vous appelez le point de terminaison HttpTrigger sans passer de paramètre name comme paramètre de requête ou dans le corps, la fonction retourne une erreur BadRequest.When you call the HttpTrigger endpoint without passing a name parameter either as a query parameter or in the body, the function returns a BadRequest error. Quand vous examinez le code dans run.ps1, vous voyez que cette erreur est voulue.When you review the code in run.ps1, you see that this error occurs by design.

  4. Les informations relatives à la requête s’affichent dans le panneau Terminal.Information about the request is shown in Terminal panel.

    Exécution de fonctions dans le panneau Terminal

  5. Quand vous avez terminé, appuyez sur Ctrl+C pour arrêter Core Tools.When done, press Ctrl + C to stop Core Tools.

Après avoir vérifié que la fonction s’exécute correctement sur votre ordinateur local, il est temps de publier le projet sur Azure.After you've verified that the function runs correctly on your local computer, it's time to publish the project to Azure.

Après avoir vérifié que la fonction s’exécute correctement sur votre ordinateur local, il est temps d’utiliser Visual Studio Code pour publier le projet directement sur Azure.After you've verified that the function runs correctly on your local computer, it's time to use Visual Studio Code to publish the project directly to Azure.

Connexion à AzureSign in to Azure

Avant de pouvoir publier votre application, vous devez vous connecter à Azure.Before you can publish your app, you must sign in to Azure.

  1. Si vous n’êtes pas déjà connecté, choisissez l’icône Azure dans la barre d’activité, puis dans la zone Azure : Fonctions, choisissez Se connecter à Azure... . Si vous ne l’avez pas encore fait, vous pouvez créer un compte Azure gratuit .If you aren't already signed in, choose the Azure icon in the Activity bar, then in the Azure: Functions area, choose Sign in to Azure.... If you don't already have one, you can Create a free Azure account. Les étudiants peuvent cliquer ici pour créer un compte gratuit Azure for Students .Students can click here to Create a free Azure for Students account

    Réponse de la fonction localhost dans le navigateur

    Si vous êtes déjà connecté, passez à la section suivante.If you're already signed in, go to the next section.

  2. Quand vous y êtes invité dans le navigateur, choisissez votre compte Azure, puis connectez-vous à l’aide de vos informations d’identification de compte Azure.When prompted in the browser, choose your Azure account and sign in using your Azure account credentials.

  3. Une fois la connexion réussie, vous pouvez fermer la nouvelle fenêtre de navigateur.After you've successfully signed in, you can close the new browser window. Les abonnements qui font partie de votre compte Azure sont affichés dans la barre latérale.The subscriptions that belong to your Azure account are displayed in the Side bar.

Publication du projet sur AzurePublish the project to Azure

Dans cette section, vous créez une application de fonction et les ressources associées dans votre abonnement Azure, puis vous déployez votre code.In this section, you create a function app and related resources in your Azure subscription and then deploy your code.

Important

La publication sur une application de fonction existante remplace le contenu de cette application dans Azure.Publishing to an existing function app overwrites the content of that app in Azure.

  1. Choisissez l’icône Azure dans la barre d’activité, puis dans la zone Azure : Fonctions, choisissez le bouton Déployer sur une application de fonction.Choose the Azure icon in the Activity bar, then in the Azure: Functions area, choose the Deploy to function app... button.

    Publier votre projet sur Azure

  2. Quand vous y êtes invité, indiquez les informations suivantes :Provide the following information at the prompts:

    • Sélectionnez le dossier : choisissez un dossier dans votre espace de travail ou accédez à un dossier qui contient votre application de fonction.Select folder: Choose a folder from your workspace or browse to one that contains your function app. Vous ne verrez pas ceci si vous avez déjà ouvert une application de fonction valide.You won't see this if you already have a valid function app opened.

    • Sélectionnez l’abonnement : choisissez l’abonnement à utiliser.Select subscription: Choose the subscription to use. Vous ne verrez pas ceci si vous n’avez qu’un seul abonnement.You won't see this if you only have one subscription.

    • Sélectionnez une application de fonction dans Azure : Choisissez + Create new Function App.Select Function App in Azure: Choose + Create new Function App. (Ne choisissez pas l’option Advanced, qui n’est pas abordée dans cet article.)(Don't choose the Advanced option, which isn't covered in this article.)

    • Entrer un nom global unique pour l’application de fonction : Tapez un nom valide dans un chemin d’URL.Enter a globally unique name for the function app: Type a name that is valid in a URL path. Le système vérifie que le nom que vous tapez est unique dans Azure Functions.The name you type is validated to make sure that it's unique in Azure Functions.

    • Sélectionnez un runtime : Choisissez la version de Python que vous avez exécutée localement.Select a runtime: Choose the version of Python you've been running on locally. Vous pouvez utiliser la commande python --version pour vérifier votre version.You can use the python --version command to check your version.
    • Sélectionnez un runtime : Choisissez la version de Node.js que vous avez exécutée localement.Select a runtime: Choose the version of Node.js you've been running on locally. Vous pouvez utiliser la commande node --version pour vérifier votre version.You can use the node --version command to check your version.
    • Sélectionnez un emplacement pour les nouvelles ressources : Pour de meilleures performances, choisissez une région proche de vous.Select a location for new resources: For better performance, choose a region near you.
  3. Quand vous avez terminé, les ressources Azure suivantes sont créées dans votre abonnement et leurs noms reposent sur le nom de votre application de fonction :When completed, the following Azure resources are created in your subscription, using names based on your function app name:

    • Un groupe de ressources, qui est un conteneur logique pour les ressources associées.A resource group, which is a logical container for related resources.
    • Un compte de stockage Azure standard, qui conserve l’état et d’autres informations spécifiques à vos projets.A standard Azure Storage account, which maintains state and other information about your projects.
    • Un plan de consommation, qui définit l’hôte sous-jacent pour votre application de fonction serverless.A consumption plan, which defines the underlying host for your serverless function app.
    • Une application de fonction, qui fournit l’environnement d’exécution de votre code de fonction.A function app, which provides the environment for executing your function code. Une application de fonction vous permet de regrouper des fonctions en une unité logique pour faciliter la gestion, le déploiement et le partage des ressources au sein du même plan d’hébergement.A function app lets you group functions as a logical unit for easier management, deployment, and sharing of resources within the same hosting plan.
    • Une instance Application Insights connectée à l’application de fonction, qui effectue le suivi de l’utilisation de votre fonction serverless.An Application Insights instance connected to the function app, which tracks usage of your serverless function.

    Une notification s’affiche après que votre application de fonction a été créée et que le package de déploiement a été appliqué.A notification is displayed after your function app is created and the deployment package is applied.

  4. Sélectionnez Afficher la sortie de dans cette notification pour afficher les résultats de la création et du déploiement, y compris les ressources Azure que vous avez créées.Select View Output in this notification to view the creation and deployment results, including the Azure resources that you created. Si vous manquez la notification, sélectionnez l’icône de cloche dans le coin inférieur droit pour la voir de nouveau.If you miss the notification, select the bell icon in the lower right corner to see it again.

    Créer une notification de fin

Exécuter la fonction dans AzureRun the function in Azure

  1. Dans la zone Azure : Fonctions de la barre latérale, développez la nouvelle application de fonction sous votre abonnement.Back in the Azure: Functions area in the side bar, expand the new function app under your subscription. Développez Fonctions, cliquez avec le bouton droit (Windows) ou appuyez sur Ctrl + clic (macOS) sur HttpExample, puis choisissez Copier l’URL de la fonction.Expand Functions, right-click (Windows) or Ctrl + click (macOS) on HttpExample, and then choose Copy function URL.

    Copier l'URL de fonction du nouveau déclencheur HTTP

  2. Collez cette URL pour la requête HTTP dans la barre d’adresse de votre navigateur, ajoutez la chaîne de requête name sous la forme ?name=Functions à la fin de cette URL, puis exécutez la requête.Paste this URL for the HTTP request into your browser's address bar, add the name query string as ?name=Functions to the end of this URL, and then execute the request. L’URL qui appelle la fonction déclenchée via HTTP doit être au format suivant :The URL that calls your HTTP-triggered function should be in the following format:

    http://<functionappname>.azurewebsites.net/api/httpexample?name=Functions
    

    L’exemple suivant montre la réponse dans le navigateur à la requête GET distante retournée par la fonction :The following example shows the response in the browser to the remote GET request returned by the function:

    Réponse de la fonction dans le navigateur

Nettoyer les ressourcesClean up resources

Quand vous passerez à l’étape suivante, Ajouter une liaison de file d’attente Stockage Azure à votre fonction, vous devrez conserver toutes vos ressources en place, car vous allez tirer parti de ce que vous avez déjà fait.When you continue to the next step, Add an Azure Storage queue binding to your function, you'll need to keep all your resources in place to build on what you've already done.

Sinon, vous pouvez utiliser les étapes suivantes pour supprimer l’application de fonction et ses ressources connexes afin d’éviter des coûts supplémentaires.Otherwise, you can use the following steps to delete the function app and its related resources to avoid incurring any further costs.

  1. Dans Visual Studio Code, appuyez sur F1 pour ouvrir la palette de commandes.In Visual Studio Code, press F1 to open the command palette. Dans la palette de commandes, recherchez et sélectionnez Azure Functions: Open in portal.In the command palette, search for and select Azure Functions: Open in portal.

  2. Choisissez votre application de fonction et appuyez sur Entrée.Choose your function app, and press Enter. La page de l’application de fonction s’ouvre dans le portail Azure.The function app page opens in the Azure portal.

  3. Sous l’onglet Vue d’ensemble, sélectionnez le lien nommé à côté de Groupe de ressources.In the Overview tab, select the named link next to Resource group.

    Sélectionnez le groupe de ressources à supprimer dans la page d’application de fonction.

  4. Sur la page Groupe de ressources, passez en revue la liste des ressources incluses et vérifiez qu’elles correspondent à celles que vous souhaitez supprimer.In the Resource group page, review the list of included resources, and verify that they are the ones you want to delete.

  5. Sélectionnez Supprimer le groupe de ressources et suivez les instructions.Select Delete resource group, and follow the instructions.

    Cette opération peut prendre quelques minutes.Deletion may take a couple of minutes. Une fois terminée, une notification s’affiche pendant quelques secondes.When it's done, a notification appears for a few seconds. Vous pouvez également sélectionner l’icône représentant une cloche en haut de la page pour afficher la notification.You can also select the bell icon at the top of the page to view the notification.

Pour en savoir plus sur les coûts de Functions, consultez Estimation des coûts d’un plan Consommation.To learn more about Functions costs, see Estimating Consumption plan costs.

Étapes suivantesNext steps

Vous avez utilisé Visual Studio Code pour créer une application de fonction à l’aide d’une fonction HTTP simple déclenchée via HTTP.You have used Visual Studio Code to create a function app with a simple HTTP-triggered function. Dans le prochain article, vous développez cette fonction en ajoutant une liaison de sortie.In the next article, you expand that function by adding an output binding. Cette liaison écrit la chaîne de la requête HTTP dans un message dans une file d’attente de Stockage File d’attente Azure.This binding writes the string from the HTTP request to a message in an Azure Queue Storage queue.