Effettuare richieste HTTP a Elastic Transcoder

Secondo quanto definito dalla specifica RFC 2616, le richieste REST di Elastic Transcoder sono richieste HTTPS (per ulteriori informazioni, visita la pagina all'indirizzo http://www.ietf.org/rfc/rfc2616.txt). Questa sezione descrive la struttura di una richiesta REST di Elastic Transcoder. Per una descrizione dettagliata delle operazioni che puoi eseguire, consulta Operazioni relative alle pipeline, Operazioni di processo e Operazioni relative ai set di impostazioni.

Un'azione REST tipica consiste nell'inviare una richiesta HTTPS a Elastic Transcoder e attendere la risposta. Come qualsiasi richiesta HTTP, una richiesta REST inviata a Elastic Transcoder contiene un metodo di richiesta, un URI, le intestazioni di richiesta e a volte una stringa di query o un corpo di richiesta. La risposta contiene un codice di stato HTTP, intestazioni di risposta e talvolta un corpo di risposta.

Contenuti nell'intestazione HTTP

Elastic Transcoder richiede le seguenti informazioni nell'intestazione di una richiesta HTTP:

Host (obbligatorio)

L'endpoint Elastic Transcoder che specifica dove vengono create le tue risorse. Il valore deve essere un determinato endpoint regionale. Consigliamo di scegliere lo stesso endpoint per il bucket Amazon S3 e per le pipeline e i processi di Elastic Transcoder. L'utilizzo di diversi endpoint comporterà l'addebito di costi aggiuntivi per il trasferimento di dati tra la regione che contiene il bucket Amazon S3 e quella in cui Elastic Transcoder esegue la codifica. Inoltre, il tempo necessario per il trasferimento dei dati ritarderà l'accesso al file transcodificato.

Per un elenco degli endpoint Elastic Transcoder supportati, consulta la guidaRegioni ed endpointnella sezioneRiferimento generale di Amazon Web Services.

Per ulteriori informazioni sulle tariffe tra più regioni, consulta la pagina relativa ai prezzi di trasferimento dei dati inPrezzi di Amazon S3.

x-amz-date o Date (Obbligatorio)

La data utilizzata per creare la firma contenuta nell'intestazione Authorization. La data va specificata nel formato ISO 8601 standard, in UTC, come nell'esempio seguente: X-Amz-Date: 20130613T203622Z

È necessario includere x-amz-date o Date. (Alcune biblioteche di client HTTP non consentono di impostare l'intestazione Date). Quando un'intestazione x-amz-date è presente, il sistema ignora qualsiasi intestazione Date all'autenticazione della richiesta.

Il timestamp non deve risalire a più di 15 minuti rispetto all'ora di sistema AWS quando la richiesta viene ricevuta. In caso contrario, il tentativo di richiesta fallisce con il codice di errore RequestExpired per evitare che qualcun altro ripeta la tua richiesta.

Autorizzazione (Obbligatoria)

Le informazioni necessarie per l'autenticazione della richiesta. Per ulteriori informazioni sulla creazione di questa intestazione, consulta Firmare le richieste.

Content-Type (Condizionale)

Specifica il formato JSON e la versione, ad esempio Content-Type: application/x-amz-json-1.0.

Condizione: Obbligatoria per richieste POST.

Content-Length (Condizionale)

La lunghezza del messaggio (senza le intestazioni) secondo la specifica RFC 2616.

Condizione: Obbligatoria se il corpo della richiesta contiene informazioni (la maggior parte dei kit di strumenti aggiunge automaticamente questa intestazione).

Il seguente è un esempio di intestazione per una richiesta HTTP per la creazione di una pipeline.

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

Corpo della richiesta HTTP

Molte delle operazioni API di Elastic Transcoder richiedono l'inserimento di dati in formato JSON nel corpo della richiesta. Il documento JSON è conforme allo schema Elastic Transcoder.

Nota

I valori JSON nel corpo della richiesta sono stringhe.

Esempio Richiesta

Il seguente esempio di richiesta utilizza una semplice istruzione JSON per creare un processo che transcodifica un file denominato sample.mp4 e lo salva come 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"
}

Risposte HTTP

Tutte le operazioni API di Elastic Transcoder includono dati in formato JSON nella risposta. Il documento JSON è conforme allo schema Elastic Transcoder.

Nota

I valori JSON nella risposta sono stringhe.

Si elencano di seguito alcune intestazioni importanti nella risposta HTTP e il modo in cui vanno gestite nella tua applicazione, se possibile:

HTTP/1.1

Questa intestazione è seguita da un codice di stato. Il codice di stato 200 indica che l'operazione è riuscita. Per informazioni sui codici di errore, consulta Codici di errore API (Errori client e server).

Type: Stringa

x-amzn-RequestId

Un valore creato da Elastic Transcoder che identifica in modo univoco la tua richiesta, ad esempio K2QH8DNOU907N97FNA2GDLL8OBV4KQNSO5AEMVJF66Q9ASUAAJG. In caso di problemi con Elastic Transcoder, AWS può utilizzare questo valore per risolverli. Ti consigliamo di registrare tali valori.

Type: Stringa

Content-Length

La lunghezza in byte del corpo della risposta.

Type: Stringa

Data

La data e l'ora della risposta di Elastic Transcoder, ad esempioSun, 25 Mar 2012 12:00:00 GMT. Il formato deve essere uno dei formati di data completa indicato dal protocollo RFC 2616, sezione 3.3.

Type: Stringa