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

コマンドの概念とステータス

AWS IoT コマンドを使用して、クラウドから接続されたデバイスに指示を送信します。この機能を使用する方法

ワークフローの詳細については、「高レベルのコマンドワークフロー」を参照してください。

コマンドキーの概念

以下の主要な概念は、 コマンド機能を理解するのに役立ちます。用語は、このドキュメント全体で一貫して使用されます。

パラメータ値条件

ペイロードテンプレートを使用してコマンドを作成するときは、値条件を定義して、実行前にパラメータ値を検証します。値条件により、パラメータが要件を満たし、無効な実行が防止されます。

CommandParameterValue タイプでサポートされている演算子

例: 温度制御コマンド

{
  "commandId": "SetTemperature",
  "namespace": "AWS-IoT",
  "payloadTemplate": "{\"temperature\": \"${aws:iot:commandexecution::parameter:temperature}\"}",
  "parameters": [
    {
      "name": "temperature",
      "type": "INTEGER",
      "valueConditions": [
        {
          "comparisonOperator": "IN_RANGE",
          "operand": {
            "numberRange": {
              "min": "60",
              "max": "80"
            }
          }
        }
      ]
    }
  ]
}

この例では、 temperatureパラメータは 60～80 (両端を含む) である必要があります。この範囲外の値の実行リクエストは検証に失敗します。

パラメータ値の優先度と評価

ペイロードテンプレートを使用してコマンド実行を開始する場合、パラメータ値は次の優先度を使用して解決されます。

値条件は、優先度で上記で導出された最終的なパラメータ値と、実行の作成前に評価されます。検証が失敗した場合、実行リクエストはエラーを返します。

例: を使用した SetTemperature コマンド defaultValue

{
  "parameters": [
    {
      "name": "temperature",
      "type": "INTEGER",
      "defaultValue": {"I": 72},
      "valueConditions": [
        {
          "comparisonOperator": "IN_RANGE",
          "operand": {"numberRange": {"min": "60", "max": "80"}}
        }
      ]
    }
  ]
}

実行を開始する場合:

コマンドの状態

のコマンドは AWS アカウント 、使用可能、非推奨、または保留中の 3 つの状態のいずれかになります。

コマンド実行ステータス

ターゲットデバイスで実行を開始すると、 CREATEDステータスになり、デバイスレポートに基づいて他のステータスに移行できます。ステータス情報を取得し、実行を追跡できます。

次の表は、実行の進行状況に基づく実行ステータスとその移行を示しています。

デバイスは、予約された MQTT トピックを使用して、いつでもステータスと結果の更新を発行できます。追加のコンテキストを提供するために、デバイスは statusReason オブジェクトの フィールドreasonCodeと reasonDescriptionフィールドを使用できます。

次の図は、実行ステータスの遷移を示しています。

以下のセクションでは、ターミナルと非ターミナルの実行とそのステータスについて説明します。

非終了のコマンド実行

デバイスからの更新を受け入れることができる場合、実行は非ターミナルです。非ターミナル実行はアクティブと見なされます。次のステータスは非ターミナルです。

終了のコマンド実行

デバイスからの更新を受け入れなくなると、実行はターミナルになります。次のステータスは終了です。実行は、、CREATED、IN_PROGRESSまたは の非ターミナルステータスからターミナルステータスに移行できますTIMED_OUT。