Azure Media Services migration guide
Planning to migrate api.video 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 api.video.
- Migrate with api.video 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 api.video to save costs.
api.video gives you the ability to migrate for free and avoid paying anything for encoding!
api.video Import Tool
With api.video, 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.
The simple tool will require you to input several parameters from the provider you are leaving and from api.video.
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.
- Navigate to your storage account and click on "Shared Access Signature":
- Enable the required parameters:
- Ensure that you generate the Shared Access Signature. Once you have the links, copy the Blob Service SAS URL.
- 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.
Navigate to the api.video Import Tool.
Select Azure Blob Service from the list
Autherize with api.video with your account. This process will link your api.video workspace to the Import tool.
Select the project that you would like to import the video.
Next, click on Sign In to Azure.
Pass in the SAS URL that you've obtained in the previous step
Mention the container you would like to import or leave it blank to import all containers.
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 api.video client libraries with the provider's client libraries or API (if there are any).
What you'll need to run the script:
- api.video API key
- Azure SAS URL
Getting the api.video API key
In order to get your API key. Navigate to the api.video dashboard (if you are not already signed up, sign up with api.video) and continue to copy your API key from the Overview page or the API Keys page
What the script will do?
- The script will check for all assets in your Azure Media Service Instance
- It will get the Storage containers and list the blobs for these storage containers
- 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)
- 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
- The file will then be uploaded and encoded with api.video
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.
- Clone the script from Github, by running the following in your command line:
$ git clone https://github.com/apivideo/azure-media-services-api-video-migration
- Navigate to the folder you've just cloned
$ cd azure-media-services-api-video-migration
- Import the modules that you need to run the script:
$ npm install @api.video/nodejs-client // api.video 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
- You'll need to make sure that you replace all the credentials in the
.envfile, 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 api.video:
let : AzureMediaServices; const : string = process.env. as string; const : string = process.env. as string; const : string = process.env. as string; const = new; const = new; let : string = process.env. as string;
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.
- Select API keys and copy over the parameters presented in the
.ENVpane (you can select either User Authentication or Service principal authentication)
- To get access to the storage, navigate to the Azure Storage Account → Shared access signature:
- Allow the following:
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
- Add the api.video API key to the .env file by navigating to the api.video dashboard and copy the API key value
run npm installin the terminal in order to install all of the node modules
npm run build
npm run startin order to start the migration script
Was this page helpful?