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 (Amazon SNS). Amazon SNS bietet eine Vielzahl von Benachrichtigungsoptionen, darunter die Möglichkeit, Nachrichten an HTTP-Endpunkte, E-Mail-Adressen und Amazon Simple Queue Service (Amazon SQS) -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 Aufträge abgeschlossen wurden, können Sie Polling eliminieren und die Ausnahmebedingungen Limit Exceeded (HTTP-Statuscode 429), die sich manchmal aus dem Polling ergeben, treten dann nicht mehr auf.

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 die Elastic Transcoder Transcoder-API verwenden:

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

   Wenn Sie bereits Amazon SNS SNS-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 Amazon SNS SNS-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 auch die Elastic Transcoder Transcoder-Konsole verwenden, um Benachrichtigungen zu konfigurieren. Wenn Sie die Konsole verwenden, können Sie Amazon SNS SNS-Themen erstellen, während Sie die Pipeline erstellen oder aktualisieren. Sie müssen jedoch weiterhin die Amazon SNS SNS-Konsole, API oder CLI verwenden, um die neuen Themen zu abonnieren.

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"
   }
}