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.
# Lire un pipeline
**Topics**
+ [Description](#get-pipeline-description)
+ [Requêtes](#get-pipeline-requests)
+ [Réponses](#get-pipeline-responses)
+ [Erreurs](#get-pipeline-response-errors)
+ [Exemples](#get-pipeline-examples)
## Description
Pour obtenir des informations détaillées sur un pipeline, envoyez une demande GET à la ressource `/2012-09-25/pipelines/pipelineId`.
## Requêtes
### Syntaxe
```
GET /2012-09-25/pipelines/pipelineId 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
```
### Paramètres de demande
Cette opération prend le paramètre de demande suivant.
**pipelineId**
Identifiant du pipeline pour lequel vous souhaitez obtenir des informations détaillées.
### En-têtes de demande
Cette opération utilise uniquement les en-têtes de demande qui sont communs à toutes les opérations. Pour plus d'informations sur les en-têtes de demande communs, consultez [Contenu de l'en-tête HTTP](making-http-requests.md#http-request-header).
### Corps de la requête
Cette opération n'a pas de corps de demande.
## Réponses
### Syntaxe
```
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
{
"Pipeline":{
"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"
},
"(Automatique) Warnings": [
{
"Code": "6000|6001|6002|6003|6004|6005|6006|6007|6008",
"Message": "The code message"
},
{...}
]
}
```
### En-têtes de réponse
Cette opération utilise uniquement les en-têtes de réponse qui sont communs à la plupart des réponses. Pour plus d'informations sur les en-têtes de réponse communs, consultez [Réponses HTTP](making-http-requests.md#http-response-header).
### Corps de la réponse
La chaîne JSON du corps de la réponse renvoie les valeurs que vous avez spécifiées lors de la création du pipeline. Pour plus d'informations sur les objets individuels, consultez [Paramètres que vous spécifiez lorsque vous créez un pipeline Elastic Transcoder](pipeline-settings.md).
Elastic Transcoder inclut également les valeurs et les avertissements suivants, le cas échéant :
**(Automatique) Id**
Identifiant du pipeline. Vous utilisez cette valeur pour identifier le pipeline dans lequel vous souhaitez effectuer diverses opérations, par exemple la création d'une tâche ou d'un préréglage.
**(Automatique) Status**
État actuel du pipeline :
+ `Active`: Le pipeline traite des tâches.
+ `Paused`: Le pipeline ne traite actuellement aucune tâche.
#### (Automatique) Warnings
Lorsque vous créez un pipeline qui utilise des ressources d'autres régions, Elastic Transcoder renvoie un ou plusieurs avertissements. Votre pipeline est toujours créé, mais il est possible que les délais de traitement aient augmenté et que des frais interrégionaux aient été facturés. Les avertissements sont au format suivant :
**Code**
**Message** - message associé au code d'avertissement.
Voici une liste de codes d'alerte valides et leurs messages :
**6000**
Le compartiment d'entrée et le pipeline se trouvent dans des régions différentes, ce qui augmente le temps de traitement des tâches du pipeline et peut entraîner des frais supplémentaires. Pour réduire le temps de traitement et éviter les frais interrégionaux, utilisez la même région pour le compartiment d'entrée et le pipeline.
**6001**
Le ContentConfig bucket et le pipeline se trouvent dans des régions différentes, ce qui augmente le temps de traitement des tâches du pipeline et peut entraîner des frais supplémentaires. Pour réduire le temps de traitement et éviter les frais interrégionaux, utilisez la même région pour le ContentConfig compartiment et le pipeline.
**6002**
Le ThumbnailConfig bucket et le pipeline se trouvent dans des régions différentes, ce qui augmente le temps de traitement des tâches du pipeline et peut entraîner des frais supplémentaires. Pour réduire le temps de traitement et éviter les frais interrégionaux, utilisez la même région pour le ThumbnailConfig compartiment et le pipeline.
**6003**
Le sujet de notification SNS pour les événements en cours et le pipeline se situent dans différentes régions, ce qui augmente le temps de traitement des tâches du pipeline et peut entraîner des frais supplémentaires. Pour réduire le temps de traitement et éviter les frais interrégionaux, utilisez la même région pour le sujet de notification SNS et le pipeline.
**6004**
Le sujet de notification SNS pour les événements d'avertissement et le pipeline se situent dans différentes régions, ce qui augmente le temps de traitement des tâches du pipeline et peut entraîner des frais supplémentaires. Pour réduire le temps de traitement et éviter les frais interrégionaux, utilisez la même région pour le sujet de notification SNS et le pipeline.
**6005**
Le sujet de notification SNS pour les événements d'achèvement et le pipeline se situent dans différentes régions, ce qui augmente le temps de traitement des tâches du pipeline et peut entraîner des frais supplémentaires. Pour réduire le temps de traitement et éviter les frais interrégionaux, utilisez la même région pour le sujet de notification SNS et le pipeline.
**6006**
La rubrique de notification SNS pour les événements d'erreur et le pipeline se situent dans différentes régions, ce qui augmente le temps de traitement des tâches du pipeline et peut entraîner des frais supplémentaires. Pour réduire le temps de traitement et éviter les frais interrégionaux, utilisez la même région pour le sujet de notification SNS et le pipeline.
**6007**
La clé et le ContentConfig compartiment AWS KMS spécifiés pour ce pipeline se trouvent dans des régions différentes, ce qui entraîne l'échec des sorties utilisant le mode de chiffrement s3-aws-kms. Pour utiliser le mode de chiffrement s3-aws-kms, utilisez la même région pour la clé KMS et le bucket. ContentConfig
**6008**
La clé et le ThumbnailConfig compartiment AWS KMS spécifiés pour ce pipeline se trouvent dans des régions différentes, ce qui entraîne l'échec des sorties utilisant le mode de chiffrement s3-aws-kms. Pour utiliser le mode de chiffrement s3-aws-kms, utilisez la même région pour la clé KMS et le bucket. ThumbnailConfig
## Erreurs
Pour plus d'informations sur les exceptions et les messages d'erreur d'Elastic Transcoder, consultez. [Gestion des erreurs dans Elastic Transcoder](error-handling.md)
## Exemples
L'exemple de demande suivant obtient le pipeline comportant l'ID `1111111111111-abcde1`.
### Exemple de demande
```
GET /2012-09-25/pipelines/1111111111111-abcde1 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
```
### Exemple de réponse
```
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
{
"Pipeline":{
"Id":"1111111111111-abcde1",
"Name":"Default",
"InputBucket":"salesoffice.example.com-source",
"OutputBucket":"salesoffice.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:ET_Errors"
},
"ContentConfig":{
"Bucket":"salesoffice.example.com-public-promos",
"Permissions":[
{
"GranteeType":"Email",
"Grantee":"marketing-promos@example.com",
"Access":[
"FullControl"
]
}
],
"StorageClass":"Standard"
},
"ThumbnailConfig":{
"Bucket":"salesoffice.example.com-public-promos-thumbnails",
"Permissions":[
{
"GranteeType":"Email",
"Grantee":"marketing-promos@example.com",
"Access":[
"FullControl"
]
}
],
"StorageClass":"ReducedRedundancy"
},
"Status":"Active"
},
"Warnings": [
{
"Code": "6000",
"Message": "The input bucket and the pipeline are in different
regions, which increases processing time for jobs in the
pipeline and can incur additional charges. To decrease
processing time and prevent cross-regional charges, use the
same region for the input bucket and the pipeline."
},
{...}
]
}
```