View a markdown version of this page

Funktionen erstellen und verwalten - AWS Elemental MediaTailor
Eine Funktion einrichtenVerwalten von -FunktionenEine Funktion wird entferntRegeln für die ValidierungAPI-Referenz

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Funktionen erstellen und verwalten

Auf dieser Seite erfahren Sie, wie Sie Funktionen mithilfe der Konsole erstellen, anhängen, aktualisieren und löschen. MediaTailor Mithilfe von Funktionen können Sie das Sitzungsverhalten und Anzeigenanfragen anpassen, indem Sie an wichtigen Stellen während der Wiedergabe Logik ausführen.

Eine Funktion einrichten

Eine Funktion mit der Konsole erstellen

  1. Öffnen Sie die MediaTailor Konsole unter https://console.aws.amazon.com/mediatailor/.

  2. Wählen Sie im Navigationsbereich Funktionen aus.

  3. Wählen Sie Funktion erstellen.

  4. Geben Sie unter Funktions-ID einen eindeutigen Namen für die Funktion ein (z. B.fetchIdentity).

  5. Wählen Sie als Funktionstyp die Option CUSTOM_OUTPUTHTTP_REQUEST, oder ausSEQUENTIAL_EXECUTOR. In der Konsole werden die Konfigurationsfelder für den ausgewählten Typ angezeigt.

  6. Füllen Sie die typspezifischen Konfigurationsfelder aus. Eine Beschreibung der einzelnen Funktionstypen und ihrer Felder finden Sie unterFunktionstypen und Zusammensetzung.

  7. Wählen Sie Funktion erstellen.

Eine Funktion an eine Wiedergabekonfiguration anhängen

Eine Funktion wird erst ausgeführt, wenn Sie sie über ein Funktions-Mapping (eine Verknüpfung zwischen einem Lifecycle-Hook und einer Funktion) an eine Wiedergabekonfiguration anhängen. Die Funktionszuordnung gibt an, welcher Lifecycle-Hook die Funktion auslöst.

  1. Öffnen Sie die MediaTailor Konsole.

  2. Wählen Sie im Navigationsbereich Konfigurationen aus.

  3. Wählen Sie die Wiedergabekonfiguration aus, die Sie aktualisieren möchten.

  4. Wählen Sie im Abschnitt Funktionszuordnung die Option Bearbeiten aus.

  5. Wählen Sie für jeden Lifecycle-Hook die Funktion aus, die angehängt werden soll:

    • Hook zur Sitzungsinitialisierung — Wählen Sie eine Funktion aus, die beim Sitzungsstart einmal ausgeführt werden soll.

    • Hook für Anzeigenanfragen — Wählen Sie eine Funktion aus, die vor jeder ADS-Anfrage ausgeführt werden soll.

  6. Wählen Sie Speichern.

Verwalten von -Funktionen

Funktionen anzeigen

Navigiere zu Funktionen, um alle Funktionen in deinem Konto zu sehen. Wählen Sie einen Funktionsnamen, um die Konfiguration anzuzeigen.

Aktualisierung einer vorhandenen Funktion

Um eine Funktion zu aktualisieren, navigieren Sie zu Funktionen, wählen Sie die Funktion aus und ändern Sie die Konfiguration. Das Update ersetzt die gesamte Funktionsdefinition.

Tipp

Speichern Sie eine Kopie Ihrer Funktionskonfiguration, bevor Sie Änderungen vornehmen. Es gibt keine integrierte Versionierung oder Rollback für Funktionen.

Eine Funktion wird entfernt

Trennen einer Funktion von einer Wiedergabekonfiguration

Bevor Sie eine Funktion löschen, entfernen Sie sie aus allen Wiedergabekonfigurationen, die auf sie verweisen.

  1. Öffnen Sie die MediaTailor Konsole.

  2. Wählen Sie im Navigationsbereich Konfigurationen aus.

  3. Wählen Sie die Wiedergabekonfiguration aus.

  4. Wählen Sie im Abschnitt Funktionszuordnung die Option Bearbeiten aus.

  5. Entfernen Sie die Funktion aus dem Lifecycle-Hook.

  6. Wählen Sie Speichern.

Löschen einer Funktion

Navigieren Sie zu Funktionen, wählen Sie die Funktion aus und wählen Sie Löschen.

Regeln zum Blockieren von Löschungen

MediaTailor verhindert, dass Sie eine Funktion löschen, die noch verwendet wird.

Bedingung Ergebnis
Die Funktion wird über eine Funktionszuordnung an eine Wiedergabekonfiguration angehängt Löschen ist blockiert. Trennen Sie zuerst die Funktion.
Auf die Funktion wird in einem verwiesen SEQUENTIAL_EXECUTOR Löschen ist blockiert. Entfernen Sie zuerst den Verweis aus der übergeordneten Funktion.
Auf die Funktion wird nirgends verwiesen Der Löschvorgang ist erfolgreich.

Regeln für die Validierung

MediaTailor validiert Ihre Funktion, wenn Sie sie erstellen oder aktualisieren. Die folgenden Prüfungen werden durchgeführt:

  • Ausdruckssyntax — Bei allen Ausdrücken muss es sich um gültige JSONATA-Ausdrücke handeln.

  • Eingeschränkte Funktionen — Ausdrücke können keine eingeschränkten JSONata-Funktionen aufrufen. Die vollständige JSONata-Ausdrucksreferenz Liste finden Sie unter.

  • Präfixe für Ausgabeschlüssel — Alle Ausgabeschlüssel müssen mit einem anerkannten Namespace-Präfix beginnen. Eine Liste der akzeptierten Präfixe finden Sie unter. Lebenszyklus-Hooks

  • Funktionsreferenzen — Alle Funktions-IDs in a FunctionList müssen auf bestehende Funktionen verweisen.

  • Zirkelverweise — Eine Funktion kann weder direkt noch indirekt auf sich selbst verweisen.

  • Verschachtelungstiefe — A SEQUENTIAL_EXECUTOR kann andere Funktionen aufrufen, aber diese Funktionen selbst können nicht SEQUENTIAL_EXECUTOR s sein.

Spezifische Werte und Größenbeschränkungen finden Sie unterEinschränkungen.

API-Referenz

Informationen zur programmgesteuerten Verwaltung von Funktionen finden Sie in der AWS Elemental MediaTailor API-Referenz.