Aggiornamento dello stato di una pipeline

Descrizione

Per sospendere o riattivare una pipeline, in modo che questa interrompa o riavvii i processi di elaborazione, aggiornare il suo stato. Inviare una richiesta POST alla risorsa /2012-09-25/pipelines/pipelineId/status.

La modifica dello stato della pipeline risulta utile per annullare uno o più processi. Non è possibile annullare i processi dopo che Elastic Transcoder ha iniziato l'elaborazione; se si sospende la pipeline alla quale sono stati inviati i processi, si avrà il tempo per ottenere gli ID processo da annullare e inviare un processo.Delete Job.

Richieste

Sintassi

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

Parametri della richiesta

Questa operazione prende il seguente parametro di richiesta.

ID pipeline

L'identificatore della pipeline da sospendere o riattivare.

Intestazioni di richiesta

Questa operazione utilizza solo le intestazioni richiesta che sono comuni a tutte le operazioni. Per informazioni sulle intestazioni richiesta comuni, consulta Contenuti nell'intestazione HTTP.

Corpo della richiesta

La stringa JSON nel corpo della richiesta contiene il seguente oggetto.

Stato

Il nuovo stato della pipeline:

• Active: abilita la pipeline, in modo che inizi l'elaborazione dei processi.

• Paused: disabilita la pipeline, in modo che interrompa l'elaborazione dei processi.

Risposte

Sintassi

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

Intestazioni di risposta

Questa operazione utilizza solo le intestazioni di risposta che sono comuni alla maggior parte delle risposte. Per informazioni sulle intestazioni di risposta comuni, consulta Risposte HTTP.

Corpo della risposta

Quando si aggiorna lo stato per una pipeline, Elastic Transcoder restituisce i valori specificati nella richiesta. Per ulteriori informazioni, consultare Corpo della richiesta.

Errori

Per informazioni sulle eccezioni e i messaggi di errore di Elastic Transcoder, consultaGestione degli errori in Elastic Transcoder.

Esempio

La richiesta di esempio seguente abilita la pipeline con ID 1111111111111-abcde1.

Richiesta di esempio

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

Risposta di esempio

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