Schritt 3: Einrichten der Migration zur V3-REST-API oder zum Client-SDK

Artikel
06/30/2023

Schritte bei der Migration 2

Wichtig

Es ist nicht mehr erforderlich, von Azure Media Service v2 zu v3 zu migrieren, da die Einstellung der V2-API mit der Einstellung von Azure Media Services übereinstimmt. Weitere Informationen finden Sie im Leitfaden zur Einstellung von Azure Media Services .

Im Folgenden werden die Schritte beschrieben, mit denen Sie Ihre Umgebung für die Verwendung der Media Services V3-API einrichten.

SDK-Modell

In der V2-API gab es zwei verschiedene Client-SDKs: eines für die Verwaltungs-API, das die programmgesteuerte Erstellung von Konten ermöglichte, und eines für die Ressourcenverwaltung.

Bisher nutzten Entwickler die Client-ID und den geheimen Clientschlüssel eines Azure-Dienstprinzipals für einen bestimmten Endpunkt der V2-REST-API für ihr AMS-Konto.

Bei der V3-API bildet Azure Resource Manager (ARM) die Basis. Die API verwendet die IDs und Schlüssel des Azure Active Directory-Dienstprinzipals (Azure AD), um eine Verbindung mit der API herzustellen. Entwickler müssen Dienstprinzipale oder verwaltete Identitäten erstellen, um eine Verbindung mit der API herzustellen. In der V3-API verwendet die API Standard-ARM-Endpunkte und damit ein ähnliches (und somit konsistentes) Modell wie alle anderen Azure-Dienste.

Kunden, die zuvor Version 2015-10-01 der ARM-Verwaltungs-API zum Verwalten Ihrer V2-Konten verwendet haben, sollten auf Version 2020-05-01 (oder höher) der ARM-Verwaltungs-API umsteigen, die für den Zugriff auf die V3-API unterstützt wird.

Erstellen eines neuen Media Services-Konto für Tests

Suchen Sie Ihre Mandanten- und Abonnement-IDs im Portal, und erstellen Sie ein Media Services-Konto. Wählen Sie dann den API-Zugriff und die Authentifizierung per Dienstprinzipal aus, um eine neue Azure AD-Anwendungs-ID und Geheimnisse für die Verwendung mit diesem Testkonto zu generieren.

Erstellen Sie ein Media Services-Konto. Rufen Sie die Anmeldeinformationen für den Zugriff auf die Media Services-API ab.

Herunterladen des gewünschten Client-SDK und Einrichten Ihrer Umgebung

SDKs verfügbar für .NET, .NET Core, Node.js, Python, Java und Go.
Azure CLI-Integration für einfache Skriptunterstützung.

Hinweis

Ein PHP SDK der Community ist für Azure Media Services V3 nicht mehr verfügbar. Wenn Sie PHP unter V2 verwenden, sollten Sie direkt in Ihrem Code zur REST-API migrieren.

Spezifikation der offenen API

V3 basiert auf einer vereinheitlichten API-Oberfläche, die sowohl Verwaltungs- als auch Betriebsfunktionen auf der Basis von Azure Resource Manager bereitstellt. Azure Resource Manager-Vorlagen können zum Erstellen und Bereitstellen von Transformationen, Streamingendpunkten, Liveereignissen und mehr verwendet werden.
Im Dokument der OpenAPI-Spezifikation (ehemals Swagger) wird das Schema für alle Dienstkomponenten erläutert.
Alle Client-SDKs sind von der auf GitHub veröffentlichten Spezifikation der offenen API abgeleitet und wurden mit dieser generiert. Zum Zeitpunkt der Veröffentlichung dieses Artikels werden die neuesten Spezifikationen der offenen API öffentlich auf GitHub verwaltet. Version 2020-05-01 ist das neueste stabile Release.

Lesen Sie die REST-API-Referenzseiten.

Sie sollten Version 2020-05-01 (oder höher) verwenden.

Lesen Sie den Artikel Verbinden mit der Media Services V3-API – .NET, um Ihre Umgebung einzurichten.

Wenn Sie nur das neueste SDK mit PackageManager installieren möchten, verwenden Sie den folgenden Befehl:

Install-Package Microsoft.Azure.Management.Media

Sie können auch das neueste SDK mithilfe der .NET-Befehlszeilenschnittstelle installieren. Verwenden Sie dazu den folgenden Befehl:

dotnet add package Microsoft.Azure.Management.Media

Außerdem sind in Azure-Samples/media-services-v3-dotnet vollständige .NET-Beispiele für verschiedene Szenarien verfügbar. Die Projekte in diesem Repository veranschaulichen, wie unterschiedliche Azure Media Services-Szenarien mithilfe von V3 implementiert werden.

Erste Schritte bei der Anpassung Ihres Codes

Durchsuchen Sie Ihre Codebasis nach Instanzen von CloudMediaContext, um den Upgradevorgang auf die V3-API zu starten.

Der folgende Code zeigt, wie bisher mit Version 2 des .NET SDK auf die V2-API zugegriffen wurde. Entwickler erstellen zunächst einen CloudMediaContext und eine Instanz mit einem 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);

Anfordern von Hilfe und Support

Sie können Media Services mit Fragen kontaktieren oder unsere Updates mit einer der folgenden Methoden verfolgen:

Q & A
Stack Overflow. Markieren Sie Fragen mit azure-media-services.
@MSFTAzureMedia oder verwenden Sie @AzureSupport , um Support anzufordern.
Öffnen Sie ein Supportticket über die Azure-Portal.