Aviso de fin de soporte: el 13 de noviembre de 2025, AWS dejaremos de ofrecer soporte a Amazon Elastic Transcoder. Después del 13 de noviembre de 2025, ya no podrás acceder a la consola de Elastic Transcoder ni a los recursos de Elastic Transcoder.

[Para obtener más información sobre la transición a AWS Elemental MediaConvert, visite esta entrada de blog.](https://aws.amazon.com/blogs/media/how-to-migrate-workflows-from-amazon-elastic-transcoder-to-aws-elemental-mediaconvert/)

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.

# Crear canalización
<a name="create-pipeline"></a>

**Topics**
+ [Descripción](#create-pipeline-description)
+ [Solicitudes](#create-pipeline-requests)
+ [Respuestas](#create-pipeline-responses)
+ [Errores](#create-pipeline-response-errors)
+ [Ejemplos](#create-pipeline-examples)

## Descripción
<a name="create-pipeline-description"></a>

Para crear una canalización, envíe una solicitud POST al recurso `/2012-09-25/pipelines/`.

## Solicitudes
<a name="create-pipeline-requests"></a>

### Sintaxis
<a name="create-pipeline-request-syntax"></a>

```
POST /2012-09-25/pipelines 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
{
   "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"
   }
}
```

### Parámetros de la solicitud
<a name="create-pipeline-request-parameters"></a>

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

### Encabezados de solicitud
<a name="create-pipeline-request-headers"></a>

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](making-http-requests.md#http-request-header).

### Cuerpo de la solicitud
<a name="create-pipeline-request-body"></a>

La cadena JSON del cuerpo de solicitud contiene los objetos de entrada de la operación `CreatePipeline`. 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](pipeline-settings.md). 

## Respuestas
<a name="create-pipeline-responses"></a>

### Sintaxis
<a name="create-pipeline-response-syntax"></a>

```
Status: 201 Created
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

{
   "Pipeline":{
      "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 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":[
            {
               "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
<a name="create-pipeline-response-headers"></a>

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](making-http-requests.md#http-response-header).

### Cuerpo de respuesta
<a name="create-pipeline-response-body"></a>

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](#create-pipeline-request-body).

Además, Elastic Transcoder devuelve los siguientes valores.

**(Automatic) 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. 

**(Automatic) Status**  
El estado de la canalización actual:  
+ `Active`: la canalización está procesando tareas.
+ `Paused`: la canalización no está procesando tareas.

#### (Automatic) Warnings
<a name="create-pipeline-response-warnings"></a>

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**: el código de advertencia.  
**Message**: el mensaje asociado al código de advertencia.

Los códigos de advertencia y los mensajes que se pueden devolver son los siguientes:

**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 ContentConfig depósito y el oleoducto se encuentran en regiones diferentes, lo que aumenta el tiempo de procesamiento de los trabajos en proceso y puede generar cargos adicionales. Para reducir el tiempo de procesamiento y evitar cargos interregionales, utilice la misma región para el ContentConfig segmento y la canalización. 

**6002**  
El ThumbnailConfig depósito y la canalización se encuentran en regiones diferentes, lo que aumenta el tiempo de procesamiento de los trabajos en proceso y puede generar cargos adicionales. Para reducir el tiempo de procesamiento y evitar cargos interregionales, utilice la misma región para el ThumbnailConfig segmento 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 y el ContentConfig bucket de AWS KMS 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, use la misma región para la clave KMS y el bucket. ContentConfig 

**6008**  
La clave y el ThumbnailConfig bucket de AWS KMS 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, use la misma región para la clave KMS y el bucket. ThumbnailConfig 

## Errores
<a name="create-pipeline-response-errors"></a>

Para obtener información acerca de los mensajes de error y las excepciones en Elastic Transcoder, consulte [Gestión de errores en Elastic Transcoder](error-handling.md).

## Ejemplos
<a name="create-pipeline-examples"></a>

La siguiente solicitud de ejemplo crea una canalización llamada `Default`.

### Solicitud de muestra
<a name="create-pipeline-examples-sample-request"></a>

```
POST /2012-09-25/pipelines 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
{  
   "Name":"Default",
   "InputBucket":"salesoffice.example.com-source",
   "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"
   }
}
```

### Respuesta de ejemplo
<a name="create-pipeline-examples-sample-response"></a>

```
Status: 201 Created
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
{
   "Pipeline":{
     "Id":"1111111111111-abcde1",
     "Name":"Default",
     "InputBucket":"salesoffice.example.com-source",
     "Role":"arn:aws:iam::123456789012:role/Elastic_Transcoder_Default_Role",
     "AwsKmsKeyArn":"base64-encoded key from KMS",
     "Notifications":{
         "Complete":"",
         "Error":"arn:aws:sns:us-east-1:111222333444:ET_Errors",
         "Progressing":"",
         "Warning":""
      },
      "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."
      },
      {...}
   ]
}
```