Passo 3 – Configurar a migração para a API REST V3 ou o SDK de cliente

Artigo
09/27/2023

passos de migração 2

Importante

Já não é necessário migrar do Serviço de Multimédia do Azure v2 para o v3, uma vez que a preterição da API V2 será alinhada com a extinção dos Serviços de Multimédia do Azure. Veja o Guia de extinção dos Serviços de Multimédia do Azure para obter mais informações.

O seguinte descreve os passos a seguir para configurar o seu ambiente para utilizar a API V3 dos Serviços de Multimédia.

Modelo do SDK

Na API V2, existiam dois SDKs de cliente diferentes, um para a API de gestão, que permitia a criação programática de contas e outro para a gestão de recursos.

Anteriormente, os programadores trabalhariam com um ID de cliente do principal de serviço do Azure e um segredo do cliente, juntamente com um ponto final específico da API REST V2 para a conta AMS.

A API V3 é baseada no Azure Resource Management (ARM). Utiliza IDs e chaves do principal de serviço do Azure Active Directory (Azure AD) para ligar à API. Os programadores terão de criar principais de serviço ou identidades geridas para se ligarem à API. Na API V3, a API utiliza pontos finais arm padrão e utiliza um modelo semelhante e consistente para todos os outros serviços do Azure.

Os clientes que utilizaram anteriormente a versão 2015-10-01 da API de gestão do ARM para gerir as respetivas contas V2 devem utilizar a versão 2020-05-01 (ou posterior) da API de gestão do ARM suportada para acesso à API V3.

Criar uma nova conta de serviços de multimédia para teste

Localize o seu inquilino e ids de subscrição no portal e crie uma conta dos Serviços de Multimédia. Em seguida, selecione Acesso à API e autenticação do principal de serviço para gerar um novo ID de aplicação Azure AD e segredos para utilização com esta conta de teste.

Criar uma conta de serviços de multimédia. Obtenha credenciais para aceder à API dos Serviços de Multimédia.

Transfira o SDK do cliente à sua escolha e configure o seu ambiente

SDKs disponíveis para .NET, .NET Core ,Node.js, Python, Java e Go.
Integração da CLI do Azure para suporte de scripts simples.

Nota

Um SDK PHP da comunidade já não está disponível para os Serviços de Multimédia do Azure na V3. Se estiver a utilizar PHP na V2, deve migrar para a API REST diretamente no seu código.

Especificações da API Aberta

O V3 baseia-se numa superfície de API unificada, que expõe a funcionalidade de gestão e operações criada no Azure Resource Manager. Os modelos de Resource Manager do Azure podem ser utilizados para criar e implementar transformações, pontos finais de transmissão em fluxo, eventos em direto e muito mais.
O documento OpenAPI Specification (anteriormente denominado Swagger) explica o esquema para todos os componentes do serviço.
Todos os SDKs de cliente são derivados e gerados a partir da especificação open API publicada no GitHub. No momento da publicação deste artigo, as especificações mais recentes da Open API são mantidas publicamente no GitHub. A versão 2020-05-01 é a versão estável mais recente.

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

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

Leia o artigo Ligar à API v3 dos Serviços de Multimédia com o .NET para configurar o seu ambiente.

Se quiser simplesmente instalar o SDK mais recente com o PackageManager, utilize o seguinte comando:

Install-Package Microsoft.Azure.Management.Media

Em alternativa, para instalar o SDK mais recente com a CLI do .NET, utilize o seguinte comando:

dotnet add package Microsoft.Azure.Management.Media

Além disso, estão disponíveis exemplos completos de .NET em Azure-Samples/media-services-v3-dotnet para vários cenários. Os projetos neste repositório mostram como implementar diferentes cenários dos Serviços de Multimédia do Azure com a versão v3.

Começar a ajustar o código

Procure no código base instâncias de utilização para iniciar o processo de CloudMediaContext atualização para a API V3.

O código seguinte mostra como a API v2 foi acedida anteriormente com o SDK .NET v2. Os programadores começariam por criar uma CloudMediaContext instância 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

Pode contactar os Serviços de Multimédia com perguntas ou seguir as nossas atualizações através de um dos seguintes métodos:

Q & A
Stack Overflow. Perguntas sobre etiquetas com azure-media-services.
@MSFTAzureMedia ou utilize @AzureSupport para pedir suporte.
Abra um pedido de suporte através do portal do Azure.