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.

# Obtenez les codes de défaillance OTA avec le AWS CLI
<a name="ota-failure-codes"></a>

1. Installez et configurez l’[AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html).

1. Exécutez `aws configure` et entrez les informations suivantes.

   ```
   $ aws configure
   AWS Access Key ID [None]: AccessID
   AWS Secret Access Key [None]: AccessKey
   Default region name [None]: Region
   Default output format [None]: json
   ```

   Pour plus d'informations, consultez la section [Configuration rapide avec `aws configure`](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html#cli-configure-quickstart-config).

1. Exécuter : 

   ```
   aws iot describe-job-execution --job-id JobID --thing-name ThingName
   ```

   Où *JobID* se trouvent la chaîne d'identification complète de la tâche dont nous voulons obtenir le statut (elle était associée à la tâche de mise à jour OTA lors de sa création) et *ThingName* le nom de l' AWS IoT objet sous lequel l'appareil est enregistré dans AWS IoT

1. La sortie doit se présenter comme suit :

   ```
   {
       "execution": {
           "jobId": "AFR_OTA-****************",
           "status": "FAILED",
           "statusDetails": {
               "detailsMap": {
                   "reason": "0xEEEEEEEE: 0xffffffff"
               }
           },
           "thingArn": "arn:aws:iot:Region:AccountID:thing/ThingName",
           "queuedAt": 1569519049.9,
           "startedAt": 1569519052.226,
           "lastUpdatedAt": 1569519052.226,
           "executionNumber": 1,
           "versionNumber": 2
       }
   }
   ```

   Dans cet exemple de sortie, « `reason` » dans « `detailsmap` » comporte deux champs : le champ « 0xEEEEEEEE » contient le code d'erreur générique de l'agent OTA et le champ « 0xffffffff » contient le sous-code. Les codes d'erreur génériques sont répertoriés dans le [ https://docs.aws.amazon.com/freertos/latest/lib-ref/html1/awsfichier \$1\$1ota\$1\$1agent\$18h.html](https://docs.aws.amazon.com/freertos/latest/lib-ref/html1/aws__ota__agent_8h.html). Consultez les codes d'erreur avec le préfixe « `kOTA_Err_` ». Le sous-code peut être un code spécifique à la plateforme ou fournir plus de détails sur l'erreur générique.