Manage Azure Storage Mover projects

A Storage Mover project is used to organize migration jobs into logical tasks or components. A project contains at least one job definition, which in turn describes each data source and target endpoint for your project. The Understanding the Storage Mover resource hierarchy article contains more detailed information about the relationship between a Storage Mover and its projects.

When you define a project, it's a good idea to add all related, inter-dependent data sources into the same project so that they can be migrated together. You should add all the data sources necessary to migrate a single workload rather than create projects for each data source in your migration plan. You may also choose to create individual projects for each distinct group of data sources in your migration plan.

This article guides you through the creation and management of Azure Storage Mover projects. To follow these examples, you'll need a top-level storage mover resource. If you haven't yet created one, follow the steps within the Create a Storage Mover resource article before continuing.

After you complete the steps within this article, you'll be able to create and manage projects using the Azure portal and Azure PowerShell.

Create a project

The first step in defining a migration job is the creation of a project resource. After the project has been created, you can add source and target endpoints for your data source. In this example, you'll intentionally leave the description field blank. You'll then add it in the View and edit a project's properties section later in this article.

Important

If you have not yet deployed a resource using the resource provider, you'll need to create your top level resource.

Caution

Renaming project resources is not supported. It's a good idea to ensure that you've named the project appropriately since you will not be able to change the project name after it is provisioned.

  1. Navigate to the Project Explorer page in the Azure portal to access your projects. The default All projects view displays the names of any provisioned projects and a summary of the jobs they contain.

    Image of the Project Explorer's Overview tab within the Azure Portal showing

  2. Select Create project to open the Create a Project pane. Provide a project name value in the Project name field, but leave the Project description field empty. Finally, select Create to provision the project.

    project explorer create

View and edit a project's properties

Depending on your use case, you may need to retrieve either a specific project, or a complete list of all your project resources. You may also need to add or edit a project's description.

Follow the steps in this section to view projects accessible to your Storage Mover resource.

  1. Navigate to the Project explorer page within the Azure portal to view a list of available projects. You can create and apply filters to limit or shape your view. To narrow the scope of the results, you can continue to add more filters.

    Image of the Project Explorer's Overview tab within the Azure portal highlighting the use of filters.

    Filters may also be edited or removed as needed as shown in the example below. Currently, only filtering projects by name is supported.

    Image of the Project Explorer's Overview tab within the Azure portal illustrating the use of filters.

  2. From within the project explorer pane or the results list, select the name of the project created in the previous section. The project's properties and job summary data are displayed in the details pane.

    If the project lacks a valid description, select Add description to display the Edit description pane.

    Image of the Project Explorer's Overview tab within the Azure portal illustrating the modification of filters.

    If a description exists, it will be displayed below the Description heading. Select either the Edit icon next to the description or the Edit description icon to display the editing pane. The image below shows the location of the two icons.

    Image of the Project Explorer's Project properties tab within the Azure portal. It illustrates the location of the edit controls.

  3. In the editing pane, modify your project's description. At the bottom of the pane, select Save to commit your changes.

    Image of the Edit Description pane within the Project Explorer

Delete a project

The removal of a project resource should be a relatively rare occurrence in your production environment, though there may be occasions where it may be helpful. To delete a Storage Mover project resource, follow the provide example.

Warning

Deleting a project is a permanent action and cannot be undone. It's a good idea to ensure that you're prepared to delete the project since you will not be able to restore it at a later time.

  1. Navigate to the Project Explorer page in the Azure portal to view your projects and a summary of the jobs they contain.

    An image of list of Project resources displayed within the Project Explorer

  2. First, within either the Project explorer pane or the results list, select the name of the project you want to delete. Next, select Delete project from within the Project details pane. Finally, within the Confirm project deletion dialog, select Delete to permanently remove your project. Refer to the highlighted selections within the following image if needed.

    An image showing the steps to permanently remove a project resource from within the Portal Explorer.

Warning

Deleting a project will delete all contained job definitions, their run history and results. Deleting any of these resources is permanent and cannot be undone. Storage endpoints are not affected.

Next steps

After your projects are created, you can begin working with job definitions.