테스트 역할

설명

Elastic Transcoder가 작업을 만들고 처리할 수 있는지 확인하기 위해 파이프라인의 설정을 테스트하려면 /2012-09-25/roleTests 리소스에 POST 요청을 보냅니다.

요청

조건

POST /2012-09-25/roleTests 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
{
   "InputBucket":"Amazon S3 bucket that contains files to transcode",
   "OutputBucket":"Amazon S3 bucket in which to save transcoded files",
   "Role":"IAM ARN for the role to test",
   "Topics": [
      "ARN of SNS topic to test"
   ]
}

요청 파라미터

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

요청 헤더

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

요청 본문

요청 본문의 JSON 문자열에는 다음 객체가 포함되어 있습니다.

InputBucket

트랜스코딩할 미디어 파일을 저장한 Amazon S3 버킷입니다. Test Role은 이 버킷에서 읽기를 시도합니다.

OutputBucket

Elastic Transcoder가 트랜스코딩된 파일을 저장할 Amazon S3 버킷입니다. Test Role은 이 버킷에서 읽기를 시도합니다.

역할

Elastic Transcoder가 작업을 트랜스코딩하는 데 사용할 역할의 IAM Amazon 리소스 이름(ARN)입니다. Test Role은 지정된 역할을 맡으려고 시도합니다.

주제

Test Role에서 테스트 알림을 보내려는 하나 이상의 Amazon Simple Notification Service(SNS) 주제에 대한 ARN입니다. Amazon SNS 알림을 사용하지 않는 경우 빈 목록을 지정할 수 있습니다.

응답

조건

Status: 200 OK
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

{
   "Messages": [
      "error messages, if any"
   ],
   "Success": "true | false"
}

응답 헤더

이 작업은 대부분의 응답에 일반적인 응답 헤더만 사용합니다. 일반적인 응답 헤더에 대한 내용은 HTTP 응답 섹션을 참조하세요.

응답 본문

파이프라인의 설정을 테스트하면 Elastic Transcoder가 다음 값을 반환합니다.

메시지

Success의 값이 false인 경우, Messages에 실패한 테스트를 설명하는 하나 이상의 메시지 배열이 포함됩니다.

Success

작업에 성공하면 이 값은 true입니다. 그렇지 않은 경우 값은 false입니다.

오류

Elastic Transcoder 예외 및 오류 메시지에 대한 자세한 내용은 Elastic Transcoder에서의 오류 처리 섹션을 참조하세요.

예시

예제 요청

POST /2012-09-25/roleTests 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
{
   "InputBucket":"salesoffice.example.com-source",
   "OutputBucket":"salesoffice.example.com-public-promos",
   "Role":"arn:aws:iam::123456789012:role/transcode-service",
   "Topics": 
      ["arn:aws:sns:us-east-1:111222333444:ETS_Errors", 
       "arn:aws:sns:us-east-1:111222333444:ETS_Progressing"]
}

샘플 응답

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
{
   "Messages":[
      "The role arn:aws:iam::123456789012:role/transcode-service does not have access to the bucket: salesoffice.example.com-source",
      "The role arn:aws:iam::123456789012:role/transcode-service does not have access to the topic: arn:aws:sns:us-east-1:111222333444:ETS_Errors"
   ], 
   "Success": "false"
}