Skip to content

Commit d27866f

Browse files
committed
added description of other dts roles
1 parent e19db94 commit d27866f

File tree

1 file changed

+20
-11
lines changed

1 file changed

+20
-11
lines changed

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

Lines changed: 20 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -62,11 +62,11 @@ Learn more about durable task scheduler [features](./durable-task-scheduler.md#f
6262
docker run -itP mcr.microsoft.com/dts/dts-emulator:v0.0.5
6363
```
6464

65-
The command above 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 below:
65+
The command above 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 below:
6666

67-
```bash
68-
docker run -itP -e DTS_TASK_HUB_NAMES=taskhub1,taskhub2,taskhub3 mcr.microsoft.com/dts/dts-emulator:v0.0.5
69-
```
67+
```bash
68+
docker run -itP -e DTS_TASK_HUB_NAMES=taskhub1,taskhub2,taskhub3 mcr.microsoft.com/dts/dts-emulator:v0.0.5
69+
```
7070

7171
## Create a scheduler and task hub
7272

@@ -154,8 +154,8 @@ docker run -itP -e DTS_TASK_HUB_NAMES=taskhub1,taskhub2,taskhub3 mcr.microsoft.c
154154
::: zone pivot="az-portal"
155155

156156
You can create a scheduler and task hub on Azure portal via two ways:
157-
- **Function app integrated creation:** *(recommended)* automatically creates the managed identity resource and RBAC assignment needed for your app to access durable task scheduler.
158-
- **Top-level creation:** Requires you to [manually assign RBAC](#configure-identity-based-authentication-for-app-to-access-dts) to configure scheduler access for your app.
157+
- **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.
158+
- **Top-level creation:** Requires you to [manually assign RBAC permission](#configure-identity-based-authentication-for-app-to-access-dts) to configure scheduler access for your app.
159159

160160
> [!NOTE]
161161
> 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.
@@ -216,11 +216,11 @@ You can see the list of scheduler resources created in all subscriptions you hav
216216

217217
::: zone pivot="az-cli"
218218

219-
Retrieve a list of task hubs in a specific scheduler by running:
219+
Retrieve a list of task hubs in a specific scheduler by running:
220220

221-
```azurecli
222-
az durabletask taskhub list --resource-group <RESOURCE_GROUP_NAME> --scheduler-name <SCHEDULER_NAME>
223-
```
221+
```azurecli
222+
az durabletask taskhub list --resource-group <RESOURCE_GROUP_NAME> --scheduler-name <SCHEDULER_NAME>
223+
```
224224

225225
::: zone-end
226226

@@ -266,7 +266,16 @@ You can see all the task hubs created in a scheduler on the **Overview** of the
266266

267267
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 de-provisioned.
268268
269-
The following sections demonstrate how to configure identity resources for your durable functions app to access a scheduler and its task hubs.
269+
The following are the durable task scheduler related roles you can grant to an identity:
270+
271+
- **Durable Task Data Contributor**: Role for all data access operations. This role is a superset of all other roles.
272+
- **Durable Task Worker**: Role used by worker applications to interact with the durable task scheduler. Assign this role if your app is used *only* for processing orchestrations, activities, and entities.
273+
- **Durable Task Data Reader**: Role to read all durable task scheduler data. Assign this role if you only need listing of orchestrations and entities payloads.
274+
275+
> [!NOTE]
276+
> Most durable functions apps would require the Durable Task Data Contributor role.
277+
278+
The sections below demonstrate how to grant permissions to an identity resource and configure your durable functions app to use the identity for access to schedulers and task hubs.
270279
271280
### Assign RBAC (role-based access control) to managed identity resource
272281

0 commit comments

Comments
 (0)