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
<a name="monetization-functions-managing"></a>

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
<a name="monetization-functions-managing-setup"></a>

### Eine Funktion mit der Konsole erstellen
<a name="monetization-functions-managing-create-console"></a>

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

1. Wählen Sie im Navigationsbereich **Funktionen** aus.

1. Wählen Sie **Funktion erstellen**.

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

1. Wählen Sie als **Funktionstyp** die Option `CUSTOM_OUTPUT``HTTP_REQUEST`, oder aus`SEQUENTIAL_EXECUTOR`. In der Konsole werden die Konfigurationsfelder für den ausgewählten Typ angezeigt.

1. Füllen Sie die typspezifischen Konfigurationsfelder aus. Eine Beschreibung der einzelnen Funktionstypen und ihrer Felder finden Sie unter[Funktionstypen und Zusammensetzung](monetization-functions-types.md).

1. Wählen Sie **Funktion erstellen**.

### Eine Funktion an eine Wiedergabekonfiguration anhängen
<a name="monetization-functions-managing-attach"></a>

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.

1. Wählen Sie im Navigationsbereich **Konfigurationen** aus.

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

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

1. 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.

1. Wählen Sie **Speichern**.

## Verwalten von -Funktionen
<a name="monetization-functions-managing-ops"></a>

### Funktionen anzeigen
<a name="monetization-functions-managing-view"></a>

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

### Aktualisierung einer vorhandenen Funktion
<a name="monetization-functions-managing-update"></a>

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
<a name="monetization-functions-managing-remove"></a>

### Trennen einer Funktion von einer Wiedergabekonfiguration
<a name="monetization-functions-managing-detach"></a>

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

1. Öffnen Sie die MediaTailor Konsole.

1. Wählen Sie im Navigationsbereich **Konfigurationen** aus.

1. Wählen Sie die Wiedergabekonfiguration aus.

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

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

1. Wählen Sie **Speichern**.

### Löschen einer Funktion
<a name="monetization-functions-managing-delete"></a>

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

### Regeln zum Blockieren von Löschungen
<a name="monetization-functions-managing-delete-blocking"></a>

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
<a name="monetization-functions-managing-validation"></a>

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](monetization-functions-jsonata.md) 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](monetization-functions-hooks.md)
+ **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 unter[Einschränkungen](monetization-functions-limits.md).

## API-Referenz
<a name="monetization-functions-managing-api-ref"></a>

Informationen zur programmgesteuerten Verwaltung von Funktionen finden Sie in der [AWS Elemental MediaTailor API-Referenz](https://docs.aws.amazon.com/mediatailor/latest/apireference/).