Migrate from Media Services v2 to v3 introduction

migration guide logo

Important

It is no longer necessary to migrate from Azure Media Service v2 to v3 as deprecation of V2 API will align with the retirement of Azure Media Services. Please see the Azure Media Services retirement guide for more information.

The Media Services migration guide helps you migrate from Media Services V2 APIs to V3 APIs based on a migration that takes advantage of the new features and functions that are now available. You should use your best judgment and determine what best fits your scenario.

For more information about retired media processors and to keep track of those that are planned for retirement, see the Media processor retirement reference reference.

How to use this guide

Throughout the guide, you will see the following graphic.

migration steps

The step you are on will be indicated by a color change in the number of the step, like so:

migration steps 2

At the end of each page, you will see links to the rest of the migration documents you can read underneath the Next steps heading.

Guidance

The guidance provided here is general. It includes content to improve your awareness of what is now available in V3 as well as what has changed in the Media Services workflows.

For more detailed guidance, including screenshots and conceptual graphics, there are links to concepts, tutorials, quickstarts, samples and API references in each scenario-based topic. We have also listed samples that help you compare the V2 API to the V3 API.

Migration guidance overview

There are four general steps to follow during your migration:

Step 1 Benefits


Understand the benefits of migrating to Media Services API V3.

Step 2 Differences


Understand the differences between Media Services V2 API and the V3 API.

Step 3 SDK setup


Understand the SDK differences and set up to migrate to the V3 REST API or client SDK.

Step 4 Scenario-based guidance


Your application of Media Services V2 may be unique. Therefore, we have provided scenario-based guidance based on how you may have used media services in the past and the steps for each feature of the service such as: