Vorbereiten der AMS-Einstellung: VI-Migrations- und Aktualisierungshandbuch

Artikel
04/16/2024

Azure AI Video Indexer (VI) verwendete Azure Media Services (AMS) zum Codieren, Verpacken und Streamen von Medienressourcen. AMS kündigte an, dass sie am 30. Juni 2024 eingestellt wird. Daher entfernt VI die Abhängigkeit von AMS.

Um VI weiterhin zu verwenden, müssen Sie zwischen dem 15. Februar und dem 30. Juni 2024 die folgenden Schritte ausführen, um die Abhängigkeit von ihrem aktuellen VI-Konto amS zu entfernen:

Aktualisieren Sie Ihr VI-Konto so, dass es anstelle eines AMS-Kontos mit einem Azure Storage-Konto verknüpft ist.
Migrieren Sie die vorhandenen VI AMS-Ressourcen aus dem verwalteten AMS-Speicherkonto zu dem Speicherkonto, das Sie mit dem VI-Konto verknüpft haben. Obwohl optional, wenn die Migration von Ressourcen nicht abgeschlossen ist, können Sie nach dem Zurückziehen von AMS nicht auf Ihre zuvor indizierten Videos oder deren Einblicke zugreifen.

Diese Änderungen wirken sich auf viele Bereiche von VI und die vorbereitenden Maßnahmen aus, die Sie ergreifen müssen, hängt davon ab, wie Sie sie verwenden. Daher sollten Sie vor der Durchführung einer VI-Kontoaktualisierung überprüfen, wie Sie VI verwenden, und die erforderlichen Änderungen vornehmen, um Ihre Anwendungen und Plattformen zu schützen, die VI verwenden, nicht beeinträchtigt.

In diesem Dokument werden die einzelnen Änderungen, ihre Auswirkungen und die Schritte erläutert, die für eine reibungslose Navigation erforderlich sind.

Änderungen

In der folgenden Beschreibung werden die Änderungen am VI-Produkt beschrieben, die angewendet werden, nachdem Sie Ihr Konto aktualisiert haben. Berücksichtigen Sie diese Änderungen und ihre Auswirkungen auf Ihren Workflow und Ihren Code. Sie gelten nur, nachdem Sie Ihr Konto aktualisiert haben.

Videoupload

Die AMS-Objekt-ID wird nicht mehr zum Hochladen eines Videos verwendet. Stattdessen wird eine Video-URL oder lokale Datei verwendet.

Kontoerstellung, -aktualisierung und -verwaltung

Kontoaktualisierung: Alle VI-Konten, die vor dem 15. Februar erstellt wurden, müssen aktualisiert werden, damit sie mit einem Azure Storage-Konto und nicht mit einem AMS-Konto verknüpft sind. Anleitungen zur Vorgehensweise im Portal oder über die API finden Sie unter Aktualisieren eines vorhandenen ARM-Kontos.
Klassisches Konto – Herstellen einer Verbindung mit neuem ARM-Konto: Wie im September 2023 angekündigt, werden VI Classic-Konten am 30. Juni 2024 eingestellt. Vor der Einstellung müssen alle klassischen Konten mit einem neuen ARM-basierten VI-Konto verbunden sein. Anleitungen zur Vorgehensweise im Portal oder über die API finden Sie unter Verbinden einem klassischen Konto zu einem neuen ARM-basierten Konto.
Kontoerstellung mit API
- Sie müssen die Kontoerstellung und Anforderungen für die Verwendung der VI-API Version 2024-01-01 aktualisieren.
- Anforderungen müssen mit der Azure Storage-Kontoeigenschaft und nicht mit dem AMS-Konto übermittelt werden.
Portal: Während des Vi-Kontoerstellungsprozesses werden neue VI-Konten einem Azure Storage-Konto zugeordnet.

Speicherkonto

Das Verknüpfen eines Azure Storage-Kontos mit einem VI-Konto ist dauerhaft und kann nicht rückgängig gemacht werden. Daher wird empfohlen, ein Speicherkonto zu erstellen, das ausschließlich für die Verwendung mit dem VI-Konto vorgesehen ist. (Dies ist besonders wichtig, wenn Sie davon ausgehen, dass Netzwerkeinschränkungen verwendet werden.) Es wird empfohlen, dass sich das Speicherkonto in derselben Region wie das VI-Konto befindet.

Sie können Ihr VI-Konto nicht mit dem Speicherkonto verknüpfen, das zuvor dem AMS-Konto zugeordnet war.

Klassische Konten– API-tokenbasierte Authentifizierung

Da VI Classic-Konten am 30. Juni 2024 eingestellt werden, müssen alle Kunden mit klassischen VI-Konten sie vor dem 1. Juli 2024 mit Azure Resource Manager (ARM)-basierten VI-Konten verbinden. Mit dieser Änderung ändert sich die Art und Weise, wie VI-Zugriffstoken generiert werden. Während VI Classic-Konten Zugriffstoken für die Authentifizierung mit der KLASSISCHEn Zugriffstoken-API generieren, sind aktualisierte VI-Konten ARM-basierte und ARM-basierte Konten verwenden die ARM-API , um Zugriffstoken zu generieren.

Nachdem Sie Ihr klassisches Konto mit einem ARM-Konto verbunden haben, gibt es einen Übergangszeitraum von 30 Tagen, in dem VI den Zugriff auf Ihre Anzahl sowohl mit klassischen API- als auch mit ARM-API generierten Zugriffstoken unterstützt. Hier erfahren Sie, wie Sie Ihr klassisches Konto mit einem ARM-Konto verbinden.

Streaming-Player

Azure Medienwiedergabe wird ab dem 30. Juni 2024 ebenfalls eingestellt. Wenn Sie den VI-Streaming-Endpunkt zum Streamen von Videos verwendet haben, müssen Sie einen anderen Player auswählen, der Dash- oder HLS-Verpackungen und die Verwendung eines Tokens in der Anforderung unterstützt.

Streaming- und Streamingendpunkte

Adaptives Bitrate-Streaming – Codierung und Streaming mit adaptiver Bitrate werden nicht mehr unterstützt, und Indizierungsanforderungen schlagen fehl, wenn Streaming auf adaptive Bitrate festgelegt ist. Senden Sie stattdessen eine Anforderung zum Codieren mit einzelner Bitrate oder ohne Streaming.

Neu indiziertes Video – Alle API-Anforderungen für eine Streaming-URL erhalten eine URL zu einem VI-Endpunkt anstelle eines AMS-Endpunkts. Dem VI-Endpunkt wird "vi-apim" vorangestellt.

Zuvor indizierte Videos – Ihr aktualisiertes VI-Konto kann Ihre AMS-Ressourcen weiterhin streamen, bis sie migriert werden. In diesem Fall unterscheiden sich die Antworten auf Anforderungen für eine Streaming-URL und Get Video Index, je nachdem, Get Streaming Video URL ob die Ressourcen migriert wurden. Daher muss Ihre Anwendung sowohl vom AMS-Endpunkt als auch von den VI-Endpunkten wiedergegeben werden können. Beispielsweise kann Shaka Player nur VI-Endpunkte wiedergeben, während AMP AMS-Endpunkte wiedergeben kann.

Nicht migrierte Videos – Anforderungen für Videos, die nicht migriert werden, geben bis zum 30. Juni 2024 eine AMS-Streaming-URL zurück. Nach diesem Datum können Sie überhaupt keine Anfragen an AMS senden.

Projekte

VI verfügt über ein Projektfeature, mit dem Videos bearbeitet und zusammengefügt werden können. Nachdem Ihr VI-Konto aktualisiert wurde, wird das Feature eingeschränkt, bis Ihre Videos migriert werden. Aktualisierte VI-Konten und VI-Konten, die nach dem 15. Februar erstellt wurden, können erst im Juni 2024 neue Projekte erstellen.

Vorhandene Projekte können abgespielt werden, aber Sie können sie nicht bearbeiten oder rendern. Rendern sie bei Bedarf, und laden Sie die Projektdateien herunter, bevor Sie Ihr Konto aktualisieren.

Wenn VI Ihre VI AMS-Ressourcen für Sie migriert, werden Projekte während der Tage/Stunden deaktiviert, die Ihre Ressourcen migriert werden. Sobald die Migration abgeschlossen ist, können sie abgespielt werden.

Sie erhalten eine E-Mail-Benachrichtigung, dass die Migration abgeschlossen ist, und Sie können auch den Migrationsstatus auf der VI-Website überprüfen.

Abrechnung

VI wird für das Streaming nicht belastet. VI berechnet einen Pauschalsatz für die Codierung, was in den meisten Fällen weniger kosten wird als bisher kosten, um mit AMS zu codieren. Die Gebühr für die Codierung wird als "Videoänderung" angezeigt. Denken Sie daran, zu überprüfen, ob Sie Abrechnungswarnungen ändern müssen.

Migration

Empfohlen: Anfordern von VI-Unterstützung bei der Migration

Aufgrund der Einstellung vom 30. Juni 2024 AMS müssen alle VI-Kunden, die VI-Dateien beibehalten, Videos und Einblicke in ein neues Format verarbeiten und zu dem Azure Storage-Konto migrieren, das mit ihrem VI-Konto verknüpft ist.

Dies erfordert die folgenden Vorgänge:

Sie verarbeitet die Medienressourcen neu, konvertiert die AMS-Ressourcen in das CMAF-Format mit HLS- und DASH-Manifesten. Dies ist erforderlich, damit die Ressourcen von VideoIndexer und anderen Spielern gestreamt werden.
Speichern dieser neu verarbeiteten Ressourcen im Azure Storage-Konto, das Sie mit Ihrem VI-Konto verknüpft haben.

Da die MIGRATION von AMS-Ressourcen auf eigene Faust eine Herausforderung darstellen würde, bietet VI eine Migrationserfahrung sowohl für die Dateiumverarbeitung als auch für die Ressourcenverschiebung. Es gibt keine Kosten für die Verwendung der Migrationslösung mit Ausnahme der Speicherung der migrierten Ressourcen und der Netzwerkkosten, die mit dem Verschieben der Daten verbunden sind. Die Kosten sollten niedrig sein, wenn sich beide Speicherkonten in derselben Region befinden. Die Migration erfolgt nicht sofort, aber VI verpflichtet sich, Ihre Vermögenswerte vor dem AmS-Ruhestandsdatum zu migrieren.

Sie können sich über die Azure-Portal oder über eine API-Anforderung anmelden, wenn Sie Ihr Konto bis zum Ruhestand am 30. Juni 2024 aktualisieren.

Nur Ihre vi zugeordneten AMS-Ressourcen werden migriert. Wenn andere AMS-Objekte auf demselben Speicherkonto vorhanden sind, werden sie nicht migriert.

VI löscht die originalen Kopien Ihrer AMS-Dateien nicht. Wenn das MIT VI verknüpfte AMS-Konto und das mit AMS verknüpfte Speicherkonto nur für VI verwendet wurden, können Sie beide löschen, nachdem die Migration erfolgreich abgeschlossen wurde.

Wichtig

Selbst nachdem Sie Ihr Konto aktualisiert haben, greift VI weiterhin auf Ihr AMS-Konto und das zugehörige Speicherkonto zu, bis alle Ihre Videos migriert wurden. Bis die Migration abgeschlossen ist, ist es wichtig, dass Sie die Konten, Rollen oder Berechtigungen der AMS-, Azure Storage- oder VI-Konten NICHT löschen oder ändern. Darüber hinaus wird empfohlen, VI AMS-Ressourcen erst gelöscht zu werden, wenn Sie benachrichtigt werden, dass die Migration abgeschlossen ist, da sie möglicherweise noch nicht migriert wurden. Der VI-Kontobesitzer erhält eine E-Mail-Benachrichtigung, dass die Migration abgeschlossen ist, und Sie können auch den Migrationsstatus auf der VI-Website überprüfen.

Wenn eine Ressource trotz mehrerer Versuche und Wiederholungen zum Migrieren nicht migriert werden kann, wird die Migration mit Fehlern behandelt, und Sie werden eine Liste der Dateien gesendet, die nicht migriert werden konnten. Sie können auch von der Seite "Migration" auf der VI-Website heruntergeladen werden.

Sie können den Status und den Fortschritt Ihrer Migration auf der VI-Website anzeigen, und der Kontobesitzer erhält eine Benachrichtigungs-E-Mail, sobald die Migration abgeschlossen ist.

Microsoft lehnt jegliche Haftung für schäden im Zusammenhang mit der Migration ab.

Detaillierte Aktualisierungs- und Migrationsanweisungen

Eine vollständige schrittweise Anleitung finden Sie unter Aktualisieren Ihres Azure AI Video Indexer-Kontos und Migrieren von Ressourcen.

Häufig gestellte Fragen

Können wir verlangen, dass VI nur einige unserer Konten VI AMS Assets migriert?

Nein, es ist alles oder nichts. Bevor Sie die Migration starten, sollten Sie alle Ressourcen überprüfen und löschen, die Sie nicht migrieren möchten.

Ich habe mich für die VI-Migrationslösung entschieden, aber dann meine Meinung geändert. Kann ich kündigen?

Sie können die Anforderung nicht über das Portal oder die API ändern, und VI hat möglicherweise bereits mit der Migration Ihrer Ressourcen begonnen. Bei Bedarf können Sie ein Supportticket öffnen und wenn der Migrationsprozess noch nicht gestartet wurde, kann VI die Anforderung möglicherweise stornieren.

Berechnet VI mich für die Migration?

Nein, es ist eine kostenlose Erfahrung. Die einzigen Kosten sind die Speicherung der migrierten Ressourcen in einem Speicherkonto und die Netzwerkkosten, die mit dem Verschieben der Daten verbunden sind. Die Kosten sollten niedrig sein, wenn sich beide Speicherkonten in derselben Region befinden.

Wenn ich VI nicht zum Streamen oder Codieren verwende, muss ich weiterhin VI AMS-Ressourcen migrieren, um weiterhin auf VI Insights zuzugreifen?

Es wird weiterhin empfohlen, da sichergestellt wird, dass alle VI-Daten oder Ressourcen, die ihnen derzeit zur Verfügung stehen, weiterhin verfügbar sind.

Wenn keine Videodaten gespeichert werden, müssen wir VI AMS-Ressourcen migrieren?

Nein, es sei denn, Sie möchten das Quellvideo migrieren, das Sie zunächst zur Indizierung an VI gesendet haben.

Ich sehe, dass meine Ressourcenmigration aktiv ist – spielt es eine Rolle, ob ein bestimmtes Video noch migriert wurde?

In den meisten Fällen nein. Das einzige Szenario, das betroffen ist, ist, wenn Sie eine VI-Streaming-URL zum Wiedergeben von Videos verwenden. Videos, die noch nicht migriert wurden, müssen von einem Player wiedergegeben werden, der AMS-Ressourcen unterstützt, dem Azure Medienwiedergabe. Videos, die bereits indiziert wurden, müssen von einem Player wiedergegeben werden, der Dash- oder HLS-Verpackungen und das Senden eines Tokens in der Anforderung unterstützt (z. B. Shaka, DashJS oder VideoJS).

Wie kann ich feststellen, ob ein Video noch migriert wurde?

Durch die Antwort der Get Streaming URL-Anforderung – falls noch nicht migriert, enthält sie Erwähnung des Mediendiensts am Anfang.