How To Find Azure Functions Run Time Version

An Azure Function App always runs on a particular runtime version. Below are the three versions of the Azure Functions as of now

1.x
2.x
3.x

3.x run time version of the Azure Function is the default version of the Azure Function as of now. These are known as the major versions of the Azure Functions.

Azure Function targets a specific Azure function runtime version by using the FUNCTIONS_EXTENSION_VERSION application setting in a function app. Each major version of the Azure Function has a FUNCTIONS_EXTENSION_VERSION value i.e for the Azure Function major version 3.x, the value for this is ~3.

Similarly, for the Azure Function major version 2.x, the FUNCTIONS_EXTENSION_VERSION value for this is ~2 and for the Azure Function major version 1.x, the FUNCTIONS_EXTENSION_VERSION value for this is ~1.

Well, now we will discuss, How to find the Azure Functions Run Time Version In Azure Portal. You can follow the below steps to check the Run time version of your Azure Function.

Once you will be logged in to the Azure Portal, navigate to the Azure function App for the one you want to verify the Run time version.

On the Azure Function App page, click on the Configuration option from the left navigation under the Settings option. Then click on the Function runtime settings tab from the right side window, You can able to see the Azure Function Runtime version as highlighted below.

How To Find Azure Functions Run Time Version — How to target Azure Functions runtime versions

~3 is the default run time version as of now if you want to change the run time version you can change to ~2 or ~1 as per your requirement.

Find Azure Functions Run Time Version — function runtime version

If you want to change the run time version to ~2 or ~1, you can select the appropriate version for example if you want to change the run time version to ~1 then select the same and specify the Daily Usage Quota (GB-Sec) option and then click on the Save button to save the changes.

azure functions runtime version — change azure function runtime version

Now on the next window, click on the Continue button to save the updated changes

Check azure functions runtime version — azure function runtime version error

Now the next step is to make sure to Restart the Azure Function App by clicking on the Restart Button on the Azure Function App Overview tab as highlighted below

How to Check azure functions runtime version — azure functions runtime version

Note: An important note here is, You can’t change the runtime version of the Azure Function App using the Azure Portal if the Azure Function App already contains Functions.

This is How To Find Azure Functions Run Time Version in the Azure Portal and how to update the Azure Function runtime version in the Azure portal. Now let’s see How to find Azure Functions Run Time Version in the Visual Studio 2019.

How to find Azure Functions Run Time Version in the Visual Studio 2019

Her, we will discuss How to find Azure Functions Run Time Version in the Visual Studio. Open your Azure Function Project in the Visual Studio 2019.

Right click on the Azure Function Project name and the click on the Edit Project file option as highlighted below

Now you can able to see the .csproj file that looks like below

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>netcoreapp2.1</TargetFramework>
    <AzureFunctionsVersion>v2</AzureFunctionsVersion>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="Microsoft.NET.Sdk.Functions" Version="1.0.36" />
  </ItemGroup>
  <ItemGroup>
    <None Update="host.json">
      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    </None>
    <None Update="local.settings.json">
      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
      <CopyToPublishDirectory>Never</CopyToPublishDirectory>
    </None>
  </ItemGroup>
</Project>

You can see the Azure Function version as highlighted below

How to find Azure Functions Run Time Version in the Visual Studio 2017 — change azure function runtime version

You can also change the Azure Function Versions along with the TargetFramework and then click on the Save button to save the changes.

If you want to change the Azure function version to the version V1, You can change the TargetFramework to net461 like below.

<TargetFramework>net461</TargetFramework>
<AzureFunctionsVersion>v1</AzureFunctionsVersion>

Similarly, If you want to change the Azure function version to the version V2, You can change the TargetFramework to netcoreapp2.1 like below.

<TargetFramework>netcoreapp2.1</TargetFramework>
<AzureFunctionsVersion>v2</AzureFunctionsVersion>

And, If you want to update the Azure function version to the version V3, You can change the TargetFramework to netcoreapp3.1 like below.

<TargetFramework>netcoreapp3.1</TargetFramework>
<AzureFunctionsVersion>v3</AzureFunctionsVersion>

How To Change Azure Functions Run Time Version using PowerShell

You can use the PowerShell ISE or Windows PowerShell to set the Azure Functions run time version. Follow the below steps to update the Azure Function run time version with other Application settings values.

Open the PowerShell ISE using the Run As Administrator mode

How To Change Azure Functions Run Time Version using PowerShell

Copy and paste the below PowerShell script and make sure to change the Azure Function App name and the Resource Group name and then run the script.

$MyNewAppSettings = @{
    "FUNCTIONS_EXTENSION_VERSION" = "~1"
    "customsetting1" = "xyz"
    "customsetting2" = "abc"
}
Set-AzureRmWebApp -ResourceGroupName MyNewresgroupupdt -Name newfuncApp125 -AppSettings $MyNewAppSettings

You can see the same as below

Set Azure Functions Run Time Version using PowerShell — how to change azure function runtime version

Now if you will navigate to the Azure Function App and then click on the configuration from the left navigation, you can able to see the Azure Function runtime version under the Function runtime settings tab, got updated to ~1.

Update Azure Functions Run Time Version using PowerShell — how to change azure function runtime version

The Remote Azure Functions Runtime Version Needs To Be Updated

When You are developing an Azure Function using the Visual Studio and trying to Publish it from the Visual studio itself, You will see this once you will click on the Publish button on the Publish window as shown below

function app runtime version — azure function runtime version

Once you will click on the Publish button, You can able to see the below Pop up that says

“The remote Azure Functions runtime version needs to be updated in order for this project to run successfully in Azure. Updating the runtime version may cause any existing functions on that site to stop working. Automatically update the remote Azure Functions version and continue to Publish? “

You can click on the Yes button to confirm.

This Pop up you are getting because if you will see your Azure Function project file i.e .csproj file that contains the Azure Function version as V2 and the TargetFramework as netcoreapp2.1 as shown below

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>netcoreapp2.1</TargetFramework>
    <AzureFunctionsVersion>v2</AzureFunctionsVersion>
  </PropertyGroup>

Now, if you will change the Azure Function version to V3 and the TargetFramework to netcoreapp3.1, like below

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>netcoreapp3.1</TargetFramework>
    <AzureFunctionsVersion>v3</AzureFunctionsVersion>
  </PropertyGroup>

Now click on the save button and then clean and rebuild the Azure Function project once again, Now click on the Publish button on the Publish window as discussed above, you won’t able to see the popup this time.

Azure Functions Runtime

The Azure Functions Runtime (preview) is supported only for the version 1.x as of now. There is no support for the higher versions of Azure Functions for the Azure Functions Runtime. It provides a new way for the Azure Functions programming model on-premises.

The Azure Functions Runtime basically, consists of two main terms. Those are as follows

Management Role
Worker Role

Management Role:

Basically, provides a host to manage the Azure Function on-premises. This is role that actually do the following tasks

Can help you to host the Azure Functions Management Portal that is the same as the Azure Portal.
It also provides a publishing endpoint that helps you to publish your Azure Functions from the Visual Studio by importing the Publish profile.

Worker Role:

These roles are deployed in the windows containers where actually your Azure Function Code actually executes.

Azure Function Runtime Version : Error

There might be a chance that you will sometimes see an error like “Error: Azure Functions Runtime is unreachable. Click here for details on storage configuration.” Azure Functions Runtime can’t start due to some issues so because of that reason you might see this error.

Cause of the Error Azure Functions Runtime is unreachable

Mostly, the cause of this error is, there is some problem with the Storage account that the Azure Function related to. So the Azure Functions Runtime is trying to access the storage account and it is not actually getting the reference of the Storage account that is used for the Azure Function so it is showing Azure Functions Runtime is unreachable.

Azure Functions Runtime Is Unreachable

Below are some key possibilities that you need to verify to find the root cause of this error.

Verify if the Storage Account is deleted

The first step is you need to cross-check if the storage account that you have used while creating the Azure Function still exists or it got deleted. You might be thinking about how you will get the name of your storage account. To get the Storage account name, You can navigate to the Application Settings of your Azure Function and if you will verify the WEBSITE_CONTENTAZUREFILECONNECTIONSTRING value it will show you the Azure storage account name. The value of this will be like below

DefaultEndpointsProtocol=https;AccountName=mydemoazurefunctionapp89;AccountKey=kFjagA+Qd+dY8AAR4DorVklqR4S6XSEmy4G4OsAnYbfzIRMOOcDwC1qzWE2LibNBfAc9c/aM6V1K0xRG84gjaA==;EndpointSuffix=core.windows.net

You can find out the Storage account name from here, and you can search for the storage account in the Azure Portal, if it exists or not if it is not there then you can recreate the storage account and replace the storage account name in the connection string above. You need to redeploy your Azure Function Code.

Verify the Application Settings for the Storage Account Is Deleted

There might be the case that the application settings for the Azure Storage Account might get deleted, You need to cross-check that and act accordingly.

Check the storage account firewall Configuration

Sometimes the configuration of the Firewall settings might not be proper and it can block access to the Storage Account. You need to configure the Firewall to allow the traffic from or to the Azure Functions.

Check out the storage account connection string key value

The storage account connection string contains the Storage Account key that needs to be verified again just to make sure that it is correct. If you have regenerated the key by chance that needs to update in the Azure Storage connection string.

This is how you can able to fix the error azure functions runtime is unreachable or azure function runtime is unreachable.

Cannot Upgrade With Existing Functions

Sometimes after the deployment of the Azure Function, You might want to upgrade your Azure Function runtime version. While you are trying to update the Azure Function version in the Azure Portal, You will get a warning like below

Cannot Upgrade With Existing Functions. Major version upgrade can introduce breaking changes to languages and bindings. When upgrading the major versions of the runtime, consider creating a new function app and migrate your functions to this new app.

It’s not suggestable to change the major version of the Azure Functions but if you still want to upgrade the Azure Function runtime version then you need to follow the below steps

Functions_Extension_Version

By using the Functions_Extension_Version application settings, you can target a particular version for your Azure Function App. You can also use the Functions_Extension_Version application setting in case you want to update the version of your Azure Function to a previous version or the current version.

The value of the Functions_Extension_Version can be ike ~3, ~2, ~1, etc.

Navigate to the Azure Function App and click on the configuration from the left navigation and then click on the FUNCTIONS_EXTENSION_VERSION.

Once you will click on that, You can able to change the FUNCTIONS_EXTENSION_VERSION value and then click on the Ok button as shown below

azure function app runtime version — “azure functions runtime is unreachable”

The next step is, Make sure to click on the Save button on the Application setting page to update the changes.

You may also like following the below Articles

Wrapping Up

Well, Here, we discussed How To Find Azure Functions Run Time Version, How to find Azure Functions Run Time Version in the Visual Studio 2019, How To Change Azure Functions Run Time Version using PowerShell and we also discussed The Remote Azure Functions Runtime Version Needs To Be Updated and Azure Functions Runtime, Azure Function Runtime Version: Error, Cannot Upgrade With Existing Functions, Azure Functions Runtime Is Unreachable, Functions_Extension_Version. Hope you have enjoyed this article !!!