title | description | author | ms.service | ms.topic | ms.date | ms.author |
---|---|---|---|---|---|---|
Migrate from Media Services v2 to v3 introduction |
This article is an introduction to migrating from Media Services v2 to v3. |
IngridAtMicrosoft |
media-services |
conceptual |
06/29/2023 |
inhenkel |
[!INCLUDE migration-no-longer-necessary]
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.
[!INCLUDE v2 deprecation notice]
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.
Throughout the guide, you will see the following graphic.
The step you are on will be indicated by a color change in the number of the step, like so:
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.
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.
There are four general steps to follow during your migration:
Understand the benefits of migrating to Media Services API V3.
Understand the differences between Media Services V2 API and the V3 API.
Understand the SDK differences and set up to migrate to the V3 REST API or client SDK.
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:
[!INCLUDE media-services-community]