本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

命令概念和狀態

使用 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 帳戶 可以處於三種狀態之一：可用、已棄用或待刪除。

命令執行狀態

當您在目標裝置上啟動執行時，它會進入 CREATED 狀態，並根據裝置報告轉換為其他狀態。您可以擷取狀態資訊和追蹤執行。

下表顯示根據執行進度的執行狀態及其轉換。

裝置可以隨時使用命令預留 MQTT 主題來發佈狀態和結果更新。為了提供額外的內容，裝置可以使用 statusReason 物件中的 reasonCode和 reasonDescription 欄位。

下圖顯示執行狀態轉換。

下列各節說明終端機和非終端機執行及其狀態。

非終端命令執行

如果可以接受來自裝置的更新，則執行是非終端的。非終端執行會被視為作用中。下列狀態為非終端狀態：

終端機命令執行

當執行不再接受來自裝置的更新時，就會變成終端機。下列狀態為終端機。執行可以從任何非終端狀態轉換為終端狀態：CREATED、 IN_PROGRESS或 TIMED_OUT。