파이프라인 업데이트 - Amazon Elastic Transcoder
설명값을 업데이트하고 삭제하는 방법요청응답오류예시

다음을 통해 비용을 절감하고 더 많은 기능을 이용할 수 있습니다. AWS Elemental MediaConvert

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

이미 Amazon Elastic Transcoder를 사용하고 계신가요? MediaConvert마이그레이션하는 방법은 간단합니다. 자세한 내용은 마이그레이션 프로세스에 대한 중요한 정보와 추가 리소스 링크가 포함된 이 개요를 참조하세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

파이프라인 업데이트

설명

파이프라인의 설정을 업데이트하려면 /2012-09-25/pipelines/pipelineId 리소스에 PUT 요청을 보냅니다.

중요

파이프라인 설정을 변경하면 변경 사항이 즉시 적용됩니다. 설정을 변경한 후 제출한 작업 외에도 이미 제출했으나 Elastic Transcoder가 처리를 시작하지 않은 작업도 영향을 받습니다.

값을 업데이트하고 삭제하는 방법

값을 업데이트하려면 예를 들어 다음과 같이 새 값을 지정합니다.

"GranteeType":"Canonical"

값을 변경하지 않고 그대로 두려면 다음 중 하나를 수행합니다.

  • 현재 값을 지정합니다.

  • null 값을 지정합니다. 이는 개별 객체(예: "Role":null) 및 어레이(예: "ContentConfig":null)에 모두 적용됩니다.

  • 요청에서 JSON 객체를 뺍니다. 이는 개별 객체(예: Role) 및 어레이(예: ContentConfig)에 모두 적용됩니다.

현재 값을 삭제하려면 빈 값을 지정합니다. 예를 들어 알림을 삭제하려면 "Progressing":""과 같이 빈 스트링을 지정합니다. 어레이의 값을 모두 삭제하려면 "Permissions":[]과 같이 빈 어레이를 지정합니다.

예를 들어 작업을 처리하는 중에 Elastic Transcoder에 경고가 발생했을 때 더 이상 알림을 받고 싶지 않으며 다른 알림 설정을 변경하지 않으려는 경우, 요청의 Notifications에 다음을 지정합니다.

...
"Notifications":{
   "Warning":""
},
...

요청

조건

PUT /2012-09-25/pipelines/pipelineId 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
{
   "Id":"pipelineId",
   "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"
}

요청 파라미터

이 작업은 요청 파라미터를 사용하지 않습니다.

요청 헤더

이 작업은 모든 작업에 일반적인 요청 헤더만 사용합니다. 일반적인 요청 헤더에 대한 내용은 HTTP 헤더 콘텐츠 섹션을 참조하세요.

요청 본문

요청 본문의 JSON 문자열에는 UpdatePipeline 작업에 대한 입력 객체가 포함되어 있습니다. 입력 객체에 대한 자세한 내용은 Elastic Transcoder 파이프라인을 생성할 때 지정하는 설정 섹션을 참조하세요.

Id

파이프라인의 식별자. 이 값을 사용하여 작업 또는 프리셋 생성과 같은 다양한 작업을 수행하려는 파이프라인을 식별합니다.

상태

파이프라인의 현재 상태입니다.

  • Active: 파이프라인이 작업을 처리 중입니다.

  • Paused: 파이프라인이 현재 작업을 처리하지 않습니다.

응답

조건

Status: 202 Accepted
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

{
   "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 id",
   "Notifications":{
      "Progressing":"SNS topic to notify when
         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
         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는 해당되는 경우 다음 경고를 포함합니다.

(자동) 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에서의 오류 처리 섹션을 참조하세요.

예시

다음 예제 요청은 ID가 1111111111111-abcde1인 파이프라인을 업데이트합니다.

예제 요청

PUT /2012-09-25/pipelines/1111111111111-abcde1 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
{  
   "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"
}

샘플 응답

Status: 202 Accepted
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
{
   "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."
      },
      {...}
   ]
}