Mettre à jour un pipeline - Amazon Elastic Transcoder
DescriptionProcédure de mise à jour et de suppression de valeursRequêtesRéponsesErreursExemples

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.

Mettre à jour un pipeline

Description

Pour mettre à jour les paramètres d'un pipeline, envoyez une requête PUT à la ressource /2012-09-25/pipelines/pipelineId.

Important

Lorsque vous modifiez les paramètres d'un pipeline, vos changements prennent effet immédiatement. Les tâches que vous avez déjà soumises et qu'Elastic Transcoder n'a pas commencé à traiter sont affectées, en plus des tâches que vous soumettez après avoir modifié les paramètres.

Procédure de mise à jour et de suppression de valeurs

Pour mettre à jour une valeur, spécifiez la nouvelle valeur, par exemple :

"GranteeType":"Canonical"

Pour laisser une valeur inchangée, effectuez l'une des actions suivantes :

  • Spécifiez la valeur actuelle.

  • Indiquez une valeur null. Cela concerne les objets individuels (par exemple, "Role":null) et les tableaux (par exemple, "ContentConfig":null).

  • Omettez l'objet JSON de la demande. Cela concerne les objets individuels (par exemple, Role) et les tableaux (par exemple, ContentConfig).

Pour supprimer la valeur actuelle, indiquez une valeur vide. Par exemple, pour supprimer une notification, spécifiez une chaîne vide :. "Progressing":"". Pour supprimer toutes les valeurs d'un tableau, spécifiez un tableau vide :."Permissions":[].

Par exemple, si vous ne souhaitez plus recevoir une notification lorsqu'Elastic Transcoder rencontre un avertissement pendant le traitement d'une tâche, et que vous ne souhaitez pas modifier les autres paramètres de notification, vous devez spécifier les éléments suivants pourNotificationsdans la demande :

...
"Notifications":{
   "Warning":""
},
...

Requêtes

Syntaxe

PUT /2012-09-25/pipelines/pipelineId 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
{
   "Id":"pipelineId",
   "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"
}

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 UpdatePipeline. 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.

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.

État

Statut actuel du pipeline :

  • Active: Le pipeline traite des tâches.

  • Paused: Le pipeline ne traite pas actuellement les tâches.

Réponses

Syntaxe

Status: 202 Accepted
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

{
   "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 id",
   "Notifications":{
      "Progressing":"SNS topic to notify when
         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
         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.

Elastic Transcoder inclut également les avertissements suivants, le cas échéant :

(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, consultezGestion des erreurs dans Elastic Transcoder.

Exemples

L'exemple de requête suivant met à jour le pipeline comportant l'Id 1111111111111-abcde1.

Exemple de demande

PUT /2012-09-25/pipelines/1111111111111-abcde1 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
{  
   "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"
}

Exemple de réponse

Status: 202 Accepted
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
{
   "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."
      },
      {...}
   ]
}