Démarrage rapide : Créer votre première fonction dans Azure à l’aide de Visual StudioQuickstart: Create your first function in Azure using Visual Studio

Azure Functions vous permet d’exécuter votre code dans un environnement serverless, et sans avoir à créer une machine virtuelle ou à publier une application web au préalable.Azure Functions lets you run your code in a serverless environment without having to first create a VM or publish a web application.

Dans ce guide de démarrage rapide, vous allez découvrir comment utiliser Visual Studio 2019 pour créer et tester en local une application de fonction C# déclenchée par HTTP, « Hello world », avant de la publier sur Azure.In this quickstart, you learn how to use Visual Studio 2019 to locally create and test a "hello world" HTTP-triggered C# function app, which you then publish to Azure.

Réponse de la fonction localhost dans le navigateur

Ce guide de démarrage rapide est conçu pour Visual Studio 2019.This quickstart is designed for Visual Studio 2019.

PrérequisPrerequisites

Pour suivre ce tutoriel, commencez par installer Visual Studio 2019.To complete this tutorial, first install Visual Studio 2019. Assurez-vous de sélectionner la charge de travail Développement Azure lors de l’installation.Ensure you select the Azure development workload during installation. Si vous préférez créer un projet Azure Functions avec Visual Studio 2017, vous devez commencer par installer les tout derniers outils Azure Functions.If you want to create an Azure Functions project by using Visual Studio 2017 instead, you must first install the latest Azure Functions tools.

Installez Visual Studio avec la charge de travail de développement Azure.

Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.If you don't have an Azure subscription, create a free account before you begin.

Créer un projet d’application de fonctionCreate a function app project

Le modèle de projet Azure Functions dans Visual Studio crée un projet que vous pouvez publier dans une application de fonction dans Azure.The Azure Functions project template in Visual Studio creates a project that you can publish to a function app in Azure. Vous pouvez utiliser une application de fonction pour regrouper des fonctions en une unité logique afin de faciliter la gestion, le déploiement, la mise à l’échelle et le partage des ressources.You can use a function app to group functions as a logical unit for easier management, deployment, scaling, and sharing of resources.

  1. Dans Visual Studio, dans le menu Fichier, sélectionnez Nouveau > Projet.In Visual Studio, on the File menu, select New > Project.

  2. Dans Créer un projet, entrez functions dans la zone de recherche, puis choisissez le modèle Azure Functions.In Create a new project, enter functions in the search box, and then choose the Azure Functions template.

  3. Dans Configurer votre nouveau projet, entrez un Nom de projet, puis sélectionnez Créer.In Configure your new project, enter a Project name for your project, and then select Create. Le nom d’application de la fonction doit être valide en tant qu’espace de noms C#, afin de ne pas utiliser des traits d’union, des traits de soulignement ou d’autres caractères non alphanumériques.The function app name must be valid as a C# namespace, so don't use underscores, hyphens, or any other nonalphanumeric characters.

  4. Pour les paramètres Nouveau projet - <nom de votre projet> , utilisez les valeurs du tableau suivant :For the New Project - <your project name> settings, use the values in the following table:

    ParamètreSetting ValeurValue DescriptionDescription
    Runtime FunctionsFunctions runtime Azure Functions v2
    (.NET Core)
    Azure Functions v2
    (.NET Core)
    Cette valeur crée un projet de fonction qui utilise la version 2.x du runtime Azure Functions, qui prend en charge .NET Core.This value creates a function project that uses the version 2.x runtime of Azure Functions, which supports .NET Core. La version 1.x d’Azure Functions prend en charge .NET Framework.Azure Functions 1.x supports the .NET Framework. Pour plus d’informations, consultez Vue d’ensemble des versions du runtime Azure Functions.For more information, see Azure Functions runtime versions overview.
    Modèle de fonctionFunction template Déclencheur HTTPHTTP trigger Cette valeur crée une fonction déclenchée par une requête HTTP.This value creates a function triggered by an HTTP request.
    Compte de stockageStorage Account Émulateur de stockageStorage Emulator Étant donné qu’une fonction Azure nécessite un compte de stockage, celui-ci est attribué ou créé quand vous publiez votre projet sur Azure.Because an Azure Function requires a storage account, one is assigned or created when you publish your project to Azure. Un déclencheur HTTP n’utilise pas de chaîne de connexion de compte Stockage Azure ; tous les autres types de déclencheurs nécessitent une chaîne de connexion de compte Stockage Azure valide.An HTTP trigger doesn't use an Azure Storage account connection string; all other trigger types require a valid Azure Storage account connection string.
    Droits d’accèsAccess rights AnonymeAnonymous La fonction créée peut être déclenchée par n’importe quel client sans fournir une clé.The created function can be triggered by any client without providing a key. Ce paramètre d’autorisation facilite le test de votre nouvelle fonction.This authorization setting makes it easy to test your new function. Pour plus d’informations sur les clés et autorisations, consultez Clés d’autorisation et Liaisons HTTP et webhook.For more information about keys and authorization, see Authorization keys and HTTP and webhook bindings.

    Paramètres de projet Azure Functions

    Veillez à définir les Droits d’accès sur Anonyme.Make sure you set the Access rights to Anonymous. Si vous choisissez le niveau par défaut Fonction, vous êtes invité à présenter la clé de fonction dans les requêtes d’accès à votre point de terminaison de fonction.If you choose the default level of Function, you're required to present the function key in requests to access your function endpoint.

  5. Sélectionnez OK pour créer le projet de fonction et la fonction déclenchée par HTTP.Select OK to create the function project and HTTP-triggered function.

Visual Studio crée un projet et une classe qui contient un code réutilisable pour le type de fonction de déclencheur HTTP.Visual Studio creates a project and class that contains boilerplate code for the HTTP trigger function type. L’attribut de méthode FunctionName définit le nom de la fonction qui, par défaut, est Function1.The FunctionName method attribute sets the name of the function, which by default is Function1. L’attribut HttpTrigger spécifie que l’exécution de la fonction est déclenchée par une requête HTTP.The HttpTrigger attribute specifies that the function is triggered by an HTTP request. Le code réutilisable envoie une réponse HTTP qui inclut une valeur de la chaîne de requête ou du corps de requête.The boilerplate code sends an HTTP response that includes a value from the request body or query string.

Étendez les capacités de votre fonction à l’aide de liaisons d’entrée et de sortie en appliquant les attributs appropriés à la méthode.Expand the capabilities of your function with input and output bindings by applying the appropriate attributes to the method. Pour plus d’informations, voir la section Déclencheurs et liaisons de l’article Informations de référence pour les développeurs C# sur Azure Functions.For more information, see the Triggers and bindings section of the Azure Functions C# developer reference.

Maintenant que vous avez créé un projet de fonction et une fonction déclenchée via HTTP, vous pouvez la tester sur votre ordinateur local.Now that you've created your function project and an HTTP-triggered function, you can test it on your local computer.

Exécuter la fonction localementRun the function locally

Visual Studio s’intègre à Azure Functions Core Tools pour vous permettre de tester vos fonctions en local avec le runtime Azure Functions complet.Visual Studio integrates with Azure Functions Core Tools so that you can test your functions locally using the full Azure Functions runtime.

  1. Pour exécuter votre fonction, appuyez sur F5 dans Visual Studio.To run your function, press F5 in Visual Studio. Vous devez peut-être activer une exception de pare-feu afin de permettre aux outils de prendre en charge les requêtes HTTP.You might need to enable a firewall exception so that the tools can handle HTTP requests. Les niveaux d’autorisation ne sont jamais appliqués quand vous exécutez une fonction localement.Authorization levels are never enforced when you run a function locally.

  2. Copiez l’URL de votre fonction à partir de la sortie runtime Azure Functions.Copy the URL of your function from the Azure Functions runtime output.

    Azure runtime local

  3. Collez l’URL de la demande HTTP dans la barre d’adresses de votre navigateur.Paste the URL for the HTTP request into your browser's address bar. Ajoutez la chaîne de requête ?name=<YOUR_NAME> à cette URL et exécutez la demande.Append the query string ?name=<YOUR_NAME> to this URL and run the request. L’image suivante montre dans le navigateur la réponse de la fonction à la requête GET locale :The following image shows the response in the browser to the local GET request returned by the function:

    Réponse de la fonction localhost dans le navigateur

  4. Pour arrêter le débogage, appuyez sur Maj+F5 dans Visual Studio.To stop debugging, press Shift+F5 in Visual Studio.

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.

Publication du projet sur AzurePublish the project to Azure

Avant de pouvoir publier votre projet, vous devez disposer d’une application de fonction dans votre abonnement Azure.Before you can publish your project, you must have a function app in your Azure subscription. La publication Visual Studio crée une application de fonction pour vous la première fois que vous publiez votre projet.Visual Studio publishing creates a function app for you the first time you publish your project.

  1. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le projet, puis sélectionnez Publier.In Solution Explorer, right-click the project and select Publish.

  2. Dans la boîte de dialogue Choisir une cible de publication, utilisez les options de publication comme indiqué dans le tableau sous l’image :In the Pick a publish target dialog, use the publish options as specified in the table below the image:

    Choisir une cible de publication

    OptionOption DescriptionDescription
    Plan Consommation Azure FunctionsAzure Functions Consumption plan Quand vous publiez votre projet dans une application de fonction qui s'exécute dans un Plan Consommation, vous payez uniquement pour les exécutions de votre application.When you publish your project to a function app that runs in a Consumption plan, you only pay for executions of your functions app. D’autres plans d’hébergement occasionnent des coûts plus élevés.Other hosting plans incur higher costs. Pour en savoir plus, voir Mise à l’échelle et hébergement d’Azure Functions.To learn more, see Azure Functions scale and hosting.
    CréerCreate new Une nouvelle application de fonction, avec les ressources associées, est créée dans Azure.A new function app, with related resources, is created in Azure. Lorsque vous choisissez Sélectionner existant, tous les fichiers de l’application de fonction existante dans Azure sont remplacés par les fichiers du projet local.When you choose Select Existing, all files in the existing function app in Azure are overwritten by files from the local project. N’utilisez cette option que lorsque vous réappliquez des mises à jour à une application de fonction existante.Only use this option when republishing updates to an existing function app.
    Exécuter à partir d’un fichier de packageRun from package file Votre application de fonction est déployée en utilisant Zip Deploy avec le mode Exécuter à partir du fichier de package activé.Your function app is deployed using Zip Deploy with Run-From-Package mode enabled. Il s’agit de la méthode recommandée pour exécuter vos fonctions, car elle produit de meilleures performances.This is the recommended way of running your functions, which results in better performance. Quand vous n’utilisez pas cette option, veillez à ce que votre projet d’application de fonction ne s’exécute pas localement avant de publier sur Azure.When not using this option, make sure to stop your function app project from running locally before you publish to Azure.
  3. Sélectionnez Publier.Select Publish. Si vous ne vous êtes pas encore connecté à votre compte Azure à partir de Visual Studio, sélectionnez Connexion.If you haven't already signed-in to your Azure account from Visual Studio, select Sign-in. Vous pouvez également créer un compte Azure gratuit.You can also create a free Azure account.

  4. Dans la boîte de dialogue Azure App Service : Créer nouveau, utilisez les paramètres Hébergement comme indiqué dans le tableau situé sous l’image :In the Azure App Service: Create new dialog, use the Hosting settings as specified in the table below the image:

    Boîte de dialogue Créer App Service

    ParamètreSetting Valeur suggéréeSuggested value DescriptionDescription
    NomName Nom globalement uniqueGlobally unique name Nom qui identifie uniquement votre nouvelle application de fonction.Name that uniquely identifies your new function app. Les caractères valides sont a-z, 0-9 et -.Valid characters are a-z, 0-9, and -.
    AbonnementSubscription Choisir votre abonnementChoose your subscription Sélectionnez l’abonnement Azure à utiliser.The Azure subscription to use.
    Groupe de ressourcesResource Group myResourceGroupmyResourceGroup Nom du groupe de ressources où créer votre application de fonction.Name of the resource group in which to create your function app. Choisissez Nouveau pour créer un groupe de ressources.Choose New to create a new resource group.
    Plan d’hébergementHosting Plan Plan de consommationConsumption plan Après avoir sélectionné Nouveau pour créer un plan serverless, veillez à choisir Consommation sous Taille.Make sure to choose the Consumption under Size after you select New to create a serverless plan. Choisissez également un Emplacement dans une région près de chez vous ou près d’autres services auxquels ont accès vos fonctions.Also, choose a Location in a region near you or near other services your functions access. Si vous exécutez un plan autre que le plan Consommation, vous devez gérer la mise à l’échelle de votre application de fonction.When you run in a plan other than Consumption, you must manage the scaling of your function app.
    Stockage AzureAzure Storage Compte de stockage à usage généralGeneral-purpose storage account Un compte de stockage Azure est obligatoire par le runtime Functions.An Azure storage account is required by the Functions runtime. Sélectionnez Nouveau pour créer un compte de stockage universel.Select New to create a general-purpose storage account. Vous pouvez également utiliser un compte existant qui répond aux exigences relatives aux comptes de stockage.You can also use an existing account that meets the storage account requirements.
  5. Sélectionnez Créer pour créer une application de fonction et les ressources associées dans Azure avec ces paramètres et déployer votre code de projet de fonction.Select Create to create a function app and related resources in Azure with these settings and deploy your function project code.

  6. Une fois le déploiement terminé, notez la valeur URL du site, qui est l’adresse de votre application de fonctions dans Azure.After the deployment is complete, make a note of the Site URL value, which is the address of your function app in Azure.

    Message de réussite de publication

Tester votre fonction dans AzureTest your function in Azure

  1. Copiez l’URL de base de l’application de fonction à partir de la page de profil Publier.Copy the base URL of the function app from the Publish profile page. Remplacez la partie localhost:port de l’URL que vous avez utilisée pour tester en local la fonction par la nouvelle URL de base.Replace the localhost:port portion of the URL you used to test the function locally with the new base URL. Ajoutez la chaîne de requête ?name=<YOUR_NAME> à cette URL et exécutez la demande.Append the query string ?name=<YOUR_NAME> to this URL and run the request.

    L’URL qui appelle la fonction déclenchée via HTTP est au format suivant :The URL that calls your HTTP triggered function is in the following format:

    http://<APP_NAME>.azurewebsites.net/api/<FUNCTION_NAME>?name=<YOUR_NAME>

  2. Collez cette nouvelle URL de requête HTTP dans la barre d’adresse de votre navigateur.Paste this new URL for the HTTP request into your browser's address bar. L’image suivante montre dans le navigateur la requête retournée par la fonction suite à la demande distante GET :The following image 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

Les autres démarrages rapides de cette collection reposent sur ce démarrage rapide.Other quickstarts in this collection build upon this quickstart. Si vous envisagez d’utiliser d’autres guides de démarrage rapide, tutoriels ou l’un des services que vous avez créés dans ce guide de démarrage rapide, ne supprimez pas les ressources.If you plan to work with subsequent quickstarts, tutorials, or with any of the services you have created in this quickstart, do not clean up the resources.

Ressources dans Azure fait référence aux applications de fonction, fonctions, comptes de stockage, et ainsi de suite.Resources in Azure refer to function apps, functions, storage accounts, and so forth. Elles sont rassemblées en groupes de ressources, et vous pouvez supprimer tous les éléments d’un groupe en supprimant le groupe.They're grouped into resource groups, and you can delete everything in a group by deleting the group.

Vous avez créé des ressources pour effectuer ces démarrages rapides.You created resources to complete these quickstarts. Vous pouvez être facturé pour ces ressources, en fonction de l’état de votre compte et de la tarification du service.You may be billed for these resources, depending on your account status and service pricing. Si vous n’avez plus besoin des ressources, voici comment les supprimer :If you don't need the resources anymore, here's how to delete them:

  1. Dans le portail Azure, accédez à la page Groupe de ressources.In the Azure portal, go to the Resource group page.

    Pour accéder à cette page à partir de la page d’application de fonction, sélectionnez l’onglet Vue d’ensemble, puis le lien situé sous Groupe de ressources.To get to that page from the function app page, select the Overview tab and then select the link under Resource group.

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

    Pour accéder à la page à partir du tableau de bord, sélectionnez Groupes de ressources, puis le groupe de ressources que vous avez utilisé pour ce démarrage rapide.To get to that page from the dashboard, select Resource groups, and then select the resource group that you used for this quickstart.

  2. Dans 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're the ones you want to delete.

  3. 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.

Étapes suivantesNext steps

Dans ce guide de démarrage rapide, vous avez utilisé Visual Studio pour créer et publier une application de fonction C# dans Azure à l’aide d’une simple fonction déclenchée via HTTP.In this quickstart, you used Visual Studio to create and publish a C# function app in Azure with a simple HTTP triggered function.

Passez à l’article suivant pour savoir comment ajouter une liaison de file d’attente de stockage Azure à votre fonction :Advance to the next article to learn how to add an Azure Storage queue binding to your function: