Stornieren von Aufträgen

Beschreibung

Um einen Auftrag abbrechen, mit seiner Verarbeitung Elastic Transcoder noch nicht begonnen hat, senden Sie eine DELETE-Anfrage an/2012-09-25/jobs/jobIdressource. Elastic Transcoder gibt den Job möglicherweise immer noch zurück, wenn Sie eineRead Job,List Job by Pipeline, oderList Job by Statusanfordern, aber Elastic Transcoder wird die Eingabedatei nicht transcodieren, und Ihnen wird der Auftrag nicht in Rechnung gestellt.

Anmerkung

Sie können nur Aufträge mit dem Status Submitted stornieren. Um zu verhindern, dass eine Pipeline mit der Verarbeitung eines Auftrags beginnt, während Sie die Auftrags-ID abrufen, verwenden Sie Aktualisieren des Pipelinestatus, um die Pipeline vorübergehend anzuhalten.

Anforderungen

Syntax

DELETE /2012-09-25/jobs/jobId HTTP/1.1
Content-Type: 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

Anfrageparameter

Diese Operation akzeptiert die folgenden Anforderungsparameter.

jobId

Die ID des Auftrags, den Sie stornieren möchten.

Um eine Liste der Aufträge (einschließlich ihrer jobId) mit dem Status Submitted zu erhalten, verwenden Sie die API-Aktion Auflisten von Aufträgen nach Status.

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

Dieser Vorgang besitzt keinen Anforderungstext.

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

{
   "Success":"true"
}

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

Der Antworttext enthält das folgende JSON-Objekt.

Herzlichen Glückwunsch

Wenn der Auftrag erfolgreich storniert wurde, weist Success den Wert true auf.

Fehler

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

Beispiele

Mit der folgenden Beispielanfrage wird der Auftrag mit der ID 3333333333333-abcde3 storniert.

Beispielanforderung

DELETE /2012-09-25/jobs/3333333333333-abcde3 HTTP/1.1
Content-Type: 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

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
{
   "Success":"true"
}