Actualizar estado de la canalización

Descripción

Para pausar o volver a activar una canalización, de modo que esta deje de procesar tareas o reinicie el procesamiento, actualice el estado de la canalización. Envíe una solicitud POST al recurso /2012-09-25/pipelines/pipelineId/status.

Cambiar el estado de la canalización es útil si desea cancelar una o varias tareas. No se pueden cancelar las tareas una vez que Elastic Transcoder ha comenzado a procesarlas; si pone en pausa la canalización a la que envió las tareas, dispondrá de más tiempo para obtener los ID de las tareas que desea cancelar, así como para enviar una solicitud Delete Job.

Solicitudes

Sintaxis

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

Parámetros de solicitud

Esta operación toma el siguiente parámetro de solicitud.

pipelineId

Identificador de la canalización que desea pausar o volver a activar.

Encabezados de solicitud

Esta operación solo usa encabezados de solicitud que sean comunes para todas las operaciones. Para obtener información acerca de los encabezados de solicitudes comunes, consulte Contenido de los encabezados HTTP.

Cuerpo de la solicitud

La cadena JSON del cuerpo de solicitud contiene el siguiente objeto.

Estado

El nuevo estado de la canalización:

• Active: habilita la canalización, por lo que comienza a procesar tareas.

• Paused: deshabilita la canalización, por lo que deja de procesar tareas.

Respuestas

Sintaxis

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

Encabezados de respuesta

Esta operación solo usa encabezados de respuesta que sean comunes a la mayoría de las respuestas. Para obtener información acerca de los encabezados de respuestas comunes, consulte Respuestas HTTP.

Cuerpo de respuesta

Al actualizar el estado de una canalización, Elastic Transcoder devuelve los valores que especificó en la solicitud. Para obtener más información, consulte Cuerpo de la solicitud.

Errores

Para obtener información acerca de los mensajes de error y las excepciones en Elastic Transcoder, consulte Gestión de errores en Elastic Transcoder.

Ejemplo

La siguiente solicitud de ejemplo habilita la canalización que tiene el ID 1111111111111-abcde1.

Solicitud de muestra

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

Respuesta de ejemplo

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