Step 3 - Set up to migrate to the V3 REST API or client SDK

migration guide logo


migration steps 2

The following describes the steps to take to set up your environment to use the Media Services V3 API.

SDK model

In the V2 API, there were two different client SDKs, one for the management API, which allowed programmatic creation of accounts, and one for resource management.

Previously, developers would work with an Azure service principal client ID and client secret, along with a specific V2 REST API endpoint for their AMS account.

The V3 API is Azure Resource Management (ARM) based. It uses Azure Active Directory (Azure AD) service principal IDs and keys to connect to the API. Developers will need to create service principals or managed identities to connect to the API. In the V3 API, the API uses standard ARM endpoints, uses a similar and consistent model to all other Azure services.

Customers previously using the 2015-10-01 version of the ARM management API to manage their V2 accounts should use the 2020-05-01 (or later) version of the ARM management API supported for V3 API access.

Create a new media services account for testing

Find your tenant and subscription ids in the portal and create a Media Services account. Then, select API access and service principal authentication to generate a new Azure AD application ID and secrets for use with this test account.

Create a media services account. Get credentials to access Media Services API.

Download client SDK of your choice and set up your environment

Note

A community PHP SDK is no longer available for Azure Media Services on V3. If you're using PHP on V2, you should migrate to the REST API directly in your code.

Open API specifications

  • V3 is based on a unified API surface, which exposes both management and operations functionality built on Azure Resource Manager. Azure Resource Manager templates can be used to create and deploy transforms, streaming endpoints, live events, and more.

  • The OpenAPI Specification (formerly called Swagger) document explains the schema for all service components.

  • All client SDKs are derived and generated from the Open API specification published on GitHub. At the time of publication of this article, the latest Open API specifications are maintained publicly in GitHub. The 2020-05-01 version is the latest stable release.

Read the REST API reference pages.

You should use the 2020-05-01 (or later) version.