Realización de solicitudes HTTP a Elastic Transcoder

Las solicitudes REST de Elastic Transcoder son solicitudes HTTPS según se define en RFC 2616. (Para obtener más información, consulte http://www.ietf.org/rfc/rfc2616.txt.) En esta sección se describe la estructura de una solicitud REST a Elastic Transcoder. Para consultar descripciones detalladas de las acciones que se pueden realizar, consulte Operaciones de las canalizaciones, Operaciones de tareas y Operaciones preestablecidas.

Una acción REST típica consiste en enviar una solicitud HTTPS a Elastic Transcoder y esperar la respuesta. Al igual que cualquier solicitud HTTP, una solicitud REST a Elastic Transcoder contiene un método de solicitud, una URI, encabezados de solicitud y, en ocasiones, una cadena de consulta o el cuerpo de la solicitud. La respuesta contiene un código de estado HTTP, encabezados de respuesta y, a veces, una respuesta.

Contenido de los encabezados HTTP

Elastic Transcoder requiere que figure la siguiente información en el encabezado de una solicitud HTTP:

Host (requerida)

El punto de conexión de Elastic Transcoder que especifica dónde se crean los recursos. El valor debe ser un punto de conexión regional con nombre. Le recomendamos que use el mismo punto de conexión para sus buckets de Amazon S3 para sus tareas y canalizaciones de Elastic Transcoder. Si usa puntos de conexión diferentes, los datos transferidos entre la región que contiene sus buckets de Amazon S3 y la región en la que Elastic Transcoder realiza la codificación pueden ocasionar gastos adicionales. Además, el tiempo necesario para la transferencia de datos retrasará el acceso al archivo transcodificado.

Para obtener una lista de los puntos de conexión de Elastic Transcoder admitidos, consulte la sección Regiones y puntos de conexión en la Referencia general de Amazon Web Services.

Para obtener más información acerca de las tarifas regionales, consulte los precios de transferencia de datos en Precios de Amazon S3.

x-amz-date o Date (requerida)

Fecha utilizada para crear la firma contenida en el encabezado de la Authorization. Especifique la fecha en formato estándar ISO 8601, hora UTC, tal y como se muestra en el ejemplo siguiente: X-Amz-Date: 20130613T203622Z,

Debe incluir x-amz-date o Date. (Algunas bibliotecas de cliente de HTTP no permiten configurar el encabezado de la Date). Cuando hay un encabezado x-amz-date presente, el sistema hace caso omiso de cualquier encabezado Date al autenticar la solicitud.

La marca de tiempo debe estar en el intervalo de 15 minutos de la hora del sistema AWS a la que se recibe la solicitud. En caso contrario, la solicitud falla y emite el código de error RequestExpired para impedir que otra persona reproduzca sus solicitudes.

Authorization (requerida)

Información necesaria para solicitar la autenticación. Para obtener más información sobre la creación de este encabezado, consulte Firma de solicitudes.

Content-Type (condicional)

Especifica JSON y la versión; por ejemplo, Content-Type: application/x-amz-json-1.0.

Condición: necesaria para las solicitudes POST.

Content-Length (condicional)

Longitud del mensaje (sin encabezados) de acuerdo con RFC 2616.

Condición: obligatoria si el texto de la solicitud contiene información (la mayoría de los kits de herramientas agregan este encabezado automáticamente).

A continuación se muestra un ejemplo de un encabezado en una solicitud HTTP para crear una canalización.

POST /2012-09-25/pipelines HTTP/1.1
host: elastictranscoder.us-east-1.amazonaws.com:443
x-amz-date: 20120116T174952Z
Authorization: AWS4-HMAC-SHA256 Credential=AccessKeyID/20120116/us-east-1/elastictranscoder/aws4_request,SignedHeaders=host;x-amz-date;x-amz-target,Signature=145b1567ab3c50d929412f28f52c45dbf1e63ec5c66023d232a539a4afd11fd9
content-type: application/x-amz-json-1.0
content-length: 231
connection: Keep-Alive

Cuerpo de la solicitud HTTP

Muchas acciones de la API de Elastic Transcoder requieren que se incluyan datos con formato JSON en el cuerpo de la solicitud. El JSON se ajusta al esquema de Elastic Transcoder.

nota

Los valores JSON del cuerpo de la solicitud son cadenas.

ejemplo Solicitud

La siguiente solicitud de ejemplo usa una declaración JSON simple para crear una tarea que realice la transcodificación de un archivo llamado sample.mp4 y la guarda como sams-birthday.mp4.

POST /2012-09-25/jobs HTTP/1.1
Content-Type: application/json; charset=UTF-8
Accept: */*
Host: elastictranscoder.us-east-1.amazonaws.com:443
Content-Length: 300
 
{
   "Input":{
      "Key":"sample.mp4",
      "FrameRate":"auto",
      "Resolution":"auto",
      "AspectRatio":"auto",
      "Interlaced":"auto",
      "Container":"mp4"
   },
   "OutputKeyPrefix":"family-videos/",
   "Outputs":[
      {
         "Key":"sams-birthday.mp4",
         "ThumbnailPattern":"thumbnails/sams-birthday-{count}",
         "Rotate":"0",
         "PresetId":"1351620000000-100080"
      }
   ],
   "PipelineId":"1111111111111-abcde1"
}

Respuestas HTTP

Todas las acciones de la API de Elastic Transcoder incluyen datos con formato JSON en la respuesta. El JSON se ajusta al esquema de Elastic Transcoder.

nota

Los valores JSON de la respuesta son cadenas.

Estos son algunos encabezados importantes en la respuesta HTTP y cómo debe controlarlos en su aplicación, si procede:

HTTP/1.1

Este encabezado viene seguido de un código de estado. El código de estado 200 indica el éxito de la operación. Para obtener información sobre los códigos de error, consulte Códigos de error de la API (errores de cliente y de servidor).

Tipo: Cadena

x-amzn-RequestId

Valor creado por Elastic Transcoder que identifica de forma inequívoca la solicitud; por ejemplo, K2QH8DNOU907N97FNA2GDLL8OBVV4KQNSO5AEMVJF66Q9ASUAAJG. Si tiene un problema con Elastic Transcoder, AWS puede utilizar este valor para solucionarlo. Recomendamos registrar estos valores.

Tipo: Cadena

Longitud del contenido

Longitud del cuerpo de la respuesta en bytes.

Tipo: Cadena

Fecha

La fecha y hora a las que Elastic Transcoder respondió; por ejemplo, Sun, 25 Mar 2012 12:00:00 GMT. El formato de la fecha debe ser uno de los formatos de fecha completa especificados por RFC 2616, sección 3.3.

Tipo: Cadena