Etapa 3 - configurar a migração para a API REST V3 ou o SDK do cliente

Artigo
06/30/2023

etapas da migração 2

Importante

Não é mais necessário migrar do Serviço de Mídia do Azure v2 para v3, pois a substituição da API V2 se alinhará à desativação dos Serviços de Mídia do Azure. Consulte o guia de desativação dos Serviços de Mídia do Azure para obter mais informações.

Veja a seguir uma descrição das etapas a serem seguidas para configurar seu ambiente para usar a API dos serviços de mídia v3.

Modelo de SDK

Na API v2, havia dois SDKs de cliente diferentes, um para a API de gerenciamento, que permitia a criação programática de contas e outra para o gerenciamento de recursos.

Anteriormente, os desenvolvedores trabalhavam com uma ID de cliente da entidade de serviço do Azure e o segredo do cliente, juntamente com um ponto de extremidade de API REST do v2 específico para sua conta do AMS.

A API v3 é baseada no Gerenciamento de recursos do Azure (ARM). Ele usa as IDs e chaves da entidade de serviço do Azure Active Directory (AD do Azure) para se conectar à API. Os desenvolvedores precisarão criar entidades de serviço ou identidades gerenciadas para se conectar à API. Na API v3, a API usa pontos de extremidade padrão do ARM, usa um modelo semelhante e consistente para todos os outros serviços do Azure.

Os clientes que usavam a versão de 01/10/2015 da API de gerenciamento do ARM para gerenciar suas contas V2 devem usar a versão de 01/05/2020 da API de gerenciamento ARM com suporte para acesso à API v3.

Criar uma nova conta dos serviços de mídia para teste

Localize suas IDs de locatário e de assinatura no portal e crie uma conta dos Serviços de Mídia. Em seguida, selecione o acesso à API e a autenticação da entidade de serviço para gerar uma nova ID do aplicativo do Azure AD e segredos para uso com essa conta de teste.

Crie uma conta de Serviços de Mídia. Obtenha credenciais para acessar a API dos Serviços de Mídia.

Baixe o SDK do cliente de sua escolha e configure seu ambiente

SDKs disponíveis para .NET, .NET Core, Node.js, Python, Java e Go.
CLI do Azure integração com o suporte a scripts simple.

Observação

Um SDK da comunidade PHP não está mais disponível para os serviços de mídia do Azure na v3. Se você estiver usando PHP na v2, deverá migrar para a API REST diretamente no seu código.

Especificações da API do sensor

A v3 é baseada em uma superfície de API unificada que expõe a funcionalidade de operações e gerenciamento compilada no Azure Resource Manager. Os modelos do Azure Resource Manager podem ser usados para criar e implantar Transformações, Pontos de Extremidade de Streaming, Eventos ao Vivo, entre outros.
O documento de especificação OpenAPI (anteriormente chamado de Swagger) explica o esquema para todos os componentes de serviço.
Todos os SDKs do cliente são derivados e gerados a partir da especificação da API aberta publicada no GitHub. No momento da publicação deste artigo, as especificações de API aberta mais recentes estão mantidas publicamente no GitHub. A versão 2020-05-01 é a versão estávelmais recente.

Leia as páginas de referência da API REST.

Use a versão 2020-05-01 (ou posterior).

Leia o artigo conectar-se à API dos serviços de mídia v3 com .NET para configurar seu ambiente.

Se você simplesmente deseja instalar o SDK mais recente usando o PackageManager, use o seguinte comando:

Install-Package Microsoft.Azure.Management.Media

Ou para instalar o SDK mais recente usando a CLI do .NET, use o seguinte comando:

dotnet add package Microsoft.Azure.Management.Media

Além disso, os exemplos completos do .NET estão disponíveis no Azure-Samples/Media-Services-V3-dotnet para vários cenários. Os projetos neste repositório mostram como implementar diferentes cenários de Serviços de Mídia do Azure usando a versão v3.

Comece a ajustar seu código

Pesquise sua base de código para instâncias de CloudMediaContext uso para iniciar o processo de atualização para a API v3.

O código a seguir mostra como a API v2 foi acessada anteriormente usando o SDK do .NET v2. Os desenvolvedores começaram a criar um CloudMediaContext e criar uma instância com um AzureAdTokenCredentials objeto.


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

Obter ajuda e suporte

Você pode entrar em contato com os Serviços de Mídia com dúvidas ou seguir nossas atualizações por um dos seguintes métodos:

P & R
Stack Overflow. Marque perguntas com azure-media-services.
@MSFTAzureMedia ou use @AzureSupport para solicitar suporte.
Abra um tíquete de suporte por meio do portal do Azure.

Compartilhar via