Senden von HTTP-Anforderungen an Elastic Transcoder - Amazon Elastic Transcoder
Inhalt des HTTP-HeadersHTTP-AnforderungstextHTTP-Antworten

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

Senden von HTTP-Anforderungen an Elastic Transcoder

Elastic Transcoder REST-Anforderungen sind HTTPS-Anforderungen im Sinne von RFC 2616. (Weitere Informationen finden Sie unter http://www.ietf.org/rfc/rfc2616.txt.) In diesem Abschnitt wird die Struktur einer REST-Anforderung von Elastic Transcoder beschrieben. Eine detaillierte Beschreibung der möglichen Aktionen finden Sie unter Pipeline-Operationen, Auftragsoperationen und Operationen für Voreinstellungen.

Eine typische REST-Aktion besteht aus dem Senden einer HTTPS-Anforderung an Elastic Transcoder und dem Warten auf die Antwort. Wie alle HTTP-Anforderungen enthält auch eine REST-Anforderung an Elastic Transcoder eine Anforderungsmethode, einen URI, Anforderungs-Header und manchmal eine Abfragezeichenfolge oder einen Anforderungstext. Die Antwort enthält einen HTTP-Statuscode, Antwort-Header und manchmal auch Antworttext.

Inhalt des HTTP-Headers

Elastic Transcoder benötigt die folgenden Informationen im Header einer HTTP-Anforderung:

Host (erforderlich)

Dieser Endpunkt von Elastic Transcoder gibt an, wo die Ressourcen erstellt werden. Der Wert muss ein benannter regionaler Endpunkt sein. Wir empfehlen, für Ihre Amazon S3 S3-Buckets und Ihre Elastic Transcoder-Pipelines und -Aufträge den gleichen Endpunkt zu verwenden. Wenn Sie verschiedene Endpunkte verwenden, fallen ggf. zusätzliche Gebühren für Datenübertragungen zwischen der Region, die Ihre Amazon S3 S3-Buckets enthält, und der Region, in der Elastic Transcoder die Codierung durchführt, an. Außerdem verzögert die benötigte Zeit für die Datenübertragung den Zugriff auf die transcodierte Datei.

Eine Liste der unterstützten Elastic Transcoder Transcoder-Endpunkte finden Sie im-Regionen und -Endpunkte-Abschnitt imAllgemeine Amazon Web Services Services-Referenzaus.

Weitere Informationen zu regionsübergreifenden Gebühren finden Sie unter Datenübertragungspreise inAmazon S3 – Preiseaus.

x-amz-date oder Datum (erforderlich)

Das Datum, an dem die im Header Authorization enthaltene Signatur erstellt wurde. Geben Sie das Datum wie folgt im ISO 8601-Standardformat in UTC-Zeit an: X-Amz-Date: 20130613T203622Z.

Sie müssen entweder x-amz-date oder Date angeben. (Einige HTTP-Client-Bibliotheken lassen den Header Date nicht zu). Ist der Header x-amz-date vorhanden, ignoriert das System bei der Anforderungsauthentifizierung alle Header des Typs Date.

Bei Eingang der Anforderung muss der Zeitstempel innerhalb eines Zeitraums von 15 Minuten zur AWS-Systemzeit liegen. Ist das nicht der Fall, schlägt die Anforderung mit dem Fehlercode RequestExpired fehl, damit niemand sonst Ihre Anforderungen wiedergeben kann.

Autorisierung (erforderlich)

Die erforderlichen Informationen für die Anforderungsauthentifizierung. Weitere Informationen zum Erstellen dieses Headers finden Sie unter Signieren von Anforderungen.

Content-Type (bedingt)

Gibt JSON und die Version an, zum Beispiel Content-Type: application/x-amz-json-1.0.

Bedingung: Erforderlich bei POST-Anfragen.

Content-Length (bedingt)

Länge der Nachricht (ohne Header) gemäß RFC 2616.

Bedingung: Erforderlich, wenn der Anforderungstext selbst Informationen enthält (die meisten Toolkits fügen diesen Header automatisch hinzu).

Nachfolgend finden Sie einen Beispiel-Header für eine HTTP-Anforderung zum Erstellen einer Pipeline.

POST /2012-09-25/pipelines HTTP/1.1
host: elastictranscoder.us-east-1.amazonaws.com:443
x-amz-date: 20120116T174952Z
Authorization: AWS4-HMAC-SHA256 Credential=AccessKeyID/20120116/us-east-1/elastictranscoder/aws4_request,SignedHeaders=host;x-amz-date;x-amz-target,Signature=145b1567ab3c50d929412f28f52c45dbf1e63ec5c66023d232a539a4afd11fd9
content-type: application/x-amz-json-1.0
content-length: 231
connection: Keep-Alive

HTTP-Anforderungstext

Bei vielen API-Aktionen von Elastic Transcoder müssen Daten im JSON-Format im Anforderungstext enthalten sein. Das JSON-Format entspricht dem Elastic Transcoder Transcoder--Schema.

Anmerkung

JSON-Werte im Anforderungstext sind Zeichenfolgen.

Beispiel Anfrage

Bei der folgenden Beispielanfrage wird eine einfache JSON-Anweisung verwendet, um einen Auftrag zu erstellen, der eine Datei namens sample.mp4 transcodiert und als sams-birthday.mp4 speichert.

POST /2012-09-25/jobs HTTP/1.1
Content-Type: application/json; charset=UTF-8
Accept: */*
Host: elastictranscoder.us-east-1.amazonaws.com:443
Content-Length: 300
 
{
   "Input":{
      "Key":"sample.mp4",
      "FrameRate":"auto",
      "Resolution":"auto",
      "AspectRatio":"auto",
      "Interlaced":"auto",
      "Container":"mp4"
   },
   "OutputKeyPrefix":"family-videos/",
   "Outputs":[
      {
         "Key":"sams-birthday.mp4",
         "ThumbnailPattern":"thumbnails/sams-birthday-{count}",
         "Rotate":"0",
         "PresetId":"1351620000000-100080"
      }
   ],
   "PipelineId":"1111111111111-abcde1"
}

HTTP-Antworten

Alle API-Aktionen von Elastic Transcoder enthalten in JSON-Format in die Antwort. Das JSON-Format entspricht dem Elastic Transcoder Transcoder--Schema.

Anmerkung

JSON-Werte in der Antwort sind Zeichenfolgen.

Nachfolgend werden einige wichtige Header in der HTTP-Antwort und der Umgang mit diesen in der Anwendung (sofern verwendet) erläutert:

HTTP/1.1

Diesem Header folgt ein Statuscode. Der Statuscode 200 gibt an, dass der Vorgang erfolgreich war. Weitere Informationen zu Fehlercodes finden Sie unter API-Fehlercodes (Client- und Server-Fehler).

Type: String (Zeichenfolge)

x-amzn-RequestId

Ein von Elastic Transcoder erstellter Wert, der Ihre Anforderung eindeutig identifiziert, z. B. K2QH8DNOU907N97FNA2GDLL8OBV4KQNSO5AEMVJF66Q9ASUAAJG. Wenn ein Problem mit Elastic Transcoder auftritt, kann AWS das Problem anhand dieses Werts beheben. Wir empfehlen, diese Werte zu protokollieren.

Type: String (Zeichenfolge)

Content-Length

Die Länge des Antworttexts in Byte.

Type: String (Zeichenfolge)

Date (Datum)

Datum und Uhrzeit der Antwort von Elastic Transcoder, z. B.Sun, 25 Mar 2012 12:00:00 GMTaus. Das Datumsformat muss einem der vollständigen Datumsformate folgen, die in RFC 2616, Abschnitt 3.3 angegeben sind.

Type: String (Zeichenfolge)