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

هل هذه الصفحة مفيدة؟

هل لديك ملاحظات إضافية؟

سيتم إرسال الملاحظات إلى Microsoft: بالضغط على الزر «إرسال»، سيتم استخدام ملاحظاتك لتحسين منتجات Microsoft وخدماتها. نهج الخصوصية.

---

يصف ما يلي الخطوات التي يجب اتخاذها لإعداد بيئتك لاستخدام 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.

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

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

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

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

• تتوفر حزم SDK ل .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

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

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

.NET

اقرأ المقالة، الاتصال إلى Media Services v3 API مع .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);

Java

اقرأ المقالة، الاتصال إلى Media Services v3 API مع Java لإعداد بيئتك.

Python

اقرأ المقالة، الاتصال إلى Azure Media Services v3 API - Python لإعداد بيئتك.

Node.js

اقرأ المقالة الاتصال إلى Azure Media Services v3 API - Node.js لإعداد بيئتك.

انتقال

قم بتنزيل Go SDK.