Actualizar canalización - Amazon Elastic Transcoder
DescripciónCómo actualizar y eliminar valoresSolicitudesRespuestasErroresEjemplos

Ahorre costes y obtenga más funciones con AWS Elemental MediaConvert

MediaConvert es un servicio de transcodificación de vídeo basado en archivos más reciente que ofrece un conjunto completo de funciones de transcodificación avanzadas, con tarifas a pedido a partir de 0,0075$ por minuto. Lea más.

¿Ya utiliza Amazon Elastic Transcoder? Es fácil migrar a él. MediaConvert Para obtener más información, consulte esta descripción general, que incluye información valiosa sobre el proceso de migración y enlaces a recursos adicionales.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Actualizar canalización

Descripción

A fin de actualizar la configuración de una canalización, envíe una solicitud PUT al recurso /2012-09-25/pipelines/pipelineId.

importante

Cuando realiza cambios en la configuración de la canalización, estos surten efecto inmediatamente. Las tareas que ya ha enviado y que Elastic Transcoder no ha comenzado a procesar se ven afectadas además de las tareas que envíe después de cambiar la configuración.

Cómo actualizar y eliminar valores

Para actualizar un valor, especifique el valor nuevo, por ejemplo:

"GranteeType":"Canonical"

Para dejar un valor inalterado, lleve a cabo alguna de las siguientes operaciones:

  • Especifique el valor actual.

  • Especifique un valor nulo. Esto se aplica tanto a objetos individuales (por ejemplo, "Role":null) como a matrices (por ejemplo, "ContentConfig":null).

  • Omita el objeto JSON de la solicitud. Esto se aplica tanto a objetos individuales, por ejemplo, Role, como a matrices, por ejemplo, ContentConfig.

Para eliminar el valor actual, especifique un valor vacío. Por ejemplo, para eliminar una notificación, especifique una cadena vacía: "Progressing":"". Para eliminar todos los valores en una matriz, especifique una matriz vacía: "Permissions":[].

Por ejemplo, si ya no desea recibir una notificación cuando Elastic Transcoder reciba una advertencia al procesar una tarea y no desea cambiar ningún otro ajuste de la notificación, debe especificar lo siguiente para Notifications en la solicitud:

...
"Notifications":{
   "Warning":""
},
...

Solicitudes

Sintaxis

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 solicitud

Esta operación no usa parámetros de solicitud.

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 los objetos de entrada de la operación UpdatePipeline. Para obtener más información acerca de los objetos de entrada, consulte Configuración que se especifica para crear una canalización de Elastic Transcoder.

Id

El identificador de la canalización. Este valor se utiliza para identificar la canalización en la que se van a realizar diversas operaciones como, por ejemplo, la creación de una tarea o un elemento preestablecido.

Estado

El estado de la canalización actual:

  • Active: la canalización está procesando tareas.

  • Paused: la canalización no está procesando 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 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",
   "(Automatic) Warnings": [
      {
         "Code": "6000|6001|6002|6003|6004|6005|6006|6007|6008",
         "Message": "The code message"
      },
      {...}
   ]
}

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 crear una canalización, Elastic Transcoder devuelve los valores especificados en la solicitud. Para obtener más información, consulte Cuerpo de la solicitud.

Elastic Transcoder incluye también las siguientes advertencias, si procede:

(Automatic) Warnings

Cuando se crea una canalización que utiliza recursos de otras regiones, Elastic Transcoder devuelve una o más advertencias. Su canalización en realidad se ha creado, pero podrían haber aumentado los tiempos de procesamiento e incurrir en cargos interregionales. Las advertencias tienen el siguiente formato:

Code

Message: el mensaje asociado al código de advertencia.

A continuación se ofrece una lista de códigos de advertencia válidos y sus mensajes:

6000

El bucket de entrada y la canalización se encuentran en regiones diferentes, lo que aumenta el tiempo de procesamiento de las tareas en la canalización y puede conllevar gastos adicionales. Para reducir el tiempo de procesamiento y evitar cargos interregionales, utilice la misma región para el bucket de entrada y la canalización.

6001

El bucket de ContentConfig y la canalización se encuentran en regiones diferentes, lo que aumenta el tiempo de procesamiento de las tareas en la canalización y puede conllevar gastos adicionales. Para reducir el tiempo de procesamiento y evitar cargos interregionales, utilice la misma región para el bucket de ContentConfig y la canalización.

6002

El bucket de ThumbnailConfig y la canalización se encuentran en regiones diferentes, lo que aumenta el tiempo de procesamiento de las tareas pendientes y puede generar cargos adicionales. Para reducir el tiempo de procesamiento y evitar cargos interregionales, utilice la misma región para el bucket de ThumbnailConfig y la canalización.

6003

El tema de las notificaciones de SNS para los eventos en curso y la canalización se encuentran en regiones diferentes, lo cual aumenta el tiempo de procesamiento de las tareas pendientes y puede generar gastos adicionales. Para reducir el tiempo de procesamiento y evitar cargos interregionales, utilice la misma región para el tema de las notificaciones de SNS y la canalización.

6004

El tema de las notificaciones de SNS para los eventos de advertencia y la canalización se encuentran en regiones diferentes, lo cual aumenta el tiempo de procesamiento de las tareas pendientes y puede generar gastos adicionales. Para reducir el tiempo de procesamiento y evitar cargos interregionales, utilice la misma región para el tema de las notificaciones de SNS y la canalización.

6005

El tema de las notificaciones de SNS para los eventos de finalización y la canalización se encuentran en regiones diferentes, lo cual aumenta el tiempo de procesamiento de las tareas pendientes y puede generar gastos adicionales. Para reducir el tiempo de procesamiento y evitar cargos interregionales, utilice la misma región para el tema de las notificaciones de SNS y la canalización.

6006

El tema de las notificaciones de SNS para los eventos de error y la canalización se encuentran en regiones diferentes, lo cual aumenta el tiempo de procesamiento de las tareas pendientes y puede generar gastos adicionales. Para reducir el tiempo de procesamiento y evitar cargos interregionales, utilice la misma región para el tema de las notificaciones de SNS y la canalización.

6007

La clave de AWS KMS y el bucket de ContentConfig especificados para esta canalización se encuentran en regiones diferentes, lo que provoca un error en las salidas que utilizan el modo de cifrado s3-aws-kms. Para usar el modo de cifrado s3-aws-kms, utilice la misma región para la clave de KMS y el bucket de ContentConfig.

6008

La clave de AWS KMS y el bucket de ThumbnailConfig especificados para esta canalización se encuentran en regiones diferentes, lo que provoca un error en las salidas que utilizan el modo de cifrado s3-aws-kms. Para usar el modo de cifrado s3-aws-kms, utilice la misma región para la clave de KMS y el bucket de ThumbnailConfig.

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.

Ejemplos

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

Solicitud de muestra

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

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",
   "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."
      },
      {...}
   ]
}