パイプラインを作成する - Amazon Elastic Transcoder
説明リクエストレスポンスエラー例

でコストを節約し、より多くの機能を取得 AWS Elemental MediaConvert

MediaConvert は、包括的な一連の高度なトランスコード機能を提供する、より新しいファイルベースのビデオトランスコードサービスで、オンデマンド料金は 1 分あたり 0.0075 USD からとなります。もっと読む。

既に Amazon Elastic Transcoder をご使用中ですか？ への移行は簡単です MediaConvert。詳細については、移行プロセスに関する貴重な情報やその他のリソースへのリンクを記載した本概要を参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

パイプラインを作成する

説明

パイプラインを作成するには、/2012-09-25/pipelines/ リソースに POST リクエストを送信します。

リクエスト

構文

POST /2012-09-25/pipelines HTTP/1.1
Content-Type: application/json; 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
Content-Length: number of characters in the JSON string
{
   "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"
   }
}

リクエストパラメータ

このオペレーションではリクエストパラメータを使用しません。

リクエストヘッダー

この操作では、すべての操作で共通のリクエストヘッダーのみ使用します。共通のリクエストヘッダーの詳細については、「HTTP ヘッダーの内容」を参照してください。

リクエスト本文

リクエストボディの JSON 文字列には、CreatePipeline オペレーションの入力オブジェクトが含まれます。入力オブジェクトの詳細については、「Elastic Transcoder パイプラインの作成時に指定する設定」を参照してください。

レスポンス

構文

Status: 201 Created
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":[
            {
               "Access":[
                  "Read|ReadAcp|WriteAcp|FullControl",
                  ...
               ],
               "Grantee":"AWS user ID or CloudFront origin access identity"|
                         "registered email address for AWS account|
                         AllUsers|AuthenticatedUsers|LogDelivery",
               "GranteeType":"Canonical|Email|Group"
            },
            {...}
         ],
         "StorageClass":"Standard|ReducedRedundancy"
      },
      "Status":"Active|Paused"
   },
   "(自動) Warnings": [
      {
         "Code": "6000|6001|6002|6003|6004|6005|6006|6007|6008", 
         "Message": "The code message"
      },
      {...}
   ]
}

レスポンスヘッダー

この操作はほとんどのレスポンスに共通のレスポンスヘッダーのみを使用します。共通のレスポンスヘッダーの詳細については、「HTTP レスポンス」を参照してください。

レスポンス本文

パイプラインを作成すると、リクエストで指定した値が Elastic Transcoder によって返されます。詳細については、「リクエスト本文」を参照してください。

また、以下の値も Elastic Transcoder によって返されます。

(自動) Id

パイプラインの識別子。この値を使用して、ジョブやプリセットの作成など、さまざまな操作を実行するパイプラインを特定します。

(自動) Status

パイプラインの現在のステータス:

  • Active: パイプラインでジョブが処理されています。

  • Paused: 現在、パイプラインでジョブが処理されていません。

(自動) Warnings

他のリージョンでリソースを使用するパイプラインを作成すると、Elastic Transcoder により 1 つ以上の警告が返されます。パイプラインは作成されますが、処理時間が長くなりリージョン間の料金が発生する可能性があります。警告は次の形式になります。

CodeCode — 警告コード。

Message – 警告コードに関連付けられたメッセージ。

返すことができる警告コードとメッセージは次のとおりです。

6000

入力バケットとパイプラインが異なるリージョンに存在するため、パイプライン内のジョブの処理時間が長くなり、追加料金が発生する可能性があります。処理時間を短縮し、リージョン間の料金の発生を回避するには、入力バケットとパイプラインに同じリージョンを使用してください。

6001

ContentConfig バケットとパイプラインが異なるリージョンに存在するため、パイプライン内のジョブの処理時間が長くなり、追加料金が発生する可能性があります。処理時間を短縮し、リージョン間の料金の発生を回避するには、ContentConfig バケットとパイプラインに同じリージョンを使用してください。

6002

ThumbnailConfig バケットとパイプラインが異なるリージョンに存在するため、パイプライン内のジョブの処理時間が長くなり、追加料金が発生する可能性があります。処理時間を短縮し、リージョン間の料金の発生を回避するには、ThumbnailConfig バケットとパイプラインに同じリージョンを使用してください。

6003

進捗イベントの SNS 通知トピックとパイプラインが異なるリージョンに存在するため、パイプライン内のジョブの処理時間が長くなり、追加料金が発生する可能性があります。処理時間を短縮し、リージョン間の料金の発生を回避するには、SNS 通知トピックとパイプラインに同じリージョンを使用してください。

6004

警告イベントの SNS 通知トピックとパイプラインが異なるリージョンに存在するため、パイプライン内のジョブの処理時間が長くなり、追加料金が発生する可能性があります。処理時間を短縮し、リージョン間の料金の発生を回避するには、SNS 通知トピックとパイプラインに同じリージョンを使用してください。

6005

完了イベントの SNS 通知トピックとパイプラインが異なるリージョンに存在するため、パイプライン内のジョブの処理時間が長くなり、追加料金が発生する可能性があります。処理時間を短縮し、リージョン間の料金の発生を回避するには、SNS 通知トピックとパイプラインに同じリージョンを使用してください。

6006

エラーイベントの SNS 通知トピックとパイプラインが異なるリージョンに存在するため、パイプライン内のジョブの処理時間が長くなり、追加料金が発生する可能性があります。処理時間を短縮し、リージョン間の料金の発生を回避するには、SNS 通知トピックとパイプラインに同じリージョンを使用してください。

6007

このパイプラインに対して指定された AWS KMS キーと ContentConfig バケットが異なるリージョンに存在するため、s3-aws-kms 暗号化モードを使用した出力が失敗します。s3-aws-kms 暗号化モードを使用するには、KMS キーと ContentConfig バケットに同じリージョンを使用してください。

6008

このパイプラインに対して指定された AWS KMS キーと ThumbnailConfig バケットが異なるリージョンに存在するため、s3-aws-kms 暗号化モードを使用した出力が失敗します。s3-aws-kms 暗号化モードを使用するには、KMS キーと ThumbnailConfig バケットに同じリージョンを使用してください。

エラー

Elastic Transcoder の例外とエラーメッセージについては、「Elastic Transcoder でのエラー処理」を参照してください。

例

以下のリクエスト例では、Default という名前のパイプラインを作成しています。

リクエスト例

POST /2012-09-25/pipelines HTTP/1.1
Content-Type: application/json; 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
Content-Length: number of characters in the JSON string
{  
   "Name":"Default",
   "InputBucket":"salesoffice.example.com-source",
   "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: 201 Created
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",
     "Role":"arn:aws:iam::123456789012:role/Elastic_Transcoder_Default_Role",
     "AwsKmsKeyArn":"base64-encoded key from KMS",
     "Notifications":{
         "Complete":"",
         "Error":"arn:aws:sns:us-east-1:111222333444:ET_Errors",
         "Progressing":"",
         "Warning":""
      },
      "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."
      },
      {...}
   ]
}