Description Requêtes Réponses Erreurs Exemples

Réduisez les coûts et bénéficiez de davantage de fonctionnalités avec AWS Elemental MediaConvert

MediaConvert est un nouveau service de transcodage vidéo basé sur des fichiers qui fournit une suite complète de fonctionnalités de transcodage avancées, avec des tarifs à la demande à partir de 0,0075 $/minute. En savoir plus.

Vous utilisez déjà Amazon Elastic Transcoder ? La migration vers cette solution est simple MediaConvert. Pour plus d'informations, consultez cette présentation qui inclut des informations précieuses sur le processus de migration et des liens vers des ressources supplémentaires.

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 demande

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 plus d'informations, consultez Corps de la demande.

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 pas actuellement les tâches.

(Automatique) Warnings

Lorsque vous créez un pipeline qui utilise des ressources dans d'autres régions, Elastic Transcoder renvoie un ou plusieurs avertissements. Votre pipeline est toujours créé, mais les délais de traitement peuvent être accrus et entraîner des frais interrégionaux. 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 différentes régions, ce qui augmente le temps de traitement des tâches dans le pipeline et peut entraîner des frais supplémentaires. Pour réduire le temps de traitement et empêcher les frais interrégionaux, utilisez la même région pour le compartiment d'entrée et le pipeline.
6001: Le compartiment ContentConfig et le pipeline se trouvent dans différentes régions, ce qui augmente le temps de traitement des tâches dans le pipeline et peut entraîner des frais supplémentaires. Pour réduire le temps de traitement et empêcher les frais interrégionaux, utilisez la même région pour le compartiment ContentConfig et le pipeline.
6002: Le compartiment ThumbnailConfig et le pipeline se trouvent dans différentes régions, ce qui augmente le temps de traitement des tâches dans le pipeline et peut entraîner des frais supplémentaires. Pour réduire le temps de traitement et empêcher les frais interrégionaux, utilisez la même région pour le compartiment ThumbnailConfig et le pipeline.
6003: La rubrique de notification SNS pour les événements progressifs et le pipeline se trouve dans différentes régions, ce qui augmente le temps de traitement des tâches dans le pipeline et peut entraîner des frais supplémentaires. Pour réduire le temps de traitement et empêcher les frais interrégionaux, utilisez la même région pour la rubrique de notification SNS et le pipeline.
6004: La rubrique de notification SNS pour les événements d'avertissement et le pipeline se trouve dans différentes régions, ce qui augmente le temps de traitement des tâches dans le pipeline et peut entraîner des frais supplémentaires. Pour réduire le temps de traitement et empêcher les frais interrégionaux, utilisez la même région pour la rubrique de notification SNS et le pipeline.
6005: La rubrique de notification SNS pour les événements d'achèvement et le pipeline se trouve dans différentes régions, ce qui augmente le temps de traitement des tâches dans le pipeline et peut entraîner des frais supplémentaires. Pour réduire le temps de traitement et empêcher les frais interrégionaux, utilisez la même région pour la rubrique de notification SNS et le pipeline.
6006: La rubrique de notification SNS pour les événements d'erreur et le pipeline se trouve dans différentes régions, ce qui augmente le temps de traitement des tâches dans le pipeline et peut entraîner des frais supplémentaires. Pour réduire le temps de traitement et empêcher les frais interrégionaux, utilisez la même région pour la rubrique de notification SNS et le pipeline.
6007: La clé AWS KMS et le compartiment ContentConfig spécifiés pour ce pipeline se trouvent dans différentes régions, 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 compartiment ContentConfig.
6008: La clé AWS KMS et le compartiment ThumbnailConfig spécifiés pour ce pipeline se trouvent dans différentes régions, 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 compartiment ThumbnailConfig.

Erreurs

Pour plus d'informations sur les exceptions et les messages d'erreur Elastic Transcoder, consultezGestion 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."
      },
      {...}
   ]
}

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Opérations de pipeline

Répertorier les pipelines