Benachrichtigungen über den Status eines Auftrags - Amazon Elastic Transcoder

Sparen Sie Kosten und erhalten Sie mehr Funktionen mit AWS Elemental MediaConvert

MediaConvert ist ein neuerer dateibasierter Videotranskodierungsdienst, der eine umfassende Suite erweiterter Transcodierungsfunktionen bietet. On-Demand-Tarife beginnen bei 0,0075 USD/Minute. Lesen Sie mehr.

Verwenden Sie bereits Amazon Elastic Transcoder? Die Migration darauf ist einfach. MediaConvert Weitere Informationen finden Sie in dieser Übersicht, die wertvolle Informationen über den Migrationsprozess und Links zu weiteren Ressourcen enthält.

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.

Benachrichtigungen über den Status eines Auftrags

Elastic Transcoder kann Sie benachrichtigen, wenn sich der Status eines Jobs ändert. Sie können Elastic Transcoder so konfigurieren, dass Sie Benachrichtigungen für eine beliebige Kombination (oder keine) der folgenden Statusänderungen erhalten:

  • Fortschritte: Elastic Transcoder hat begonnen, einen Job in der Pipeline zu verarbeiten.

  • Abgeschlossen: Elastic Transcoder hat die Verarbeitung eines Jobs in der Pipeline abgeschlossen.

  • Warnung: Elastic Transcoder ist bei der Verarbeitung eines Jobs in der Pipeline auf eine Warnung gestoßen.

  • Fehler: Elastic Transcoder ist bei der Verarbeitung eines Jobs in der Pipeline auf einen Fehler gestoßen.

Elastic Transcoder sendet Benachrichtigungen mithilfe von Amazon Simple Notification Service (AmazonSNS). Amazon SNS bietet eine Vielzahl von Benachrichtigungsoptionen, darunter die Möglichkeit, Nachrichten an HTTP Endpunkte, E-Mail-Adressen und Amazon Simple Queue Service (AmazonSQS) -Warteschlangen zu senden. Weitere Informationen zu diesen und anderen Optionen finden Sie im Amazon Simple Notification Service Developer Guide.

Benachrichtigungen sind beim Entwerfen ereignisgesteuerter Anwendungen nützlich. Wenn Sie Benachrichtigungen verwenden, um festzustellen, wann Jobs abgeschlossen sind, können Sie die Abfrage eliminieren, und Sie werden nicht auf die Limit Exceeded Ausnahmen (HTTPStatuscode 429) stoßen, die manchmal bei Abfragen auftreten.

Sie konfigurieren die Benachrichtigungen, wenn Sie eine Pipeline erstellen bzw. aktualisieren. Für jeden Job, den Sie an diese Pipeline senden, sendet Elastic Transcoder die entsprechenden Benachrichtigungen.

Wichtig

Wenn Sie Benachrichtigungen ändern, werden diese Änderungen sofort wirksam. Jobs, die Sie bereits eingereicht haben und deren Verarbeitung Elastic Transcoder noch nicht begonnen hat, sind betroffen, ebenso wie Jobs, die Sie einreichen, nachdem Sie die Benachrichtigungen geändert haben.

So konfigurieren Sie Elastic Transcoder so, dass Sie über Änderungen des Jobstatus informiert werden, wenn Sie den Elastic Transcoder verwenden: API

  1. Erstellen Sie ein oder mehrere SNS Amazon-Themen und abonnieren Sie jedes Thema. Weitere Informationen finden Sie in der Dokumentation zu Amazon Simple Notification Service.

    Wenn Sie bereits SNS Amazon-Themen haben, die Sie verwenden möchten, können Sie diesen Schritt überspringen.

  2. Erstellen Sie eine Pipeline oder aktualisieren Sie eine vorhandene Pipeline. Geben Sie für jede Statusänderung, für die Sie eine Benachrichtigung wünschen (Progress, Complete, Warning, Error), das entsprechende SNS Amazon-Thema an, das Sie in Schritt 1 erstellt haben. Weitere Informationen finden Sie unter Erstellen einer Pipeline, Aktualisieren einer Pipeline oder Aktualisieren von Pipeline-Benachrichtigungen.

  3. Testen Sie Benachrichtigungen Progressing und Complete Status, indem Sie einen Job an Elastic Transcoder senden.

Sie können Benachrichtigungen auch mit der Elastic Transcoder Transcoder-Konsole konfigurieren. Wenn Sie die Konsole verwenden, können Sie SNS Amazon-Themen erstellen, während Sie die Pipeline erstellen oder aktualisieren. Sie müssen jedoch weiterhin die SNS Amazon-Konsole verwenden oder CLI die neuen Themen abonnieren. API

Wenn Elastic Transcoder Ihnen eine Benachrichtigung über eine Statusänderung sendet, hat die in der Benachrichtigung zurückgegebene Nachricht das folgende JSON Format. Bitte beachten Sie, dass die Nachricht den Status für jede Ausgabe sowie einen Status für den Auftrag enthält:

{
   "state" : "PROGRESSING|COMPLETED|WARNING|ERROR",
   "errorCode" : "the code of any error that occurred",
   "messageDetails" : "the notification message you created in Amazon SNS",
   "version" : "API version that you used to create the job",
   "jobId" : "value of Job:Id object that Elastic Transcoder 
             returns in the response to a Create Job request",
   "pipelineId" : "value of PipelineId object 
                  in the Create Job request",
   "input" : {
      job Input settings
   },
   "outputKeyPrefix" : "prefix for file names in Amazon S3 bucket",
   "outputs": [
      {
         applicable job Outputs settings,
         "status" : "Progressing|Complete|Warning|Error"
      },
      {...}
   ],
   "playlists": [
      {
         applicable job playlists settings
      }
   ],
   "userMetadata": {
      "metadata key": "metadata value"
   }
}