Edit

Share via

Create and manage a storage task assignment

An assignment identifies a storage account and a subset of objects in that account that the task will target. An assignment also defines when the task runs and where execution reports are stored.

This article helps you create an assignment, and then enable that assignment to run. To learn more about storage task assignments, see Storage task assignments.

Important

Before you enable storage task assignment, make sure that you grant access to trusted Azure services in the network settings of each target storage account. To learn more, see Grant access to trusted Azure services.

Create and manage an assignment

Create an assignment for each storage account you want to target. A storage task can contain up to 50 assignments.

Note

In the current release, you can target only storage accounts that are in the same region as the storage tasks.

Create an assignment from the storage task menu

You can create an assignment in the context of a storage task. This option can be convenient if you're the task author and you want to target multiple storage accounts. For each assignment, you'll identify the storage account that you want to target.

Navigate to the storage task in the Azure portal and then under Storage task management, select Assignments.

In the Assignments page, select + Add assignment and the Add assignment pane will appear.

Screenshot of the Assignments page that appears in the context of the storage task.

Create an assignment from the storage account menu

You can also create an assignment in the context of a storage account. This option can be convenient if you want to use an existing task to process objects in your storage account. For each assignment, you'll identify the storage task that you want to assign to your account.

Navigate to the storage account in the Azure portal and then under Data management, select Storage tasks.

In the Storage tasks page, select the Task assignment tab, select + Create assignment, and then select + Add assignment.

Screenshot of the Assignments page that appears in the context of a storage account.

The Add assignment pane appears.

Select a scope

In the Select scope section, select a subscription and name the assignment. Then, select the storage account that you want to target.

If you opened the Add assignment pane in the context of the storage account, you'll select a storage task instead of the storage account.

For a description of each property, see Assignment settings.

Add a role assignment

In the Role assignment section, in the Role drop-down list, select the role that you want to assign to the managed identity of the storage task. To ensure a successful task assignment, use roles that have the Blob Data Owner permissions. To learn more, see Azure roles required to assign tasks.

Note

You choose the managed identity type (system-assigned or user-assigned) as part of creating the storage task.

Screenshot of the Role assignment section of the assignment pane.

For a description of each property, see Assignment settings.

Add a filter

In the Filter objects section, choose whether you want to target a subset of blobs based on a filter. Filters help you narrow the scope of execution. If you want the task to evaluate all of the containers and blobs in an account, then you can select the Do not filter option. The following example uses a filter to target only blobs that exist in a container that is named mycontainer.

Screenshot of the Filter objects section of the Add assignment pane.

For a description of each property, see Assignment settings.

Define the trigger

In the Trigger details section, select how often you'd like this task to run. You can choose to run this task only once, or run the task recurring. If you decide to run this task on a recurring basis, choose a start and end time and specify the number of days in between each run. You can also specify where you'd like to store the execution reports.

Screenshot of the Triggers section of the Add assignment pane.

For a description of each property, see Assignment settings.

Save the assignment

Select the Add button to create the assignment.

The Add assignment pane closes. When deployment is complete, the assignment appears in the Assignments page. If you don't see the assignment in that page, then select the Refresh button.

Screenshot of the assignment appearing in the Assignments page.

Enable an assignment

The assignment is disabled by default. To enable the assignment so that it will be scheduled to run, select the checkbox that appears beside the assignment, and then select Enable.

Screenshot of the Enable button in the Assignments page.

After the task runs, an execution report is generated and then stored in the container that you specified when you created the assignment. For more information about that report as well as how to view metrics that capture the number of objects targeted, the number of operations attempted, and the number of operations that succeeded, see Analyze storage task runs.

Edit an assignment

An assignment becomes a sub resource of the targeted storage account. Therefore, after you create the assignment, you can edit only it's run frequency. The other fields of an assignment become read only. The Single run (only once) option becomes read only as well.

  • To edit the run frequency of an assignment in the context of a storage task, navigate to the storage task in the Azure portal and then under Storage task management, select Assignments.

  • To edit the run frequency of an assignment in the context of a storage account, navigate to the storage account in the Azure portal and then under Data management, select Storage tasks.

See also