Avviso di fine del supporto: il 13 novembre 2025, il supporto per Amazon Elastic Transcoder AWS verrà interrotto. Dopo il 13 novembre 2025, non potrai più accedere alla console Elastic Transcoder o alle risorse Elastic Transcoder.
[Per ulteriori informazioni sulla transizione a, consulta questo post del blog AWS Elemental MediaConvert.](https://aws.amazon.com/blogs/media/how-to-migrate-workflows-from-amazon-elastic-transcoder-to-aws-elemental-mediaconvert/)
Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Effettuare richieste HTTP a Elastic Transcoder
Le richieste REST di Elastic Transcoder sono richieste HTTPS come definito nella RFC 2616. [(Per ulteriori informazioni, vai a http://www.ietf. org/rfc/rfc](http://www.ietf.org/rfc/rfc2616.txt)2616.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](operations-pipelines.md), [Operazioni di processo](operations-jobs.md) e [Operazioni relative ai set di impostazioni](operations-presets.md).
Una tipica azione REST consiste nell'inviare una richiesta HTTPS a Elastic Transcoder e attendere la risposta. Come qualsiasi richiesta HTTP, una richiesta REST a Elastic Transcoder contiene un metodo di richiesta, un URI, intestazioni di richiesta e talvolta una stringa di query o un corpo della richiesta. La risposta contiene un codice di stato HTTP, intestazioni di risposta e talvolta un corpo di risposta.
**Topics**
+ [Contenuti nell'intestazione HTTP](#http-request-header)
+ [Corpo della richiesta HTTP](#http-request-body)
+ [Risposte HTTP](#http-response-header)
## 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 risorse. Il valore deve essere un determinato endpoint regionale. Ti consigliamo di utilizzare lo stesso endpoint per i bucket Amazon S3 e per le pipeline e i job Elastic Transcoder. Se utilizzi endpoint diversi, dovrai sostenere costi aggiuntivi per il trasferimento dei dati tra la regione che contiene i bucket Amazon S3 e la regione 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, vai alla sezione [Regioni ed endpoints del](https://docs.aws.amazon.com/general/latest/gr/rande.html#elastictranscoder_region) Amazon Web *Services* General Reference.
Per ulteriori informazioni sulle tariffe interregionali, consulta i prezzi per il trasferimento dei dati nei prezzi di [Amazon S3](https://aws.amazon.com/s3/pricing/).
**x-amz-date o data (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](signing-requests.md).
**Content-Type (Condizionale)**
Specifica il formato JSON e la versione, ad esempio `Content-Type: application/x-amz-json-1.0`.
Condizione: Obbligatoria per le richieste POST.
**Content-Length (Condizionale)**
La lunghezza del messaggio (senza le intestazioni) secondo la specifica RFC 2616.
Condizione: necessaria 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 azioni dell'API Elastic Transcoder richiedono l'inclusione di dati in formato JSON nel corpo della richiesta. Il JSON è conforme allo schema Elastic Transcoder.
**Nota**
I valori JSON nel corpo della richiesta sono stringhe.
**Example 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 azioni dell'API Elastic Transcoder includono dati in formato JSON nella risposta. Il 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)](error-handling.md#api-error-codes).
Tipo: stringa
**x-amzn- RequestId**
Un valore creato da Elastic Transcoder che identifica in modo univoco la tua richiesta, ad esempio K2 07N97 Q9ASUAAJG. QH8 DNOU9 FNA2 GDLL8 OBVV4 KQNSO5 AEMVJF66 Se hai un problema con Elastic Transcoder, AWS può utilizzare questo valore per risolvere il problema. Ti consigliamo di registrare tali valori.
Tipo: stringa
**Content-Length**
La lunghezza in byte del corpo della risposta.
Tipo: stringa
**Data**
La data e l'ora in cui Elastic Transcoder ha risposto, ad esempio,. `Sun, 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.
Tipo: stringa