파이프라인 생성 - Amazon Elastic Transcoder
설명요청응답오류예시

비용을 절감하고 더 많은 기능을 확보하십시오. AWS Elemental MediaConvert

MediaConvert 는 포괄적인 고급 트랜스코딩 기능을 제공하는 최신 파일 기반 비디오 트랜스코딩 서비스로, 온디맨드 요금은 분당 0.0075달러부터 시작합니다. 자세한 내용을 읽어보세요.

이미 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가 하나 이상의 경고를 반환합니다. 그래도 파이프라인은 생성되지만 처리 시간이 증가하고 교차 리전 비용이 발생할 수 있습니다. 경고는 다음 형식으로 제공됩니다.

코드 - 경고 코드입니다.

메시지 - 경고 코드와 관련된 메시지입니다.

반환될 수 있는 경고 코드와 메시지는 다음과 같습니다.

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."
      },
      {...}
   ]
}