Preparando-se para a aposentadoria do AMS: VI guia de migração e atualização

  • Artigo

O Azure AI Video Indexer (VI) usou os Serviços de Mídia do Azure (AMS) para codificação, empacotamento e streaming de ativos de mídia. A AMS anunciou que está se aposentando em 30 de junho de 2024. Portanto, VI está removendo a dependência do AMS.

Para continuar usando o VI, entre 15 de fevereiro e 30 de junho de 2024, você deve seguir as seguintes etapas para fazer a transição da dependência AMS da conta VI atual:

  1. Atualize sua conta VI para que ela seja vinculada a uma conta de Armazenamento do Azure em vez de uma conta AMS.
  2. Migre os ativos VI AMS existentes da conta de armazenamento gerenciado AMS para a conta de armazenamento vinculada à conta VI. Embora opcional, se a migração de ativos não for concluída, quando o AMS for desativado, você não poderá acessar seus vídeos indexados anteriormente ou seus insights.

Essas mudanças afetam muitas áreas do VI e as ações preparatórias que você deve tomar dependem de como você está usando-o. Portanto, antes de executar uma atualização de conta VI, você deve revisar como está usando o VI e fazer as alterações necessárias para evitar que seus aplicativos e plataformas que usam o VI sejam afetados negativamente.

Este documento discute cada uma dessas mudanças, seu impacto e o que precisa ser feito para navegar sem problemas.

Alterações

A descrição a seguir descreve as alterações no produto VI que se aplicam depois que você atualiza sua conta. Considere essas alterações e como elas afetam seu fluxo de trabalho e seu código. Só se aplicam depois de atualizar a sua conta.

Upload de vídeo

O ID do ativo AMS não será mais usado para carregar um vídeo. Em vez disso, será utilizado um URL de vídeo ou um ficheiro local.

Criação, atualização e gerenciamento de contas

  • Atualização da conta: todas as contas VI criadas antes de 15 de fevereiro devem ser atualizadas para que sejam vinculadas a uma conta de Armazenamento do Azure em vez de uma conta AMS. Para obter orientação sobre como fazer isso no portal ou por meio da API, consulte Atualizando uma conta ARM existente.
  • Conta Classic - conecte-se à nova conta ARM: Conforme anunciado em setembro de 2023, as contas VI Classic serão desativadas em 30 de junho de 2024. Antes da desativação, todas as contas Classic devem estar conectadas a uma nova conta VI baseada em ARM. Para obter orientação sobre como fazer isso no portal ou por meio da API, consulte Conectar uma conta Classic a uma nova conta baseada em ARM.
  • Criação de conta com API
    • Você deve atualizar a criação da conta e as solicitações para usar a versão da API VI 2024-01-01.
    • As solicitações devem ser enviadas com a propriedade Conta de Armazenamento do Azure em vez da conta AMS.
  • Portal: Durante o processo de criação da conta VI, novas contas VI serão associadas a uma conta de Armazenamento do Azure.

Conta de armazenamento

Vincular uma conta de Armazenamento do Azure a uma conta VI é permanente e não pode ser desfeito. Portanto, é recomendável que você crie uma conta de armazenamento que seja exclusivamente para uso com a conta VI. (Isso é especialmente importante se você espera usar restrições de rede.) É recomendável que a conta de armazenamento esteja na mesma região da conta VI.

Você não poderá vincular sua conta VI à conta de armazenamento que foi associada anteriormente à conta AMS.

Contas clássicas - autenticação baseada em token de API

Como as contas VI Classic estão sendo desativadas em 30 de junho de 2024, todos os clientes com contas Classic VI precisam conectá-las a contas VI baseadas no Azure Resource Manager (ARM) antes de 1º de julho de 2024. Com essa mudança, a forma como os tokens de acesso VI são gerados muda. Enquanto as contas VI Classic geram tokens de acesso para autenticação com a API Classic Get Access Token, as contas VI atualizadas são baseadas em ARM e as contas baseadas em ARM usam a API ARM para gerar tokens de acesso.

Depois de conectar sua conta Classic a uma conta ARM, há um período de estado de transição de 30 dias durante o qual o VI suporta acessar sua contagem com tokens de acesso gerados pela API Classic e pela API ARM. Saiba como conectar sua conta Classic a uma conta ARM aqui.

Leitor de streaming

O Azure Media Player também está sendo desativado a partir de 30 de junho de 2024. Se você estiver usando o ponto de extremidade de streaming VI para transmitir vídeos, deverá escolher um player diferente que suporte o empacotamento Dash ou HLS e o uso de um token na solicitação.

Pontos finais de streaming e streaming

Streaming de taxa de bits adaptável – A codificação e o streaming com taxa de bits adaptável não são mais suportados e as solicitações de indexação falharão se o streaming estiver definido como taxa de bits adaptável. Em vez disso, envie uma solicitação para codificar com taxa de bits única ou sem streaming.

Vídeo recém-indexado - Todas as solicitações de API para uma URL de streaming receberão uma URL para um ponto de extremidade VI em vez de um ponto de extremidade AMS. O VI endpoint será prefixado com "vi-apim".

Vídeos indexados anteriormente – Sua conta VI atualizada ainda poderá transmitir seus ativos AMS até que eles sejam migrados. Nesse caso, Get Streaming Video URL as respostas às solicitações de uma URL de streaming e Get Video Index, serão diferentes dependendo se os ativos foram migrados. Portanto, seu aplicativo deve ser capaz de reproduzir a partir do ponto de extremidade AMS e dos pontos de extremidade VI. Por exemplo, o jogador Shaka só poderá jogar endpoints VI, enquanto AMP poderá jogar endpoints AMS.

Vídeos não migrados - As solicitações de vídeos que não foram migrados retornarão uma URL de streaming AMS até 30 de junho de 2024. Após essa data, você não poderá fazer solicitações ao AMS.

Projetos

O VI tem um recurso Projetos que pode ser usado para editar e costurar vídeos. Assim que sua conta VI for atualizada, o recurso será limitado até que seus vídeos sejam migrados. As contas VI atualizadas e as contas VI criadas após 15 de fevereiro não poderão criar novos Projetos até junho de 2024.

Os projetos existentes poderão ser reproduzidos, mas você não poderá editá-los ou renderizá-los. Se necessário, renderize e baixe os arquivos do projeto antes de atualizar sua conta.

Se o VI estiver migrando seus ativos VI AMS para você, os projetos serão desativados durante os dias/horas em que seus ativos estão sendo migrados. Quando a migração estiver concluída, eles poderão ser jogados.

Você receberá uma notificação por e-mail informando que a migração foi concluída e também poderá verificar o status da migração no site do VI.

Faturação

O VI não cobrará pelo streaming. O VI cobrará uma taxa fixa pela codificação, que custará menos do que custava anteriormente codificar com AMS na maioria dos casos. A cobrança pela codificação aparecerá como "Modificação de vídeo". Lembre-se de verificar se precisa alterar algum alerta de cobrança.

Migração

Devido à desativação do AMS de 30 de junho de 2024, todos os clientes do VI que persistirem nos vídeos e insights criados pelo VI devem processar os ativos para um novo formato e migrá-los para a conta de Armazenamento do Azure vinculada à sua conta VI.

Isso requer as seguintes operações:

  • Ele reprocessa os ativos de mídia, convertendo os ativos AMS para o formato CMAF com manifestos HLS e DASH. Isso é necessário para que os ativos sejam transmitidos pelo Video Indexer e outros players.
  • Armazenamento desses ativos reprocessados na conta de Armazenamento do Azure que você vinculou à sua conta VI.

Como a migração de ativos AMS seria um desafio por conta própria, o VI está fornecendo uma experiência de migração para o reprocessamento de arquivos e a movimentação de ativos. Não há custo para usar a solução de migração, exceto o armazenamento dos ativos migrados e os custos de rede associados à movimentação dos dados. Os custos devem ser baixos se ambas as contas de armazenamento estiverem na mesma região. A migração não acontecerá imediatamente, mas a VI se compromete a migrar seus ativos antes da data de aposentadoria do AMS.

Você pode optar por meio do portal do Azure ou por meio de uma solicitação de API ao atualizar sua conta até a aposentadoria do AMS em 30 de junho de 2024.

Somente seus ativos AMS associados ao VI serão migrados. Se existirem outros ativos AMS na mesma conta de armazenamento, eles não serão migrados.

O VI não excluirá as cópias originais dos seus arquivos AMS. Depois que a migração for concluída com êxito, se a conta do AMS vinculada ao VI e a conta de armazenamento vinculada ao AMS tiverem sido usadas apenas para o VI, você poderá considerar a exclusão de ambos.

Importante

Mesmo depois de atualizar sua conta, o VI ainda acessará sua conta AMS e sua conta de armazenamento associada até que todos os seus vídeos tenham sido migrados. Até que a migração seja concluída, é importante que você NÃO exclua ou altere as contas, funções ou permissões das contas AMS, Armazenamento do Azure ou VI. Além disso, é recomendável que os ativos VI AMS não sejam excluídos até que você seja notificado de que a migração foi concluída, pois eles podem ainda não ter migrado. O proprietário da conta VI receberá uma notificação por e-mail de que a migração foi concluída e você também pode verificar o status da migração no site do VI.

Se um ativo não conseguir migrar, apesar das várias tentativas e tentativas de migração do VI, a migração será tratada como concluída com erros e você receberá uma lista dos arquivos que não conseguiram migrar. Eles também podem ser baixados da página Migração no site VI.

Você pode visualizar o status e o progresso da sua migração no site do VI e o proprietário da conta receberá um e-mail de notificação assim que a migração for concluída.

A Microsoft se isenta de qualquer responsabilidade por quaisquer danos relacionados à migração.

Instruções detalhadas de atualização e migração

Para obter um guia passo a passo completo, consulte Atualizar sua conta do Azure AI Video Indexer e migrar ativos.

FAQ

Podemos solicitar que o VI migre apenas alguns dos nossos ativos VI AMS das nossas contas?

Não, é tudo ou nada. Antes de iniciar a migração, você deve revisar e excluir todos os ativos que não deseja migrar.

Eu optei pela solução VI migrar, mas depois mudei de ideia. Posso optar por não participar?

Você não pode alterar a solicitação por meio do portal ou da API e o VI pode já ter começado a migrar seus ativos. Se necessário, você pode abrir um tíquete de suporte e, se o processo de migração ainda não tiver começado, o VI poderá cancelar a solicitação.

O VI cobra-me pela migração?

Não, é uma experiência gratuita. O único custo é o armazenamento dos ativos migrados em uma conta de armazenamento e os custos de rede associados à movimentação dos dados. O custo deve ser baixo se ambas as contas de armazenamento estiverem na mesma região.

Se eu não usar o VI para streaming ou codificação, ainda terei que migrar os ativos do VI AMS para continuar acessando os insights do VI?

Ainda é encorajado, pois garantirá que quaisquer dados ou ativos do VI atualmente disponíveis para você continuem disponíveis.

Se não persistirmos nenhum dado de vídeo, teremos que migrar os ativos do VI AMS?

Não, a menos que você queira migrar o vídeo de origem que você enviou inicialmente para o VI para indexação.

Vejo que minha migração de ativos está em processo – importa se um determinado vídeo já foi migrado?

Na maioria dos casos, não. O único cenário afetado é se você estiver usando um URL de streaming VI para reproduzir vídeos. Os vídeos ainda não migrados precisam ser reproduzidos por um player que ofereça suporte a ativos AMS, o Azure Media Player. Os vídeos que já foram indexados precisam ser reproduzidos por um player que suporte o empacotamento Dash ou HLS e o envio de um token na solicitação (como Shaka, DashJS, ou VideoJS).

Como posso saber se um vídeo já foi migrado?

Pela resposta da solicitação Get Streaming URL – se ainda não tiver sido migrada, ela conterá menção ao serviço de mídia no início.

Várias contas VI podem ser vinculadas a uma única conta de armazenamento?

Sim

Várias contas de armazenamento podem ser vinculadas a uma única conta VI?

Não