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

O Indexador de Vídeo de IA (VI) do Azure 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, o 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 os seguintes passos para fazer a transição para fora da dependência AMS da conta VI atual:

  1. Atualize sua conta do VI para que ela seja vinculada a uma conta de Armazenamento do Azure em vez de uma conta do 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, uma vez que 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. 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 VI sejam afetados negativamente.

Este documento discute cada uma dessas alterações, 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. Eles só se aplicam depois que você atualiza sua conta.

Upload de vídeo

O ID de ativo do AMS não será mais usado para carregar um vídeo. Um URL de vídeo ou arquivo local será usado em vez disso.

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

  • Atualização de 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 clássica - conecte-se à nova conta ARM: Conforme anunciado em setembro de 2023, as contas VI Classic estão sendo aposentadas em 30 de junho de 2024. Antes da aposentadoria, 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 clássica a uma nova conta baseada em ARM.
  • Criação de conta com API
    • Você deve atualizar a criação de conta e as solicitações para usar a versão 2024-01-01 da API VI.
    • As solicitações devem ser enviadas com a propriedade Conta de Armazenamento do Azure em vez da conta do 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

A vinculação de uma conta de Armazenamento do Azure a uma conta VI é permanente e não pode ser desfeita. 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 que a 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 se aposentando em 30 de junho de 2024, todos os clientes com contas VI Clássicas 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 oferece suporte ao acesso à 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 ofereça suporte ao empacotamento Dash ou HLS e ao uso de um token na solicitação.

Endpoints 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 ponto de extremidade VI 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, as respostas às solicitações de uma URL Get Streaming Video 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 do AMS até 30 de junho de 2024. Após essa data, você não poderá fazer solicitações ao AMS.

Projetos

VI tem um recurso de projetos que pode ser usado para editar e costurar vídeos. Depois que sua conta VI for atualizada, o recurso será limitado até que seus vídeos sejam migrados. Contas VI atualizadas e 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 do VI AMS para você, os projetos serão desativados durante os dias/horas em que seus ativos estiverem 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 está concluída e também poderá verificar o status da migração no site do VI.

Cobrança

VI não cobrará por streaming. VI cobrará uma taxa fixa para codificação, que custará menos do que custava anteriormente para 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 você precisa alterar algum alerta de faturamento.

Migração

Devido à aposentadoria do AMS de 30 de junho de 2024, todos os clientes VI que persistirem em vídeos e insights criados por 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 do AMS seria um desafio para fazer 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 os ativos AMS associados ao VI serão migrados. Se outros ativos do AMS existirem na mesma conta de armazenamento, eles não serão migrados.

O VI não excluirá as cópias originais de 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 forem 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 do VI AMS não sejam excluídos até que você seja notificado de que a migração está concluída, pois eles podem ainda não ter migrado. O proprietário da conta VI receberá uma notificação por e-mail informando que a migração está concluída e você também poderá verificar o status da migração no site da VI.

Se um ativo não conseguir migrar, apesar das várias tentativas e tentativas do VI de migrá-lo, 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 ver o status e o progresso da 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 em relação à migração.

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

Para obter um guia passo a passo completo, consulte Atualizar sua conta do Indexador de Vídeo de IA do Azure e migrar ativos.

Perguntas frequentes

Podemos solicitar que o VI migre apenas alguns de nossos ativos de contas VI AMS?

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

Optei pela solução VI migrar, mas depois mudei de ideia. Posso recusar?

Você não pode alterar a solicitação por meio do portal ou da API e o VI pode já ter iniciado a migração de 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.

VI me cobra 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 preciso migrar ativos do VI AMS para continuar acessando os insights do VI?

Ele ainda é encorajado, pois garantirá que todos os 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 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 uma URL de streaming de 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á estavam indexados precisam ser reproduzidos por um player que ofereça suporte ao empacotamento Dash ou HLS e ao 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?

Yes

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

Não