Merge pull request #299637 from MicrosoftDocs/main

Merged by Learn.Build PR Management system

Author: learn-build-service-prod[bot]

.openpublishing.redirection.json

@@ -227,7 +227,7 @@
     },
     {
       "source_path": "articles/databox-online/azure-stack-edge-2301-release-notes.md",
-      "redirect_url": "/previous-versions/azure/databox-online/azure-stack-edge-2301-release-notes",
+      "redirect_url": "/previous-versions/azure/databox-online/azure-stack-edge-2301-release-notes"
     },
     {
       "source_path": "articles/network-watcher/nsg-flow-logs-rest.md",
@@ -2393,7 +2393,7 @@
       "source_path_from_root": "/articles/app-service/manage-disaster-recovery.md",
       "redirect_url": "/azure/architecture/web-apps/guides/multi-region-app-service/multi-region-app-service",
       "redirect_document_id": false
-    },       
+    },
     {
       "source_path_from_root": "/articles/public-multi-access-edge-compute-mec/tutorial-create-vm-using-python-sdk.md",
       "redirect_url": "/previous-versions/azure/public-multi-access-edge-compute-mec/tutorial-create-vm-using-python-sdk",
@@ -6875,49 +6875,49 @@
       "redirect_document_id": false
     },
     {
-         "source_path": "articles/storage/files/storage-files-enable-soft-delete.md",
+      "source_path": "articles/storage/files/storage-files-enable-soft-delete.md",
       "redirect_url": "/azure/storage/files/storage-files-prevent-file-share-deletion",
       "redirect_document_id": false
-     },
-     {
+    },
+    {
       "source_path": "articles/defender-for-iot/organizations/release-notes-archive.md",
       "redirect_url": "/azure/defender-for-iot/organizations/release-notes-ot-monitoring-sensor-archive",
-       "redirect_document_id": false
-     },
-     {
+      "redirect_document_id": false
+    },
+    {
       "source_path": "articles/nat-gateway/quickstart-create-nat-gateway-portal.md",
       "redirect_url": "/azure/nat-gateway/quickstart-create-nat-gateway",
-       "redirect_document_id": false
-     },
-     {
+      "redirect_document_id": false
+    },
+    {
       "source_path": "articles/nat-gateway/quickstart-create-nat-gateway-powershell.md",
       "redirect_url": "/azure/nat-gateway/quickstart-create-nat-gateway",
-       "redirect_document_id": false
-     },
-     {
+      "redirect_document_id": false
+    },
+    {
       "source_path": "articles/nat-gateway/quickstart-create-nat-gateway-cli.md",
       "redirect_url": "/azure/nat-gateway/quickstart-create-nat-gateway",
-       "redirect_document_id": false
-     },
-     {
+      "redirect_document_id": false
+    },
+    {
       "source_path": "articles/nat-gateway/quickstart-create-nat-gateway-template.md",
       "redirect_url": "/azure/nat-gateway/quickstart-create-nat-gateway",
-       "redirect_document_id": false
-     },
-     {
+      "redirect_document_id": false
+    },
+    {
       "source_path": "articles/nat-gateway/quickstart-create-nat-gateway-terraform.md",
       "redirect_url": "/azure/nat-gateway/quickstart-create-nat-gateway",
-       "redirect_document_id": false
-     },
-     {
+      "redirect_document_id": false
+    },
+    {
       "source_path": "articles/nat-gateway/quickstart-create-nat-gateway-bicep.md",
       "redirect_url": "/azure/nat-gateway/quickstart-create-nat-gateway",
-       "redirect_document_id": false
-     },
-     {
+      "redirect_document_id": false
+    },
+    {
       "source_path": "articles/defender-for-iot/organizations/eiot-sensor.md",
       "redirect_url": "/azure/defender-for-iot/organizations/concept-enterprise",
       "redirect_document_id": false
     }
   ]
-}
+}

articles/azure-functions/durable/TOC.yml

@@ -116,7 +116,7 @@
     href: ./durable-task-scheduler/durable-task-scheduler.md
   - name: Choosing an orchestration framework
     href: ./durable-task-scheduler/choose-orchestration-framework.md
-  - name: Create Durable Task Scheduler resources
+  - name: Develop with Durable Task Scheduler
     href: ./durable-task-scheduler/develop-with-durable-task-scheduler.md
   - name: Identity
     href: ./durable-task-scheduler/durable-task-scheduler-identity.md

articles/azure-functions/durable/durable-task-scheduler/develop-with-durable-task-scheduler-functions.md

@@ -17,60 +17,13 @@ The Azure Functions Durable Task Scheduler is a highly performant, fully managed
 Learn more about Durable Task Scheduler [features](./durable-task-scheduler.md#feature-highlights), [supported regions](./durable-task-scheduler.md#limitations-and-considerations), and [plans](./durable-task-scheduler.md#limitations-and-considerations).
 
 ## Create a scheduler and task hub
-
-You can create a scheduler and task hub on Azure portal via two ways: 
-- **Function app integrated creation:** *(recommended)* automatically creates the managed identity resource and RBAC assignment, plus configures required environment variables for your app to access Durable Task Scheduler.
-- **Top-level creation:** Requires you to [manually assign RBAC permission](#configure-identity-based-authentication-for-app-to-access-durable-task-scheduler) to configure scheduler access for your app.
+You can create a scheduler and a task hub as part of the Function app creation on Azure portal. This creation approach automatically configures identity-based authentication for the app to access the task hub. 
 
 > [!NOTE]
 > Durable Task Scheduler currently supports apps hosted in the **App Service** and **Functions Premium** plans, so this experience is available only when either of these plan types is picked. 
 
-# [Function app integrated creation](#tab/function-app-integrated-creation)  
-
-You can create a scheduler and a task hub as part of the Function app creation on Azure portal. 
-
 [!INCLUDE [function-app-integrated-creation](./includes/function-app-integrated-creation.md)]
 
-# [Top-level creation](#tab/top-level-creation) 
-
-1. In the Azure portal, search for **Durable Task Scheduler** and select it from the results. 
-
-    :::image type="content" source="media/create-durable-task-scheduler/search-for-durable-task-scheduler.png" alt-text="Screenshot of searching for the Durable Task Scheduler in the portal.":::
-
-1. Click **Create** to open the **Azure Functions: Durable Task Scheduler (preview)** pane.
-
-    :::image type="content" source="media/create-durable-task-scheduler/top-level-create-form.png" alt-text="Screenshot of the create page for the Durable Task Scheduler.":::
-
-1. Fill out the fields in the **Basics** tab. Click **Review + create**. Once the validation passes, click **Create**. 
-
-    Deployment may take around 15 to 20 minutes. 
-
----
-
-## View all Durable Task Scheduler resources in a subscription
-
-In the Azure portal, search for **Durable Task Scheduler** and select it from the results. 
-
-:::image type="content" source="media/create-durable-task-scheduler/search-for-durable-task-scheduler.png" alt-text="Screenshot of searching for the Durable Task Scheduler service in the portal.":::
-
-You can see the list of scheduler resources created in all subscriptions you have access to. 
-
-## View all task hubs in a Durable Task Scheduler
-
-You can see all the task hubs created in a scheduler on the **Overview** of the resource on Azure portal. 
-
-:::image type="content" source="media/create-durable-task-scheduler/durable-task-scheduler-overview-portal.png" alt-text="Screenshot of overview tab of Durable Task Scheduler in the portal.":::
-
-## Delete the scheduler and task hub
-
-1. Open the scheduler resource on Azure portal and click **Delete**: 
-
-    :::image type="content" source="media/create-durable-task-scheduler/durable-task-scheduler-delete-portal.png" alt-text="Screenshot of scheduler resource in the portal highlighting delete button.":::
-
-1. Find the scheduler with the task hub you want to delete, then click into that task hub. Click **Delete**:
-
-    :::image type="content" source="media/create-durable-task-scheduler/task-hub-delete-portal.png" alt-text="Screenshot of task hub resource in the portal highlighting delete button.":::
-
 ## Configure identity-based authentication for app to access Durable Task Scheduler
 
 Durable Task Scheduler **only** supports either *user-assigned* or *system-assigned* managed identity authentication. **User-assigned identities are recommended,** as they aren't tied to the lifecycle of the app and can be reused after the app is deprovisioned.
@@ -109,6 +62,8 @@ az resource update -g <resource_group> -n <function_app_name>/config/web --set p
 
    Currently, migrating across providers isn't supported. Function apps that have existing runtime data need to start with a fresh, empty task hub after they switch to the Durable Task Scheduler. Similarly, the task hub contents that are created by using the scheduler resource can't be preserved if you switch to a different backend provider.
 
+- **[Management operations using the Azure Functions Core Tools](../durable-functions-instance-management.md#azure-functions-core-tools)**
+
 ## Next steps
 
 > [!div class="nextstepaction"]

articles/azure-functions/durable/durable-task-scheduler/develop-with-durable-task-scheduler.md

@@ -3,23 +3,44 @@ title: Develop with Durable Task Scheduler (preview)
 description: Learn how to develop with the Durable Task Scheduler using the Azure CLI for both Durable Functions and Durable Task Scheduler.
 ms.topic: how-to
 ms.date: 05/06/2025
+zone_pivot_groups: dts-devexp
 ---
 
 # Develop with Durable Task Scheduler (preview)
 
 The Durable Task Scheduler is a highly performant, fully managed backend provider for Durable Functions with an [out-of-the-box monitoring dashboard](./durable-task-scheduler-dashboard.md). Azure offers two developer-oriented orchestration frameworks that work with Durable Functions to build apps: Durable Task SDKs and Durable Functions. 
 
-In this article, you use the Azure CLI and the Durable Task extension to:
+In this article, you learn to:
 
 > [!div class="checklist"]
-> * Create a scheduler and task hub. 
-> * Configure identity-based authentication for your application to access Durable Task Scheduler.
-> * Monitor the status of your app and task hub on the Durable Task Scheduler dashboard. 
+> * Run the Durable Task Scheduler emulator
+> * Perform CRUD operations on a scheduler and task hub. 
 
 Learn more about Durable Task Scheduler [features](./durable-task-scheduler.md#feature-highlights), [supported regions](./durable-task-scheduler.md#limitations-and-considerations), and [plans](./durable-task-scheduler.md#limitations-and-considerations).
 
-> [!NOTE]
-> Durable Task Scheduler currently supports apps hosted in the **App Service** and **Functions Premium** plans only.  
+## Durable Task Scheduler emulator
+
+The Durable Task Scheduler emulator is only available as a Docker image today. 
+
+1. Pull the docker image containing the emulator. 
+
+   ```bash
+   docker pull mcr.microsoft.com/dts/dts-emulator:latest
+   ```
+
+1. Run the emulator.
+
+   ```bash
+   docker run -itP mcr.microsoft.com/dts/dts-emulator:latest
+   ```
+
+    This command exposes a single task hub named `default`. If you need more than one task hub, you can set the environment variable `DTS_TASK_HUB_NAMES` on the container to a comma-delimited list of task hub names like in the following command:
+
+    ```bash
+    docker run -itP -e DTS_TASK_HUB_NAMES=taskhub1,taskhub2,taskhub3 mcr.microsoft.com/dts/dts-emulator:latest
+    ```
+
+::: zone pivot="az-cli" 
 
 ## Prerequisites
 
@@ -45,29 +66,11 @@ Learn more about Durable Task Scheduler [features](./durable-task-scheduler.md#f
     ```azurecli
     az extension add --upgrade --name durabletask
     ```
-
-## Run the Durable Task emulator
-
-1. Pull the docker image containing the emulator. 
-
-   ```bash
-   docker pull mcr.microsoft.com/dts/dts-emulator:latest
-   ```
-
-1. Run the emulator.
-
-   ```bash
-   docker run -itP mcr.microsoft.com/dts/dts-emulator:latest
-   ```
-
-    This command exposes a single task hub named `default`. If you need more than one task hub, you can set the environment variable `DTS_TASK_HUB_NAMES` on the container to a comma-delimited list of task hub names like in the following command:
-
-    ```bash
-    docker run -itP -e DTS_TASK_HUB_NAMES=taskhub1,taskhub2,taskhub3 mcr.microsoft.com/dts/dts-emulator:latest
-    ```
+::: zone-end 
 
 ## Create a scheduler and task hub
 
+::: zone pivot="az-cli" 
 1. Create a resource group.
 
     ```azurecli
@@ -141,9 +144,28 @@ Learn more about Durable Task Scheduler [features](./durable-task-scheduler.md#f
       "type": "microsoft.durabletask/scheduler/taskhubs"
     }
     ```
+::: zone-end 
+
+::: zone pivot="az-portal"
+
+1. In the Azure portal, search for **Durable Task Scheduler** and select it from the results. 
+
+    :::image type="content" source="media/create-durable-task-scheduler/search-for-durable-task-scheduler.png" alt-text="Screenshot of searching for the Durable Task Scheduler in the portal.":::
+
+1. Click **Create** to open the **Azure Functions: Durable Task Scheduler (preview)** pane.
+
+    :::image type="content" source="media/create-durable-task-scheduler/top-level-create-form.png" alt-text="Screenshot of the create page for the Durable Task Scheduler.":::
+
+1. Fill out the fields in the **Basics** tab. Click **Review + create**. Once the validation passes, click **Create**. 
+
+    Deployment may take around 15 to 20 minutes. 
+
+::: zone-end 
 
 ## View all Durable Task Scheduler resources in a subscription
 
+::: zone pivot="az-cli" 
+
 1. Get a list of all scheduler names within a subscription by running the following command.
 
     ```azurecli
@@ -155,17 +177,41 @@ Learn more about Durable Task Scheduler [features](./durable-task-scheduler.md#f
     ```azurecli
     az durabletask scheduler list --subscription <SUBSCRIPTION_ID> --resource-group <RESOURCE_GROUP_NAME>
     ```
+::: zone-end
+
+::: zone pivot="az-portal"
+
+In the Azure portal, search for **Durable Task Scheduler** and select it from the results. 
+
+:::image type="content" source="media/create-durable-task-scheduler/search-for-durable-task-scheduler.png" alt-text="Screenshot of searching for the Durable Task Scheduler service in the portal.":::
+
+You can see the list of scheduler resources created in all subscriptions you have access to. 
+
+::: zone-end
 
 ## View all task hubs in a Durable Task Scheduler
 
-Retrieve a list of task hubs in a specific scheduler by running: 
+::: zone pivot="az-cli" 
+
+1. Retrieve a list of task hubs in a specific scheduler by running: 
+
+    ```azurecli
+    az durabletask taskhub list --resource-group <RESOURCE_GROUP_NAME> --scheduler-name <SCHEDULER_NAME>
+    ```
+::: zone-end
+
+::: zone pivot="az-portal"
+
+You can see all the task hubs created in a scheduler on the **Overview** of the resource on Azure portal. 
+
+:::image type="content" source="media/create-durable-task-scheduler/durable-task-scheduler-overview-portal.png" alt-text="Screenshot of overview tab of Durable Task Scheduler in the portal.":::
 
-```azurecli
-az durabletask taskhub list --resource-group <RESOURCE_GROUP_NAME> --scheduler-name <SCHEDULER_NAME>
-```
+::: zone-end
 
 ## Delete the scheduler and task hub
 
+::: zone pivot="az-cli" 
+
 1. Delete the scheduler:
 
     ```azurecli
@@ -177,22 +223,36 @@ az durabletask taskhub list --resource-group <RESOURCE_GROUP_NAME> --scheduler-n
     ```azurecli
     az durabletask taskhub delete --resource-group YOUR_RESOURCE_GROUP --scheduler-name YOUR_SCHEDULER --name YOUR_TASKHUB
     ```
+::: zone-end
+
+::: zone pivot="az-portal"
+
+1. Open the scheduler resource on Azure portal and click **Delete**: 
+
+    :::image type="content" source="media/create-durable-task-scheduler/durable-task-scheduler-delete-portal.png" alt-text="Screenshot of scheduler resource in the portal highlighting delete button.":::
+
+1. Find the scheduler with the task hub you want to delete, then click into that task hub. Click **Delete**:
+
+    :::image type="content" source="media/create-durable-task-scheduler/task-hub-delete-portal.png" alt-text="Screenshot of task hub resource in the portal highlighting delete button.":::
+
+::: zone-end
+
 
 ## Configure identity-based authentication for app to access Durable Task Scheduler
 
 Durable Task Scheduler **only** supports either *user-assigned* or *system-assigned* managed identity authentication. **User-assigned identities are recommended,** as they aren't tied to the lifecycle of the app and can be reused after the app is deprovisioned.
 
-If you haven't already, [configure managed identity for your Durable Functions app](./durable-task-scheduler-identity.md).
+Learn more about [identity-based access in Durable Task Scheduler](./durable-task-scheduler-identity.md). 
 
 ## Access the Durable Task Scheduler dashboard
 
-[Assign the required role to your *developer identity (email)*](./durable-task-scheduler-dashboard.md#access-the-durable-task-scheduler-dashboard) to gain access to the Durable Task Scheduler dashboard. 
+[Assign the required role to your *developer identity (email)*](./durable-task-scheduler-dashboard.md) to gain access to the Durable Task Scheduler dashboard. 
 
 ## Next steps
 
-For Durable Task Scheduler for Durable Functions:
+For using Durable Task Scheduler with Durable Functions:
 - [Quickstart: Configure a Durable Functions app to use Azure Functions Durable Task Scheduler](./quickstart-durable-task-scheduler.md)
 
-For Durable Task Scheduler for the Durable Task SDKs:
+For using Durable Task Scheduler with the Durable Task SDKs:
 - [Quickstart: Create an app with Durable Task SDKs and Durable Task Scheduler](./quickstart-portable-durable-task-sdks.md)
 - [Quickstart: Host a Durable Task SDK app on Azure Container Apps](./quickstart-container-apps-durable-task-sdk.md)

articles/azure-functions/durable/durable-task-scheduler/durable-task-scheduler.md

@@ -120,7 +120,7 @@ curl -s https://mcr.microsoft.com/v2/dts/dts-emulator/tags/list
 
 ### Autopurge retention policies
 
-Large volumes of completed orchestration instance data can lead to storage bloat, incur higher storage costs, and degrade performance. The autopurge feature for Durable Task Scheduler provides a streamlined, configurable solution to manage orchestration instance clean-up automatically. [Learn more about setting autopurge retention policies for Durable Task Scheduler.](./durable-task-scheduler-auto-purge.md)
+Stale orchestration data should be purged periodically to ensure efficient storage usage. The autopurge feature for Durable Task Scheduler provides a streamlined, configurable solution to manage orchestration instance clean-up automatically. [Learn more about setting autopurge retention policies for Durable Task Scheduler.](./durable-task-scheduler-auto-purge.md)
 
 ## Limitations and considerations
 
@@ -156,10 +156,9 @@ Large volumes of completed orchestration instance data can lead to storage bloat
 
     - [Orchestration rewind](../durable-functions-instance-management.md#rewind-instances-preview)
     - [Extended sessions](../durable-functions-azure-storage-provider.md#extended-sessions)
-    - [Management operations using the Azure Functions Core Tools](../durable-functions-instance-management.md#azure-functions-core-tools)
 
     > [!NOTE]
-    > Feature availability is subject to change as the Durable Task Scheduler backend approaches general availability. To report problems or request new features, submit an issue in the [Durable Task Scheduler samples GitHub repository](https://github.com/Azure-Samples/Durable-Task-Scheduler/).
+    > Feature availability is subject to change as the Durable Task Scheduler backend approaches general availability. To report problems or request new features, submit an issue in the [Durable Task Scheduler GitHub repository](https://github.com/azure/Durable-Task-Scheduler).
 
 ## Next steps