Erstellen einer Pipeline - Amazon Elastic Transcoder
BeschreibungAnforderungenAntwortenFehlerBeispiele

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.

Erstellen einer Pipeline

Beschreibung

Um eine Pipeline zu erstellen, senden Sie eine POST-Anfrage an die Ressource /2012-09-25/pipelines/.

Anforderungen

Syntax

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

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 CreatePipeline-Operation. Weitere Informationen zu den Eingabeobjekten finden Sie unter Einstellungen, die Sie beim Erstellen einer Elastic Transcoder-Pipeline festlegen.

Antworten

Syntax

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

Außerdem gibt Elastic Transcoder die folgenden Werte zurück.

(Automatisch) 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.

(Automatisch) Status

Der aktuelle Status der Pipeline:

  • Active: Die Pipeline verarbeitet Jobs.

  • Paused: Die Pipeline verarbeitet derzeit keine Jobs.

(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- Der Warnungscode.

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

Es können die folgenden Warnungscodes und -nachrichten zurückgegeben werden:

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 Transcoder-Ausnahmen und -Fehlermeldungen finden Sie unterUmgang mit Fehlern in Elastic Transcoderaus.

Beispiele

Im folgenden Beispiel wird eine Pipeline mit dem Namen Default erstellt.

Beispielanforderung

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

Beispielantwort

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