

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.

# Enumerar canalizaciones
<a name="list-pipelines"></a>

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

## Descripción
<a name="list-pipelines-description"></a>

Para obtener una lista de las canalizaciones asociadas a la cuenta de AWS actual, envíe una solicitud GET al recurso `/2012-09-25/pipelines/`.

## Solicitudes
<a name="list-pipelines-requests"></a>

### Sintaxis
<a name="list-pipelines-request-syntax"></a>

Para obtener información acerca de todas las canalizaciones asociadas a la cuenta de AWS actual, envíe la siguiente solicitud GET. 

```
GET /2012-09-25/pipelines/Ascending=true|false&
PageToken=value for accessing the next page of results HTTP/1.1
Content-Type: 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
```

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

Esta operación toma los siguientes parámetros de solicitud. Elastic Transcoder devuelve todas las canalizaciones.

**Ascendente**  
Para mostrar las canalizaciones en orden cronológico por la fecha y hora en que se enviaron, escriba `true`. Para mostrar las canalizaciones en orden cronológico inverso, escriba `false`.

**PageToken**  
Cuando Elastic Transcoder devuelva más de una página de resultados, use `PageToken` en las solicitudes `GET` posteriores para obtener cada una de las páginas de resultados sucesivas.

### Encabezados de solicitud
<a name="list-pipelines-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="list-pipelines-request-body"></a>

Esta operación no tiene un cuerpo de la solicitud.

## Respuestas
<a name="list-pipelines-responses"></a>

### Sintaxis
<a name="list-pipelines-response-syntax"></a>

```
Status: 200 OK
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
{
   "Pipelines":[
      {
         "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":[
               {
                  "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"
      },
      {...}
   ],
   "NextPageToken":value for accessing the next page of results|null
}
```

### Encabezados de respuesta
<a name="list-pipelines-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="list-pipelines-response-body"></a>

La cadena JSON del cuerpo de la respuesta devuelve los valores que especificó cuando creó las canalizaciones. Para obtener más detalles acerca de los distintos objetos, consulte [Configuración que se especifica para crear una canalización de Elastic Transcoder](pipeline-settings.md).

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.

**(Automático) NextPageToken**  
Un valor que se utiliza para acceder a la segunda página de resultados y a las siguientes, si las hubiera. Cuando las canalizaciones caben en una sola página o cuando se llega a la última página de resultados, el valor de `NextPageToken` es `null`.

## Errores
<a name="list-pipelines-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="list-pipelines-examples"></a>

La siguiente solicitud de ejemplo obtiene una lista de las canalizaciones asociadas a la cuenta de AWS actual.

### Solicitud de muestra
<a name="list-pipelines-examples-sample-request"></a>

```
GET /2012-09-25/pipelines HTTP/1.1
Content-Type: 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
```

### Respuesta de ejemplo
<a name="list-pipelines-examples-sample-response"></a>

```
Status: 200 OK
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
{
   "Pipelines":[
      {
         "Id":"1111111111111-abcde1",
         "Name":"Tokyo-Default",
         "InputBucket":"salesoffice-tokyo.example.com-source",
         "OutputBucket":"salesoffice-tokyo.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:ETS_Errors"
         },
         "ContentConfig":{
            "Bucket":"salesoffice-tokyo.example.com-public-promos",
            "Permissions":[
               {
                  "GranteeType":"Email",
                  "Grantee":"marketing-promos-tokyo@example.com",
                  "Access":[
                     "FullControl"
                  ]
               }
            ],
            "StorageClass":"Standard"
         },
         "ThumbnailConfig":{
            "Bucket":"salesoffice-tokyo.example.com-public-promos-
               thumbnails",
            "Permissions":[
               {
                  "GranteeType":"Email",
                  "Grantee":"marketing-promos-tokyo@example.com",
                  "Access":[
                     "FullControl"
                  ]
               }
            ],
            "StorageClass":"ReducedRedundancy"
         },
         "Status":"Active"
      },
      {
         "Id":"2222222222222-abcde2",
         "Name":"Amsterdam-Default",
         "InputBucket":"salesoffice-amsterdam.example.com-source",
         "OutputBucket":"salesoffice-amsterdam.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:ETS_Errors"
         },
         "ContentConfig":{
            "Bucket":"salesoffice-amsterdam.example.com-public-promos",
            "Permissions":[
               {
                  "GranteeType":"Email",
                  "Grantee":"marketing-promos-amsterdam@example.com",
                  "Access":[
                     "FullControl"
                  ]
               }
            ],
            "StorageClass":"Standard"
         },
         "ThumbnailConfig":{
            "Bucket":"salesoffice-amsterdam.example.com-public-promos-
               thumbnails",
            "Permissions":[
               {
                  "GranteeType":"Email",
                  "Grantee":"marketing-promos-amsterdam@example.com",
                  "Access":[
                     "FullControl"
                  ]
               }
            ],
            "StorageClass":"ReducedRedundancy"
         },
         "Status":"Active"
      }
   ]
}
```