3. lépés – A V3 REST API-ra vagy az ügyfél SDK-ra való migrálás beállítása

---

Fontos

Már nem szükséges migrálni az Azure Media Service v2-ről a v3-ra, mivel a V2 API elavulása igazodik az Azure Media Services kivonásához. További információt az Azure Media Services kivonási útmutatójában talál.

Az alábbiakban bemutatjuk a környezet Media Services V3 API használatára való beállításának lépéseit.

SDK-modell

A V2 API-ban két különböző ügyféloldali SDK volt, az egyik a felügyeleti API-hoz készült, amelyek lehetővé tették a fiókok programozott létrehozását, a másik pedig az erőforrás-kezelést.

Korábban a fejlesztők egy Azure-szolgáltatásnév ügyfélazonosítójával és titkos ügyfélkódjával, valamint egy adott V2 REST API-végponttal dolgoztak az AMS-fiókjukhoz.

A V3 API Azure Resource Managementen (ARM) alapul. Az Azure Active Directory (Azure AD) szolgáltatásnév azonosítóit és kulcsait használja az API-hoz való csatlakozáshoz. A fejlesztőknek szolgáltatásneveket vagy felügyelt identitásokat kell létrehozniuk az API-hoz való csatlakozáshoz. A V3 API-ban az API standard ARM-végpontokat használ, hasonló és konzisztens modellt használ az összes többi Azure-szolgáltatáshoz.

A V2-fiókok kezeléséhez korábban az ARM felügyeleti API 2015-10-01-es verzióját használó ügyfeleknek a V3 API-hozzáféréshez támogatott ARM felügyeleti API 2020-05-01 (vagy újabb) verzióját kell használniuk.

Új Media Services-fiók létrehozása teszteléshez

Keresse meg a bérlői és előfizetési azonosítókat a portálon, és hozzon létre egy Media Services-fiókot. Ezután válassza az API-hozzáférés és a szolgáltatásnév-hitelesítés lehetőséget egy új Azure AD alkalmazásazonosító és titkos kódok létrehozásához a tesztfiókhoz való használathoz.

Hozzon létre egy Media Services-fiókot. Hitelesítő adatok lekérése a Media Services API eléréséhez.

A választott ügyféloldali SDK letöltése és a környezet beállítása

• A .NET, .NET Core, Node.js, Python, Java és Go SDK-k érhetők el.
• Azure CLI-integráció egyszerű szkriptek támogatásához.

Megjegyzés

A közösségi PHP SDK már nem érhető el a V3-on futó Azure Media Serviceshez. Ha PHP-t használ a V2-n, a kódban közvetlenül a REST API-ra kell migrálnia.

API-specifikációk megnyitása

• A V3 egy egységes API-felületen alapul, amely az Azure Resource Manager-ra épülő felügyeleti és üzemeltetési funkciókat is elérhetővé teszi. Az Azure Resource Manager-sablonok átalakítások, streamvégpontok, élő események stb. létrehozására és üzembe helyezésére használhatók.

• Az OpenAPI-specifikáció (korábbi nevén Swagger) dokumentum ismerteti az összes szolgáltatásösszetevő sémáját.

• Az összes ügyféloldali SDK a GitHubon közzétett Open API-specifikációból származik és jön létre. A cikk közzétételekor a legújabb Open API-specifikációk nyilvánosan megmaradnak a GitHubon. A 2020-05-01-es verzió a legújabb stabil kiadás.

REST

Olvassa el a REST API referenciaoldalait.

A 2020-05-01 (vagy újabb) verziót kell használnia.

.NET

A környezet beállításához olvassa el a Csatlakozás a Media Services v3 API-hoz .NET-tel című cikket.

Ha egyszerűen csak telepíteni szeretné a legújabb SDK-t a PackageManager használatával, használja a következő parancsot:

Install-Package Microsoft.Azure.Management.Media

Vagy ha a legújabb SDK-t szeretné telepíteni a .NET CLI-vel, használja a következő parancsot:

dotnet add package Microsoft.Azure.Management.Media

Emellett teljes . NET-minták érhetők el az Azure-Samples/media-services-v3-dotnet különböző forgatókönyvekhez. Az adattár projektjei bemutatják, hogyan implementálhat különböző Azure Media Services-forgatókönyveket a v3 verzióval.

A kód módosításának első lépései

Keresse meg a kódbázisban a használati példányokat CloudMediaContext a V3 API-ra való frissítés megkezdéséhez.

Az alábbi kód bemutatja, hogy a v2 API-t korábban hogyan lehetett elérni a v2 .NET SDK használatával. A fejlesztők először létrehoznak egy példányt CloudMediaContext , majd létrehoznak egy AzureAdTokenCredentials objektumot.

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

Python

A környezet beállításához olvassa el a Csatlakozás az Azure Media Services v3 API-hoz – Pythonhoz című cikket.

Node.js

Olvassa el a Csatlakozás az Azure Media Services v3 API-hoz – Node.js a környezet beállításához című cikket.

Ugrás

Töltse le a Go SDK-t.

Súgó és támogatás

Kérdéseket tehet fel a Media Serviceshez, vagy kövesse a frissítéseket az alábbi módszerek egyikével:

• Q & A
• Stack Overflow. Kérdések címkézése a következővel: azure-media-services.
• @MSFTAzureMediavagy @AzureSupport használatával kérjen támogatást.
• Nyisson meg egy támogatási jegyet a Azure Portal keresztül.