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
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.
Créer un pipeline
Description
Pour créer un pipeline, envoyez une demande POST à la ressource /2012-09-25/pipelines/
.
Requêtes
Syntaxe
POST /2012-09-25/pipelines HTTP/1.1 Content-Type: application/json; 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
Content-Length:number of characters in the JSON string
{ "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" } }
Paramètres de demande
Cette opération n'utilise pas les paramètres de demande.
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.
Corps de la requête
La chaîne JSON du corps de la demande contient les objets d'entrée pour l'opération CreatePipeline
. Pour en savoir plus sur les objets d'entrée, consultez Paramètres que vous spécifiez lorsque vous créez un pipeline Elastic Transcoder.
Réponses
Syntaxe
Status: 201 Created 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":[ { "Access":[ "Read|ReadAcp|WriteAcp|FullControl", ... ], "Grantee":"AWS user ID or CloudFront origin access identity
"| "registered email address for AWS account
| AllUsers|AuthenticatedUsers|LogDelivery", "GranteeType":"Canonical|Email|Group" }, {...} ], "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.
Corps de la réponse
Lorsque vous créez un pipeline, Elastic Transcoder renvoie les valeurs que vous avez spécifiées dans la demande. Pour de plus amples informations, veuillez consulter Corps de la requête.
En outre, Elastic Transcoder renvoie les valeurs suivantes.
- (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 - Code de l'avertissement.
-
Message - message associé au code d'avertissement.
Les codes et messages d'avertissement qui peuvent être renvoyés sont les suivants :
- 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
Exemples
L'exemple de demande suivant crée un pipeline nommé Default
.
Exemple de demande
POST /2012-09-25/pipelines HTTP/1.1 Content-Type: application/json; 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
Content-Length:number of characters in the JSON string
{ "Name":"Default", "InputBucket":"salesoffice.example.com-source", "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" } }
Exemple de réponse
Status: 201 Created 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", "Role":"arn:aws:iam::123456789012:role/Elastic_Transcoder_Default_Role", "AwsKmsKeyArn":"base64-encoded key from KMS
", "Notifications":{ "Complete":"", "Error":"arn:aws:sns:us-east-1:111222333444:ET_Errors", "Progressing":"", "Warning":"" }, "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." }, {...} ] }