翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# を使用して OTA 障害コードを取得する AWS CLI
<a name="ota-failure-codes"></a>

1. [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html) をインストールして設定します。

1. `aws configure` を実行し、以下の情報を入力します。

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

   詳細については、[`aws configure` を使用したクイック設定](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html#cli-configure-quickstart-config)を参照してください。

1. 以下を実行します: 

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

   {{JobID}} はステータスを取得するジョブの完全なジョブ ID 文字列で (作成時に OTA 更新ジョブに関連付けられていました）、{{ThingName}} はデバイスが に登録されている AWS IoT モノの名前です。 AWS IoT

1. 出力は次のようになります。

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

   この出力例では、「`detailsmap`」の「`reason`」には 2 つのフィールドがあります。「0xEEEEEEEE」として表示されるフィールドには、OTA Agent からの一般的なエラーコードが含まれています。「0xffffffff」として表示されるフィールドには、サブコードが含まれています。一般的なエラーコードの一覧は、[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) にあります。プレフィックス「`kOTA_Err_`」が付いたエラーコードを参照してください。サブコードは、プラットフォーム固有のコードであるか、一般的なエラーに関する詳細を提供します。