Beschreibung Aktualisieren und Löschen von Werten Anforderungen Antworten Fehler Beispiele

Sparen Sie Kosten und erhalten Sie mehr Funktionen mit AWS Elemental MediaConvert

MediaConvert ist ein neuerer dateibasierter Videotranskodierungsdienst, der eine umfassende Suite erweiterter Transcodierungsfunktionen bietet. On-Demand-Tarife beginnen bei 0,0075 USD/Minute. Lesen Sie mehr.

Verwenden Sie bereits Amazon Elastic Transcoder? Es ist einfach, darauf zu migrieren. MediaConvert Weitere Informationen finden Sie in dieser Übersicht, die wertvolle Informationen über den Migrationsprozess und Links zu weiteren Ressourcen enthält.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Aktualisieren einer Pipeline

Beschreibung

Um die Einstellungen für eine Pipeline zu aktualisieren, senden Sie eine PUT-Anfrage an die Ressource /2012-09-25/pipelines/pipelineId.

Wichtig

Wenn Sie die Pipeline-Einstellungen ändern, werden diese Änderungen sofort wirksam. Aufträge, die Sie bereits übermittelt haben und mit deren Verarbeitung von Elastic Transcoder noch nicht begonnen hat, sind zusätzlich zu den Aufträgen betroffen, die Sie nach Ändern der Einstellungen übermitteln.

Aktualisieren und Löschen von Werten

Um einen Wert zu aktualisieren, geben Sie den neuen Wert an, z. B.:

"GranteeType":"Canonical"

Um einen Wert unverändert zu lassen, führen Sie einen der folgenden Schritte aus:

Geben Sie den aktuellen Wert an.
Geben Sie einen Null-Wert an. Dies gilt für einzelne Objekte (z. B. "Role":null) und für Arrays (z. B. "ContentConfig":null).
Lassen Sie das JSON-Objekt bei der Anfrage aus. Dies gilt für einzelne Objekte (z. B. Role) und für Arrays (z. B. ContentConfig).

Um den aktuellen Wert zu löschen, geben Sie einen leeren Wert an. Um beispielsweise eine Benachrichtigung zu löschen, geben Sie eine leere Zeichenfolge an: "Progressing":""aus. Um alle Werte in einem Array zu löschen, geben Sie ein leeres Array an:"Permissions":[]aus.

Wenn Sie beispielsweise nicht mehr benachrichtigt werden möchten, wenn Elastic Transcoder bei der Verarbeitung eines Auftrags auf eine Warnung stößt, und Sie keine der anderen Benachrichtigungseinstellungen ändern möchten, würden Sie für Folgendes inNotificationsin der Anforderung:


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

Anforderungen

Syntax


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"
}

Anfrageparameter

Dieser Vorgang verwendet keine Anforderungsparameter.

Anforderungsheader

Für diesen Vorgang werden ausschließlich Anforderungs-Header verwendet, die für alle Vorgänge gelten. Weitere Informationen über allgemeine Anforderungs-Header finden Sie unter Inhalt des HTTP-Headers.

Anforderungstext

Die JSON-Zeichenfolge im Anfragetext enthält die Eingabeobjekte für die UpdatePipeline-Operation. Weitere Informationen zu den Eingabeobjekten finden Sie unter Einstellungen, die Sie beim Erstellen einer Elastic Transcoder-Pipeline festlegen.

Id

Bezeichner für die Pipeline. Sie verwenden diesen Wert, um die Pipeline zu identifizieren, in der Sie eine Vielzahl von Operationen ausführen möchten, z. B. zum Erstellen eines Jobs oder einer Voreinstellung.

Status

Der aktuelle Status der Pipeline:

Active: Die Pipeline verarbeitet Jobs.
Paused: Die Pipeline verarbeitet derzeit keine Jobs.

Antworten

Syntax


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",
   "(Automatisch) Warnungen": [
      {
         "Code": "6000|6001|6002|6003|6004|6005|6006|6007|6008",
         "Message": "The code message"
      },
      {...}
   ]
}

Antwort-Header

Für diesen Vorgang werden ausschließlich Antwort-Header verwendet, die für die meisten Antworten gelten. Weitere Informationen über allgemeine Antwort-Header finden Sie unter HTTP-Antworten.

Antworttext

Wenn Sie eine Pipeline erstellen, gibt Elastic Transcoder die Werte zurück, die Sie in der Anforderung angegeben haben. Weitere Informationen finden Sie unter Anforderungstext .

Elastic Transcoder schließt ggf. auch die folgenden Warnungen ein:

(Automatisch) Warnungen

Wenn Sie eine Pipeline erstellen, die Ressourcen in anderen Regionen verwendet, gibt Elastic Transcoder eine oder mehrere Warnungen zurück. Ihre Pipeline wird weiterhin erstellt, hat jedoch möglicherweise die Bearbeitungszeiten erhöht und überregionale Gebühren anfallen. Die Warnungen haben das folgende Format:

Code: Fehlermeldung— Die Nachricht, die mit dem Warnungscode verknüpft ist.

Im Folgenden finden Sie eine Liste gültiger Warnungscodes mit den zugehörigen Nachrichten:

6 000: Der Eingabe-Bucket und die Pipeline befinden sich in verschiedenen Regionen, was die Bearbeitungszeit für Jobs in der Pipeline erhöht und zusätzliche Gebühren anfallen kann. Um die Bearbeitungszeit zu verkürzen und überregionale Gebühren zu verhindern, verwenden Sie dieselbe Region für den Eingabe-Bucket und die Pipeline.
6001: Der ContentConfig-Bucket und die Pipeline befinden sich in verschiedenen Regionen, was die Bearbeitungszeit für Jobs in der Pipeline erhöht und zusätzliche Gebühren anfallen kann. Um die Bearbeitungszeit zu verkürzen und überregionale Gebühren zu verhindern, verwenden Sie dieselbe Region für den ContentConfig-Bucket und die Pipeline.
6002: Der thumbnailConfig-Bucket und die Pipeline befinden sich in verschiedenen Regionen, was die Bearbeitungszeit für Jobs in der Pipeline erhöht und zusätzliche Gebühren anfallen kann. Um die Bearbeitungszeit zu verkürzen und überregionale Gebühren zu verhindern, verwenden Sie dieselbe Region für den thumbnailConfig-Bucket und die Pipeline.
6003: Das Thema der SNS-Benachrichtigung für fortschreitende Ereignisse und die Pipeline befinden sich in verschiedenen Regionen, was die Bearbeitungszeit für Jobs in der Pipeline erhöht und zusätzliche Gebühren anfallen kann. Um die Bearbeitungszeit zu verkürzen und überregionale Gebühren zu verhindern, verwenden Sie dieselbe Region für das Thema SNS-Benachrichtigung und die Pipeline.
6004: Das Thema SNS Benachrichtigung für Warnereignisse und die Pipeline befinden sich in verschiedenen Regionen, was die Bearbeitungszeit für Jobs in der Pipeline erhöht und zusätzliche Gebühren anfallen kann. Um die Bearbeitungszeit zu verkürzen und überregionale Gebühren zu verhindern, verwenden Sie dieselbe Region für das Thema SNS-Benachrichtigung und die Pipeline.
6005: Das Thema SNS Benachrichtigung für Abschlussereignisse und die Pipeline befinden sich in verschiedenen Regionen, was die Bearbeitungszeit für Jobs in der Pipeline erhöht und zusätzliche Gebühren anfallen kann. Um die Bearbeitungszeit zu verkürzen und überregionale Gebühren zu verhindern, verwenden Sie dieselbe Region für das Thema SNS-Benachrichtigung und die Pipeline.
6006: Das Thema der SNS-Benachrichtigung für Fehlerereignisse und die Pipeline befinden sich in verschiedenen Regionen, was die Bearbeitungszeit für Jobs in der Pipeline erhöht und zusätzliche Gebühren anfallen kann. Um die Bearbeitungszeit zu verkürzen und überregionale Gebühren zu verhindern, verwenden Sie dieselbe Region für das Thema SNS-Benachrichtigung und die Pipeline.
6007: Der für diese Pipeline angegebene AWS KMS KMS-Schlüssel und der ContentConfig-Bucket befinden sich in verschiedenen Regionen, wodurch Ausgaben im s3-aws-kms-Verschlüsselungsmodus fehlschlagen. Um den s3-aws-kms-Verschlüsselungsmodus zu verwenden, verwenden Sie dieselbe Region für den KMS-Schlüssel und den ContentConfig-Bucket.
6008: Der für diese Pipeline angegebene AWS KMS KMS-Schlüssel und der ThumbnailConfig-Bucket befinden sich in verschiedenen Regionen, wodurch Ausgaben im s3-aws-kms-Verschlüsselungsmodus fehlschlagen. Um den s3-aws-kms-Verschlüsselungsmodus zu verwenden, verwenden Sie dieselbe Region für den KMS-Schlüssel und den thumbnailConfig-Bucket.

Fehler

Weitere Informationen über Elastic Transcoder -Ausnahmen und -Fehlermeldungen finden Sie unterUmgang mit Fehlern in Elastic Transcoderaus.

Beispiele

Mit der folgenden Beispielanfrage wird die Pipeline mit der ID 1111111111111-abcde1 aktualisiert.

Beispielanforderung


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"
}

Beispielantwort


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

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Lesen einer Pipeline

Aktualisieren des Pipelinestatus