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á.

# Obtenha códigos de falha OTA com o AWS CLI
<a name="ota-failure-codes"></a>

1. Instale e configure a [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html).

1. Execute `aws configure` e insira as seguintes informações.

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

   Para obter mais informações, consulte a [Configuração rápida com `aws configure`](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html#cli-configure-quickstart-config).

1. Execute: 

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

   Onde {{JobID}} está a string completa de ID do trabalho cujo status queremos obter (estava associado ao trabalho de atualização do OTA quando foi criado) e {{ThingName}} é o nome do AWS IoT item com o qual o dispositivo está registrado em AWS IoT

1. A saída será semelhante a esta:

   ```
   {
       "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
       }
   }
   ```

   Neste exemplo de saída, o "`reason`" no "`detailsmap`" tem dois campos: o campo mostrado como "0xEEEEEEEE" contém o código de erro genérico do agente de OTA; o campo mostrado como "0xffffffff" contém o subcódigo. Os códigos de erro genéricos estão listados em [https://docs.aws.amazon.com/freertos/latest/lib-ref/html1/aws\_\_ota\_\_agent\_8h.html](https://docs.aws.amazon.com/freertos/latest/lib-ref/html1/aws__ota__agent_8h.html). Consulte os códigos de erro com o prefixo "`kOTA_Err_`". O subcódigo pode ser um código específico da plataforma ou fornecer mais detalhes sobre o erro genérico.