الخطوة 3 - إعداد للترحيل إلى V3 REST API أو SDK للعميل

مقالة
06/30/2023

خطوات الترحيل 2

هام

لم يعد من الضروري الترحيل من Azure Media Service v2 إلى v3 لأن إهمال V2 API سيتوافق مع إيقاف Azure Media Services. يرجى الاطلاع على دليل إيقاف Azure Media Services لمزيد من المعلومات.

يصف ما يلي الخطوات التي يجب اتخاذها لإعداد بيئتك لاستخدام Media Services V3 API.

نموذج SDK

في V2 API، كان هناك نوعان مختلفان من SDKs للعميل، واحدة لواجهة برمجة تطبيقات الإدارة، والتي سمحت بإنشاء برمجي للحسابات، وواحدة لإدارة الموارد.

في السابق، كان المطورون يعملون مع معرف العميل الأساسي لخدمة Azure وسر العميل، جنبا إلى جنب مع نقطة نهاية V2 REST API محددة لحساب AMS الخاص بهم.

تستند واجهة برمجة تطبيقات V3 إلى إدارة موارد Azure (ARM). ويستخدم معرفات ومفاتيح كيان خدمة Azure Active Directory (Azure AD) للاتصال بواجهة برمجة التطبيقات. سيحتاج المطورون إلى إنشاء كيانات الخدمة أو الهويات المدارة للاتصال بواجهة برمجة التطبيقات. في V3 API، تستخدم واجهة برمجة التطبيقات نقاط نهاية ARM القياسية، وتستخدم نموذجا مشابها ومتسقا لجميع خدمات Azure الأخرى.

يجب على العملاء الذين يستخدمون إصدار 2015-10-01 من واجهة برمجة تطبيقات إدارة ARM لإدارة حساباتهم V2 استخدام الإصدار 2020-05-01 (أو أحدث) من واجهة برمجة تطبيقات إدارة ARM المدعومة للوصول إلى V3 API.

إنشاء حساب خدمات وسائط جديد للاختبار

ابحث عن معرفات المستأجر والاشتراك في المدخل وأنشئ حساب Media Services. ثم حدد الوصول إلى واجهة برمجة التطبيقات والمصادقة الأساسية للخدمة لإنشاء معرف تطبيق Azure AD جديد وأسرار للاستخدام مع حساب الاختبار هذا.

إنشاء حساب خدمات وسائط Azure. الحصول على بيانات الاعتماد للوصول إلى واجهة برمجة تطبيقات خدمات الوسائط.

قم بتنزيل عميل SDK من اختيارك وإعداد بيئتك

تتوفر SDKs ل .NET و.NET Core Node.js وPython وJava وGo.
تكامل Azure CLI لدعم البرمجة النصية البسيط.

ملاحظة

لم يعد PHP SDK المجتمع متوفرا لخدمات وسائط Azure على V3. إذا كنت تستخدم PHP على V2، يجب الترحيل إلى واجهة برمجة تطبيقات REST مباشرة في التعليمات البرمجية الخاصة بك.

فتح مواصفات واجهة برمجة التطبيقات

يستند الإصدار 3 إلى سطح واجهة برمجة تطبيقات موحد، والذي يعرض وظائف الإدارة والعمليات المبنية على Azure Resource Manager. يمكن استخدام قوالب Azure Resource Manager لإنشاء وتوزيع التحويلات ونقاط النهاية المتدفقة والأحداث المباشرة والمزيد.
يشرح مستند OpenAPI Specification (المعروف سابقًا باسم Swagger) المخطط لكافة مكونات الخدمة.
يتم اشتقاق جميع SDKs للعميل وإنشاءها من مواصفات Open API المنشورة على GitHub. في وقت نشر هذه المقالة، يتم الاحتفاظ بأحدث مواصفات Open API بشكل عام في GitHub. إصدار 2020-05-01 هو أحدث إصدار مستقر.

اقرأ الصفحات المرجعية لواجهة برمجة تطبيقات REST.

يجب استخدام الإصدار 2020-05-01 (أو أحدث).

اقرأ المقالة، الاتصال بواجهة برمجة تطبيقات خدمات الوسائط الإصدار 3 باستخدام .NET لإعداد بيئتك.

إذا كنت تريد ببساطة تثبيت أحدث SDK باستخدام PackageManager، فاستخدم الأمر التالي:

Install-Package Microsoft.Azure.Management.Media

أو لتثبيت أحدث SDK باستخدام .NET CLI استخدم الأمر التالي:

dotnet add package Microsoft.Azure.Management.Media

بالإضافة إلى ذلك، تتوفر نماذج .NET الكاملة في Azure-Samples/media-services-v3-dotnet لسيناريوهات مختلفة. توضح المشاريع في هذا المستودع كيفية تنفيذ سيناريوهات خدمات وسائط Azure المختلفة باستخدام إصدار v3.

بدء ضبط التعليمات البرمجية

ابحث في قاعدة التعليمات البرمجية الخاصة بك عن مثيلات الاستخدام CloudMediaContext لبدء عملية الترقية إلى V3 API.

توضح التعليمات البرمجية التالية كيفية الوصول إلى v2 API مسبقا باستخدام v2 .NET SDK. سيبدأ المطورون بإنشاء CloudMediaContext وإنشاء مثيل مع كائن 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);

الحصول على التعليمات والدعم

يمكنك الاتصال بخدمات الوسائط بأسئلة أو اتباع تحديثاتنا بإحدى الطرق التالية:

س & أ
موقع Stack Overflow. وضع علامة على الأسئلة باستخدام azure-media-services.
@MSFTAzureMedia أو استخدم @AzureSupport لطلب الدعم.
افتح تذكرة دعم من خلال مدخل Microsoft Azure.

مشاركة عبر