Migrate from Media Services v2 to v3 introduction
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.
Note
Update your Azure Media Services REST API and SDKs to v3 by 29 February 2024. Version 3 of Azure Media Services REST API and client SDKs for .NET and Java offers more capabilities than version 2. We’re retiring version 2 of the Azure Media Services REST API and client SDKs for .NET and Java.
Action Required: To minimize disruption to your workloads, review the migration guide to transition your code from the version 2 API and SDKs to version 3 API and SDK before February 29th, 2024. After February 29th, 2024, Azure Media Services will no longer accept traffic on the version 2 REST API, the ARM account management API version 2015-10-01, or from the version 2 .NET client SDKs. This includes any 3rd party open-source client SDKS that may call the version 2 API. Learn about the latest version, starting with the Media Services v3 Overview.
How to use this guide
Navigating
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.
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: