Skip to content

Commit ee3cbc3

Browse files
committed
edits
1 parent 83baac8 commit ee3cbc3

10 files changed

+44
-50
lines changed

articles/azure-functions/durable/TOC.yml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -35,11 +35,11 @@
3535
- name: Create a Durable Functions app - Java
3636
displayName: get started, chaining
3737
href: quickstart-java.md
38-
- name: Configure storage provider - Netherite
38+
- name: Configure a storage provider - Netherite
3939
href: quickstart-netherite.md
40-
- name: Configure storage provider - MSSQL
40+
- name: Configure a storage provider - MSSQL
4141
href: quickstart-mssql.md
42-
- name: Configure Durable Functions with Microsoft Entra ID
42+
- name: Authenticate a Durable Functions app
4343
href: durable-functions-configure-durable-functions-with-credentials.md
4444
- name: Tutorials
4545
items:

articles/azure-functions/durable/durable-functions-configure-durable-functions-with-credentials.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ ms.author: azfuncdf
1111

1212
[Microsoft Entra ID](/entra/fundamentals/whatis) is a cloud-based identity and access management service. Identity-based connections allow Durable Functions, a feature of Azure Functions, to make authorized requests against Microsoft Entra-protected resources, such as an Azure Storage account, without using manually managed secrets. When Durable Functions uses the default Azure storage provider, it must authenticate against an Azure storage account.
1313

14-
In this quickstart, you complete the steps to set up a Durable Functions app to use two different kinds of identity-based connections:
14+
In this quickstart, you complete steps to set up a Durable Functions app to use two different kinds of identity-based connections:
1515

1616
* Managed identity credentials (recommended)
1717
* Client secret credentials
@@ -60,7 +60,7 @@ Before you can use your app's managed identity, make some changes to the app con
6060

6161
1. In the list of settings, select **AzureWebJobsStorage** and select the **Delete** icon.
6262

63-
:::image type="content" source="media/durable-functions-configure-df-with-credentials/durable-functions-managed-identity-scenario-01.png" alt-text="Screenshot that shows default storage settings and deleting AzureWebJobsStorage.":::
63+
:::image type="content" source="media/durable-functions-configure-df-with-credentials/durable-functions-managed-identity-scenario-01.png" alt-text="Screenshot that shows default storage settings and deleting AzureWebJobsStorage." lightbox="media/durable-functions-configure-df-with-credentials/durable-functions-managed-identity-scenario-01.png":::
6464

6565
1. Add a setting to link your Azure storage account to the application.
6666

@@ -103,7 +103,7 @@ Before you can use your app's managed identity, make some changes to the app con
103103

104104
* For **AzureWebJobsStorage__clientId**, get this GUID value from the Microsoft Entra admin center.
105105

106-
:::image type="content" source="media/durable-functions-configure-df-with-credentials/durable-functions-managed-identity-scenario-03.png" alt-text="Screenshot that shows the user identity client ID.":::
106+
:::image type="content" source="media/durable-functions-configure-df-with-credentials/durable-functions-managed-identity-scenario-03.png" alt-text="Screenshot that shows the user identity client ID." lightbox="media/durable-functions-configure-df-with-credentials/durable-functions-managed-identity-scenario-03.png":::
107107

108108
## Configure your app to use client secret credentials
109109

@@ -127,7 +127,7 @@ Registering a client application in Microsoft Entra ID is another way that you c
127127

128128
The secret value doesn't appear again after you leave the pane, so be sure that you *copy the secret and save it*.
129129

130-
:::image type="content" source="media/durable-functions-configure-df-with-credentials/durable-functions-client-secret-scenario-01.png" alt-text="Screenshot that shows the Add a client secret pane.":::
130+
:::image type="content" source="media/durable-functions-configure-df-with-credentials/durable-functions-client-secret-scenario-01.png" alt-text="Screenshot that shows the Add a client secret pane." lightbox="media/durable-functions-configure-df-with-credentials/durable-functions-client-secret-scenario-01.png":::
131131

132132
### Assign access roles to your application
133133

@@ -143,11 +143,11 @@ To add the roles:
143143

144144
1. In the resource menu, select **Access Control (IAM)**, and then select **Add role assignment**.
145145

146-
:::image type="content" source="media/durable-functions-configure-df-with-credentials/durable-functions-client-secret-scenario-02.png" alt-text="Screenshot that shows the Access control pane with Add role assignment highlighted.":::
146+
:::image type="content" source="media/durable-functions-configure-df-with-credentials/durable-functions-client-secret-scenario-02.png" alt-text="Screenshot that shows the Access control pane with Add role assignment highlighted." lightbox="media/durable-functions-configure-df-with-credentials/durable-functions-client-secret-scenario-02.png":::
147147

148148
1. Select the role you want to add, select **Next**, and then search for your application. Review the role, and then add the role.
149149

150-
:::image type="content" source="media/durable-functions-configure-df-with-credentials/durable-functions-client-secret-scenario-03.png" alt-text="Screenshot that shows the role assignment pane.":::
150+
:::image type="content" source="media/durable-functions-configure-df-with-credentials/durable-functions-client-secret-scenario-03.png" alt-text="Screenshot that shows the role assignment pane." lightbox="media/durable-functions-configure-df-with-credentials/durable-functions-client-secret-scenario-03.png":::
151151

152152
### Configure the client secret
153153

@@ -186,7 +186,7 @@ In the Azure portal, run and test the application. To run and test the app local
186186

187187
You can get the values for these URI variables in the storage account on the **Endpoints** tab.
188188

189-
:::image type="content" source="media/durable-functions-configure-df-with-credentials/durable-functions-managed-identity-scenario-02.png" alt-text="Screenshot that shows an example of an endpoint as a specific service URI.":::
189+
:::image type="content" source="media/durable-functions-configure-df-with-credentials/durable-functions-managed-identity-scenario-02.png" alt-text="Screenshot that shows an example of an endpoint as a specific service URI." lightbox="media/durable-functions-configure-df-with-credentials/durable-functions-managed-identity-scenario-02.png":::
190190

191191
1. To add client secret credentials, specify the following values:
192192

@@ -198,4 +198,4 @@ In the Azure portal, run and test the application. To run and test the app local
198198

199199
The values to use for the client ID and the tenant ID appear on your client application Overview pane. The client secret value is the one that you saved in an earlier step. The client secret value isn't available after the page is refreshed.
200200

201-
:::image type="content" source="media/durable-functions-configure-df-with-credentials/durable-functions-client-secret-scenario-04.png" alt-text="Screenshot that shows the tenant ID and client ID on a Microsoft Entra application pane.":::
201+
:::image type="content" source="media/durable-functions-configure-df-with-credentials/durable-functions-client-secret-scenario-04.png" alt-text="Screenshot that shows the tenant ID and client ID on a Microsoft Entra application pane." lightbox="media/durable-functions-configure-df-with-credentials/durable-functions-client-secret-scenario-04.png":::

articles/azure-functions/durable/durable-functions-isolated-create-first-csharp.md

Lines changed: 6 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -12,19 +12,15 @@ ms.custom: mode-other, devdivchpfy22, vscode-azure-extension-update-complete, de
1212

1313
# Quickstart: Create a C# Durable Functions app
1414

15-
Durable Functions is a feature of [Azure Functions](../functions-overview.md) that you can use to write stateful functions in a serverless environment. Durable Functions manages state, checkpoints, and restarts for you.
15+
Durable Functions is a feature of [Azure Functions](../functions-overview.md). Use Durable Functions to write stateful functions in a serverless environment. Durable Functions manages state, checkpoints, and restarts in your application.
1616

17-
Like Azure Functions, Durable Functions supports two process models for .NET class library functions:
18-
19-
[!INCLUDE [functions-dotnet-execution-model](../../../includes/functions-dotnet-execution-model.md)]
20-
21-
To learn more about the two processes, see [Differences between in-process and isolated worker process .NET Azure Functions](../dotnet-isolated-in-process-differences.md).
17+
Like Azure Functions, Durable Functions supports two process models for .NET class library functions. To learn more about the two processes, see [Differences between in-process and isolated worker process .NET Azure Functions](../dotnet-isolated-in-process-differences.md).
2218

2319
::: zone pivot="code-editor-vscode"
2420

2521
In this quickstart, you use Visual Studio Code to locally create and test a "hello world" Durable Functions app. The function app orchestrates and chains together calls to other functions. Then, you publish the function code in Azure. The tools you use are available via the Visual Studio Code [Azure Functions extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azurefunctions).
2622

27-
:::image type="content" source="./media/durable-functions-create-first-csharp/functions-vscode-complete.png" alt-text="Screenshot of Durable Functions app code in Visual Studio Code.":::
23+
:::image type="content" source="./media/durable-functions-create-first-csharp/functions-vscode-complete.png" alt-text="Screenshot that shows Durable Functions app code in Visual Studio Code.":::
2824

2925
## Prerequisites
3026

@@ -109,11 +105,11 @@ Azure Functions Core Tools gives you the capability to run an Azure Functions pr
109105
> [!NOTE]
110106
> For more information about debugging, see [Durable Functions diagnostics](durable-functions-diagnostics.md#debugging).
111107
>
112-
> If the message *No job functions found* appears, [update your Azure Functions Core Tools installation to the latest version](./../functions-core-tools-reference.md). Earlier versions of Core Tools don't support the .NET isolated worker model.
108+
> If the message *No job functions found* appears, [update your Azure Functions Core Tools installation to the latest version](./../functions-core-tools-reference.md).
113109
114110
1. In the terminal panel, copy the URL endpoint of your HTTP-triggered function.
115111

116-
:::image type="content" source="media/durable-functions-create-first-csharp/isolated-functions-vscode-debugging.png" alt-text="Screenshot of Azure local output window." lightbox="media/durable-functions-create-first-csharp/isolated-functions-vscode-debugging.png":::
112+
:::image type="content" source="media/durable-functions-create-first-csharp/isolated-functions-vscode-debugging.png" alt-text="Screenshot of the Azure local output window." lightbox="media/durable-functions-create-first-csharp/isolated-functions-vscode-debugging.png":::
117113

118114
1. Use a tool like [Postman](https://www.getpostman.com/) or [cURL](https://curl.haxx.se/) to send an HTTP POST request to the URL endpoint.
119115

@@ -171,7 +167,7 @@ If you no longer need the resources that you created to complete the quickstart,
171167

172168
::: zone pivot="code-editor-visualstudio"
173169

174-
In this quickstart, you use Visual Studio 2022 to locally create and test a "hello world" Durable Functions app that runs in the isolated worker process. The function orchestrates and chains together calls to other functions. Then, you publish the function code in Azure. The tools you use are available via the *Azure development workload* in Visual Studio 2022.
170+
In this quickstart, you use Visual Studio 2022 to locally create and test a "hello world" Durable Functions app. The function orchestrates and chains together calls to other functions. Then, you publish the function code in Azure. The tools you use are available via the *Azure development workload* in Visual Studio 2022.
175171

176172
:::image type="content" source="./media/durable-functions-create-first-csharp/functions-vs-complete.png" alt-text="Screenshot of Durable Functions app code in Visual Studio 2019.":::
177173

articles/azure-functions/durable/quickstart-java.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ zone_pivot_groups: create-java-durable-options
1212

1313
# Quickstart: Create a Java Durable Functions app
1414

15-
Durable Functions is a feature of [Azure Functions](../functions-overview.md) that you can use to write stateful functions in a serverless environment. Durable Functions manages state, checkpoints, and restarts for you.
15+
Durable Functions is a feature of [Azure Functions](../functions-overview.md). Use Durable Functions to write stateful functions in a serverless environment. Durable Functions manages state, checkpoints, and restarts in your application.
1616

1717
In this quickstart, you create and test a "hello world" Durable Functions app in Java.
1818

@@ -274,7 +274,7 @@ Durable Functions needs a storage provider to store runtime state. You can set A
274274

275275
1. In Visual Studio Code, select F1 (or select Ctrl/Cmd+Shift+P) to open the command palette. At the prompt (`>`), enter and then select **Azure Functions: Create New Project**.
276276

277-
![Screenshot of the create new functions project command.](media/quickstart-js-vscode/functions-create-project.png)
277+
:::image type="content" source="media/quickstart-js-vscode/functions-create-project.png" alt-text="Screenshot of the create new functions project command.":::
278278

279279
1. Select **Browse**. In the **Select Folder** dialog, go to a folder to use for your project, and then choose **Select**.
280280

@@ -353,7 +353,7 @@ Azure Functions Core Tools gives you the capability to run an Azure Functions pr
353353

354354
1. In the terminal panel, copy the URL endpoint of your HTTP-triggered function.
355355

356-
![Screenshot of Azure local output.](media/quickstart-java/maven-functions-run.png)
356+
:::image type="content" source="media/quickstart-java/maven-functions-run.png" alt-text="Screenshot of Azure local output.":::
357357

358358
1. Use a tool like [Postman](https://www.getpostman.com/) or [cURL](https://curl.haxx.se/) to send an HTTP POST request to the URL endpoint. The response should look similar to the following example:
359359

articles/azure-functions/durable/quickstart-js-vscode.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ zone_pivot_groups: functions-nodejs-model
1212

1313
# Quickstart: Create a JavaScript Durable Functions app
1414

15-
Durable Functions is a feature of [Azure Functions](../functions-overview.md) that you can use to write stateful functions in a serverless environment. You install Durable Functions by installing the [Azure Functions extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azurefunctions) in Visual Studio Code. The extension manages state, checkpoints, and restarts for you.
15+
Durable Functions is a feature of [Azure Functions](../functions-overview.md). Use Durable Functions to write stateful functions in a serverless environment. You install Durable Functions by installing the [Azure Functions extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azurefunctions) in Visual Studio Code. The extension manages state, checkpoints, and restarts in your application.
1616

1717
In this quickstart, you use the Durable Functions extension in Visual Studio Code to locally create and test a "hello world" Durable Functions app in Azure Functions. The Durable Functions app orchestrates and chains together calls to other functions. Then, you publish the function code to Azure. The tools you use are available via the Visual Studio Code extension.
1818

articles/azure-functions/durable/quickstart-mssql.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,8 @@ ms.reviewer: azfuncdf
1010

1111
# Quickstart: Set a Durable Functions app to use the MSSQL storage provider
1212

13+
Durable Functions is a feature of [Azure Functions](../functions-overview.md). Use Durable Functions to write stateful functions in a serverless environment. Durable Functions manages state, checkpoints, and restarts in your application.
14+
1315
Durable Functions supports several [storage providers](durable-functions-storage-providers.md), also known as _back ends_, for storing orchestration and entity runtime state. By default, new projects are configured to use the [Azure Storage provider](durable-functions-storage-providers.md#azure-storage). In this quickstart, you configure a Durable Functions app to use the [Microsoft SQL Server (MSSQL) storage provider](durable-functions-storage-providers.md#mssql).
1416

1517
> [!NOTE]

0 commit comments

Comments
 (0)