Migrate to Cloud Services (extended support) using the Azure portal

This article shows you how to use the Azure portal to migrate from Cloud Services (classic) to Cloud Services (extended support).

Before you begin

Ensure you are an administrator for the subscription.

To perform this migration, you must be added as a coadministrator for the subscription in the Azure portal.

  1. Sign in to the Azure portal.
  2. On the Hub menu, select Subscription. If you don't see it, select All services.
  3. Find the appropriate subscription entry, and then look at the MY ROLE field. For a coadministrator, the value should be Account admin.

If you're not able to add a co-administrator, contact a service administrator or co-administrator for the subscription to get yourself added.

Sign up for Migration resource provider

  1. Register with the migration resource provider Microsoft.ClassicInfrastructureMigrate and preview feature Cloud Services under Microsoft.Compute namespace using the Azure portal.
  2. Wait five minutes for the registration to complete then check the status of the approval.

Migrate your Cloud Service resources

  1. Go to Cloud Services (classic) portal blade.

  2. Select the Cloud Service you want to migrate.

  3. Select the Migrate to ARM blade.


    If migrating a Cloud Services (classic) located inside a virtual network (classic), a banner message will appear prompting you to move the virtual network (classic) blade. You will be brought to the virtual network (classic) blade to complete the migration of both the virtual network (classic) and the Cloud Services (classic) deployments within it. Image shows moving a virtual network classic in the Azure portal.

  4. Validate the migration.

    If validation is successful, then all deployments are supported and ready to be prepared.

    Image shows the Migrate to ARM blade in the Azure portal.

    If validate fails, a list of unsupported scenarios will be displayed and need to be fixed before migration can continue.

    Image shows validation error in the Azure portal.

  5. Prepare for the migration.

    If the prepare is successful, the migration is ready for commit.

    Image shows validation passing in the Azure portal.

    If the prepare fails, review the error, address any issues, and retry the prepare.

    Image shows validation failure error.

    After Prepare, all Cloud Services in a virtual network are available for read operations using both Cloud Services (classic) and Cloud Services (extended support) Azure portal blade. The Cloud Service (extended support) deployment can now be tested to ensure proper functioning before finalizing the migration.

    Image shows testing APIs in portal blade.

  6. (Optional) Abort migration.

    If you chose to discontinue the migration, use the Abort button to roll back the previous steps. The Cloud Services (classic) deploy is then unlocked for all CRUD operations.

    Image shows validation passing.

    If abort fails, select Retry abort. A retry should fix the issue. If not, contact support.

    Image shows validation failure error message.

  7. Commit migration.


    Once you commit to the migration, there is no option to roll back.

    Type in "yes" to confirm and commit to the migration. The migration is now complete. The migrated Cloud Services (extended support) deployment is unlocked for all operations".

Next steps

Review the Post migration changes section to see changes in deployment files, automation and other attributes of your new Cloud Services (extended support) deployment.