Enumerar canalizaciones - Amazon Elastic Transcoder
DescripciónSolicitudesRespuestasErroresEjemplos

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

MediaConvert es un nuevo servicio de transcodificación de vídeo basado en archivos 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.

Enumerar canalizaciones

Descripción

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

Sintaxis

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 solicitud

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

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

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

Respuestas

Sintaxis

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

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

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.

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) 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

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 obtiene una lista de las canalizaciones asociadas a la cuenta de AWS actual.

Solicitud de muestra

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

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