Aktualisieren des Pipelinestatus

Beschreibung

Um eine Pipeline anzuhalten oder erneut zu aktivieren, damit die Pipeline die Verarbeitung von Aufträgen beendet bzw. fortsetzt, aktualisieren Sie den Pipelinestatus. Senden Sie eine POST-Anfrage an die Ressource /2012-09-25/pipelines/pipelineId/status.

Die Änderung des Pipelinestatus ist hilfreich, wenn Sie einen oder mehrere Aufträge stornieren möchten. Sie können keine Aufträge stornieren, nachdem Elastic Transcoder mit der Verarbeitung dieser Aufträge bereits begonnen hat. Wenn Sie die Pipeline, an die Sie die Aufträge übermittelt haben, anhalten, haben Sie mehr Zeit, die IDs der Aufträge abzurufen, die Sie stornieren möchten, und um eineDelete Jobrequest.

Anforderungen

Syntax

POST /2012-09-25/pipelines/pipelineId/status HTTP/1.1
Content-Type: application/json; charset=UTF-8
Accept: */*
Host: elastictranscoder.Elastic Transcoder endpoint.amazonaws.com:443
x-amz-date: 20130114T174952Z
Authorization: AWS4-HMAC-SHA256 
               Credential=AccessKeyID/request-date/Elastic Transcoder endpoint/elastictranscoder/aws4_request,
               SignedHeaders=host;x-amz-date;x-amz-target,
               Signature=calculated-signature
Content-Length: number of characters in the JSON string
{
   "Status":"new status for the pipeline"
}

Anfrageparameter

Diese Operation akzeptiert die folgenden Anforderungsparameter.

PipelineID

Die ID der Pipeline, die Sie anhalten oder erneut aktivieren möchten.

Anforderungsheader

Für diesen Vorgang werden ausschließlich Anforderungs-Header verwendet, die für alle Vorgänge gelten. Weitere Informationen über allgemeine Anforderungs-Header finden Sie unter Inhalt des HTTP-Headers.

Anforderungstext

Die JSON-Zeichenfolge im Anfragetext enthält das folgende Objekt.

Status

Der neue Status der Pipeline:

• Active: Aktiviert die Pipeline, sodass sie mit der Verarbeitung von Aufträgen beginnt.

• Paused: Deaktiviert die Pipeline, sodass sie die Verarbeitung von Aufträgen beendet.

Antworten

Syntax

Status: 202 Accepted
x-amzn-RequestId: c321ec43-378e-11e2-8e4c-4d5b971203e9
Content-Type: application/json
Content-Length: number of characters in the response
Date: Mon, 14 Jan 2013 06:01:47 GMT

{
   "Id":"ID for the pipeline",
   "Status":"new status for the pipeline"
}

Antwort-Header

Für diesen Vorgang werden ausschließlich Antwort-Header verwendet, die für die meisten Antworten gelten. Weitere Informationen über allgemeine Antwort-Header finden Sie unter HTTP-Antworten.

Antworttext

Wenn Sie den Status einer Pipeline aktualisieren, gibt Elastic Transcoder die Werte zurück, die Sie in der Anfrage angegeben haben. Weitere Informationen finden Sie unter Anforderungstext .

Fehler

Weitere Informationen über Elastic Transcoder und -Fehlermeldungen finden Sie unterUmgang mit Fehlern in Elastic Transcoderaus.

Beispiel

Mit der folgenden Beispielanfrage wird die Pipeline mit der ID 1111111111111-abcde1 aktiviert.

Beispielanforderung

POST /2012-09-25/pipelines/1111111111111-abcde1/status HTTP/1.1
Content-Type: application/json; charset=UTF-8
Accept: */*
Host: elastictranscoder.Elastic Transcoder endpoint.amazonaws.com:443
x-amz-date: 20130114T174952Z
Authorization: AWS4-HMAC-SHA256 
               Credential=AccessKeyID/request-date/Elastic Transcoder endpoint/elastictranscoder/aws4_request,
               SignedHeaders=host;x-amz-date;x-amz-target,
               Signature=calculated-signature
Content-Length: number of characters in the JSON string
{
   "Status":"Active"
}

Beispielantwort

Status: 202 Accepted
x-amzn-RequestId: c321ec43-378e-11e2-8e4c-4d5b971203e9
Content-Type: application/json
Content-Length: number of characters in the response
Date: Mon, 14 Jan 2013 06:01:47 GMT
{
   "Id":"1111111111111-abcde1",
   "Status":"Active"
}