Lesen einer Pipeline

Beschreibung

Um detaillierte Informationen über eine Pipeline abzurufen, senden Sie eine GET-Anfrage an die Ressource /2012-09-25/pipelines/pipelineId.

Anforderungen

Syntax

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

Anfrageparameter

Diese Operation akzeptiert die folgenden Anforderungsparameter.

PipelineID

Die ID der Pipeline, für die Sie detaillierte Informationen abrufen möchten.

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

Dieser Vorgang besitzt keinen Anforderungstext.

Antworten

Syntax

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

Die JSON-Zeichenfolge im Antworttext gibt die Werte zurück, die Sie beim Erstellen der Pipeline angegeben haben. Weitere Informationen zu den einzelnen Objekten finden Sie unter Einstellungen, die Sie beim Erstellen einer Elastic Transcoder-Pipeline festlegen.

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

(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

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

Beispielanforderung

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

Beispielantwort

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":"[e-mail]",
               "Access":[
                  "FullControl"
               ]
            }
         ],
         "StorageClass":"Standard"
      },
      "ThumbnailConfig":{
         "Bucket":"salesoffice.example.com-public-promos-thumbnails",
         "Permissions":[
            {
               "GranteeType":"Email",
               "Grantee":"[e-mail]",
               "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."
      },
      {...}
   ]
}