Avis de fin de support : le 13 novembre 2025, le support d'Amazon Elastic Transcoder AWS sera interrompu. Après le 13 novembre 2025, vous ne pourrez plus accéder à la console Elastic Transcoder ni aux ressources Elastic Transcoder.
Pour plus d'informations sur la transition vers AWS Elemental MediaConvert, consultez ce billet de [blog](https://aws.amazon.com/blogs/media/how-to-migrate-workflows-from-amazon-elastic-transcoder-to-aws-elemental-mediaconvert/).
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Envoi de requêtes HTTP à Elastic Transcoder
Les requêtes REST d'Elastic Transcoder sont des requêtes HTTPS telles que définies dans la RFC 2616. (Pour plus d'informations, rendez-vous sur [http://www.ietf. org/rfc/rfc](http://www.ietf.org/rfc/rfc2616.txt)2616.txt.) Cette section décrit la structure d'une requête REST Elastic Transcoder. Pour une description détaillée des actions que vous pouvez effectuer, consultez [Opérations de pipeline](operations-pipelines.md), [Opérations de tâche](operations-jobs.md) et [Opérations de préréglages](operations-presets.md).
Une action REST classique consiste à envoyer une requête HTTPS à Elastic Transcoder et à attendre la réponse. Comme toute requête HTTP, une requête REST adressée à Elastic Transcoder contient une méthode de requête, un URI, des en-têtes de requête et parfois une chaîne de requête ou un corps de requête. La réponse contient un code de statut HTTP, des en-têtes de réponse et parfois un corps de réponse.
**Topics**
+ [Contenu de l'en-tête HTTP](#http-request-header)
+ [Corps de la requête HTTP](#http-request-body)
+ [Réponses HTTP](#http-response-header)
## Contenu de l'en-tête HTTP
Elastic Transcoder requiert les informations suivantes dans l'en-tête d'une requête HTTP :
**Hôte (obligatoire)**
Le point de terminaison Elastic Transcoder qui indique où vos ressources sont créées. La valeur doit être un point de terminaison régional nommé. Nous vous recommandons d'utiliser le même point de terminaison pour vos buckets Amazon S3 et pour vos pipelines et jobs Elastic Transcoder. Si vous utilisez différents points de terminaison, vous devrez payer des frais supplémentaires pour les données transférées entre la région contenant vos buckets Amazon S3 et la région dans laquelle Elastic Transcoder effectue le codage. De plus, le temps nécessaire au transfert de données retardera l'accès au fichier transcodé.
Pour obtenir la liste des points de terminaison Elastic Transcoder pris en charge, consultez la section [Régions et points de terminaison](https://docs.aws.amazon.com/general/latest/gr/rande.html#elastictranscoder_region) du manuel *Amazon Web Services General Reference*.
Pour plus d'informations sur les frais interrégionaux, consultez la section Tarification des transferts de données dans la section Tarification [d'Amazon S3](https://aws.amazon.com/s3/pricing/).
**x-amz-date ou date (obligatoire)**
La date utilisée pour créer la signature contenue dans l'en-tête `Authorization`. Spécifiez la date au format standard ISO 8601, avec l'heure UTC, comme dans l'exemple suivant : `X-Amz-Date: 20130613T203622Z`.
Vous devez inclure soit `x-amz-date` ou `Date`. (Certaines bibliothèques client HTTP ne vous permettent pas de définir l'en-tête `Date`). Lorsqu'un en-tête `x-amz-date` est présent, le système ignore tout en-tête `Date` lors de l'authentification de la demande.
L'horodatage doit se trouver dans les 15 minutes de l'heure du système AWS de réception de la demande. Si ce n'est pas le cas, la requête échoue avec le code d'erreur `RequestExpired` pour empêcher quelqu'un d'autre de relire vos requêtes.
**Autorisation (requise)**
Les informations requises pour l'authentification de la demande. Pour plus d'informations sur la construction de cet en-tête, consultez [Signature des requêtes](signing-requests.md).
**Content-Type (Conditional)**
Spécifie JSON et la version, par exemple, `Content-Type: application/x-amz-json-1.0`.
Condition : Requis pour les requêtes POST.
**Content-Length (Conditional)**
Longueur du message (sans les en-têtes) selon la RFC 2616.
Condition : obligatoire si le corps de la demande lui-même contient des informations (la plupart des boîtes à outils ajoutent automatiquement cet en-tête).
Voici un exemple d'en-tête de demande HTTP utilisé pour créer un 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
```
## Corps de la requête HTTP
De nombreuses actions de l'API Elastic Transcoder nécessitent que vous incluiez des données au format JSON dans le corps de la requête. Le JSON est conforme au schéma Elastic Transcoder.
**Note**
Les valeurs JSON figurant dans le corps de la requête sont des chaînes.
**Example Demande**
L'exemple suivant de demande utilise une instruction JSON simple pour créer une tâche qui transcode un fichier nommé `sample.mp4` et l'enregistre en tant que `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"
}
```
## Réponses HTTP
Toutes les actions de l'API Elastic Transcoder incluent des données au format JSON dans la réponse. Le JSON est conforme au schéma Elastic Transcoder.
**Note**
Les valeurs JSON figurant dans la réponse sont des chaînes.
Voici quelques en-têtes importants dans la réponse HTTP et la façon dont vous devez les gérer dans votre application, le cas échéant :
**HTTP/1.1**
Cet en-tête est suivi d'un code d'état. Le code du statut `200` indique une opération réussie. Pour obtenir des informations sur les codes d'erreur, consultez [Codes d'erreur d'API (erreurs de client et de serveur)](error-handling.md#api-error-codes).
Type : String
**x-amzn- RequestId**
Valeur créée par Elastic Transcoder qui identifie de manière unique votre demande, par exemple, K2 QH8 DNOU9 07N97 Q9ASUAAJG. FNA2 GDLL8 OBVV4 KQNSO5 AEMVJF66 Si vous rencontrez un problème avec Elastic Transcoder, AWS peut utiliser cette valeur pour le résoudre. Nous vous recommandons de consigner ces valeurs.
Type : String
**Content-Length**
Longueur du corps de la réponse en octets.
Type : String
**Date**
La date et l'heure auxquelles Elastic Transcoder a répondu, par exemple,. `Sun, 25 Mar 2012 12:00:00 GMT` Le format de la date doit être l'un des formats de date complète spécifiés par RFC 2616, section 3.3.
Type : String