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. # Erstellen und Löschen mit einem Batch-Befehl Um Aktionen im Zeitplan für einen Channel zu erstellen und zu löschen, verwenden Sie den Befehl zur Stapelaktualisierung. Mit diesem Befehl können Sie mehrere Aktionen in einer Anforderung ausführen. Es gibt keinen Befehl zum Erstellen von Aktionen und einen anderen zum Löschen von Aktionen. **Wichtig** Wenn Sie mit einem gestarteten und laufenden Channel arbeiten, verwenden Sie den **batch-update-schedule**Befehl, um Aktionen hinzuzufügen oder zu entfernen. Verwenden Sie den Befehl **delete-schedule** nur für inaktive Kanäle. Der Befehl **delete-schedule** löscht alle geplanten Aktionen und kann bei Verwendung auf einem Live-Kanal zu Dienstunterbrechungen führen. Verwenden Sie den Befehl wie folgt: + Senden Sie eine *einzelne* Anforderung, z. B. eine Anforderung, um Folgendes zu tun: + Erstellen einer Aktion. + Löschen einer Aktion. + Senden Sie eine *Stapelanforderung* z. B. eine Anforderung, um Folgendes zu tun: + Erstellen mehrerer Aktionen. + Löschen mehrerer Aktionen. + Erstellen einer oder mehrerer Aktionen und Löschen einer oder mehrerer Aktionen. **Wichtig** In einem Befehl, der Aktionen zum Erstellen und Löschen kombiniert, werden die Löschaktionen *immer* vor den Aktionen zum Erstellen ausgeführt. Das bedeutet, dass die Löschaktionen aus dem Zeitplan MediaLive entfernt werden, bevor die Erstellungsaktionen zum Zeitplan hinzugefügt werden. **Topics** + [Wie funktioniert eine Batch-Anfrage](how-batch-schedule-requests-work.md) + [Batch-Befehl in verschiedenen Benutzeroberflächen](batchupdatecommand-interfaces.md) + [JSON-Nutzlast in verschiedenen Schnittstellen](batchupdatecommand-payloads.md) # Wie funktioniert eine Batch-Anfrage Sinn und Zweck der Stapelverarbeitung ist, dass alle Aktionen zusammen erfolgreich übergeben werden bzw. fehlschlagen. Daher MediaLive validiert AWS Elemental Batch-Aktionen gemeinsam. MediaLive führt die folgende Validierung durch: + Es stellt sicher, dass jede Aktion, die erstellt oder gelöscht wird, eine explizite oder implizite Startzeit hat, die mindestens 15 Sekunden in der future liegt. + Wenn sich die Aktion auf eine vorhandene Aktion im Zeitplan bezieht, wird sichergestellt, dass der Verweis auf die vorhandene Aktion korrekt ist. Ein nachfolgender Eingabewechsel enthält beispielsweise einen Verweis auf die Aktion, der er folgt. Diese Aktion muss vorhanden sein. Wenn die Validierung für eine Aktion fehlschlägt, schlägt sie automatisch für alle Aktionen im Stapel fehl. Wenn Sie nicht möchten, dass die Aktionen zusammen bestehen werden bzw. fehlschlagen, richten Sie keinen Stapel ein. Erstellen Sie stattdessen jede Aktion in einem eigenen Befehl zur Stapelaktualisierung. Wenn die Überprüfung erfolgreich ist, MediaLive werden alle Löschanforderungen vor den Erstellungsanforderungen verarbeitet, unabhängig von den Startzeiten der Aktionen. **Beispiel 1** Eine wichtige Anwendung der Batchverarbeitung besteht darin, mehrere Aktionen auszuführen, die gemeinsam erfolgreich sein müssen oder fehlschlagen. Nehmen wir beispielsweise an, Sie möchten das Firmenlogo entfernen und sofort ein splice\$1insert einfügen (um zu einem Ad-Avail zu wechseln). Dazu müssen Sie eine Aktion zum Entfernen des Logos und eine weitere Aktion zum Einfügen des splice\$1insert erstellen. Sie möchten die Aktion „Entfernen“ jedoch nicht einfügen MediaLive , wenn die Aktion splice\$1insert fehlschlägt, oder umgekehrt. Es ist besser, dass beide Aktionen fehlschlagen, da Sie dadurch die fehlerhaft formatierte Aktion korrigieren und dann beide Aktionen erneut übergeben können. Aus diesem Grund übermitteln Sie die beiden Aktionen zusammen in einem Befehl zur Stapelaktualisierung. **Beispiel 2** Eine weitere wichtige Verwendung von Stapelbefehlen besteht darin, einen Fehler bei einer Aktion im Zeitplan zu beheben. Sie können beispielsweise eine Bildüberlagerung korrigieren, die noch nicht gestartet bzw. mit der falschen Startzeit erstellt wurde. Dazu senden Sie einen Stapel-Aktualisierungszeitplanbefehl mit JSON, der Folgendes enthält: + Eine Nutzlast zum Entfernen der ursprünglichen Aktion zur Aktivierung der Bildüberlagerung. Diese Aktion hat die falsche Startzeit. + Eine Nutzlast zum Hinzufügen einer neuen Aktion zur Aktivierung derselben Bildüberlagerung. Diese Aktion hat die korrekte Startzeit. # Batch-Befehl in verschiedenen Benutzeroberflächen Der Befehl zur Stapelaktualisierung wird in verschiedenen Schnittstellen anders dargestellt: + In der AWS CLI ist der Befehl`batch-update-schedule`. + In der API wird der Befehl durch eine `HTTP PUT` auf `channels/channelId/schedule` dargestellt. + In der AWS SDKs wird der Befehl durch Konstrukte dargestellt, die für diese SDK-Sprache geeignet sind. # JSON-Nutzlast in verschiedenen Schnittstellen Die JSON-Nutzlast für den Befehl unterscheidet sich für die verschiedenen Schnittstellen: + In der AWS CLI hängt der Inhalt der Payload davon ab, wie Sie den Befehl verwenden: + Sie können einen Befehl mit zwei Parametern eingeben: `channel-id` und `--cli-input-json`. In diesem Fall erstellen Sie eine Datei, die die Channel-ID wiederholt und die JSON-Nutzlast enthält. + Sie können einen Befehl mit drei Parametern eingeben: einen für die Channel-ID, einen für die JSON-Nutzlast für die Erstellungsaktionen (falls anwendbar) und einen für die JSON-Nutzlast für die Löschaktionen (falls anwendbar). Sie übergeben die Nutzlasten in dem Befehl. Wenn beide Parameter vorhanden sind, verwendet jeder Parameter eine separate Nutzlast. Die beiden Nutzlasten werden jedoch validiert und als Stapel ausgeführt. Die Payload für AWS CLI wird immer in Pascal-Groß- und Kleinschreibung verwendet. + In der API gibt es eine Nutzlast mit zwei Abschnitten, einem `CREATES`-Abschnitt und einem `DELETES`-Abschnitt. Eine Anforderung kann einen oder beide Abschnitte enthalten. Die Nutzlast für die API verwendet für Variablennamen immer die gemischte Groß-/Kleinschreibung und für Klassen die gemischte Groß-/Kleinschreibung mit großen Anfangsbuchstaben. + In der wird die AWS SDKs JSON-Nutzlast durch Konstrukte dargestellt, die für diese SDK-Sprache geeignet sind. Um sich mit einzelnen Aktionen besser vertraut zu machen, empfehlen wir, die MediaLive Konsole zu verwenden, um eine Aktion zu erstellen. Nachdem Sie die Aktion erstellt haben, verwenden Sie den [DescribeSchedule](viewing-schedule-using-cli.md)Befehl in der entsprechenden Schnittstelle (z. B. im AWS CLI oder in einem SDK), um die unformatierte JSON-Payload für den gesamten Zeitplan abzurufen. Sie können einzelne Aktionen kopieren und sie als Modelle speichern, wenn Sie programmatisch arbeiten.