Steg 3 – Konfigurera migrering till V3 REST API eller klient-SDK

---

Viktigt

Du behöver inte längre migrera från Azure Media Service v2 till v3 eftersom utfasningen av V2-API:et överensstämmer med tillbakadragningen av Azure Media Services. Mer information finns i guiden för tillbakadragning av Azure Media Services .

Följande beskriver de steg som ska utföras för att konfigurera din miljö för användning av Media Services V3-API:et.

SDK-modell

I V2-API:et fanns det två olika klient-SDK:er, en för hanterings-API:et, som tillät programmatiskt skapande av konton och en för resurshantering.

Tidigare skulle utvecklare arbeta med ett klient-ID och en klienthemlighet för Azure-tjänstens huvudnamn, tillsammans med en specifik V2 REST API-slutpunkt för deras AMS-konto.

V3-API:et är AZURE Resource Management (ARM) baserat. Den använder ID:n och nycklar för tjänstens huvudnamn i Azure Active Directory (Azure AD) för att ansluta till API:et. Utvecklare måste skapa tjänstens huvudnamn eller hanterade identiteter för att ansluta till API:et. I V3-API:et använder API:et arm-standardslutpunkter och använder en liknande och konsekvent modell som alla andra Azure-tjänster.

Kunder som tidigare använde 2015-10-01-versionen av ARM-hanterings-API:et för att hantera sina V2-konton bör använda versionen 2020-05-01 (eller senare) av ARM-hanterings-API:et som stöds för V3 API-åtkomst.

Skapa ett nytt Media Services-konto för testning

Leta upp klient - och prenumerations-ID :t i portalen och skapa ett Media Services-konto. Välj sedan API-åtkomst och autentisering med tjänstens huvudnamn för att generera ett nytt Azure AD program-ID och hemligheter för användning med det här testkontot.

Skapa ett Media Services-konto. Hämta autentiseringsuppgifter för att få åtkomst till Media Services-API:et.

Ladda ned valfri klient-SDK och konfigurera din miljö

• SDK:er tillgängliga för .NET, .NET Core, Node.js, Python, Java och Go.
• Azure CLI-integrering för enkelt skriptstöd.

Anteckning

En COMMUNITY PHP SDK är inte längre tillgänglig för Azure Media Services på V3. Om du använder PHP på V2 bör du migrera till REST-API:et direkt i koden.

Open API-specifikationer

• V3 baseras på en enhetlig API-yta som exponerar både hanterings- och driftfunktioner som bygger på Azure Resource Manager. Azure Resource Manager mallar kan användas för att skapa och distribuera transformeringar, slutpunkter för direktuppspelning, livehändelser med mera.

• Dokumentet OpenAPI Specification (kallades tidigare Swagger) förklarar schemat för alla tjänstkomponenter.

• Alla klient-SDK:er härleds och genereras från Open API-specifikationen som publiceras på GitHub. Vid tidpunkten för publiceringen av den här artikeln underhålls de senaste Open API-specifikationerna offentligt i GitHub. Versionen 2020-05-01 är den senaste stabila versionen.

REST

Läs REST API-referenssidorna.

Du bör använda versionen 2020-05-01 (eller senare).

.NET

Läs artikeln Anslut till Media Services v3 API med .NET för att konfigurera din miljö.

Om du bara vill installera den senaste SDK:t med PackageManager använder du följande kommando:

Install-Package Microsoft.Azure.Management.Media

Om du vill installera den senaste SDK:en med hjälp av .NET CLI använder du följande kommando:

dotnet add package Microsoft.Azure.Management.Media

Dessutom finns fullständiga . NET-exempel i Azure-Samples/media-services-v3-dotnet för olika scenarier. Projekten på den här lagringsplatsen visar hur du implementerar olika Azure Media Services-scenarier med v3-versionen.

Kom igång med att justera koden

Sök i kodbasen efter användningsinstanser CloudMediaContext för att påbörja uppgraderingsprocessen till V3-API:et.

Följande kod visar hur v2-API:et tidigare användes med v2 .NET SDK. Utvecklare skulle börja med att skapa en CloudMediaContext och skapa en instans med ett AzureAdTokenCredentials -objekt.

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

Python

Läs artikeln Anslut till Azure Media Services v3 API – Python för att konfigurera din miljö.

Node.js

Läs artikeln Anslut till Azure Media Services v3 API – Node.js för att konfigurera din miljö.

Kör

Ladda ned Go SDK.

Få hjälp och support

Du kan kontakta Media Services med frågor eller följa våra uppdateringar med någon av följande metoder:

• Q & A
• Stack Overflow. Tagga frågor med azure-media-services.
• @MSFTAzureMedia eller använd @AzureSupport för att begära support.
• Öppna ett supportärende via Azure Portal.