Aviso de fim do suporte: em 13 de novembro de 2025, o suporte para o Amazon Elastic Transcoder AWS será interrompido. Depois de 13 de novembro de 2025, você não poderá mais acessar o console do Elastic Transcoder ou os recursos do Elastic Transcoder.

Para obter mais informações sobre a transição para AWS Elemental MediaConvert, visite esta [postagem do blog](https://aws.amazon.com/blogs/media/how-to-migrate-workflows-from-amazon-elastic-transcoder-to-aws-elemental-mediaconvert/).

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Função de teste
<a name="test-pipeline-role"></a>

**Topics**
+ [Descrição](#test-pipeline-role-description)
+ [Solicitações](#test-pipeline-role-requests)
+ [Respostas](#test-pipeline-role-responses)
+ [Erros](#test-pipeline-role-response-errors)
+ [Exemplos](#test-pipeline-role-examples)

## Descrição
<a name="test-pipeline-role-description"></a>

Para testar as configurações de um pipeline para garantir que o Elastic Transcoder possa criar e processar trabalhos, envie uma solicitação POST para o recurso `/2012-09-25/roleTests`.

## Solicitações
<a name="test-pipeline-role-requests"></a>

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

### Parâmetros de solicitação
<a name="test-pipeline-role-request-parameters"></a>

Essa operação não usa parâmetros de solicitação.

### Cabeçalhos de solicitação
<a name="test-pipeline-role-request-headers"></a>

Essa operação usa somente os cabeçalhos de solicitação que são comuns a todas as operações. Para informações sobre os cabeçalhos de solicitação comuns, consulte [Conteúdo de cabeçalho HTTP](making-http-requests.md#http-request-header).

### Corpo da Solicitação
<a name="test-pipeline-role-request-body"></a>

A string JSON no corpo da solicitação contém os seguintes objetos. 

**InputBucket**  
O bucket do Amazon S3 no qual você salvou os arquivos de mídia que deseja transcodificar. O `Test Role` tenta ler a partir desse bucket. 

**OutputBucket**  
O bucket do Amazon S3 no qual você deseja que o Elastic Transcoder salve os arquivos transcodificados. O `Test Role` tenta ler a partir desse bucket.

**Função**  
O nome do recurso da Amazon (ARN) do IAM para a função que você deseja que o Elastic Transcoder use para transcodificar trabalhos. O `Test Role` tenta assumir a função especificada.

**Tópicos**  
O ARNs de um ou mais tópicos do Amazon Simple Notification Service (Amazon SNS) para os quais você `Test Role` deseja enviar notificações de teste. Se você não estiver usando notificações do Amazon SNS, poderá especificar uma lista vazia. 

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

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

### Cabeçalhos de resposta
<a name="test-pipeline-role-response-headers"></a>

Essa operação usa somente os cabeçalhos de resposta que são comuns a maioria das respostas. Para informações sobre os cabeçalhos de resposta comuns, consulte [Respostas HTTP](making-http-requests.md#http-response-header).

### Corpo da resposta
<a name="test-pipeline-role-response-body"></a>

Quando você testa as configurações para um pipeline, o Elastic Transcoder retorna os seguintes valores.

**Mensagens**  
Se o valor de `Success` é `false`, `Messages` contém uma matriz de uma ou mais mensagens que explicam quais testes falharam.

**Bem-sucedida**  
Se a operação tiver êxito, este valor será `true`; caso contrário, o valor será `false`.

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

Para obter mais informações sobre exceções e mensagens de erro do Elastic Transcoder, consulte [Tratamento de erros no Elastic Transcoder](error-handling.md).

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

### Exemplo de solicitação
<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"]
}
```

### Resposta da amostra
<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"
}
```