Skip to content

Commit 4b2dca3

Browse files
Merge pull request #304341 from MicrosoftDocs/main
Auto Publish – main to live - 2025-08-18 22:00 UTC
2 parents 618de18 + 286503c commit 4b2dca3

81 files changed

Lines changed: 515 additions & 772 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

articles/application-gateway/application-gateway-private-deployment.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ Each of these features can be configured independently. For example, a public IP
3737

3838
The functionality of the new controls of private IP frontend configuration, control over NSG rules, and control over route tables, are generally available and supported in production. To join enable the feature, you must opt in to the experience using the Azure portal, PowerShell, CLI, or REST API.
3939

40-
When enrolled, all new Application Gateways provision with the ability to define any combination of the NSG, Route Table, or private IP configuration features. If you wish to opt out from the new functionality and return to the current generally available functionality of Application Gateway, you can do so by [unregistering from the feature](#unregister-the-feature).
40+
When enrolled, all new Application Gateways provision with the ability to define any combination of the NSG, Route Table, or private IP configuration features. If you wish to opt out from the new functionality, you can do so by [unregistering from the feature](#unregister-the-feature).
4141

4242
## Register the feature
4343

articles/application-gateway/understanding-pricing.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ Capacity Unit is the measure of capacity utilization for an Application Gateway
4242

4343
A single Capacity Unit consists of the following parameters:
4444
* 2,500 Persistent connections
45-
* 2.22-Mbps throughput
45+
* 1 GB per hour (2.22-Mbps) throughput
4646
* 1 Compute Unit
4747

4848
The parameter with the highest utilization among these three parameters is used to calculate capacity units for billing purposes.

articles/azure-functions/functions-bindings-azure-sql.md

Lines changed: 6 additions & 143 deletions
Original file line numberDiff line numberDiff line change
@@ -76,148 +76,21 @@ dotnet add package Microsoft.Azure.WebJobs.Extensions.Sql --prerelease
7676
::: zone-end
7777

7878

79-
::: zone pivot="programming-language-javascript, programming-language-powershell"
79+
::: zone pivot="programming-language-javascript, programming-language-powershell,programming-language-python,programming-language-java"
80+
[!INCLUDE [functions-install-extension-bundle](../../includes/functions-install-extension-bundle.md)]
8081

81-
82-
## Install bundle
83-
84-
The SQL bindings extension is part of the v4 [extension bundle], which is specified in your host.json project file.
85-
86-
87-
# [Bundle v4.x](#tab/extensionv4)
88-
89-
The extension bundle is specified by the following code in your `host.json` file:
90-
91-
```json
92-
{
93-
"version": "2.0",
94-
"extensionBundle": {
95-
"id": "Microsoft.Azure.Functions.ExtensionBundle",
96-
"version": "[4.*, 5.0.0)"
97-
}
98-
}
99-
```
100-
101-
# [Preview Bundle v4.x](#tab/extensionv4p)
102-
103-
You can use the preview extension bundle by adding or replacing the following code in your `host.json` file:
104-
105-
```json
106-
{
107-
"version": "2.0",
108-
"extensionBundle": {
109-
"id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
110-
"version": "[4.*, 5.0.0)"
111-
}
112-
}
113-
```
114-
115-
You can view preview functionality on the [Azure Functions SQL Extensions release page](https://github.com/Azure/azure-functions-sql-extension/releases).
116-
117-
> [!NOTE]
118-
> Breaking changes between preview releases of the Azure SQL bindings for Azure Functions requires that all Functions targeting the same database use the same version of the SQL extension package.
119-
120-
---
121-
122-
::: zone-end
123-
124-
125-
::: zone pivot="programming-language-python"
126-
127-
## Functions runtime
128-
129-
<!-- > [!NOTE]
130-
> Python language support for the SQL bindings extension is available starting with v4.5.0 of the [functions runtime](./set-runtime-version.md#view-and-update-the-current-runtime-version). You might need to update your install of Azure Functions [Core Tools](functions-run-local.md) for local development. -->
131-
132-
133-
## Install bundle
134-
135-
The SQL bindings extension is part of the v4 [extension bundle], which is specified in your host.json project file.
136-
137-
138-
# [Bundle v4.x](#tab/extensionv4)
139-
140-
The extension bundle is specified by the following code in your `host.json` file:
141-
142-
```json
143-
{
144-
"version": "2.0",
145-
"extensionBundle": {
146-
"id": "Microsoft.Azure.Functions.ExtensionBundle",
147-
"version": "[4.*, 5.0.0)"
148-
}
149-
}
150-
```
151-
152-
# [Preview Bundle v4.x](#tab/extensionv4p)
153-
154-
You can use the preview extension bundle by adding or replacing the following code in your `host.json` file:
155-
156-
```json
157-
{
158-
"version": "2.0",
159-
"extensionBundle": {
160-
"id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
161-
"version": "[4.*, 5.0.0)"
162-
}
163-
}
164-
```
165-
166-
You can view preview functionality on the [Azure Functions SQL Extensions release page](https://github.com/Azure/azure-functions-sql-extension/releases).
167-
168-
> [!NOTE]
169-
> Breaking changes between preview releases of the Azure SQL bindings for Azure Functions requires that all Functions targeting the same database use the same version of the SQL extension package.
170-
171-
---
172-
173-
::: zone-end
174-
175-
176-
::: zone pivot="programming-language-java"
177-
178-
179-
## Install bundle
180-
181-
The SQL bindings extension is part of the v4 [extension bundle], which is specified in your host.json project file.
182-
183-
# [Bundle v4.x](#tab/extensionv4)
184-
185-
The extension bundle is specified by the following code in your `host.json` file:
186-
187-
```json
188-
{
189-
"version": "2.0",
190-
"extensionBundle": {
191-
"id": "Microsoft.Azure.Functions.ExtensionBundle",
192-
"version": "[4.*, 5.0.0)"
193-
}
194-
}
195-
```
196-
197-
# [Preview Bundle v4.x](#tab/extensionv4p)
198-
199-
You can use the preview extension bundle by adding or replacing the following code in your `host.json` file:
200-
201-
```json
202-
{
203-
"version": "2.0",
204-
"extensionBundle": {
205-
"id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
206-
"version": "[4.*, 5.0.0)"
207-
}
208-
}
209-
```
82+
If your app needs to use preview functionality, you should instead reference the latest version of the preview bundle. For more information, see [Preview extension bundles](extension-bundles.md#preview-extension-bundles).
21083

21184
You can view preview functionality on the [Azure Functions SQL Extensions release page](https://github.com/Azure/azure-functions-sql-extension/releases).
21285

21386
> [!NOTE]
21487
> Breaking changes between preview releases of the Azure SQL bindings for Azure Functions requires that all Functions targeting the same database use the same version of the SQL extension package.
21588
216-
---
217-
89+
::: zone-end
90+
::: zone pivot="programming-language-java"
21891
## Update packages
21992

220-
Add the Java library for SQL bindings to your functions project with an update to the `pom.xml` file in your Java Azure Functions project as seen in the following snippet:
93+
Add the [Azure Functions Java SQL Types package](https://mvnrepository.com/artifact/com.microsoft.azure.functions/azure-functions-java-library-sql) to your functions project with an update to the `pom.xml` file in your project, as in this example:
22194

22295
```xml
22396
<dependency>
@@ -227,16 +100,6 @@ Add the Java library for SQL bindings to your functions project with an update t
227100
</dependency>
228101
```
229102

230-
You can use the preview extension bundle with an update to the `pom.xml` file in your Java Azure Functions project as seen in the following snippet:
231-
232-
```xml
233-
<dependency>
234-
<groupId>com.microsoft.azure.functions</groupId>
235-
<artifactId>azure-functions-java-library-sql</artifactId>
236-
<version>2.1.0-preview</version>
237-
</dependency>
238-
```
239-
240103
::: zone-end
241104

242105
## SQL connection string

articles/azure-functions/functions-bindings-cache.md

Lines changed: 49 additions & 75 deletions
Original file line numberDiff line numberDiff line change
@@ -68,100 +68,75 @@ dotnet add package Microsoft.Azure.WebJobs.Extensions.Redis
6868
```
6969

7070
---
71-
::: zone-end
72-
73-
## Install bundle
74-
75-
::: zone pivot="programming-language-java"
76-
77-
1. Create a Java function project. You could use Maven:
78-
`mvn archetype:generate -DarchetypeGroupId=com.microsoft.azure -DarchetypeArtifactId=azure-functions-archetype -DjavaVersion=8`
79-
80-
1. Add the extension bundle by adding or replacing the following code in your _host.json_ file:
81-
82-
```json
83-
{
84-
"version": "2.0",
85-
"extensionBundle": {
86-
"id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
87-
"version": "[4.11.*, 5.0.0)"
88-
}
89-
}
90-
```
91-
92-
>[!WARNING]
93-
>The Redis extension is currently only available in a preview bundle release.
94-
>
71+
::: zone-end
72+
::: zone pivot="programming-language-javascript,programming-language-python,programming-language-powershell"
73+
[!INCLUDE [functions-install-extension-bundle](../../includes/functions-install-extension-bundle.md)]
74+
::: zone-end
75+
::: zone pivot="programming-language-java"
76+
## Update packages
77+
78+
Add the [Azure Functions Java Redis Annotations package](https://mvnrepository.com/artifact/com.microsoft.azure.functions/azure-functions-java-library-redis) to your project by updating the `pom.xml` file to add this dependency:
79+
80+
```xml
81+
<dependency>
82+
<groupId>com.microsoft.azure.functions</groupId>
83+
<artifactId>azure-functions-java-library-redis</artifactId>
84+
<version>1.0.0</version>
85+
</dependency>
86+
```
87+
::: zone-end
9588

96-
1. Add the Java library for Redis bindings to the `pom.xml` file:
89+
## Redis connection string
9790

98-
```xml
99-
<dependency>
100-
<groupId>com.microsoft.azure.functions</groupId>
101-
<artifactId>azure-functions-java-library-redis</artifactId>
102-
<version>${azure.functions.java.library.redis.version}</version>
103-
</dependency>
104-
```
91+
Azure Redis triggers and bindings have a required property that indicates the application setting or collection name that contains cache connection information. The Redis trigger or binding looks for an environmental variable holding the connection string with the name passed to the `Connection` parameter.
10592

106-
::: zone-end
107-
::: zone pivot="programming-language-javascript,programming-language-python,programming-language-powershell"
93+
In local development, the `Connection` can be defined using the [local.settings.json](/azure/azure-functions/functions-develop-local#local-settings-file) file. When deployed to Azure, [application settings](/azure/azure-functions/functions-how-to-use-azure-function-app-settings) can be used.
10894

109-
Add the extension bundle by adding or replacing the following code in your _host.json_ file:
95+
When connecting to a cache instance with an Azure function, you can use one of these kinds of connections in your deployments:
11096

111-
```json
112-
{
113-
"version": "2.0",
114-
"extensionBundle": {
115-
"id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
116-
"version": "[4.11.*, 5.0.0)"
117-
}
118-
}
97+
### [User-assigned managed identity](#tab/user-assigned)
11998

120-
```
99+
A user-assigned mananged identity must be associated with your function app, and that identity must also be granted explicit permissions in your cache service. For more information, see [Use Microsoft Entra ID for cache authentication](/azure/azure-cache-for-redis/cache-azure-active-directory-for-authentication).
121100

122-
>[!WARNING]
123-
>The Redis extension is currently only available in a preview bundle release.
124-
>
101+
### [System-assigned managed identity](#tab/system-assigned)
125102

126-
::: zone-end
103+
The built-in system-assigned mananged identity must be enabled in your function app, and that identity must also be granted explicit permissions in your cache service. For more information, see [Use Microsoft Entra ID for cache authentication](/azure/azure-cache-for-redis/cache-azure-active-directory-for-authentication).
127104

128-
## Redis connection string
105+
### [Connection string](#tab/connection-string)
129106

130-
Azure Redis triggers and bindings have a required property that indicates the application setting or collection name that contains cache connection information. The connection string can be found on the [**Access keys**](/azure/azure-cache-for-redis/cache-configure#access-keys) menu in the Azure Managed Redis or Azure Cache for Redis portal. The Redis trigger or binding looks for an environmental variable holding the connection string with the name passed to the `Connection` parameter.
107+
The connection string can be found on the [**Access keys**](/azure/azure-cache-for-redis/cache-configure#access-keys) menu in the Azure Managed Redis or Azure Cache for Redis portal.
131108

132-
In local development, the `Connection` can be defined using the [local.settings.json](/azure/azure-functions/functions-develop-local#local-settings-file) file. When deployed to Azure, [application settings](/azure/azure-functions/functions-how-to-use-azure-function-app-settings) can be used.
109+
For optimal security, your function app should use Microsoft Entra ID with managed identities to authorize requests against your cache, if possible. Authorization by using Microsoft Entra ID and managed identities provides superior security and ease of use over shared access key authorization. For more information about using managed identities with your cache, see [Use Microsoft Entra ID for cache authentication](/azure/azure-cache-for-redis/cache-azure-active-directory-for-authentication).
133110

134-
When connecting to a cache instance with an Azure function, you can use three types of connections in your deployments: Connection string, System-assigned managed identity, and User-assigned managed identity.
111+
### [Service principal](#tab/service-principal)
135112

136-
For local development, you can also use service principal secrets.
113+
Connecting to the service using a service principal is only supported when running locally during development. A service principal linked to your account must be granted explicit permissions in your cache service.
137114

138-
[!INCLUDE [functions-azure-redis-cache-authentication-note](../../includes/functions-azure-redis-cache-authentication-note.md)]
115+
---
139116

140-
Use the `appsettings` to configure each of the following types of client authentication, assuming the `Connection` was set to `Redis` in the function.
117+
These examples show the key name and value of app settings required to connect to each cache service based on the kind of client authentication, assuming that the `Connection` property in the binding is set to `Redis`.
141118

142-
## [Azure Managed Redis connections](#tab/azure-managed-redis)
143-
### Connection string
119+
### [Azure Managed Redis](#tab/azure-managed-redis/user-assigned)
144120

145121
```JSON
146-
"Redis": "<cacheName>.<region>.redis.azure.net:10000,password=..."
122+
"Redis__redisHostName": "<cacheName>.<region>.redis.azure.net",
123+
"Redis__principalId": "<principalId>",
124+
"Redis__clientId": "<clientId>"
147125
```
148126

149-
### System-assigned managed identity
127+
### [Azure Managed Redis](#tab/azure-managed-redis/system-assigned)
150128

151129
```JSON
152130
"Redis__redisHostName": "<cacheName>.<region>.redis.azure.net",
153131
"Redis__principalId": "<principalId>"
154132
```
155133

156-
### User-assigned managed identity
134+
### [Azure Managed Redis](#tab/azure-managed-redis/connection-string)
157135

158136
```JSON
159-
"Redis__redisHostName": "<cacheName>.<region>.redis.azure.net",
160-
"Redis__principalId": "<principalId>",
161-
"Redis__clientId": "<clientId>"
137+
"Redis": "<cacheName>.<region>.redis.azure.net:10000,password=..."
162138
```
163-
164-
### Service Principal Secret
139+
### [Azure Managed Redis](#tab/azure-managed-redis/service-principal)
165140

166141
Connections using Service Principal Secrets are only available during local development.
167142

@@ -173,29 +148,27 @@ Connections using Service Principal Secrets are only available during local deve
173148
"Redis__clientSecret": "<clientSecret>"
174149
```
175150

176-
## [Azure Cache for Redis connections](#tab/azure-cache-redis)
177-
### Connection string
151+
### [Azure Cache for Redis](#tab/azure-cache-redis/user-assigned)
178152

179153
```JSON
180-
"Redis": "<cacheName>.redis.cache.windows.net:6380,password=..."
154+
"Redis__redisHostName": "<cacheName>.redis.cache.windows.net",
155+
"Redis__principalId": "<principalId>",
156+
"Redis__clientId": "<clientId>"
181157
```
182158

183-
### System-assigned managed identity
159+
### [Azure Cache for Redis](#tab/azure-cache-redis/system-assigned)
184160

185161
```JSON
186162
"Redis__redisHostName": "<cacheName>.redis.cache.windows.net",
187163
"Redis__principalId": "<principalId>"
188164
```
189165

190-
### User-assigned managed identity
166+
### [Azure Cache for Redis](#tab/azure-cache-redis/connection-string)
191167

192168
```JSON
193-
"Redis__redisHostName": "<cacheName>.redis.cache.windows.net",
194-
"Redis__principalId": "<principalId>",
195-
"Redis__clientId": "<clientId>"
169+
"Redis": "<cacheName>.redis.cache.windows.net:6380,password=..."
196170
```
197-
198-
### Service Principal Secret
171+
### [Azure Cache for Redis](#tab/azure-cache-redis/service-principal)
199172

200173
Connections using Service Principal Secrets are only available during local development.
201174

@@ -206,6 +179,7 @@ Connections using Service Principal Secrets are only available during local deve
206179
"Redis__tenantId": "<tenantId>"
207180
"Redis__clientSecret": "<clientSecret>"
208181
```
182+
209183
---
210184

211185
## Related content

0 commit comments

Comments
 (0)