Aviso de fin de soporte: el 13 de noviembre de 2025, AWS dejaremos de ofrecer soporte a Amazon Elastic Transcoder. Después del 13 de noviembre de 2025, ya no podrás acceder a la consola de Elastic Transcoder ni a los recursos de Elastic Transcoder.

[Para obtener más información sobre la transición a AWS Elemental MediaConvert, visite esta entrada de blog.](https://aws.amazon.com/blogs/media/how-to-migrate-workflows-from-amazon-elastic-transcoder-to-aws-elemental-mediaconvert/)

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Rol de prueba
<a name="test-pipeline-role"></a>

**Topics**
+ [Descripción](#test-pipeline-role-description)
+ [Solicitudes](#test-pipeline-role-requests)
+ [Respuestas](#test-pipeline-role-responses)
+ [Errores](#test-pipeline-role-response-errors)
+ [Ejemplos](#test-pipeline-role-examples)

## Descripción
<a name="test-pipeline-role-description"></a>

Para probar la configuración de una canalización y garantizar que Elastic Transcoder pueda crear y procesar tareas, envíe una solicitud POST al recurso `/2012-09-25/roleTests`.

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

### Sintaxis
<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 la solicitud
<a name="test-pipeline-role-request-parameters"></a>

Esta operación no usa parámetros de solicitud.

### Encabezados de solicitud
<a name="test-pipeline-role-request-headers"></a>

Esta operación solo usa encabezados de solicitud que sean comunes para todas las operaciones. Para obtener información acerca de los encabezados de solicitudes comunes, consulte [Contenido de los encabezados HTTP](making-http-requests.md#http-request-header).

### Cuerpo de la solicitud
<a name="test-pipeline-role-request-body"></a>

La cadena JSON del cuerpo de solicitud contiene los siguientes objetos. 

**InputBucket**  
El bucket de Amazon S3 en el que ha guardado los archivos multimedia que desea transcodificar. `Test Role` intenta leer de este bucket. 

**OutputBucket**  
El bucket de Amazon S3 en el que desea que Elastic Transcoder guarde los archivos transcodificados. `Test Role` intenta leer de este bucket.

**Rol**  
El nombre de recurso de Amazon (ARN) de IAM del rol que desea que Elastic Transcoder use para transcodificar tareas. `Test Role` intenta asumir el rol especificado.

**Temas**  
El ARNs de uno o más temas de Amazon Simple Notification Service (Amazon SNS) a los que `Test Role` desea enviar notificaciones de prueba. Si no está utilizando notificaciones de Amazon SNS, puede especificar una lista vacía. 

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

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

### Encabezados de respuesta
<a name="test-pipeline-role-response-headers"></a>

Esta operación solo usa encabezados de respuesta que sean comunes a la mayoría de las respuestas. Para obtener información acerca de los encabezados de respuestas comunes, consulte [Respuestas HTTP](making-http-requests.md#http-response-header).

### Cuerpo de respuesta
<a name="test-pipeline-role-response-body"></a>

Al probar la configuración de una canalización, Elastic Transcoder devuelve los siguientes valores.

**Mensajes**  
Si el valor de `Success` es `false`, `Messages` contiene una matriz de uno o varios mensajes que explican qué pruebas han fallado.

**Correcto**  
Si la operación se realiza correctamente, este valor es `true`; de lo contrario, el valor es `false`.

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

Para obtener información acerca de los mensajes de error y las excepciones en Elastic Transcoder, consulte [Gestión de errores en Elastic Transcoder](error-handling.md).

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

### Solicitud de ejemplo
<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"]
}
```

### Respuesta de ejemplo
<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"
}
```