Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

命令概念和状态

使用Amazon 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"}}
        }
      ]
    }
  ]
}

开始执行时：

命令状态

您的命令Amazon Web Services 账户可以处于以下三种状态之一：“可用”、“已弃用” 或 “待删除”。

命令执行状态

当您在目标设备上开始执行时，它会进入CREATED状态，并且可以根据设备报告过渡到其他状态。您可以检索状态信息并跟踪执行情况。

下表显示了执行状态及其基于执行进度的转换。

设备可以使用命令保留的 MQTT 主题随时发布状态和结果更新。为了提供更多上下文，设备可以在statusReason对象中使用reasonCode和reasonDescription字段。

下图显示了执行状态的转换。

以下各节描述了终端和非终端执行及其状态。

非终端命令执行

如果执行可以接受来自设备的更新，则该执行是非终止的。非终止执行被视为处于活动状态。以下状态为非终端状态：

终端命令执行

当执行不再接受来自设备的更新时，它就会变成终止。以下状态是终端的。执行可以从任何非终端状态转换为终端状态：CREATEDIN_PROGRESS、或。TIMED_OUT