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.

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

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.

• API access
• Feature gaps
• Terminology and entity changes

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:

• Encoding
• Live streaming
• Packaging and delivery
• Content protection
• Media Reserved Units (MRU)

Get help and support

You can contact Media Services with questions or follow our updates by one of the following methods:

• Q & A
• Stack Overflow. Tag questions with azure-media-services.
• @MSFTAzureMedia or use @AzureSupport to request support.
• Open a support ticket through the Azure portal.