Étape 3 : configurer la migration vers l’API REST v3 ou le Kit de développement logiciel (SDK) client

Article
06/30/2023

étapes de migration 2

Important

Il n’est plus nécessaire de migrer d’Azure Media Service v2 vers v3, car la dépréciation de l’API V2 s’alignera sur la mise hors service d’Azure Media Services. Pour plus d’informations, consultez le guide de mise hors service d’Azure Media Services .

La section suivante décrit les étapes à suivre pour configurer votre environnement afin d’utiliser l’API Media Services v3.

Modèle de Kit de développement logiciel (SDK)

L’API v2 comprenait deux kits de développement logiciel (SDK) clients distincts, l’un pour l’API de gestion, qui permettait la création de comptes par programmation, et l’autre pour la gestion des ressources.

Auparavant, les développeurs utilisaient un ID client et une clé secrète client de principal de service Azure, ainsi qu’un point de terminaison d’API REST v2 spécifique pour leur compte AMS.

L’API v3 est basée sur Azure Resource Manager (ARM). Elle utilise des ID et clés de principal de service Azure Active Directory (Azure AD) pour se connecter à l’API. Les développeurs devront créer des principaux de service ou des identités managées pour se connecter à l’API. L’API V3 utilise des points de terminaison ARM standard, ainsi qu’un modèle similaire et cohérent pour tous les autres services Azure.

Les clients qui utilisaient précédemment la version 2015-10-01 de l’API de gestion ARM pour gérer leurs comptes v2 doivent utiliser la version 2020-05-01 (ou ultérieure) de l’API de gestion ARM prise en charge pour l’accès à l’API v3.

Créer un compte Media Services à des fins de test

Trouvez vos identifiants de locataire et d'abonnement dans le portail et créez un compte Media Services. Sélectionnez ensuite un accès d’API et une authentification du principal de service pour générer un nouvel ID d’application Azure AD et des secrets à utiliser avec ce compte de test.

Créez un compte Media Services. Obtenez des informations d’identification pour accéder à l’API Media Services.

Téléchargez le Kit de développement logiciel (SDK) client de votre choix et configurez votre environnement

SDK disponibles pour .NET, .NET Core, Node.js, Python, Java et Go.
Intégration d’Azure CLI pour la prise en charge de scripts simples.

Notes

Un Kit de développement logiciel (SDK) PHP de la communauté n’est plus disponible pour Azure Media Services dans v3. Si vous utilisez PHP sur v2, vous devez migrer vers l’API REST directement dans votre code.

Spécifications de l’API Open

La version v3 est basée sur une surface d’API unifiée qui expose des fonctionnalités de gestion et d’exploitation qui s’appuient sur Azure Resource Manager. Vous pouvez utiliser des modèles Azure Resource Manager pour créer et déployer des transformations, des points de terminaison de streaming, des événements en direct, etc.
Le document spécification OpenAPI (précédemment appelée Swagger) décrit le schéma de tous les composants de service.
Tous les kits de développement logiciel (SDK) clients sont dérivés et générés à partir de la spécification de l’API Open publiée sur GitHub. Au moment de la publication de cet article, les dernières spécifications de l’API Open sont conservées publiquement dans GitHub. La version 2020-05-01 est la dernière mise en production stable.

Lisez les pages de référence de l’API REST.

Vous devez utiliser la version 2020-05-01 (ou une version ultérieure).

Lisez l’article Se connecter à l’API Azure Media Services v3 avec .NET pour configurer votre environnement.

Si vous souhaitez simplement installer le dernier Kit de développement logiciel (SDK) à l’aide de PackageManager, utilisez la commande suivante :

Install-Package Microsoft.Azure.Management.Media

Ou bien, pour installer le dernier Kit de développement logiciel (SDK) à l’aide de l’interface de ligne de commande .NET, utilisez la commande suivante :

dotnet add package Microsoft.Azure.Management.Media

En outre, des exemples .NET complets sont disponibles dans Azure-Samples/media-services-V3-dotnet pour divers scénarios. Les projets contenus dans ce référentiel montrent comment implémenter différents scénarios Azure Media Services à l’aide de la version v3.

Commencer à ajuster votre code

Recherchez dans votre base de code des instances d’utilisation de CloudMediaContext pour commencer le processus de mise à niveau vers l’API v3.

Le code suivant montre comment l’accès à l’API V2 se faisait précédemment à l’aide du Kit de développement logiciel (SDK) .NET v2. Les développeurs commençaient par créer un CloudMediaContext et une instance avec un objet AzureAdTokenCredentials.


class Program
	{
	    // Read values from the App.config file.
        private static readonly string _AADTenantDomain =
            ConfigurationManager.AppSettings["AMSAADTenantDomain"];
        private static readonly string _RESTAPIEndpoint =
            ConfigurationManager.AppSettings["AMSRESTAPIEndpoint"];
        private static readonly string _AMSClientId =
            ConfigurationManager.AppSettings["AMSClientId"];
        private static readonly string _AMSClientSecret =
            ConfigurationManager.AppSettings["AMSClientSecret"];

	    private static CloudMediaContext _context = null;

	    static void Main(string[] args)
	    {
        try
        {
            AzureAdTokenCredentials tokenCredentials =
                new AzureAdTokenCredentials(_AADTenantDomain,
                    new AzureAdClientSymmetricKey(_AMSClientId, _AMSClientSecret),
                    AzureEnvironments.AzureCloudEnvironment);

            var tokenProvider = new AzureAdTokenProvider(tokenCredentials);

            _context = new CloudMediaContext(new Uri(_RESTAPIEndpoint), tokenProvider);

Obtenir de l’aide et du support

Vous pouvez contacter Media Services pour vous poser des questions ou suivre nos mises à jour en suivant l’une des méthodes suivantes :

Q & R
Stack Overflow. Balisez les questions avec azure-media-services.
@MSFTAzureMedia ou utiliser @AzureSupport pour demander du support.
Ouvrez un ticket de support via le Portail Azure.

Partage via