Azure Media Services migration guide

Planning to migrate from Azure Media Services? We got you covered!

There are two methods at your disposal that you can use to migrate all of your video content from Azure to

  • Migrate with Import tool
  • Migrate using your own script

What's the cost?

We understand that when you want to move to a different provider, it takes effort and development resources. You also want to make sure that it is cost-efficient, especially if you are moving to to save costs. gives you the ability to migrate for free and avoid paying anything for encoding! Import Tool

With, you can use our in-house import tool to migrate all of your videos in a short time from the popular hosting and video provider. Check out how:

The simple tool will require you to input several parameters from the provider you are leaving and from

Check out the Import Tool now.

Obtaining the SAS URL

To enable the Video Import Tool access to the videos in your Azure Blob Storage containers, you must provide it with the necessary Shared Access Signature (SAS) URL.

  1. Navigate to your storage account and click on "Shared Access Signature":

Generating a Shared Access Signature

  1. Enable the required parameters:

Enabling required parameters

  1. Ensure that you generate the Shared Access Signature. Once you have the links, copy the Blob Service SAS URL.

Copying the Blob service SAS URL

  1. Finally, paste the URL into the "SAS URL" field of the Import Tool.

Importing the videos

Once you have all the pre-requisites you can proceed with the migration.

  1. Navigate to the Import Tool.

  2. Select Azure Blob Service from the list

  3. Authorize with with your account. This process will link your workspace to the Import tool.

  4. Select the project that you would like to import the video.

  5. Next, click on Sign In to Azure.

  6. Pass in the SAS URL that you've obtained in the previous step

  7. Mention the container you would like to import or leave it blank to import all containers.

  8. Now you can proceed with the import.

The process will show you the status of each video and the encoding status.

Importing with a script

Another way to import your videos is to use your own script and leverage one of the client libraries with the provider's client libraries or API (if there are any).

Setting up

What you'll need to run the script:

  • API key
  • Azure SAS URL
  • Node.js

Getting the API key

In order to get your API key. Navigate to the dashboard (if you are not already signed up, sign up with and continue to copy your API key from the Overview page or the API Keys page

What the script will do?

  1. The script will check for all assets in your Azure Media Service Instance
  2. It will get the Storage containers and list the blobs for these storage containers
  3. Because of the way Azure is encoding their videos, the script will take the file with the highest resolution (in order not to duplicate the files)
  4. Once it gets the list, it will create a video object with the name same as the blob and set the source to the Azure storage URL
  5. The file will then be uploaded and encoded with

Make sure that the script is modified according to your needs.


If you are new to Node.js, here's how you can run this script.

Make sure that you have Node.js installed, if it doesn't exist on your machine, you can install it by following this guide.

Now that you have Node.js installed, we will have to create the path of the script and install the dependencies.

  1. Clone the script from Github, by running the following in your command line:
$ git clone
  1. Navigate to the folder you've just cloned
$ cd azure-media-services-api-video-migration
  1. Import the modules that you need to run the script:
$ npm install // node.js client, in order to create the video object, upload and encode the video
$ npm install @azure/identity // access Azure services
$ npm install @azure/arm-mediaservices // client to access Azure media services
  1. You'll need to make sure that you replace all the credentials in the .env file, which are represented below, with the credentials you'll get from Azure in the steps following this one, and replace the API key you got from

let mediaServicesClient: AzureMediaServices;
    const subscriptionId: string = process.env.AZURE_SUBSCRIPTION_ID as string;
    const resourceGroup: string = process.env.AZURE_RESOURCE_GROUP as string;
    const accountName: string = process.env.AZURE_MEDIA_SERVICES_ACCOUNT_NAME as string;
    const credential = new DefaultAzureCredential();
    const apivideoClient = new ApiVideoClient({ apiKey: process.env.APIVIDEO_API_KEY });
    let remoteSasUrl: string = process.env.REMOTESTORAGEACCOUNTSAS as string;

Selecting the media service on Azure

Note that in the previous step, you will also need to update the .env file and grab the parameters from Azure. In order to do that, navigate to your Azure Media Service, and select the directory that you would like to migrate.

  1. Select API keys and copy over the parameters presented in the .ENV pane (you can select either User Authentication or Service principal authentication)

Selecting API Access for media services

Selecting the .ENV credentials pane

  1. To get access to the storage, navigate to the Azure Storage Account → Shared access signature:

Generating Shared Access Signature

  1. Allow the following:

Enabling required parameters

Copying the Blob service SAS URL

Make sure that you generate the Shared access signature and once you have the links, copy the Blob service SAS URL link to the .env file. The parameter you are looking for is REMOTESTORAGEACCOUNTSAS

  1. Add the API key to the .env file by navigating to the dashboard and copy the API key value

Copying the API key

  1. Now, run npm install in the terminal in order to install all of the node modules
  2. Run npm run build
  3. Run npm run start in order to start the migration script

Was this page helpful?