Elastic Transcoder に対する HTTP リクエストの作成

Elastic Transcoder REST リクエストは、RFC 2616 で定義されている HTTPS リクエストです。詳細については、http://www.ietf.org/rfc/rfc2616.txt を参照してください。このセクションでは、Elastic Transcoder REST リクエストの構造について説明します。実行できるアクションの詳細については、「パイプラインのオペレーション」、「ジョブのオペレーション」、「プリセットのオプション」を参照してください。

通常の REST アクションは、Elastic Transcoder への 1 つの HTTPS リクエストの送信と、レスポンスの待機で構成されます。すべての HTTP リクエストと同様に、Elastic Transcoder への REST リクエストにはリクエストメソッド、URI、リクエストヘッダーが含まれており、クエリ文字列またはリクエストボディが含まれている場合もあります。レスポンスには HTTP ステータスコードとレスポンスヘッダーが含まれており、レスポンス本文が含まれている場合もあります。

HTTP ヘッダーの内容

Elastic Transcoder では、HTTP リクエストのヘッダーに次の情報を入力する必要があります。

Host（必須）

リソースが作成される場所を指定する Elastic Transcoder エンドポイント。値は、リージョンの指名エンドポイントにする必要があります。Amazon S3 バケットと、Elastic Transcoder のパイプラインやジョブに対しては同じエンドポイントを使用することをお勧めします。異なるエンドポイントを使用すると、Amazon S3 バケットを含んでいるリージョンと Elastic Transcoder のエンコードが実行されるリージョンの間で転送されるデータについて追加料金が発生します。また、データ転送にかかる時間が原因で、変換結果ファイルへのアクセスが遅延される場合があります。

サポートされている Elastic Transcoder エンドポイントの一覧については、「アマゾン ウェブ サービス全般リファレンス」の「リージョンとエンドポイント」を参照してください。

リージョン間の料金の詳細については、「Amazon S3 料金表」の「データ転送料金表」を参照してください。

x-amz-date または Date（必須）

Authorization ヘッダーに含まれる署名を作成するのに使用された日付。ISO 8601 の標準形式に基づいて UTC 時間で日付を指定します (例: X-Amz-Date: 20130613T203622Z)。

x-amz-date または Date のどちらかを含める必要があります。(一部の HTTP クライアントライブラリでは、Date ヘッダーを設定することができません)。x-amz-date ヘッダーがある場合、リクエストの認証時に Date ヘッダーは無視されます。

タイムスタンプは、リクエストが受け取られた時点の AWS システム時刻の 15 分以内に入っている必要があります。このようにしないと、リクエストは RequestExpired エラーコードで失敗し、任意のユーザーがリクエストを再現できなくなります。

Authorization (必須)

リクエスト認証に必要な情報。このヘッダーの作成方法の詳細については、「リクエストへの署名」を参照してください。

Content-Type (条件付き)

JSON とバージョンを指定します (例: Content-Type: application/x-amz-json-1.0)。

条件: POST リクエストの場合は必須です。

Content-Length (条件付き)

RFC 2616 に基づくメッセージの長さ (ヘッダーなし)。

条件: リクエストボディ自体に情報が含まれる場合、必須です (このヘッダーは、ほとんどのツールキットで自動的に追加されます)。

次に、パイプラインを作成する HTTP リクエストのサンプルヘッダーの例を示します。

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 リクエストボディ

多くの Elastic Transcoder API アクションでは、リクエストの本文に JSON 形式のデータを含める必要があります。JSON は Elastic Transcoder スキーマに準拠しています。

注記

リクエストボディの JSON 値は文字列です。

例 リクエスト

次のサンプルリクエストでは、簡単な JSON ステートメントを使用して、sample.mp4 という名前のファイルを変換するジョブを作成し、そのファイルを sams-birthday.mp4 として保存します。

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 レスポンス

すべての Elastic Transcoder API アクションにおいて、レスポンスに JSON 形式のデータが含まれます。JSON は Elastic Transcoder スキーマに準拠しています。

注記

レスポンスの JSON 値は文字列です。

HTTP レスポンスの重要なヘッダーと、それらをアプリケーション内で扱う方法 (該当する場合) を示します。

HTTP/1.1

このヘッダーにはステータスコードが続きます。ステータスコード 200 は、オペレーションが成功したことを示します。エラーコードについては、「API のエラーコード（クライアントエラーとサーバーエラー）」を参照してください。

型: 文字列

x-amzn-RequestId

Elastic Transcoder によって作成された値であり、リクエストを一意に識別します (例: K2QH8DNOU907N97FNA2GDLL8OBVV4KQNSO5AEMVJF66Q9ASUAAJG)。Elastic Transcoder で問題が発生した場合、AWS ではこの値を使用して、問題をトラブルシューティングします。これらの値をログに記録することをお勧めします。

型: 文字列

Content-Length

レスポンス本文の長さ (バイト単位)。

型: 文字列

日付

Elastic Transcoder が応答した日時 (例: Sun, 25 Mar 2012 12:00:00 GMT)。日付の形式は、RFC 2616 のセクション 3.3 で指定されている完全な日付の形式のいずれかであることが必要です。

型: 文字列