Przygotowanie do wycofania usługi AMS: vi migracja i przewodnik aktualizacji

  • Artykuł

Usługa Azure AI Video Indexer (VI) używała usługi Azure Media Services (AMS) do kodowania, pakowania i przesyłania strumieniowego zasobów multimedialnych. AMS ogłosił, że odejmuje na emeryturę 30 czerwca 2024 r. W związku z tym vi usuwa zależność od usługi AMS.

Aby kontynuować korzystanie z vi, od 15 lutego do 30 czerwca 2024 r., należy wykonać następujące kroki, aby odejść od ich zależności AMS bieżącego konta VI:

  1. Zaktualizuj konto VI, aby łączyło się z kontem usługi Azure Storage zamiast konta usługi AMS.
  2. Przeprowadź migrację istniejących zasobów VI AMS z zarządzanego konta magazynu usługi AMS do konta magazynu połączonego z kontem VI. Mimo że opcjonalne, jeśli nie migrowanie zasobów nie zostanie wykonane, po wycofaniu usługi AMS nie będzie można uzyskać dostępu do wcześniej indeksowanych filmów wideo ani ich szczegółowych informacji.

Te zmiany wpływają na wiele obszarów VI, a działania przygotowawcze, które należy podjąć, zależą od sposobu jej używania. W związku z tym przed przeprowadzeniem aktualizacji konta VI należy sprawdzić, jak używasz vi i wprowadzić wymagane zmiany, aby uniemożliwić działanie aplikacji i platform przy użyciu vi.

W tym dokumencie omówiono każdą z tych zmian, ich wpływ i to, co należy zrobić, aby bezproblemowo nawigować po nich.

Zmiany

Poniższy opis przedstawia zmiany w produkcie VI, które mają zastosowanie po zaktualizowaniu konta. Weź pod uwagę te zmiany i sposób ich wpływu na przepływ pracy i kod. Mają one zastosowanie tylko po zaktualizowaniu konta.

Przekazywanie wideo

Identyfikator zasobu usługi AMS nie będzie już używany do przekazywania filmu wideo. Zamiast tego zostanie użyty adres URL wideo lub plik lokalny.

Tworzenie, aktualizowanie i zarządzanie kontem

  • Aktualizacja konta: wszystkie konta VI utworzone przed 15 lutego muszą zostać zaktualizowane, aby były połączone z kontem usługi Azure Storage zamiast konta usługi AMS. Aby uzyskać wskazówki dotyczące tego, jak to zrobić w portalu lub za pośrednictwem interfejsu API, zobacz Aktualizowanie istniejącego konta usługi ARM.
  • Konto klasyczne — łączenie się z nowym kontem usługi ARM: zgodnie z ogłoszeniem we wrześniu 2023 r. konta klasyczne VI są wycofywane 30 czerwca 2024 r. Przed wycofaniem wszystkie konta klasyczne muszą być połączone z nowym kontem VI opartym na usłudze ARM. Aby uzyskać wskazówki dotyczące tego, jak to zrobić w portalu lub za pośrednictwem interfejsu API, zobacz Połączenie klasyczne konto do nowego konta opartego na usłudze ARM.
  • Tworzenie konta za pomocą interfejsu API
    • Musisz zaktualizować tworzenie konta i żądania używania interfejsu API VI w wersji 2024-01-01.
    • Żądania muszą być przesyłane z właściwością Konta usługi Azure Storage, a nie z kontem usługi AMS.
  • Portal: Podczas procesu tworzenia konta VI nowe konta VI będą skojarzone z kontem usługi Azure Storage.

Konto magazynu

Łączenie konta usługi Azure Storage z kontem VI jest trwałe i nie można go cofnąć. W związku z tym zaleca się utworzenie konta magazynu, które jest przeznaczone wyłącznie do użytku z kontem VI. (Jest to szczególnie ważne, jeśli spodziewasz się używania ograniczeń sieciowych). Zaleca się, aby konto magazynu było w tym samym regionie co konto VI.

Nie będzie można połączyć konta VI z kontem magazynu, które zostało wcześniej skojarzone z kontem usługi AMS.

Konta klasyczne — uwierzytelnianie oparte na tokenach interfejsu API

Ponieważ konta klasyczne VI zostaną wycofane 30 czerwca 2024 r., wszyscy klienci z klasycznymi kontami VI muszą połączyć je z kontami VI opartymi na usłudze Azure Resource Manager (ARM) przed 1 lipca 2024 r. Dzięki tej zmianie zmiany sposób generowania tokenów dostępu VI. Podczas gdy konta klasyczne VI generują tokeny dostępu do uwierzytelniania przy użyciu interfejsu API klasycznego uzyskiwania tokenu dostępu, zaktualizowane konta VI są oparte na usłudze ARM, a konta oparte na usłudze ARM używają interfejsu API usługi ARM do generowania tokenów dostępu.

Po połączeniu konta klasycznego z usługą ARM konto ma 30-dniowy okres przejściowy, w którym vi obsługuje dostęp do liczby zarówno przy użyciu klasycznego interfejsu API, jak i interfejsu API usługi ARM wygenerowanych tokenów dostępu. Dowiedz się, jak połączyć klasyczne konto z kontem usługi ARM tutaj.

Odtwarzacz przesyłania strumieniowego

Usługa Azure Odtwarzacz multimedialny jest również wycofywana od 30 czerwca 2024 r. Jeśli używasz punktu końcowego przesyłania strumieniowego VI do przesyłania strumieniowego wideo, musisz wybrać inny odtwarzacz obsługujący pakowanie Dash lub HLS i użycie tokenu w żądaniu.

Punkty końcowe przesyłania strumieniowego i przesyłania strumieniowego

Przesyłanie strumieniowe z adaptacyjną szybkością transmisji bitów — kodowanie i przesyłanie strumieniowe z adaptacyjną szybkością transmisji bitów nie jest już obsługiwane, a żądania indeksowania kończą się niepowodzeniem, jeśli przesyłanie strumieniowe jest ustawione na adaptacyjną szybkość transmisji bitów. Zamiast tego prześlij żądanie, aby zakodować pojedynczą szybkość transmisji bitów lub bez przesyłania strumieniowego.

Nowo indeksowane wideo — wszystkie żądania interfejsu API dla adresu URL przesyłania strumieniowego otrzymają adres URL do punktu końcowego VI, a nie punktu końcowego usługi AMS. Punkt końcowy VI zostanie poprzedzony prefiksem "vi-apim".

Wcześniej indeksowane filmy wideo — zaktualizowane konto VI nadal będzie mogło przesyłać strumieniowo zasoby usługi AMS do momentu ich migracji. W takim przypadku odpowiedzi na żądania dotyczące adresu URL przesyłania strumieniowego i Get Video Index, będą się różnić w zależności od tego, Get Streaming Video URL czy zasoby zostały zmigrowane. W związku z tym aplikacja musi mieć możliwość odtwarzania zarówno z punktu końcowego usługi AMS, jak i punktów końcowych VI. Na przykład gracz Shaka będzie mógł grać tylko w punkty końcowe VI, podczas gdy AMP będzie mógł grać w punkty końcowe usługi AMS.

Filmy wideo niezamigrowane — żądania dotyczące filmów wideo, które nie zostały zmigrowane, będą zwracać adres URL przesyłania strumieniowego usługi AMS do 30 czerwca 2024 r. Po tej dacie nie będzie można w ogóle wysyłać żądań do usługi AMS.

Projekty

Vi ma funkcję Projekty, która może służyć do edytowania i łączenia filmów wideo. Po zaktualizowaniu konta VI funkcja będzie ograniczona do momentu zmigrowania filmów wideo. Zaktualizowane konta VI i konta VI utworzone po 15 lutego nie będą mogły tworzyć nowych projektów do czerwca 2024 r.

Istniejące projekty będą odtwarzane, ale nie będzie można ich edytować ani renderować. W razie potrzeby należy renderować i pobierać pliki projektu przed zaktualizowaniem konta.

Jeśli vi migruje zasoby VI AMS dla Ciebie, projekty zostaną wyłączone w dniach/godzinach migrowania zasobów. Po zakończeniu migracji będą one możliwe do odtworzenia.

Otrzymasz powiadomienie e-mail o zakończeniu migracji i możesz również sprawdzić stan migracji w witrynie internetowej VI.

Rozliczenia

Vi nie będzie pobierać opłat za przesyłanie strumieniowe. Vi będzie naliczać stawkę płaską za kodowanie, która będzie kosztować mniej niż wcześniej koszt kodowania za pomocą usługi AMS w większości przypadków. Opłata za kodowanie będzie wyświetlana jako "Modyfikacja wideo". Pamiętaj, aby sprawdzić, czy musisz zmienić alerty dotyczące rozliczeń.

Migracja

Ze względu na wycofanie usługi AMS z 30 czerwca 2024 r. wszyscy klienci VI, którzy utrwalają filmy wideo i szczegółowe informacje VI, muszą przetwarzać zasoby w nowym formacie i migrować je do konta usługi Azure Storage połączonego z kontem VI.

Wymaga to następujących operacji:

  • Przetwarza on ponownie zasoby multimedialne, konwertując zasoby AMS na format CMAF za pomocą manifestów HLS i DASH. Jest to konieczne, aby zasoby zostały przesyłane strumieniowo przez usługę Video Indexer i innych graczy.
  • Przechowywanie tych ponownie przetworzonych zasobów na koncie usługi Azure Storage połączonym z kontem VI.

Ponieważ migracja zasobów usługi AMS byłaby trudna do wykonania samodzielnie, vi zapewnia środowisko migracji zarówno do ponownego przetwarzania plików, jak i przenoszenia zasobów. Korzystanie z rozwiązania do migracji nie wiąże się z żadnymi kosztami, z wyjątkiem magazynu zmigrowanych zasobów i kosztów sieci związanych z przenoszeniem danych. Koszty powinny być niskie, jeśli oba konta magazynu znajdują się w tym samym regionie. Migracja nie nastąpi natychmiast, ale vi zobowiązuje się do migracji zasobów przed datą wycofania usługi AMS.

Możesz wyrazić zgodę za pośrednictwem witryny Azure Portal lub żądania interfejsu API podczas aktualizowania konta do czasu wycofania usługi AMS 30 czerwca 2024 r.

Zostaną zmigrowane tylko skojarzone z vi zasoby usługi AMS. Jeśli inne zasoby usługi AMS istnieją na tym samym koncie magazynu, nie zostaną one zmigrowane.

Vi nie usunie oryginalnych kopii plików AMS. Po pomyślnym zakończeniu migracji, jeśli konto usługi AMS połączone z vi i kontem magazynu połączonym z usługą AMS były używane tylko dla vi, możesz rozważyć usunięcie obu tych kont.

Ważne

Nawet po zaktualizowaniu konta vi będzie nadal uzyskiwać dostęp do konta usługi AMS i skojarzonego z nim konta magazynu do momentu zmigrowania wszystkich filmów wideo. Dopóki migracja nie zostanie ukończona, ważne jest, aby nie usuwać ani zmieniać kont, ról lub uprawnień kont usługi AMS, usługi Azure Storage lub VI. Ponadto zaleca się, aby zasoby VI AMS nie były usuwane, dopóki nie otrzymasz powiadomienia o zakończeniu migracji, ponieważ mogły jeszcze nie zostać zmigrowane. Właściciel konta VI otrzyma powiadomienie e-mail o zakończeniu migracji i możesz również sprawdzić stan migracji w witrynie internetowej VI.

Jeśli migracja zasobu nie powiedzie się, pomimo wielu prób i ponownych prób migracji vi, migracja będzie traktowana jako ukończona z błędami i zostanie wysłana lista plików, które nie powiodły się migracji. Można je również pobrać ze strony Migracja w witrynie internetowej VI.

Możesz wyświetlić stan i postęp migracji w witrynie internetowej VI, a właściciel konta otrzyma wiadomość e-mail z powiadomieniem po zakończeniu migracji.

Firma Microsoft nie ponosi odpowiedzialności za wszelkie szkody związane z migracją.

Szczegółowe instrukcje dotyczące aktualizowania i migrowania

Aby uzyskać kompletny przewodnik krok po kroku, zobacz Aktualizowanie konta usługi Azure AI Video Indexer i migrowanie zasobów.

Często zadawane pytania

Czy możemy zażądać, aby VI migrowało tylko niektóre z naszych kont VI zasobów AMS?

Nie, to wszystko lub nic. Przed rozpoczęciem migracji należy przejrzeć i usunąć wszystkie zasoby, których nie chcesz migrować.

Zdecydowałem się na rozwiązanie migracji VI, ale potem zmieniłem zdanie. Czy mogę zrezygnować?

Nie możesz zmienić żądania za pośrednictwem portalu lub interfejsu API, a vi mogło już rozpocząć migrację zasobów. W razie potrzeby możesz otworzyć bilet pomocy technicznej i jeśli proces migracji nie został jeszcze uruchomiony, vi może być w stanie anulować żądanie.

Czy vi pobiera opłaty za migrację?

Nie, to bezpłatne doświadczenie. Jedynym kosztem jest przechowywanie zmigrowanych zasobów na koncie magazynu oraz koszty sieci związane z przenoszeniem danych. Koszt powinien być niski, jeśli oba konta magazynu znajdują się w tym samym regionie.

Jeśli nie używam vi do przesyłania strumieniowego lub kodowania, czy nadal muszę migrować zasoby VI AMS, aby nadal uzyskiwać dostęp do szczegółowych informacji VI?

Jest to nadal zachęcane, ponieważ zapewni, że wszystkie dane VI lub zasób są obecnie dostępne dla Ciebie.

Jeśli nie będziemy utrwalać żadnych danych wideo, czy musimy przeprowadzić migrację zasobów VI AMS?

Nie, chyba że chcesz przeprowadzić migrację źródłowego wideo, które zostało początkowo wysłane do vi na potrzeby indeksowania.

Widzę, że migracja zasobów jest w toku — czy ma to znaczenie, czy konkretny film wideo został jeszcze zmigrowany?

W większości przypadków nie. Jedynym scenariuszem, na który ma wpływ, jest użycie adresu URL przesyłania strumieniowego VI do odtwarzania filmów wideo. Filmy wideo, które nie są jeszcze migrowane, muszą być odtwarzane przez odtwarzacz, który obsługuje zasoby usługi AMS— azure Odtwarzacz multimedialny. Filmy wideo, które zostały już indeksowane, muszą być odtwarzane przez odtwarzacz obsługujący pakowanie Dash lub HLS oraz wysyłanie tokenu w żądaniu (takich jak Shaka, DashJS lub VideoJS).

Jak sprawdzić, czy wideo zostało jeszcze zmigrowane?

Odpowiedzią żądania Get Streaming URL — jeśli jeszcze nie została zmigrowana, będzie zawierać wzmiankę o usłudze multimediów na początku.

Czy można połączyć wiele kont VI z jednym kontem magazynu?

Tak

Czy można połączyć wiele kont magazynu z jednym kontem VI?

Nie.