Langkah 3 - Penyiapan untuk melakukan migrasi ke REST API V3 atau SDK klien

Artikel
06/30/2023

langkah migrasi 2

Penting

Tidak perlu lagi bermigrasi dari Azure Media Service v2 ke v3 karena penghentian V2 API akan selaras dengan penghentian Azure Media Services. Silakan lihat panduan penghentian Azure Media Services untuk informasi selengkapnya.

Berikut ini menjelaskan langkah-langkah yang harus diambil untuk menyiapkan lingkungan Anda dalam menggunakan API Media Services V3.

Model SDK

Dalam API V2, ada dua SDK klien yang berbeda, satu untuk API manajemen, yang memungkinkan pembuatan akun terprogram, dan satu untuk manajemen sumber daya.

Sebelumnya, pengembang akan bekerja dengan ID klien utama layanan Azure dan rahasia klien, bersama dengan titik akhir REST API V2 tertentu untuk akun AMS mereka.

API V3 berbasis Azure Resource Management (ARM). Ini menggunakan ID dan kunci utama layanan Azure Active Directory (AAD) agar terhubung ke API. Pengembang harus membuat perwakilan layanan atau identitas terkelola agar terhubung ke API. Dalam API V3, API menggunakan titik akhir ARM standar, menggunakan model yang serupa dan konsisten untuk semua layanan Azure lainnya.

Pelanggan yang sebelumnya menggunakan API manajemen ARM versi 2015-10-01 untuk mengelola akun V2 mereka harus menggunakan API manajemen ARM versi 2020-05-01 (atau lebih baru) yang didukung untuk akses API V3.

Membuat akun layanan media baru untuk pengujian

Temukan id penyewa dan langganan Anda di portal dan buat akun Media Services. Lalu, pilih akses API dan autentikasi perwakilan layanan untuk menghasilkan ID aplikasi Microsoft Azure AD baru dan rahasia untuk digunakan dengan akun pengujian ini.

Buat akun layanan media. Dapatkan kredensial untuk mengakses API Media Services.

Mengunduh SDK klien pilihan dan menyiapkan lingkungan Anda

SDK tersedia untuk .NET, .NET Core, Node.js, Python, Java, dan Go.
Integrasi Azure CLI untuk dukungan skrip sederhana.

Catatan

SDK PHP komunitas tidak lagi tersedia untuk Azure Media Services di V3. Jika Anda menggunakan PHP di V2, Anda harus melakukan migrasi ke REST API langsung dalam kode Anda.

Spesifikasi Open API

V3 didasarkan pada permukaan API terpadu, yang memaparkan fungsionalitas manajemen dan operasi yang dibangun di Azure Resource Manager. Templat Azure Resource Manager dapat digunakan untuk membuat dan menyebarkan transformasi, titik akhir streaming, acara langsung, dan lainnya.
Dokumen Spesifikasi OpenAPI (sebelumnya disebut Swagger) menjelaskan skema untuk semua komponen layanan.
Semua SDK klien berasal dan dihasilkan dari spesifikasi Open API yang dipublikasikan di GitHub. Pada saat publikasi artikel ini, spesifikasi Open API terbaru dipertahankan secara publik di GitHub. Versi 2020-05-01 merupakan rilis stabil terbaru.

Baca halaman referensi REST API.

Anda harus menggunakan versi 2020-05-01 (atau lebih baru).

Baca artikel, Menyambungkan ke API Media Services v3 dengan .NET untuk menyiapkan lingkungan Anda.

Jika Anda hanya ingin memasang SDK terbaru menggunakan PackageManager, gunakan perintah berikut:

Install-Package Microsoft.Azure.Management.Media

Atau untuk memasang SDK terbaru dengan .NET CLI gunakan perintah berikut:

dotnet add package Microsoft.Azure.Management.Media

Selain itu, sampel .NET lengkap tersedia di Azure-Samples/media-services-v3-dotnet untuk berbagai skenario. Proyek-proyek dalam repositori ini menunjukkan cara mengimplementasikan berbagai skenario Azure Media Services menggunakan versi v3.

Mulai menyesuaikan kode Anda

Cari basis kode Anda misalnya penggunaan CloudMediaContext untuk memulai proses peningkatan ke API V3.

Kode berikut menunjukkan bagaimana API v2 sebelumnya diakses menggunakan .NET SDK v2. Pengembang akan mulai dengan membuat CloudMediaContext dan membuat instance dengan objek AzureAdTokenCredentials.


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

Mendapatkan bantuan dan dukungan

Anda dapat menghubungi Media Services dengan pertanyaan atau mengikuti pembaruan kami dengan salah satu metode berikut:

T & A
Stack Overflow. Beri tag pertanyaan dengan azure-media-services.
@MSFTAzureMedia atau gunakan @AzureSupport untuk meminta dukungan.
Buka tiket dukungan melalui portal Azure.