Atualizar o status do pipeline

Descrição

Para pausar ou reativar um pipeline de modo que ele pare ou reinicie trabalhos de processamento, atualize o status do pipeline. Envie uma solicitação POST para o recurso /2012-09-25/pipelines/pipelineId/status.

A alteração do status do pipeline é útil se você deseja cancelar um ou mais trabalhos. Não é possível cancelar trabalhos depois que o Elastic Transcoder começou processá-los. Se você pausar o pipeline ao qual enviou os trabalhos, terá mais tempo para obter os IDs dos trabalhos que deseja cancelar e para enviar uma solicitação .

Solicitações

Sintaxe

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 solicitação

Esta operação aceita o seguinte parâmetro de solicitação.

pipelineId

O identificador do pipeline que você deseja pausar ou reativar.

Cabeçalhos de solicitação

Essa operação usa somente os cabeçalhos de solicitação que são comuns a todas as operações. Para informações sobre os cabeçalhos de solicitação comuns, consulte Conteúdo de cabeçalho HTTP.

Corpo da solicitação

A string JSON no corpo da solicitação contém o seguinte objeto.

Status

O novo status do pipeline:

• Active: habilitar o pipeline para iniciar trabalhos de processamento.

• Paused: desabilitar o pipeline para interromper trabalhos de processamento.

Respostas

Sintaxe

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

Cabeçalhos de resposta

Essa operação usa somente os cabeçalhos de resposta que são comuns a maioria das respostas. Para informações sobre os cabeçalhos de resposta comuns, consulte Respostas HTTP.

Corpo da resposta

Quando você atualiza o status de um pipeline, o Elastic Transcoder retorna os valores especificados na solicitação. Para obter mais informações, consulte Corpo da solicitação.

Erros

Para obter mais informações sobre exceções e mensagens de erro do Elastic Transcoder, consulte Tratamento de erros no Elastic Transcoder.

Exemplo

O exemplo de solicitação a seguir habilita o pipeline cujo ID é 1111111111111-abcde1.

Exemplo de solicitação

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

Exemplo de resposta

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