Quickstart: Create your first function in Azure using Visual Studio
In this article, you use Visual Studio to create a C# class library-based function that responds to HTTP requests. After testing the code locally, you deploy it to the serverless environment of Azure Functions.
Completing this quickstart incurs a small cost of a few USD cents or less in your Azure account.
To complete this tutorial, first install Visual Studio 2019. Ensure you select the Azure development workload during installation. If you want to create an Azure Functions project by using Visual Studio 2017 instead, you must first install the latest Azure Functions tools.
Create a function app project
The Azure Functions project template in Visual Studio creates a project that you can publish to a function app in Azure. You can use a function app to group functions as a logical unit for easier management, deployment, scaling, and sharing of resources.
From the Visual Studio menu, select File > New > Project.
In Create a new project, enter functions in the search box, choose the Azure Functions template, and then select Next.
In Configure your new project, enter a Project name for your project, and then select Create. The function app name must be valid as a C# namespace, so don't use underscores, hyphens, or any other nonalphanumeric characters.
For the Create a new Azure Function Application settings, use the values in the following table:
Setting Value Description Functions runtime Azure Functions v3
This value creates a function project that uses the version 3.x runtime of Azure Functions, which supports .NET Core 3.x. Azure Functions 1.x supports the .NET Framework. For more information, see Azure Functions runtime versions overview. Function template HTTP trigger This value creates a function triggered by an HTTP request. Storage Account Storage Emulator Because an Azure Function requires a storage account, one is assigned or created when you publish your project to Azure. An HTTP trigger doesn't use an Azure Storage account connection string; all other trigger types require a valid Azure Storage account connection string. Access rights Anonymous The created function can be triggered by any client without providing a key. This authorization setting makes it easy to test your new function. For more information about keys and authorization, see Authorization keys and HTTP and webhook bindings.
Make sure you set the Access rights to Anonymous. If you choose the default level of Function, you're required to present the function key in requests to access your function endpoint.
Select Create to create the function project and HTTP trigger function.
Visual Studio creates a project and class that contains boilerplate code for the HTTP trigger function type. The boilerplate code sends an HTTP response that includes a value from the request body or query string. The
HttpTrigger attribute specifies that the function is triggered by an HTTP request.
Rename the function
FunctionName method attribute sets the name of the function, which by default is generated as
Function1. Since the tooling doesn't let you override the default function name when you create your project, take a minute to create a better name for the function class, file, and metadata.
In File Explorer, right-click the Function1.cs file and rename it to
In the code, rename the Function1 class to `HttpExample'.
run, rename the
FunctionNamemethod attribute to
Now that you've renamed the function, you can test it on your local computer.
Run the function locally
Visual Studio integrates with Azure Functions Core Tools so that you can test your functions locally using the full Azure Functions runtime.
To run your function, press F5 in Visual Studio. You might need to enable a firewall exception so that the tools can handle HTTP requests. Authorization levels are never enforced when you run a function locally.
Copy the URL of your function from the Azure Functions runtime output.
Paste the URL for the HTTP request into your browser's address bar. Append the query string
?name=<YOUR_NAME>to this URL and run the request. The following image shows the response in the browser to the local GET request returned by the function:
To stop debugging, press Shift+F5 in Visual Studio.
After you've verified that the function runs correctly on your local computer, it's time to publish the project to Azure.
Publish the project to Azure
Before you can publish your project, you must have a function app in your Azure subscription. Visual Studio publishing creates a function app for you the first time you publish your project.
In Solution Explorer, right-click the project and select Publish.
In Pick a publish target, use the publish options specified in the following table:
Option Description Azure Functions Consumption Plan Create a function app in an Azure cloud environment that runs in a Consumption plan. When you use a Consumption plan, you pay only for executions of your functions app. Other hosting plans incur higher costs. If you run in a plan other than a Consumption plan, you must manage the scaling of your function app. Create New A new function app, with related resources, is created in Azure.
If you choose Select Existing, all files in the existing function app in Azure are overwritten by files from the local project. Use this option only when you republish updates to an existing function app.
Run from package file Your function app is deployed using Zip Deploy with Run-From-Package mode enabled. This deployment, which results in better performance, is the recommended way of running your functions.
If you don't use this option, make sure to stop your function app project from running locally before you publish to Azure.
Select Create Profile. If you haven't already signed-in to your Azure account from Visual Studio, select Sign-in. You can also create a free Azure account.
In App Service: Create new, use the values specified in the following table:
Setting Value Description Name Globally unique name Name that uniquely identifies your new function app. Accept this name or enter a new name. Valid characters are:
Subscription Your subscription The Azure subscription to use. Accept this subscription or select a new one from the drop-down list. Resource group Name of your resource group The resource group in which to create your function app. Select an existing resource group from the drop-down list or choose New to create a new resource group. Hosting Plan Name of your hosting plan Select New to configure a serverless plan. Make sure to choose the Consumption under Size. When you publish your project to a function app that runs in a Consumption plan, you pay only for executions of your functions app. Other hosting plans incur higher costs. If you run in a plan other than Consumption, you must manage the scaling of your function app. Location Location of the app service Choose a Location in a region near you or other services your functions access. Azure Storage General-purpose storage account An Azure Storage account is required by the Functions runtime. Select New to configure a general-purpose storage account. You can also choose an existing account that meets the storage account requirements.
Select Create to create a function app and its related resources in Azure with these settings and deploy your function project code.
Select Publish and wait for the deployment to complete.
After the deployment completes the root URL of the function app in Azure is shown in the Publish tab.
In the Publish tab, choose Manage in Cloud Explorer. This opens the new function app Azure resource in Cloud Explorer.
Cloud Explorer lets you use Visual Studio to view the contents of the site, start and stop the function app, and browse directly to function app resources on Azure and in the Azure portal.
Test your function in Azure
In Cloud Explorer, your new function app should be selected. If not, expand your subscription > App Services, and select your new function app.
Right-click the function app and choose Open in Browser. This opens the root of your function app in your default web browser and displays the page that indicates your function app is running.
In the address bar in the browser, append the string
/api/HttpExample?name=Functionsto the base URL and run the request.
The URL that calls your HTTP trigger function is in the following format:
Go to this URL and you see a response in the browser to the remote GET request returned by the function, which looks like the following example:
Clean up resources
Other quickstarts in this collection build upon this quickstart. 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.
Resources in Azure refer to function apps, functions, storage accounts, and so forth. They're grouped into resource groups, and you can delete everything in a group by deleting the group.
You created resources to complete these quickstarts. You may be billed for these resources, depending on your account status and service pricing. If you don't need the resources anymore, here's how to delete them:
In the Cloud Explorer, expand your subscription > App Services, right-click your function app, and choose Open in Portal.
In the function app page, select the Overview tab and then select the link under Resource group.
In the Resource group page, review the list of included resources, and verify that they're the ones you want to delete.
Select Delete resource group, and follow the instructions.
Deletion may take a couple of minutes. When it's done, a notification appears for a few seconds. You can also select the bell icon at the top of the page to view the notification.
In this quickstart, you used Visual Studio to create and publish a C# function app in Azure with a simple HTTP trigger function.
Advance to the next article to learn how to add an Azure Storage queue binding to your function: