Pemberitahuan akhir dukungan: Pada 13 November 2025, AWS akan menghentikan dukungan untuk Amazon Elastic Transcoder. Setelah 13 November 2025, Anda tidak akan lagi dapat mengakses konsol Elastic Transcoder atau sumber daya Elastic Transcoder.

Untuk informasi lebih lanjut tentang transisi ke AWS Elemental MediaConvert, kunjungi [posting blog](https://aws.amazon.com/blogs/media/how-to-migrate-workflows-from-amazon-elastic-transcoder-to-aws-elemental-mediaconvert/) ini.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Peran Uji
<a name="test-pipeline-role"></a>

**Topics**
+ [Deskripsi](#test-pipeline-role-description)
+ [Permintaan](#test-pipeline-role-requests)
+ [Respons](#test-pipeline-role-responses)
+ [Kesalahan](#test-pipeline-role-response-errors)
+ [Contoh](#test-pipeline-role-examples)

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

Untuk menguji pengaturan pipeline guna memastikan bahwa Elastic Transcoder dapat membuat dan memproses pekerjaan, kirim permintaan POST ke sumber daya. `/2012-09-25/roleTests`

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

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

### Parameter Permintaan
<a name="test-pipeline-role-request-parameters"></a>

Operasi ini tidak menggunakan parameter permintaan.

### Header Permintaan
<a name="test-pipeline-role-request-headers"></a>

Operasi ini hanya menggunakan header permintaan yang umum untuk semua operasi. Untuk informasi selengkapnya tentang header permintaan umum, lihat [Konten Header HTTP](making-http-requests.md#http-request-header).

### Isi Permintaan
<a name="test-pipeline-role-request-body"></a>

String JSON di badan permintaan berisi objek berikut. 

**InputBucket**  
Bucket Amazon S3 tempat Anda menyimpan file media yang ingin Anda transkode. `Test Role`mencoba membaca dari ember ini. 

**OutputBucket**  
Bucket Amazon S3 tempat Anda ingin Elastic Transcoder menyimpan file yang ditranskode. `Test Role`mencoba membaca dari ember ini.

**Peran**  
Nama Sumber Daya Amazon IAM (ARN) untuk peran yang Anda inginkan Elastic Transcoder gunakan untuk mentranskode pekerjaan. `Test Role`mencoba untuk mengambil peran yang ditentukan.

**Topik**  
Satu atau lebih topik Amazon Simple Notification Service (Amazon SNS) yang `Test Role` ingin Anda kirimi pemberitahuan pengujian. ARNs Jika Anda tidak menggunakan notifikasi Amazon SNS, Anda dapat menentukan daftar kosong. 

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

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

### Header Respons
<a name="test-pipeline-role-response-headers"></a>

Operasi ini hanya menggunakan header respons yang umum untuk sebagian besar respons. Untuk informasi tentang header permintaan umum, lihat [Tanggapan HTTP](making-http-requests.md#http-response-header).

### Isi Respons
<a name="test-pipeline-role-response-body"></a>

Saat Anda menguji pengaturan untuk pipeline, Elastic Transcoder mengembalikan nilai-nilai berikut.

**Pesan**  
Jika nilai dari `Success` is`false`, `Messages` berisi array dari satu atau beberapa pesan yang menjelaskan tes mana yang gagal.

**Sukses**  
Jika operasi berhasil, nilai ini adalah`true`; jika tidak, nilainya adalah`false`.

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

Untuk informasi tentang pengecualian Elastic Transcoder dan pesan kesalahan, lihat. [Kesalahan Penanganan di Elastic Transcoder](error-handling.md)

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

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

### Contoh Respons
<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"
}
```