命令概念和状态

命令是从云端发送到您的物联网设备的指令。这些指令（命令有效负载）作为MQTT消息发送到设备。设备收到命令有效载荷后，可以处理指令以采取相应的操作。此类操作的示例包括修改设备配置设置、传输传感器读数或上传日志。然后，设备可以运行命令并将结果返回到云端。这使您能够远程监视和控制连接的设备。

使用命令功能时，可以为命令指定命名空间。要在中创建命令时 AWS IoT Device Management，必须使用默认AWS-IoT命名空间。使用此命名空间时，必须在创建命令时提供有效负载。当您在目标设备上运行命令时，将使用有效负载。如果要 AWS IoT FleetWise 改为创建命令，则必须改用AWS-IoT-FleetWise命名空间。有关更多信息，请参阅命令AWS IoT FleetWise 开发者指南中的远程命令。

创建命令时，必须提供一个用于定义设备必须执行的操作的有效负载。有效载荷可以使用您选择的任何格式。为确保设备能够正确读取和理解您发送的信息，我们建议您在命令中指定有效负载格式类型。如果您的设备使用MQTT5，它们可以按照MQTT标准来识别有效载荷格式。JSON或的格式指示器CBOR将在命令请求主题中提供。

要运行命令时，必须指定接收命令并执行操作的目标设备。如果您的设备已注册为事物 AWS IoT，则可以使用事物名称。如果您的设备尚未注册，则可以改用MQTT客户端 ID。客户端 ID 是MQTT协议中定义的设备或客户端的唯一标识符。它可以用来将您的设备连接到 AWS IoT.

命令执行是在目标设备上运行的命令的实例。开始执行时，命令（有效载荷）将传送到目标设备。现在将为目标生成一个唯一的命令执行 ID。然后，设备可以执行命令并将其进度报告给 AWS IoT。设备端逻辑决定如何执行命令以及如何将状态发布到保留主题。

在运行命令之前，您的设备必须已订阅命令请求主题。当您将请求发送到云端以执行命令时，有效负载将根据命令请求主题发送到设备。设备执行命令后，可以将执行结果和状态发布到命令响应主题。有关更多信息，请参阅 命令主题。

成功创建命令资源后，它将处于可用状态。现在，该命令可用于向设备发送执行命令。

如果您不再打算使用某个命令，则可以将其标记为已弃用。在此状态下，您无法将该命令的任何新执行发送到您的设备。任何已经开始的待处理执行将继续在设备上运行直至完成。要发送新的执行任务，必须恢复命令以使其可用。

当您将命令标记为删除时，如果该命令已被弃用的持续时间超过最大超时时间，则该命令将被自动删除。此操作是永久性的，无法撤消。默认情况下，最大超时持续时间为 12 小时。如果该命令未被弃用，或者已被弃用的时间短于最大超时时间，则该命令将处于待删除状态。在最长超时时间过后，该命令将自动从您的账户中删除。