Voorbereiden op buitengebruikstelling van AMS: VI-migratie en updatehandleiding

  • Artikel

Azure AI Video Indexer (VI) heeft Azure Media Services (AMS) gebruikt voor codering, verpakking en streaming van mediaactiva. AMS heeft aangekondigd dat het op 30 juni 2024 buiten gebruik wordt gesteld. Daarom verwijdert VI de afhankelijkheid van AMS.

Als u VI wilt blijven gebruiken, moet u tussen 15 februari en 30 juni 2024 de volgende stappen uitvoeren om over te stappen van de huidige AMS-afhankelijkheid van het VI-account:

  1. Werk uw VI-account bij zodat het wordt gekoppeld aan een Azure Storage-account in plaats van een AMS-account.
  2. Migreer de bestaande VI AMS-assets van het door AMS beheerde opslagaccount naar het opslagaccount dat u aan het VI-account hebt gekoppeld. Hoewel optioneel, als het niet migreren van assets niet is voltooid, kunt u, nadat AMS buiten gebruik is gesteld, geen toegang krijgen tot uw eerder geïndexeerde video's of hun inzichten.

Deze wijzigingen zijn van invloed op veel gebieden van VI en de voorbereidende acties die u moet ondernemen, is afhankelijk van hoe u deze gebruikt. Voordat u een VI-account bijwerkt, moet u daarom controleren hoe u VI gebruikt en de benodigde wijzigingen aanbrengen om ervoor te zorgen dat uw toepassingen en platforms die VI gebruiken, nadelig worden beïnvloed.

In dit document worden al deze wijzigingen, de impact ervan en wat er moet gebeuren om ze soepel te laten navigeren.

Wijzigingen

De volgende beschrijving bevat een overzicht van de wijzigingen in het VI-product die van toepassing zijn zodra u uw account hebt bijgewerkt. Houd rekening met deze wijzigingen en hoe deze van invloed zijn op uw werkstroom en uw code. Ze zijn alleen van toepassing zodra u uw account bijwerkt.

Video uploaden

De AMS-asset-id wordt niet meer gebruikt voor het uploaden van een video. In plaats daarvan wordt een video-URL of lokaal bestand gebruikt.

Account maken, bijwerken en beheren

  • Accountupdate: Alle VI-accounts die vóór 15 februari zijn gemaakt, moeten worden bijgewerkt, zodat ze zijn gekoppeld aan een Azure Storage-account in plaats van een AMS-account. Zie Een bestaand ARM-account bijwerken voor hulp bij het uitvoeren ervan in de portal of via de API.
  • Klassiek account : maak verbinding met het nieuwe ARM-account: Zoals aangekondigd in september 2023, worden klassieke VI-accounts op 30 juni 2024 buiten gebruik gesteld. Vóór de buitengebruikstelling moeten alle klassieke accounts zijn verbonden met een nieuw OP ARM gebaseerd VI-account. Zie Verbinding maken een klassiek account naar een nieuw ARM-account voor hulp bij hoe u dit doet in de portal of via de API.
  • Account maken met API
    • U moet het maken van accounts en aanvragen bijwerken om de VI API-versie 2024-01-01 te gebruiken.
    • Aanvragen moeten worden ingediend met de eigenschap Azure Storage-account in plaats van het AMS-account.
  • Portal: Tijdens het maken van het VI-account worden nieuwe VI-accounts gekoppeld aan een Azure Storage-account.

Opslagaccount

Het koppelen van een Azure Storage-account aan een VI-account is permanent en kan niet ongedaan worden gemaakt. Daarom is het raadzaam om een opslagaccount te maken dat uitsluitend voor gebruik met het VI-account is. (Dit is vooral belangrijk als u verwacht netwerkbeperkingen te gebruiken.) Het wordt aanbevolen dat het opslagaccount zich in dezelfde regio bevindt als het VI-account.

U kunt uw VI-account niet koppelen aan het opslagaccount dat eerder aan het AMS-account was gekoppeld.

Klassieke accounts: verificatie op basis van API-token

Aangezien KLASSIEKE VI-accounts op 30 juni 2024 buiten gebruik worden gesteld, moeten alle klanten met klassieke VI-accounts deze vóór 1 juli 2024 verbinden met OP ARM gebaseerde VI-accounts (Azure Resource Manager). Met deze wijziging worden wijzigingen gegenereerd op de manier waarop VI-toegangstokens worden gegenereerd. Hoewel klassieke VI-accounts toegangstokens genereren voor verificatie met de klassieke Get Access Token-API, worden bijgewerkte VI-accounts op ARM gebaseerd en ARM-accounts gebruikt u de ARM-API om toegangstokens te genereren.

Nadat u uw klassieke account hebt verbonden met een ARM,-account, is er een overgangsperiode van 30 dagen waarin VI ondersteuning biedt voor toegang tot uw telling met zowel klassieke API- als ARM-API gegenereerde toegangstokens. Lees hier hoe u uw klassieke account verbindt met een ARM-account.

Streamingspeler

Azure Mediaspeler wordt vanaf 30 juni 2024 ook buiten gebruik gesteld. Als u het VI-streaming-eindpunt hebt gebruikt om video's te streamen, moet u een andere speler kiezen die dash- of HLS-pakketten ondersteunt en het gebruik van een token in de aanvraag.

Streaming- en streaming-eindpunten

Adaptieve bitrate streaming : codering en streaming met adaptieve bitrate wordt niet meer ondersteund en indexeringsaanvragen mislukken als streaming is ingesteld op adaptieve bitrate. Dien in plaats daarvan een aanvraag in om te coderen met één bitrate of geen streaming.

Onlangs geïndexeerde video : alle API-aanvragen voor een streaming-URL krijgen een URL naar een VI-eindpunt in plaats van een AMS-eindpunt. Het VI-eindpunt wordt voorafgegaan door 'vi-apim'.

Eerder geïndexeerde video's : uw bijgewerkte VI-account kan uw AMS-assets nog steeds streamen totdat ze zijn gemigreerd. In dit geval verschillen reacties op aanvragen voor een streaming-URL Get Streaming Video URL en Get Video Index, afhankelijk van of de assets zijn gemigreerd. Daarom moet uw toepassing kunnen worden afgespeeld vanuit zowel het AMS-eindpunt als de VI-eindpunten. Shaka-speler kan bijvoorbeeld alleen VI-eindpunten afspelen terwijl AMP AMS-eindpunten kan afspelen.

Niet-gemigreerde video's: aanvragen voor video's die niet worden gemigreerd, retourneert een STREAMING-URL voor AMS tot 30 juni 2024. Na die datum kunt u helemaal geen aanvragen meer indienen bij AMS.

Projecten

VI heeft een functie Projecten die kan worden gebruikt voor het bewerken en samenvoegen van video's. Zodra uw VI-account is bijgewerkt, wordt de functie beperkt totdat uw video's zijn gemigreerd. Bijgewerkte VI-accounts en VI-accounts die na 15 februari zijn gemaakt, kunnen pas nieuwe projecten maken tot juni 2024.

Bestaande projecten kunnen worden afgespeeld, maar u kunt ze niet bewerken of weergeven. Indien nodig kunt u de projectbestanden weergeven en downloaden voordat u uw account bijwerkt.

Als VI uw VI AMS-assets voor u migreert, worden projecten uitgeschakeld tijdens de dagen/uren dat uw assets worden gemigreerd. Zodra de migratie is voltooid, kunnen ze worden afgespeeld.

U ontvangt een e-mailmelding dat de migratie is voltooid en u kunt ook de migratiestatus op de VI-website controleren.

Billing

VI brengt geen kosten in rekening voor streaming. VI brengt in de meeste gevallen een vast tarief in rekening voor codering, wat in de meeste gevallen minder kost dan voorheen voor coderen met AMS. De kosten voor codering worden weergegeven als 'Videowijziging'. Vergeet niet om te controleren of u factureringswaarschuwingen moet wijzigen.

Migratie

Vanwege de buitengebruikstelling van 30 juni 2024 moeten alle VI-klanten die VI gemaakte video's en inzichten behouden, de assets verwerken naar een nieuwe indeling en deze migreren naar het Azure Storage-account dat is gekoppeld aan hun VI-account.

Hiervoor zijn de volgende bewerkingen vereist:

  • De mediaassets worden opnieuw verwerkt, waarbij de AMS-assets worden geconverteerd naar de CMAF-indeling met HLS- en DASH-manifesten. Dit is nodig om de assets te streamen door Video Indexer en andere spelers.
  • Het opslaan van deze opnieuw verwerkte assets in het Azure Storage-account dat u hebt gekoppeld aan uw VI-account.

Aangezien migratie van AMS-assets een uitdaging zou zijn om zelf te doen, biedt VI een migratie-ervaring voor zowel het opnieuw verwerken van bestanden als het verplaatsen van assets. Er zijn geen kosten verbonden aan het gebruik van de migratieoplossing, behalve de opslag van de gemigreerde assets en de netwerkkosten die zijn gekoppeld aan het verplaatsen van de gegevens. De kosten moeten laag zijn als beide opslagaccounts zich in dezelfde regio bevinden. De migratie vindt niet onmiddellijk plaats, maar VI voert doorvoeringen uit voor het migreren van uw assets vóór de buitengebruikstellingsdatum van AMS.

U kunt zich aanmelden via Azure Portal of via een API-aanvraag wanneer u uw account bijwerkt totdat de AMS op 30 juni 2024 buiten gebruik wordt gesteld.

Alleen uw aan VI gekoppelde AMS-assets worden gemigreerd. Als er andere AMS-assets aanwezig zijn in hetzelfde opslagaccount, worden ze niet gemigreerd.

VI verwijdert de oorspronkelijke kopieën van uw AMS-bestanden niet. Nadat de migratie is voltooid, kunt u overwegen om beide te verwijderen als het AMS-account is gekoppeld aan VI en het opslagaccount dat is gekoppeld aan AMS, is gebruikt voor VI.

Belangrijk

Zelfs nadat u uw account hebt bijgewerkt, heeft VI nog steeds toegang tot uw AMS-account en het bijbehorende opslagaccount totdat al uw video's zijn gemigreerd. Totdat de migratie is voltooid, is het belangrijk dat u de accounts, rollen of machtigingen van de AMS-, Azure Storage- of VI-accounts niet verwijdert of wijzigt. Daarnaast is het raadzaam dat VI AMS-assets pas worden verwijderd wanneer u wordt gewaarschuwd dat de migratie is voltooid omdat deze mogelijk nog niet zijn gemigreerd. De eigenaar van het VI-account ontvangt een e-mailmelding dat de migratie is voltooid en u kunt ook de migratiestatus op de VI-website controleren.

Als een asset niet kan worden gemigreerd, ondanks de meerdere pogingen en nieuwe pogingen om deze te migreren, wordt de migratie behandeld als voltooid met fouten en ontvangt u een lijst met de bestanden die niet zijn gemigreerd. Ze kunnen ook worden gedownload van de migratiepagina op de VI-website.

U kunt de status en voortgang van uw migratie bekijken op de VI-website en de accounteigenaar ontvangt een e-mailmelding zodra de migratie is voltooid.

Microsoft wijst eventuele aansprakelijkheid af voor eventuele schade met betrekking tot de migratie.

Gedetailleerde instructies voor bijwerken en migreren

Zie Uw Azure AI Video Indexer-account bijwerken en assets migreren voor een volledige stapsgewijze handleiding.

Veelgestelde vragen

Kunnen we aanvragen dat VI slechts enkele van onze accounts VI AMS-assets migreert?

Nee, het is alles of niets. Voordat u de migratie start, moet u alle assets controleren en verwijderen die u niet wilt migreren.

Ik heb me aangemeld voor de VI-migratieoplossing, maar toen veranderde ik van gedachten. Kan ik me afmelden?

U kunt de aanvraag niet wijzigen via de portal of API en VI zijn mogelijk al begonnen met het migreren van uw assets. Indien nodig kunt u een ondersteuningsticket openen en als het migratieproces nog niet is gestart, kan VI de aanvraag mogelijk annuleren.

Brengt VI mij kosten in rekening voor de migratie?

Nee, het is een gratis ervaring. De enige kosten zijn de opslag van de gemigreerde assets in een opslagaccount en de netwerkkosten die zijn gekoppeld aan het verplaatsen van de gegevens. De kosten moeten laag zijn als beide opslagaccounts zich in dezelfde regio bevinden.

Als ik VI niet gebruik voor streaming of codering, moet ik nog steeds VI AMS-assets migreren om toegang te blijven krijgen tot VI-inzichten?

Nee, tenzij u de bronvideo wilt migreren die u in eerste instantie naar VI hebt verzonden voor indexering.

Als we geen videogegevens behouden, moeten we VI AMS-assets migreren?

Nee, tenzij u de bronvideo wilt migreren die u in eerste instantie naar VI hebt verzonden voor indexering.

Ik zie dat mijn assetmigratie wordt uitgevoerd. Maakt het uit of een bepaalde video al is gemigreerd?

In de meeste gevallen, nee. Het enige scenario dat wordt beïnvloed, is als u een VI Streaming-URL gebruikt om video's af te spelen. Video's die nog niet zijn gemigreerd, moeten worden afgespeeld door een speler die AMS-assets ondersteunt, de Azure Mediaspeler. Video's die al zijn geïndexeerd, moeten worden afgespeeld door een speler die dash- of HLS-pakketten ondersteunt en het verzenden van een token in de aanvraag (zoals Shaka, DashJS of VideoJS).

Hoe weet ik of een video al is gemigreerd?

Door het antwoord van de aanvraag Streaming-URL ophalen, als deze nog niet is gemigreerd, bevat deze de vermelding van mediaservice aan het begin.