Passaggio 3- Configurare la migrazione all'API REST V3 o all'SDK client

Articolo
07/12/2023

passaggi di migrazione 2

Importante

Non è più necessario eseguire la migrazione da Servizi multimediali di Azure v2 a v3 perché la deprecazione dell'API V2 sarà allineata al ritiro di Servizi multimediali di Azure. Per altre informazioni, vedere la guida al ritiro di Servizi multimediali di Azure .

Di seguito vengono descritti i passaggi da eseguire per configurare l'ambiente in modo da usare l'API Servizi multimediali V3.

Modello SDK

Nell'API V2 sono disponibili due SDK client diversi, uno per l'API di gestione, che ha consentito la creazione programmatica di account e uno per la gestione delle risorse.

In precedenza, gli sviluppatori lavorerebbero con un ID client e un segreto client dell'entità servizio di Azure, insieme a un endpoint API REST V2 specifico per il proprio account AMS.

L'API V3 è basata su Azure Resource Management (ARM). Usa GLI ID e le chiavi dell'entità servizio di Azure Active Directory (Azure AD) per connettersi all'API. Gli sviluppatori dovranno creare entità servizio o identità gestite per connettersi all'API. Nell'API V3 l'API usa endpoint ARM standard, usa un modello simile e coerente a tutti gli altri servizi di Azure.

I clienti che usano in precedenza la versione 2015-10-01 dell'API di gestione arm per gestire gli account V2 devono usare la versione 2020-05-01 (o successiva) dell'API di gestione ARM supportata per l'accesso all'API V3.

Creare un nuovo account di servizi multimediali per il test

Trovare il tenant e gli ID sottoscrizione nel portale e creare un account di Servizi multimediali. Selezionare quindi l'accesso all'API e l'autenticazione dell'entità servizio per generare un nuovo ID applicazione e segreti di Azure AD da usare con questo account di test.

Creare un account di servizi multimediali. Ottenere le credenziali per accedere all'API di Servizi multimediali.

Scaricare l'SDK client preferito e configurare l'ambiente

SDK disponibili per .NET, .NET Core, Node.js, Python, Java e Go.
Integrazione dell'interfaccia della riga di comando di Azure per semplificare il supporto di scripting.

Nota

Php SDK della community non è più disponibile per Servizi multimediali di Azure nella versione 3. Se si usa PHP nella versione 2, è consigliabile eseguire la migrazione all'API REST direttamente nel codice.

Specifiche dell'API aperte

V3 si basa su una superficie api unificata, che espone funzionalità di gestione e operazioni basate su Azure Resource Manager. I modelli di azure Resource Manager possono essere usati per creare e distribuire trasformazioni, endpoint di streaming, eventi live e altro ancora.
Il documento OpenAPI Specification (in precedenza denominato Swagger) illustra lo schema per tutti i componenti del servizio.
Tutti gli SDK client sono derivati e generati dalla specifica open API pubblicata su GitHub. Al momento della pubblicazione di questo articolo, le specifiche dell'API Open più recenti vengono mantenute pubblicamente in GitHub. La versione 2020-05-01 è la versione stabile più recente.

Leggere le pagine di riferimento dell'API REST.

È consigliabile usare la versione 2020-05-01 (o successiva).

Leggere l'articolo Connettersi all'API di Servizi multimediali v3 con .NET per configurare l'ambiente.

Se si vuole semplicemente installare l'SDK più recente usando PackageManager, usare il comando seguente:

Install-Package Microsoft.Azure.Management.Media

In alternativa, per installare l'SDK più recente usando l'interfaccia della riga di comando di .NET, usare il comando seguente:

dotnet add package Microsoft.Azure.Management.Media

Sono inoltre disponibili esempi .NET completi in Azure-Samples/media-services-v3-dotnet per vari scenari. I progetti in questo repository illustrano come implementare diversi scenari di Servizi multimediali di Azure usando la versione 3.

Introduzione alla regolazione del codice

Cercare nella codebase le istanze di utilizzo per avviare il processo di CloudMediaContext aggiornamento all'API V3.

Il codice seguente illustra come è stato eseguito l'accesso all'API v2 usando .NET SDK v2. Gli sviluppatori iniziano con la creazione di un CloudMediaContext oggetto e la creazione di un'istanza con un AzureAdTokenCredentials oggetto .


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);

Guida e supporto tecnico

È possibile contattare Servizi multimediali con domande o seguire gli aggiornamenti tramite uno dei metodi seguenti:

DOMANDE E RISPOSTE
Stack Overflow. Contrassegna le domande con azure-media-services.
@MSFTAzureMedia o usare @AzureSupport per richiedere supporto.
Aprire un ticket di supporto tramite il portale di Azure.

Share via