Stap 3: Instellen om te migreren naar de V3 REST API of client-SDK

Artikel
01/22/2024

migratiestappen 2

Belangrijk

Het is niet langer nodig om te migreren van Azure Media Service v2 naar v3, omdat afschaffing van V2-API wordt afgestemd op de buitengebruikstelling van Azure Media Services. Raadpleeg de handleiding voor buitengebruikstelling van Azure Media Services voor meer informatie.

Hieronder worden de stappen beschreven die u moet uitvoeren om uw omgeving in te stellen voor het gebruik van de Media Services V3-API.

SDK-model

In de V2-API waren er twee verschillende client-SDK's, één voor de beheer-API, waarmee programmatisch accounts konden worden gemaakt en één voor resourcebeheer.

Voorheen werkten ontwikkelaars met een client-id en clientgeheim van een Azure-service-principal, samen met een specifiek V2 REST API-eindpunt voor hun AMS-account.

De V3-API is gebaseerd op Azure Resource Management (ARM). Er wordt gebruikgemaakt van service-principal-id's en sleutels van Azure Active Directory (Azure AD) om verbinding te maken met de API. Ontwikkelaars moeten service-principals of beheerde identiteiten maken om verbinding te maken met de API. In de V3-API maakt de API gebruik van standaard-ARM-eindpunten, een vergelijkbaar en consistent model voor alle andere Azure-services.

Klanten die eerder de versie 2015-10-01 van de ARM-beheer-API gebruikten om hun V2-accounts te beheren, moeten de versie 2020-05-01 (of hoger) van de ARM-beheer-API gebruiken die wordt ondersteund voor toegang tot de V3-API.

Een nieuw Media Services-account maken voor testen

Zoek uw tenant- en abonnements-id's in de portal en maak een Media Services-account. Selecteer vervolgens API-toegang en service-principalverificatie om een nieuwe Azure AD toepassings-id en geheimen te genereren voor gebruik met dit testaccount.

Maak een Media Services-account. Referenties ophalen voor toegang tot de Media Services-API.

Download de client-SDK van uw keuze en stel uw omgeving in

SDK's beschikbaar voor .NET, .NET Core, Node.js, Python, Java en Go.
Azure CLI-integratie voor eenvoudige ondersteuning voor scripts.

Notitie

Een PHP SDK voor de community is niet meer beschikbaar voor Azure Media Services op V3. Als u PHP op V2 gebruikt, moet u rechtstreeks in uw code migreren naar de REST API.

Open API-specificaties

V3 is gebaseerd op een geïntegreerd API-oppervlak, dat zowel beheer- als bewerkingsfunctionaliteit beschikbaar maakt die is gebouwd op Azure Resource Manager. Azure Resource Manager-sjablonen kunnen worden gebruikt voor het maken en implementeren van transformaties, streaming-eindpunten, livegebeurtenissen en meer.
In het document OpenAPI Specification (voorheen Swagger genoemd) wordt het schema voor alle serviceonderdelen uitgelegd.
Alle client-SDK's worden afgeleid en gegenereerd op basis van de Open API-specificatie die is gepubliceerd op GitHub. Op het moment van publicatie van dit artikel worden de meest recente Open API-specificaties openbaar onderhouden in GitHub. De versie 2020-05-01 is de nieuwste stabiele release.

Lees de rest API-referentiepagina's.

U moet de versie 2020-05-01 (of hoger) gebruiken.

Lees het artikel Verbinding maken met Media Services v3 API met .NET om uw omgeving in te stellen.

Als u alleen de nieuwste SDK wilt installeren met behulp van PackageManager, gebruikt u de volgende opdracht:

Install-Package Microsoft.Azure.Management.Media

Of als u de nieuwste SDK wilt installeren met behulp van de .NET CLI, gebruikt u de volgende opdracht:

dotnet add package Microsoft.Azure.Management.Media

Daarnaast zijn volledige .NET-voorbeelden beschikbaar in Azure-Samples/media-services-v3-dotnet voor verschillende scenario's. De projecten in deze opslagplaats laten zien hoe u verschillende Azure Media Services-scenario's implementeert met behulp van de versie v3.

Aan de slag met het aanpassen van uw code

Zoek in uw codebasis naar exemplaren van CloudMediaContext gebruik om het upgradeproces naar de V3-API te starten.

De volgende code laat zien hoe de v2-API eerder is geopend met behulp van de v2 .NET SDK. Ontwikkelaars beginnen met het maken van een CloudMediaContext en maken een exemplaar met een AzureAdTokenCredentials -object.


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

Help en ondersteuning

U kunt contact opnemen met Media Services als u vragen hebt of onze updates op een van de volgende manieren volgen:

Q & A
Stack Overflow. Tag vragen met azure-media-services.
@MSFTAzureMedia of gebruik @AzureSupport om ondersteuning aan te vragen.
Open een ondersteuningsticket via de Azure Portal.

Delen via