지원 종료 공지: 2025년 11월 13일에 AWS 는 Amazon Elastic Transcoder에 대한 지원을 중단합니다. 2025년 11월 13일 이후에는 더 이상 Elastic Transcoder 콘솔 또는 Elastic Transcoder 리소스에 액세스할 수 없습니다.

로 전환하는 방법에 대한 자세한 내용은이 [블로그 게시물](https://aws.amazon.com/blogs/media/how-to-migrate-workflows-from-amazon-elastic-transcoder-to-aws-elemental-mediaconvert/)을 AWS Elemental MediaConvert참조하십시오.

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

# 테스트 역할
<a name="test-pipeline-role"></a>

**Topics**
+ [설명](#test-pipeline-role-description)
+ [요청](#test-pipeline-role-requests)
+ [응답](#test-pipeline-role-responses)
+ [오류](#test-pipeline-role-response-errors)
+ [예](#test-pipeline-role-examples)

## 설명
<a name="test-pipeline-role-description"></a>

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

## 요청
<a name="test-pipeline-role-requests"></a>

### 구문
<a name="test-pipeline-role-request-syntax"></a>

```
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"
   ]
}
```

### 요청 파라미터
<a name="test-pipeline-role-request-parameters"></a>

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

### 요청 헤더
<a name="test-pipeline-role-request-headers"></a>

이 작업은 모든 작업에 일반적인 요청 헤더만 사용합니다. 일반적인 요청 헤더에 대한 내용은 [HTTP 헤더 콘텐츠](making-http-requests.md#http-request-header) 섹션을 참조하세요.

### 요청 본문
<a name="test-pipeline-role-request-body"></a>

요청 본문의 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 알림을 사용하지 않는 경우 빈 목록을 지정할 수 있습니다.

## 응답
<a name="test-pipeline-role-responses"></a>

### 구문
<a name="test-pipeline-role-response-syntax"></a>

```
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"
}
```

### 응답 헤더
<a name="test-pipeline-role-response-headers"></a>

이 작업은 대부분의 응답에 일반적인 응답 헤더만 사용합니다. 일반적인 응답 헤더에 대한 내용은 [HTTP 응답](making-http-requests.md#http-response-header) 섹션을 참조하세요.

### 응답 본문
<a name="test-pipeline-role-response-body"></a>

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

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

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

## 오류
<a name="test-pipeline-role-response-errors"></a>

Elastic Transcoder 예외 및 오류 메시지에 대한 자세한 내용은 [Elastic Transcoder에서의 오류 처리](error-handling.md) 섹션을 참조하세요.

## 예
<a name="test-pipeline-role-examples"></a>

### 예 요청
<a name="test-pipeline-role-examples-sample-request"></a>

```
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"]
}
```

### 샘플 응답
<a name="test-pipeline-role-examples-sample-response"></a>

```
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"
}
```