Avis de fin de support : le 13 novembre 2025, le support d'Amazon Elastic Transcoder AWS sera interrompu. Après le 13 novembre 2025, vous ne pourrez plus accéder à la console Elastic Transcoder ni aux ressources Elastic Transcoder.

Pour plus d'informations sur la transition vers AWS Elemental MediaConvert, consultez ce billet de [blog](https://aws.amazon.com/blogs/media/how-to-migrate-workflows-from-amazon-elastic-transcoder-to-aws-elemental-mediaconvert/).

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Tester un rôle
<a name="test-pipeline-role"></a>

**Topics**
+ [Description](#test-pipeline-role-description)
+ [Requêtes](#test-pipeline-role-requests)
+ [Réponses](#test-pipeline-role-responses)
+ [Erreurs](#test-pipeline-role-response-errors)
+ [Exemples](#test-pipeline-role-examples)

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

Pour tester les paramètres d'un pipeline afin de garantir qu'Elastic Transcoder peut créer et traiter des tâches, envoyez une requête POST à la `/2012-09-25/roleTests` ressource.

## Requêtes
<a name="test-pipeline-role-requests"></a>

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

### Paramètres de demande
<a name="test-pipeline-role-request-parameters"></a>

Cette opération n'utilise pas les paramètres de demande.

### En-têtes de demande
<a name="test-pipeline-role-request-headers"></a>

Cette opération utilise uniquement les en-têtes de demande qui sont communs à toutes les opérations. Pour plus d'informations sur les en-têtes de demande communs, consultez [Contenu de l'en-tête HTTP](making-http-requests.md#http-request-header).

### Corps de la requête
<a name="test-pipeline-role-request-body"></a>

La chaîne JSON contient les objets suivants dans le corps de la demande. 

**InputBucket**  
Le compartiment Amazon S3 dans lequel vous avez enregistré les fichiers multimédias que vous souhaitez transcoder. `Test Role`essaie de lire à partir de ce compartiment. 

**OutputBucket**  
Le compartiment Amazon S3 dans lequel vous souhaitez qu'Elastic Transcoder enregistre les fichiers transcodés. `Test Role`essaie de lire à partir de ce compartiment.

**Rôle**  
Nom de ressource IAM Amazon (ARN) pour le rôle que vous souhaitez qu'Elastic Transcoder utilise pour transcoder les tâches. `Test Role`essaie d'assumer le rôle spécifié.

**Rubriques**  
Il s' ARNs agit d'une ou de plusieurs rubriques Amazon Simple Notification Service (Amazon SNS) auxquelles vous `Test Role` souhaitez envoyer des notifications de test. Si vous n'utilisez pas les notifications Amazon SNS, vous pouvez spécifier une liste vide. 

## Réponses
<a name="test-pipeline-role-responses"></a>

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

### En-têtes de réponse
<a name="test-pipeline-role-response-headers"></a>

Cette opération utilise uniquement les en-têtes de réponse qui sont communs à la plupart des réponses. Pour plus d'informations sur les en-têtes de réponse communs, consultez [Réponses HTTP](making-http-requests.md#http-response-header).

### Corps de la réponse
<a name="test-pipeline-role-response-body"></a>

Lorsque vous testez les paramètres d'un pipeline, Elastic Transcoder renvoie les valeurs suivantes.

**Messages**  
Si la valeur de `Success` est `false`, `Messages` contient un tableau comptant un ou plusieurs messages qui expliquent quels tests ont échoué.

**Succès**  
Si l'opération est réussie, cette valeur est `true` ; dans le cas contraire, la valeur est `false`.

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

Pour plus d'informations sur les exceptions et les messages d'erreur d'Elastic Transcoder, consultez. [Gestion des erreurs dans Elastic Transcoder](error-handling.md)

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

### Exemple de demande
<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"]
}
```

### Exemple de réponse
<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"
}
```