Skip to content

Commit 1dd8487

Browse files
authored
Merge pull request #98295 from alexkarcher-msft/runtime-driven-scale
Virtual network triggers information
2 parents 7501dde + f474eca commit 1dd8487

File tree

2 files changed

+33
-4
lines changed

2 files changed

+33
-4
lines changed

articles/azure-functions/functions-networking-options.md

Lines changed: 33 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ You can host function apps in a couple of ways:
2727
|----------------|-----------|----------------|---------|-----------------------|
2828
|[Inbound IP restrictions & private site access](#inbound-ip-restrictions)|✅Yes|✅Yes|✅Yes|✅Yes|
2929
|[Virtual network integration](#virtual-network-integration)|❌No|✅Yes (Regional)|✅Yes (Regional and Gateway)|✅Yes|
30-
|[Virtual network triggers (non-HTTP)](#virtual-network-triggers-non-http)|❌No| ❌No|✅Yes|✅Yes|
30+
|[Virtual network triggers (non-HTTP)](#virtual-network-triggers-non-http)|❌No| ✅Yes |✅Yes|✅Yes|
3131
|[Hybrid connections](#hybrid-connections)|❌No|✅Yes|✅Yes|✅Yes|
3232
|[Outbound IP restrictions](#outbound-ip-restrictions)|❌No| ❌No|❌No|✅Yes|
3333

@@ -118,11 +118,40 @@ Currently [Key Vault references](../app-service/app-service-key-vault-references
118118

119119
## Virtual network triggers (non-HTTP)
120120

121-
Currently, to use function triggers other than HTTP from within a virtual network, you must run your function app in an App Service plan or in an App Service Environment.
121+
Currently, you can use non-HTTP trigger functions from within a virtual network in one of two ways:
122+
+ Run your function app in a Premium plan and enable Virtual network trigger support.
123+
+ Run your function app in an App Service plan or App Service Environment.
122124

123-
For example, assume you want to configure Azure Cosmos DB to accept traffic only from a virtual network. You would need to deploy your function app in an app service plan that provides virtual network integration with that virtual network in order to configure Azure Cosmos DB triggers from that resource. During preview, configuring virtual network integration doesn't allow the Premium plan to trigger off that Azure Cosmos DB resource.
125+
### Premium Plan with virtual network triggers
124126

125-
See [this list for all non-HTTP triggers](./functions-triggers-bindings.md#supported-bindings) to double-check what's supported.
127+
When running in a Premium plan, you can connect non-HTTP trigger functions to services running inside a virtual network. To do this, you must enable virtual network trigger support for your function app. The **virtual network trigger support** setting is found in the [Azure portal](https://portal.azure.com) under **Function app settings**.
128+
129+
![VNETToggle](media/functions-networking-options/virtual-network-trigger-toggle.png)
130+
131+
You can also enable virtual network triggers using the following Azure CLI command:
132+
133+
```azurecli-interactive
134+
az resource update -g <resource_group> -n <premium_plan_name> --set properties.functionsRuntimeScaleMonitoringEnabled=1
135+
```
136+
137+
Virtual network triggers are supported in version 2.x and above of the Functions runtime. The following non-HTTP trigger types are supported.
138+
139+
| Extension | Minimum Version |
140+
|-----------|---------|
141+
|[Microsoft.Azure.WebJobs.Extensions.Storage](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.Storage/) | 3.0.10 or above |
142+
|[Microsoft.Azure.WebJobs.Extensions.EventHubs](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.EventHubs)| 4.1.0 or above|
143+
|[Microsoft.Azure.WebJobs.Extensions.ServiceBus](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.ServiceBus)| 3.2.0 or above|
144+
|[Microsoft.Azure.WebJobs.Extensions.CosmosDB](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.CosmosDB)| 3.0.5 or above|
145+
|[Microsoft.Azure.WebJobs.Extensions.DurableTask](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.DurableTask)| 2.0.0 or above|
146+
147+
> [!IMPORTANT]
148+
> When enabling virtual network trigger support, only the trigger types above scale dynamically with your application. You can still use triggers not listed above, however they are not scaled beyond their pre-warmed instance count. See [triggers and bindings](./functions-triggers-bindings.md#supported-bindings) for the complete list of triggers.
149+
150+
### App Service Plan and App Service Environment with virtual network triggers
151+
152+
When your function app runs in either an App Service Plan or an App Service Environment, you can use non-HTTP trigger functions. For your functions to get triggered correctly, you must be connected to a virtual network with access to the resource defined in the trigger connection.
153+
154+
For example, assume you want to configure Azure Cosmos DB to accept traffic only from a virtual network. In this case, you must deploy your function app in an App Service plan that provides virtual network integration with that virtual network. This enabled a function to be triggered by that Azure Cosmos DB resource.
126155

127156
## Hybrid Connections
128157

44.2 KB
Loading

0 commit comments

Comments
 (0)