Economize custos e obtenha mais recursos com AWS Elemental MediaConvert
MediaConvert é um novo serviço de transcodificação de vídeo baseado em arquivos que fornece um conjunto abrangente de recursos avançados de transcodificação, com tarifas sob demanda a partir de 0,0075 USD por minuto. Leia mais
Já usa o Amazon Elastic Transcoder? É simples migrar para o. MediaConvert Para obter mais informações, consulte esta visão geral
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 pipeline
Descrição
Para atualizar as configurações de um pipeline, envie uma solicitação PUT para o recurso /2012-09-25/pipelines/
pipelineId
.
Importante
Quando você altera as configurações de pipeline, as alterações entram em vigor imediatamente. Os trabalhos já enviados que o Elastic Transcoder não começou a processar são afetados, além daqueles que você enviar depois de alterar as configurações.
Como atualizar e excluir valores
Para atualizar um valor, especifique o novo valor, por exemplo:
"GranteeType":"Canonical"
Para deixar um valor inalterado, siga um destes procedimentos:
Especifique o valor atual.
Especifique um valor nulo. Isso se aplica a objetos individuais (por exemplo,
"Role":null
) e a arrays (por exemplo,"ContentConfig":null
).Omita o objeto JSON da solicitação. Isso se aplica a objetos individuais, por exemplo,
Role
, e a arrays, por exemplo,ContentConfig
.
Para excluir o valor atual, especifique um valor vazio. Por exemplo, para excluir uma notificação, especifique uma string vazia: "Progressing":""
. Para excluir todos os valores em uma matriz, especifique uma matriz vazia: "Permissions":[]
.
Por exemplo, se você não quiser mais ser notificado quando o Elastic Transcoder encontrar um aviso ao processar um trabalho e não quiser alterar nenhuma das demais configurações de notificação, especifique o seguinte para na solicitação:
... "Notifications":{ "Warning":"" }, ...
Solicitações
Sintaxe
PUT /2012-09-25/pipelines/
pipelineId
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
{ "Id":"pipelineId
", "Name":"pipeline name
", "InputBucket":"Amazon S3 bucket that contains files to transcode and graphics to use as watermarks
", "OutputBucket":"Use this, or use ContentConfig:Bucket plus ThumbnailConfig:Bucket
", "Role":"IAM role ARN
", "AwsKmsKeyArn":"AWS-KMS key arn of the AWS-KMS key you want to use with this pipeline
", "Notifications":{ "Progressing":"SNS topic to notify when Elastic Transcoder has started to process the job
", "Complete":"SNS topic to notify when Elastic Transcoder has finished processing the job
", "Warning":"SNS topic to notify when Elastic Transcoder encounters a warning condition
" "Error":"SNS topic to notify when Elastic Transcoder encounters an error condition
" }, "ContentConfig":{ "Bucket":"Use this plus ThumbnailConfig:Bucket, or use OutputBucket
", "Permissions":[ { "GranteeType":"Canonical|Email|Group", "Grantee":"AWS user ID or CloudFront origin access identity
"| "registered email address for AWS account
"| AllUsers|AuthenticatedUsers|LogDelivery", "Access":[ "Read|ReadAcp|WriteAcp|FullControl", ... ] }, {...} ], "StorageClass":"Standard|ReducedRedundancy" }, "ThumbnailConfig":{ "Bucket":"Use this plus ContentConfig:Bucket, or use OutputBucket
", "Permissions":[ { "GranteeType":"Canonical|Email|Group", "Grantee":"AWS user ID or CloudFront origin access identity
"| "registered email address for AWS account
"| AllUsers|AuthenticatedUsers|LogDelivery", "Access":[ "Read|ReadAcp|WriteAcp|FullControl", ... ] }, {...} ], "StorageClass":"Standard|ReducedRedundancy" }, "Status":"Active|Paused" }
Parâmetros de solicitação
Essa operação não usa parâmetros de solicitação.
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 os objetos de entrada para a operação UpdatePipeline
. Para obter mais informações sobre os objetos de entrada, consulte Configurações especificadas ao criar um pipeline do Elastic Transcoder.
- Id
-
Identificador do pipeline. Você usa esse valor para identificar o pipeline no qual deseja realizar uma variedade de operações, por exemplo, criar um trabalho ou uma predefinição.
- Status
-
O status atual do pipeline:
Active
: o pipeline está processando trabalhos.Paused
: no momento, o pipeline não está processando trabalhos.
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 new pipeline
", "Name":"pipeline name
", "InputBucket":"Amazon S3 bucket that contains files to transcode and graphics to use as watermarks
", "OutputBucket":"Use this, or use ContentConfig:Bucket plus ThumbnailConfig:Bucket
", "Role":"IAM role ARN
", "AwsKmsKeyArn":"AWS-KMS key id
", "Notifications":{ "Progressing":"SNS topic to notify when when Elastic Transcoder has started to process the job
", "Complete":"SNS topic to notify when Elastic Transcoder has finished processing the job
", "Warning":"SNS topic to notify when when Elastic Transcoder encounters a warning condition
", "Error":"SNS topic to notify when Elastic Transcoder encounters an error condition
" }, "ContentConfig":{ "Bucket":"Use this plus ThumbnailConfig:Bucket, or use OutputBucket
", "Permissions":[ { "GranteeType":"Canonical|Email|Group", "Grantee":"AWS user ID or CloudFront origin access identity
"| "registered email address for AWS account
| AllUsers|AuthenticatedUsers|LogDelivery", "Access":[ "Read|ReadAcp|WriteAcp|FullControl", ... ] }, {...} ], "StorageClass":"Standard|ReducedRedundancy" }, "ThumbnailConfig":{ "Bucket":"Use this plus ContentConfig:Bucket, or use OutputBucket
", "Permissions":[ { "Access":[ "Read|ReadAcp|WriteAcp|FullControl", ... ], "Grantee":"AWS user ID or CloudFront origin access identity
"| "registered email address for AWS account
| AllUsers|AuthenticatedUsers|LogDelivery", "GranteeType":"Canonical|Email|Group" }, {...} ], "StorageClass":"Standard|ReducedRedundancy" }, "Status":"Active|Paused", "(Automático) Avisos": [ { "Code": "6000|6001|6002|6003|6004|6005|6006|6007|6008", "Message": "The code message
" }, {...} ] }
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ê cria um pipeline, o Elastic Transcoder retorna os valores especificados na solicitação. Para obter mais informações, consulte Corpo da solicitação.
O Elastic Transcoder também inclui os seguintes avisos, se aplicáveis:
(Automático) Avisos
Quando você cria um pipeline que usa recursos em outras regiões, o Elastic Transcoder retorna um ou mais avisos. Seu pipeline ainda será criado, mas pode apresentar tempos de processamento aumentados e incorrer em cobranças entre regiões. Os avisos estão no seguinte formato:
- Código
-
Mensagem — a mensagem associada ao código do aviso.
Veja a seguir uma lista de códigos de aviso válidos e suas mensagens:
- 6000
-
O bucket de entrada e o pipeline estão em regiões diferentes, o que aumenta o tempo de processamento para os trabalhos no pipeline e pode resultar em custos adicionais. Para diminuir o tempo de processamento e evitar cobranças entre regiões, use a mesma região para o bucket de entrada e o pipeline.
- 6001
-
O bucket ContentConfig e o pipeline estão em regiões diferentes, o que aumenta o tempo de processamento para os trabalhos no pipeline e pode resultar em custos adicionais. Para diminuir o tempo de processamento e evitar cobranças entre regiões, use a mesma região para o bucket ContentConfig e o pipeline.
- 6002
-
O bucket ThumbnailConfig e o pipeline estão em regiões diferentes, o que aumenta o tempo de processamento para os trabalhos no pipeline e pode resultar em custos adicionais. Para diminuir o tempo de processamento e evitar cobranças entre regiões, use a mesma região para o bucket ThumbnailConfig e o pipeline.
- 6003
-
O tópico de notificação do SNS para eventos de progresso e o pipeline estão em regiões diferentes, o que aumenta o tempo de processamento para as tarefas no pipeline e pode resultar em custos adicionais. Para diminuir o tempo de processamento e evitar cobranças entre regiões, use a mesma região para o tópico de notificação do SNS e o pipeline.
- 6004
-
O tópico de notificação do SNS para eventos de aviso e o pipeline estão em regiões diferentes, o que aumenta o tempo de processamento para as tarefas no pipeline e pode resultar em custos adicionais. Para diminuir o tempo de processamento e evitar cobranças entre regiões, use a mesma região para o tópico de notificação do SNS e o pipeline.
- 6005
-
O tópico de notificação do SNS para eventos de conclusão e o pipeline estão em regiões diferentes, o que aumenta o tempo de processamento para as tarefas no pipeline e pode resultar em custos adicionais. Para diminuir o tempo de processamento e evitar cobranças entre regiões, use a mesma região para o tópico de notificação do SNS e o pipeline.
- 6006
-
O tópico de notificação do SNS para eventos de erro e o pipeline estão em regiões diferentes, o que aumenta o tempo de processamento para as tarefas no pipeline e pode resultar em custos adicionais. Para diminuir o tempo de processamento e evitar cobranças entre regiões, use a mesma região para o tópico de notificação do SNS e o pipeline.
- 6007
-
A chave do AWS KMS e o bucket ContentConfig especificados para esse pipeline estão em regiões diferentes, o que faz com que as saídas que usam o modo de criptografia s3-aws-kms falhem. Para usar o modo de criptografia s3-aws-kms, use a mesma região para a chave do KMS e o bucket ContentConfig.
- 6008
-
A chave do AWS KMS e o bucket ThumbnailConfig especificados para esse pipeline estão em regiões diferentes, o que faz com que as saídas que usam o modo de criptografia s3-aws-kms falhem. Para usar o modo de criptografia s3-aws-kms, use a mesma região para a chave do KMS e o bucket ThumbnailConfig.
Erros
Para obter mais informações sobre exceções e mensagens de erro do Elastic Transcoder, consulte Tratamento de erros no Elastic Transcoder.
Exemplos
O exemplo de solicitação a seguir atualiza o pipeline cujo ID é 1111111111111-abcde1
.
Exemplo de solicitação
PUT /2012-09-25/pipelines/1111111111111-abcde1 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
{ "Id":"1111111111111-abcde1" "Name":"Default", "InputBucket":"salesoffice.example.com-source", "OutputBucket":"salesoffice.example.com-output", "Role":"arn:aws:iam::123456789012:role/Elastic_Transcoder_Default_Role", "AwsKmsKeyArn":"base64 encoded key from KMS
", "Notifications":{ "Progressing":"", "Complete":"", "Warning":"", "Error":"arn:aws:sns:us-east-1:111222333444:ET_Errors" }, "ContentConfig":{ "Bucket":"salesoffice.example.com-public-promos", "Permissions":[ { "GranteeType":"Email", "Grantee":"marketing-promos@example.com", "Access":[ "FullControl" ] } ], "StorageClass":"Standard" }, "ThumbnailConfig":{ "Bucket":"salesoffice.example.com-public-promos-thumbnails", "Permissions":[ { "GranteeType":"Email", "Grantee":"marketing-promos@example.com", "Access":[ "FullControl" ] } ], "StorageClass":"ReducedRedundancy" }, "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", "Name":"Default", "InputBucket":"salesoffice.example.com-source", "OutputBucket":"salesoffice.example.com-output", "Role":"arn:aws:iam::123456789012:role/Elastic_Transcoder_Default_Role", "AwsKmsKeyArn":"base64 encoded key from KMS
", "Notifications":{ "Progressing":"", "Complete":"", "Warning":"", "Error":"arn:aws:sns:us-east-1:111222333444:ET_Errors" }, "ContentConfig":{ "Bucket":"salesoffice.example.com-public-promos", "Permissions":[ { "GranteeType":"Email", "Grantee":"marketing-promos@example.com", "Access":[ "FullControl" ] } ], "StorageClass":"Standard" }, "ThumbnailConfig":{ "Bucket":"salesoffice.example.com-public-promos-thumbnails", "Permissions":[ { "GranteeType":"Email", "Grantee":"marketing-promos@example.com", "Access":[ "FullControl" ] } ], "StorageClass":"ReducedRedundancy" }, "Status":"Active", "Warnings": [ { "Code": "6000", "Message": "The input bucket and the pipeline are in different regions, which increases processing time for jobs in the pipeline and can incur additional charges. To decrease processing time and prevent cross-regional charges, use the same region for the input bucket and the pipeline." }, {...} ] }