Hinweis zum Ende des Supports: Am 13. November 2025 AWS wird der Support für Amazon Elastic Transcoder eingestellt. Nach dem 13. November 2025 können Sie nicht mehr auf die Elastic Transcoder Transcoder-Konsole oder die Elastic Transcoder Transcoder-Ressourcen zugreifen. [Weitere Informationen zur Umstellung auf finden Sie in diesem AWS Elemental MediaConvert Blogbeitrag.](https://aws.amazon.com/blogs/media/how-to-migrate-workflows-from-amazon-elastic-transcoder-to-aws-elemental-mediaconvert/) 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. # Lesen einer Pipeline **Topics** + [Beschreibung](#get-pipeline-description) + [Anforderungen](#get-pipeline-requests) + [Antworten](#get-pipeline-responses) + [Fehler](#get-pipeline-response-errors) + [Beispiele](#get-pipeline-examples) ## 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 ``` ### Anforderungsparameter Diese Operation akzeptiert die folgenden Anforderungsparameter. **Pipeline-ID** 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](making-http-requests.md#http-request-header). ### 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](making-http-requests.md#http-response-header). ### 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 angeben, wenn Sie eine Elastic Transcoder-Pipeline erstellen](pipeline-settings.md). Elastic Transcoder enthält auch die folgenden Werte und Warnungen, sofern zutreffend: **(Automatisch) Id** Bezeichner für die Pipeline. Sie verwenden diesen Wert, um die Pipeline zu identifizieren, in der Sie eine Vielzahl von Vorgängen ausführen möchten, z. B. das 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 immer noch erstellt, hat aber möglicherweise längere Bearbeitungszeiten und es fallen überregionale Gebühren an. Die Warnungen haben das folgende Format: **Code** **Nachricht** — die mit dem Warncode verknüpfte Nachricht. Im Folgenden finden Sie eine Liste gültiger Warnungscodes mit den zugehörigen Nachrichten: **6000** Der Eingabe-Bucket und die Pipeline befinden sich in unterschiedlichen Regionen, was die Verarbeitungszeit für Jobs in der Pipeline erhöht und zusätzliche Kosten anfallen können. Um die Verarbeitungszeit zu verkürzen und regionsübergreifende Gebühren zu vermeiden, sollten Sie dieselbe Region für den Eingabe-Bucket und die Pipeline verwenden. **6001** Der ContentConfig Bucket und die Pipeline befinden sich in unterschiedlichen Regionen, was die Verarbeitungszeit für Jobs in der Pipeline erhöht und zusätzliche Kosten anfallen können. Verwenden Sie dieselbe Region für den ContentConfig Bucket und die Pipeline, um die Bearbeitungszeit zu verkürzen und regionsübergreifende Gebühren zu vermeiden. **6002** Der ThumbnailConfig Bucket und die Pipeline befinden sich in unterschiedlichen Regionen, was die Bearbeitungszeit für Jobs in der Pipeline erhöht und zusätzliche Kosten anfallen können. Verwenden Sie dieselbe Region für den ThumbnailConfig Bucket und die Pipeline, um die Bearbeitungszeit zu verkürzen und regionsübergreifende Gebühren zu vermeiden. **6003** Das Thema SNS-Benachrichtigung für laufende Ereignisse und die Pipeline befinden sich in unterschiedlichen Regionen. Dadurch verlängert sich die Bearbeitungszeit für Aufträge in der Pipeline und es können zusätzliche Kosten anfallen. Um die Bearbeitungszeit zu verkürzen und regionsübergreifende Gebühren zu vermeiden, sollten Sie für das Thema SNS-Benachrichtigung und für die Pipeline dieselbe Region verwenden. **6004** Das Thema der SNS-Benachrichtigung für Warnmeldungen und die Pipeline befinden sich in unterschiedlichen Regionen. Dadurch verlängert sich die Bearbeitungszeit für Aufträge in der Pipeline und es können zusätzliche Kosten anfallen. Um die Bearbeitungszeit zu verkürzen und regionsübergreifende Gebühren zu vermeiden, sollten Sie für das Thema SNS-Benachrichtigung und für die Pipeline dieselbe Region verwenden. **6005** Das Thema SNS-Benachrichtigung für Fertigstellungsereignisse und die Pipeline befinden sich in unterschiedlichen Regionen. Dadurch verlängert sich die Bearbeitungszeit für Aufträge in der Pipeline und es können zusätzliche Kosten anfallen. Um die Bearbeitungszeit zu verkürzen und regionsübergreifende Gebühren zu vermeiden, sollten Sie für das Thema SNS-Benachrichtigung und für die Pipeline dieselbe Region verwenden. **6006** Das Thema SNS-Benachrichtigung für Fehlerereignisse und die Pipeline befinden sich in unterschiedlichen Regionen, wodurch die Verarbeitungszeit für Jobs in der Pipeline verlängert wird und zusätzliche Kosten anfallen können. Um die Bearbeitungszeit zu verkürzen und regionsübergreifende Gebühren zu vermeiden, sollten Sie für das Thema SNS-Benachrichtigung und für die Pipeline dieselbe Region verwenden. **6007** Der für diese Pipeline angegebene AWS-KMS-Schlüssel und der ContentConfig Bucket befinden sich in verschiedenen Regionen, was dazu führt, dass Ausgaben, die den s3-aws-kms-Verschlüsselungsmodus verwenden, fehlschlagen. Um den s3-aws-kms-Verschlüsselungsmodus zu verwenden, verwenden Sie dieselbe Region für den KMS-Schlüssel und den Bucket. ContentConfig **6008** Der für diese Pipeline angegebene AWS-KMS-Schlüssel und der ThumbnailConfig Bucket befinden sich in verschiedenen Regionen, was dazu führt, dass Ausgaben, die den s3-aws-kms-Verschlüsselungsmodus verwenden, fehlschlagen. Um den s3-aws-kms-Verschlüsselungsmodus zu verwenden, verwenden Sie dieselbe Region für den KMS-Schlüssel und den Bucket. ThumbnailConfig ## Fehler Informationen zu Elastic Transcoder Transcoder-Ausnahmen und Fehlermeldungen finden Sie unter. [Umgang mit Fehlern in Elastic Transcoder](error-handling.md) ## 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":"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." }, {...} ] } ```