Krok 3. Konfigurowanie migracji do interfejsu API REST w wersji 3 lub zestawu SDK klienta

Artykuł
06/29/2023

kroki migracji 2

Ważne

Migracja z usługi Azure Media Service w wersji 2 do wersji 3 nie jest już konieczna, ponieważ wycofanie interfejsu API w wersji 2 będzie zgodne z wycofaniem usługi Azure Media Services. Aby uzyskać więcej informacji, zobacz Przewodnik po wycofaniu usługi Azure Media Services .

Poniżej opisano kroki, które należy wykonać, aby skonfigurować środowisko do korzystania z interfejsu API usługi Media Services w wersji 3.

Model zestawu SDK

W interfejsie API w wersji 2 istniały dwa różne zestawy SDK klientów: jeden dla interfejsu API zarządzania, który umożliwiał programowe tworzenie kont, a drugi do zarządzania zasobami.

Wcześniej deweloperzy pracowali z identyfikatorem klienta jednostki usługi platformy Azure i kluczem tajnym klienta wraz z określonym punktem końcowym interfejsu API REST w wersji 2 dla konta usługi AMS.

Interfejs API w wersji 3 jest oparty na usłudze Azure Resource Management (ARM). Używa ona identyfikatorów i kluczy jednostki usługi Azure Active Directory (Azure AD), aby nawiązać połączenie z interfejsem API. Deweloperzy będą musieli utworzyć jednostki usługi lub tożsamości zarządzane, aby nawiązać połączenie z interfejsem API. W interfejsie API w wersji 3 interfejs API używa standardowych punktów końcowych usługi ARM, używa podobnego i spójnego modelu do wszystkich innych usług platformy Azure.

Klienci korzystający wcześniej z interfejsu API zarządzania usługi ARM w wersji 2015-10-01 do zarządzania kontami w wersji 2 powinni używać wersji 2020-05-01 (lub nowszej) interfejsu API zarządzania usługi ARM obsługiwanej na potrzeby dostępu do interfejsu API w wersji 3.

Tworzenie nowego konta usługi Media Services na potrzeby testowania

Znajdź swoje identyfikatory dzierżawy i subskrypcji w portalu i utwórz konto usługi Media Services. Następnie wybierz pozycję Dostęp do interfejsu API i uwierzytelnianie jednostki usługi, aby wygenerować nowy Azure AD identyfikator aplikacji i wpisy tajne do użycia z tym kontem testowym.

Utwórz konto usługi Media Services. Uzyskiwanie poświadczeń w celu uzyskania dostępu do interfejsu API usługi Media Services.

Pobierz wybrany zestaw SDK klienta i skonfiguruj środowisko

Zestawy SDK dostępne dla platform .NET, .NET Core, Node.js, Python, Java i Go.
Integracja interfejsu wiersza polecenia platformy Azure na potrzeby obsługi prostych skryptów.

Uwaga

Zestaw SDK języka PHP społeczności nie jest już dostępny dla usługi Azure Media Services w wersji 3. Jeśli używasz języka PHP w wersji 2, musisz przeprowadzić migrację do interfejsu API REST bezpośrednio w kodzie.

Specyfikacje interfejsu API open

Wersja 3 jest oparta na ujednoliconej powierzchni interfejsu API, która udostępnia funkcje zarządzania i operacji oparte na usłudze Azure Resource Manager. Szablony usługi Azure Resource Manager mogą służyć do tworzenia i wdrażania przekształceń, punktów końcowych przesyłania strumieniowego, wydarzeń na żywo i nie tylko.
Dokument Specyfikacja interfejsu OpenAPI (wcześniej nazywany swagger) wyjaśnia schemat wszystkich składników usługi.
Wszystkie zestawy SDK klienta są generowane na podstawie specyfikacji interfejsu Open API opublikowanej w witrynie GitHub. W momencie publikacji tego artykułu najnowsze specyfikacje interfejsu Open API są przechowywane publicznie w usłudze GitHub. Wersja 2020-05-01 jest najnowszą stabilną wersją.

Przeczytaj strony referencyjne interfejsu API REST.

Należy użyć wersji 2020-05-01 (lub nowszej).

Przeczytaj artykuł Connect to Media Services v3 API with .NET (Łączenie z interfejsem API usługi Media Services w wersji 3 przy użyciu platformy .NET), aby skonfigurować środowisko.

Jeśli chcesz po prostu zainstalować najnowszy zestaw SDK przy użyciu narzędzia PackageManager, użyj następującego polecenia:

Install-Package Microsoft.Azure.Management.Media

Aby zainstalować najnowszy zestaw SDK przy użyciu interfejsu wiersza polecenia platformy .NET, użyj następującego polecenia:

dotnet add package Microsoft.Azure.Management.Media

Ponadto pełne przykłady platformy .NET są dostępne w temacie Azure-Samples/media-services-v3-dotnet dla różnych scenariuszy. Projekty w tym repozytorium pokazują, jak zaimplementować różne scenariusze usługi Azure Media Services przy użyciu wersji 3.

Wprowadzenie do dostosowywania kodu

Wyszukaj bazę kodu pod kątem CloudMediaContext wystąpień użycia, aby rozpocząć proces uaktualniania do interfejsu API w wersji 3.

Poniższy kod pokazuje, jak interfejs API w wersji 2 był wcześniej uzyskiwany przy użyciu zestawu SDK platformy .NET w wersji 2. Deweloperzy zaczęli od utworzenia i CloudMediaContext utworzenia wystąpienia za pomocą AzureAdTokenCredentials obiektu .


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

Uzyskiwanie pomocy i obsługi technicznej

Możesz skontaktować się z usługą Media Services z pytaniami lub postępować zgodnie z naszymi aktualizacjami, korzystając z jednej z następujących metod:

Q & A
Stack Overflow. Tagowanie pytań przy użyciu polecenia azure-media-services.
@MSFTAzureMedia lub użyj @AzureSupport , aby poprosić o pomoc techniczną.
Otwórz bilet pomocy technicznej za pośrednictwem Azure Portal.

Udostępnij za pośrednictwem