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? Die Migration darauf ist einfach. MediaConvert Weitere Informationen finden Sie in dieser Übersicht
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
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":"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." }, {...} ] }