Förbereda för AMS-pensionering: VI-migrering och uppdateringsguide

Azure AI Video Indexer (VI) använde Azure Media Services (AMS) för kodning, paketering och strömning av medietillgångar. AMS meddelade att det går i pension den 30 juni 2024. Därför tar VI bort beroendet av AMS.

Om du vill fortsätta använda VI, mellan den 15 februari och den 30 juni 2024, måste du vidta följande steg för att övergå från det aktuella AMS-beroendet för VI-kontot:

  1. Uppdatera ditt VI-konto så att det länkar till ett Azure Storage-konto i stället för ett AMS-konto.
  2. Migrera befintliga VI AMS-tillgångar från det AMS-hanterade lagringskontot till det lagringskonto som du länkade till VI-kontot. Även om det är valfritt, om du inte migrerar tillgångar, kommer du inte att kunna komma åt dina tidigare indexerade videor eller deras insikter när AMS har dragits tillbaka.

Dessa ändringar påverkar många områden i VI och de förberedande åtgärder som du måste vidta beror på hur du använder det. Innan du utför en VI-kontouppdatering bör du därför granska hur du använder VI och göra de ändringar som krävs för att förhindra att dina program och plattformar som använder VI påverkas negativt.

I det här dokumentet beskrivs var och en av dessa ändringar, deras inverkan och vad som behöver göras för att smidigt navigera dem.

Ändringar

I följande beskrivning beskrivs de ändringar av VI-produkten som gäller när du uppdaterar ditt konto. Tänk på de här ändringarna och hur de påverkar ditt arbetsflöde och din kod. De gäller bara när du har uppdaterat ditt konto.

Videouppladdning

AMS-tillgångs-ID:t används inte längre för att ladda upp en video. En video-URL eller lokal fil används i stället.

Skapa, uppdatera och hantera konton

  • Kontouppdatering: Alla VI-konton som skapats före den 15 februari måste uppdateras så att de är länkade till ett Azure Storage-konto i stället för ett AMS-konto. Vägledning om hur du gör det i portalen eller via API :et finns i Uppdatera ett befintligt ARM-konto.
  • Klassiskt konto – anslut till ett nytt ARM-konto: Som vi meddelade i september 2023 dras vi klassiska konton tillbaka den 30 juni 2024. Innan du går i pension måste alla klassiska konton vara anslutna till ett nytt ARM-baserat VI-konto. Information om hur du gör det i portalen eller via API:et finns i Anslut ett klassiskt konto till ett nytt ARM-baserat konto.
  • Skapa konto med API
    • Du måste uppdatera kontots skapande och begäranden om att använda VI API-version 2024-01-01.
    • Begäranden måste skickas med egenskapen Azure Storage-konto i stället för AMS-kontot.
  • Portal: När VI-kontot skapas associeras nya VI-konton med ett Azure Storage-konto.

Lagringskonto

Att länka ett Azure Storage-konto till ett VI-konto är permanent och kan inte ångras. Därför rekommenderar vi att du skapar ett lagringskonto som endast ska användas med VI-kontot. (Detta är särskilt viktigt om du förväntar dig att använda nätverksbegränsningar.) Vi rekommenderar att lagringskontot finns i samma region som VI-kontot.

Du kommer inte att kunna länka ditt VI-konto till lagringskontot som tidigare var associerat med AMS-kontot.

Klassiska konton – API-tokenbaserad autentisering

Eftersom vi klassiska konton dras tillbaka den 30 juni 2024 måste alla kunder med klassiska VI-konton ansluta dem till Azure Resource Manager-baserade VI-konton före den 1 juli 2024. Med den här ändringen genereras sättet som VI-åtkomsttoken genereras på. Medan vi klassiska konton genererar åtkomsttoken för autentisering med api:et för klassisk get-åtkomsttoken, är uppdaterade VI-konton ARM-baserade och ARM-baserade konton använder ARM-API:et för att generera åtkomsttoken.

När du har anslutit ditt klassiska konto till ett ARM-konto finns det en 30-dagars övergångsperiod under vilken VI har stöd för åtkomst till ditt antal med både klassiska API- och ARM API-genererade åtkomsttoken. Lär dig hur du ansluter ditt klassiska konto till ett ARM-konto här.

Strömmande spelare

Azure Mediespelare dras också tillbaka från och med den 30 juni 2024. Om du har använt VI-slutpunkten för direktuppspelning för att strömma videor måste du välja en annan spelare som stöder Dash- eller HLS-paketering och användning av en token i begäran.

Slutpunkter för direktuppspelning och direktuppspelning

Direktuppspelning med anpassningsbar bithastighet – Kodning och direktuppspelning med anpassningsbar bithastighet stöds inte längre och indexeringsbegäranden misslyckas om direktuppspelningen är inställd på anpassningsbar bithastighet. Skicka i stället en begäran om att koda med antingen enkel bithastighet eller ingen direktuppspelning.

Nyligen indexerad video – Alla API-begäranden för en strömmande URL hämtar en URL till en VI-slutpunkt i stället för en AMS-slutpunkt. VI-slutpunkten prefixeras med "vi-apim".

Tidigare indexerade videor – Ditt uppdaterade VI-konto kommer fortfarande att kunna strömma dina AMS-tillgångar tills de migreras. I det här fallet varierar svaren på begäranden om en strömmande URL Get Streaming Video URL och Get Video Index, beroende på om tillgångarna har migrerats. Därför måste ditt program kunna spela upp från både AMS-slutpunkten och VI-slutpunkterna. Shaka-spelare kan till exempel bara spela VI-slutpunkter medan AMP kan spela AMS-slutpunkter.

Omigrerade videor – Begäranden om videor som inte migreras returnerar en AMS-strömmande URL fram till den 30 juni 2024. Efter det datumet kommer du inte att kunna göra begäranden till AMS alls.

Projekt

VI har en projektfunktion som kan användas för att redigera och sammanfoga videor. När ditt VI-konto har uppdaterats begränsas funktionen tills dina videor migreras. Uppdaterade VI-konton och VI-konton som skapats efter den 15 februari kommer inte att kunna skapa nya projekt förrän i juni 2024.

Befintliga projekt kan spelas upp, men du kommer inte att kunna redigera eller återge dem. Om det behövs kan du rendera och ladda ned projektfilerna innan du uppdaterar ditt konto.

Om VI migrerar dina VI AMS-tillgångar åt dig inaktiveras projekt under de dagar/timmar som dina tillgångar migreras. När migreringen är klar kan de spelas upp.

Du får ett e-postmeddelande om att migreringen är klar och du kan även kontrollera migreringsstatusen på VI-webbplatsen.

Fakturering

VI debiterar inte för strömning. VI debiterar ett fast pris för kodning, vilket kostar mindre än det tidigare kostade att koda med AMS i de flesta fall. Kostnaden för kodning visas som "Videoändring". Kom ihåg att kontrollera om du behöver ändra några faktureringsaviseringar.

Migrering

På grund av ams-tillbakadragningen den 30 juni 2024 måste alla VI-kunder som bevarar VI-skapade videor och insikter bearbeta tillgångarna till ett nytt format och migrera dem till det Azure Storage-konto som är länkat till deras VI-konto.

Detta kräver följande åtgärder:

  • Den bearbetar medietillgångarna igen och konverterar AMS-tillgångarna till CMAF-format med HLS- och DASH-manifest. Detta krävs för att tillgångarna ska kunna strömmas av Video Indexer och andra spelare.
  • Lagring av dessa ombearbetade tillgångar i Det Azure Storage-konto som du har länkat till ditt VI-konto.

Som AMS-tillgångsmigrering skulle vara svårt att göra på egen hand tillhandahåller VI en migreringsupplevelse för både filbearbetning och tillgångsflytt. Det kostar ingenting att använda migreringslösningen förutom lagring av de migrerade tillgångarna och de nätverkskostnader som är associerade med att flytta data. Kostnaderna bör vara låga om båda lagringskontona finns i samma region. Migreringen sker inte omedelbart, men VI åtar sig att migrera dina tillgångar före AMS-tillbakadragningsdatumet.

Du kan anmäla dig via Azure-portalen eller via en API-begäran när du uppdaterar ditt konto fram till AMS-tillbakadragningen den 30 juni 2024.

Endast dina VI-associerade AMS-tillgångar migreras. Om det finns andra AMS-tillgångar på samma lagringskonto migreras de inte.

VI tar inte bort de ursprungliga kopiorna av dina AMS-filer. När migreringen har slutförts kan du ta bort båda dem om AMS-kontot som är länkat till VI och lagringskontot som är länkat till AMS endast användes för VI.

Viktigt!

Även när du har uppdaterat ditt konto kommer VI fortfarande att komma åt ditt AMS-konto och dess associerade lagringskonto tills alla dina videor har migrerats. Tills migreringen är klar är det viktigt att du INTE tar bort eller ändrar konton, roller eller behörigheter för AMS-, Azure Storage- eller VI-kontona. Dessutom rekommenderar vi att VI AMS-tillgångar inte tas bort förrän du får ett meddelande om att migreringen är klar eftersom de kanske inte har migrerats ännu. VI-kontoägaren får ett e-postmeddelande om att migreringen är klar och du kan även kontrollera migreringsstatusen på VI-webbplatsen.

Om en tillgång inte kan migreras, trots VI:s flera försök och återförsök att migrera den, behandlas migreringen som slutförd med fel och du får en lista över de filer som inte kunde migreras. De kan också laddas ned från migreringssidan på VI-webbplatsen.

Du kan visa status och förlopp för migreringen på VI-webbplatsen och kontoägaren får ett e-postmeddelande när migreringen är klar.

Microsoft frånsäger sig allt ansvar för eventuella skador i samband med migreringen.

Detaljerade anvisningar för uppdatering och migrering

En fullständig stegvis guide finns i Uppdatera ditt Azure AI Video Indexer-konto och migrera tillgångar.

Vanliga frågor

Kan vi begära att VI bara migrerar vissa av våra kontons VI AMS-tillgångar?

Nej, det är allt eller inget. Innan du påbörjar migreringen bör du granska och ta bort alla tillgångar som du inte vill migrera.

Jag valde vi-migreringslösningen men ändrade mig sedan. Kan jag avregistrera mig?

Du kan inte ändra begäran via portalen eller API:et och VI kanske redan har börjat migrera dina tillgångar. Om det behövs kan du öppna ett supportärende och om migreringsprocessen inte har startat ännu kanske VI kan avbryta begäran.

Debiterar VI mig för migreringen?

Nej, det är en kostnadsfri upplevelse. Den enda kostnaden är lagringen av de migrerade tillgångarna i ett lagringskonto och de nätverkskostnader som är associerade med att flytta data. Kostnaden bör vara låg om båda lagringskontona finns i samma region.

Om jag inte använder VI för strömning eller kodning, måste jag fortfarande migrera VI AMS-tillgångar för att fortsätta komma åt VI-insikter?

Det uppmuntras fortfarande eftersom det kommer att se till att alla VI-data eller tillgångar som för närvarande är tillgängliga för dig fortsätter att vara tillgängliga.

Om vi inte bevarar några videodata måste vi migrera VI AMS-tillgångar?

Nej, såvida du inte vill migrera källvideon som du ursprungligen skickade till VI för indexering.

Jag ser att min tillgångsmigrering pågår – spelar det någon roll om en viss video har migrerats ännu?

I de flesta fall, nej. Det enda scenario som påverkas är om du använder en URL för VI-direktuppspelning för att spela upp videor. Videor som ännu inte har migrerats måste spelas upp av en spelare som stöder AMS-tillgångar, azure-Mediespelare. Videor som redan har indexerats måste spelas upp av en spelare som stöder Dash- eller HLS-paketering och sändning av en token i begäran (till exempel Shaka, DashJS eller VideoJS).

Hur vet jag om en video har migrerats än?

Som svar på begäran om hämta direktuppspelnings-URL – om den inte har migrerats ännu, kommer den att innehålla omnämnande av medietjänsten i början.

Kan flera VI-konton länkas till ett enda lagringskonto?

Ja

Kan flera lagringskonton länkas till ett enda VI-konto?

Nej