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.

Lire un pipeline

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.

Corps de la demande

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.

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.

Elastic Transcoder inclut également les valeurs et 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

Statut 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: 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 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, consultez.Gestion des erreurs dans Elastic Transcoder.

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."
      },
      {...}
   ]
}

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

Répertorier les pipelines

Mettre à jour un pipeline