Atualizar o status do pipeline - Amazon Elastic Transcoder

Aviso de fim do suporte: em 13 de novembro de 2025, o suporte para o Amazon Elastic Transcoder AWS será interrompido. Depois de 13 de novembro de 2025, você não poderá mais acessar o console do Elastic Transcoder ou os recursos do Elastic Transcoder.

Para obter mais informações sobre a transição para AWS Elemental MediaConvert, visite esta postagem do blog.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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