Paso 3: Configuración para migrar a la API REST v3 o SDK de cliente

---

Importante

Ya no es necesario migrar de Azure Media Service v2 a v3, ya que el desuso de la API V2 se alineará con la retirada de Azure Media Services. Consulte la guía de retirada de Azure Media Services para más información.

A continuación se describen los pasos necesarios para configurar el entorno para usar la API de Media Services v3.

Modelo de SDK

En la API v2, había dos SDK de cliente diferentes, uno para la API de administración, que permitía la creación mediante programación de cuentas, y otro para la administración de recursos.

Anteriormente, los desarrolladores usaban un id. y secreto de cliente para el cliente de la entidad de servicio de Azure, junto con un punto de conexión de API REST v2 específico para su cuenta de AMS.

La API v3 está basada en Azure Resource Manager (ARM). Usa claves e identificadores de entidad de servicio de Azure Active Directory (Azure AD) para conectarse a la API. Los desarrolladores deberán crear entidades de servicio o identidades administradas para conectarse a la API. En la API v3, la API usa puntos de conexión estándar de ARM y usa un modelo similar y coherente para todos los demás servicios de Azure.

Los clientes que anteriormente usaban la versión 2015-10-01 de la API de administración de ARM para administrar sus cuentas de v2 deben usar la versión 2020-05-01 (o posterior) de la API de administración de ARM compatible con el acceso a la API v3.

Creación de una cuenta de Media Services para pruebas

Busque los identificadores de inquilino y suscripción en el portal y cree una cuenta de Media Services. Luego, seleccione acceso de API y autenticación de entidad de servicio para generar un nuevo identificador de aplicación y secretos de Azure AD para usarlos con esta cuenta de prueba.

Cree una cuenta de Media Services. Obtenga credenciales para acceder a la API de Media Services.

Descarga del SDK de cliente que prefiera y configuración del entorno

• SDK disponibles para .NET, .NET Core, Node.js, Python, Java y Go.
• La integración de la CLI de Azure para la compatibilidad de scripting sencilla.

Nota

Ya no está disponible ningún SDK de PHP de la comunidad para Azure Media Services en la versión v3. Si está usando PHP en v2, debe migrar a la API REST directamente en el código.

Especificaciones de Open API

• La versión v3 se basa en una superficie de API unificada que expone la funcionalidad de administración y operaciones creada en Azure Resource Manager. Las plantillas de Azure Resource Manager se pueden usar para crear e implementar transformaciones, puntos de conexión de streaming, eventos en directo, etc.

• El documento especificación de OpenAPI (anteriormente denominado Swagger) explica el esquema de todos los componentes del servicio.

• Todos los SDK de cliente se derivan y generan a partir de la especificación de Open API publicada en GitHub. En el momento de la publicación de este artículo, las especificaciones más recientes de Open API se mantienen de manera pública en GitHub. La versión 2020-05-01 es la versión estable más reciente.

REST

Lea las páginas de referencia de la API REST.

Deberías usar la versión de 01/05/2020 (o posterior).

.NET

Lea el artículo Conexión a la API de Media Services v3 con .NET para configurar su entorno.

Si simplemente quiere instalar el SDK más reciente mediante PackageManager, use el siguiente comando:

Install-Package Microsoft.Azure.Management.Media

O bien, para instalar el SDK más reciente mediante la CLI de .NET, use el siguiente comando:

dotnet add package Microsoft.Azure.Management.Media

Además, los ejemplos completos de .NET están disponibles en Azure-samples/Media-Services-V3-dotnet para diversos escenarios. Los proyectos de este repositorio muestran cómo implementar distintos escenarios de Azure Media Services con la versión v3.

Introducción a la adaptación del código

Busque en el código base las instancias de uso de CloudMediaContext para iniciar el proceso de actualización a la API v3.

En el código siguiente se muestra cómo se obtenía acceso anteriormente a la API v2 mediante el SDK de .NET v2. Los desarrolladores comenzaban por crear un CloudMediaContext y crear una instancia con un objeto 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);

Python

Lea el artículo Conexión a la API de Azure Media Services v3: Python para configurar su entorno.

Node.js

Lea el artículo Conexión a la API de Azure Media Services v3: Node.js para configurar su entorno.

Go

Descargue el SDK de Go.

Obtener ayuda y soporte técnico

Puede ponerse en contacto con Media Services con preguntas o seguir nuestras actualizaciones mediante uno de los métodos siguientes:

• PREGUNTAS Y RESPUESTAS
• Stack Overflow. Etiquete las preguntas con azure-media-services.
• @MSFTAzureMedia o use @AzureSupport para solicitar soporte técnico.
• Abra una incidencia de soporte técnico a través del Azure Portal.