View a markdown version of this page

Amazon IoT 命令疑难解答 - Amazon IoT Core
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

Amazon IoT 命令疑难解答

这是 Amazon IoT Device Management 命令的故障排除部分。

命令执行问题

命令执行保持在 CREATED 状态

当命令执行保持CREATED状态且未进入IN_PROGRESS或另一种状态时,请考虑以下几点:

  • 验证设备已连接到 Amazon IoT Core 并已订阅命令请求主题。

  • 检查设备政策是否允许iot:Subscribe、命令请求iot:Publish主题和命令响应主题。iot:Receive

  • 如果设备处于离线状态并使用 MQTT 持久会话,则该命令将在 Amazon IoT 核心层等待。当设备在持续会话超时和执行超时之前重新连接时,它可以处理命令。如果执行超时到期,则执行将转换为TIMED_OUT。

DataConflict 开机时出错 UpdateCommandExecution

当并行或在短时间内向服务UpdateCommandExecution发出多个请求时(例如,IN_PROGRESS紧接着是SUCCEEDED),就会出现DataConflict错误。

要解决此问题,请执行以下操作:

  • 订阅/accepted和/rejected回复主题以确认每个状态更新都已处理完毕,然后再发送下一次更新。

  • 在收到错误时使用指数退避实现重试逻辑。DataConflict

命令执行意外变为 TIMED_OUT 终端状态

当命令执行过渡到设备可以处理TIMED_OUT之前时:

  • 查看为命令执行配置的超时值。对于您的用例而言,默认超时可能太短。

  • 如果发送命令时设备处于脱机状态,请验证设备是否在超时到期之前重新连接并收到了执行请求。

  • 云端启动的TIMED_OUT不是终端。设备仍然可以将执行更新为终端状态(SUCCEEDEDFAILED、REJECTED、或TIMED_OUT)。

注意

设备启动TIMED_OUT是一种终端状态,无法对该命令执行进行进一步的更新。

如何查看 CloudWatch 日志中的错误?

来自 UpdateCommandExecution MQTT 请求的错误记录在亚马逊 CloudWatch的AWSIoTLogsV2日志组中。要启用日志记录和查看日志,请参阅配置 Amazon IoT 日志记录。

UpdateCommandExecution 错误代码

当 UpdateCommandExecution MQTT 请求失败时,该服务会向该/rejected主题发布错误响应。错误响应包含错误代码和消息。下表列出了可以返回的错误代码。

错误代码 可重试 说明
InvalidStateTransition 否 不允许请求的状态转换。例如,从过渡SUCCEEDED到IN_PROGRESS,更新设备启动的执行TIMED_OUT。
TerminalStateReached 否 命令执行已达到终端状态,无法更新。
ResourceNotFound 否 指定的命令执行不存在。
DataConflict 是 命令执行已同时修改。当快速连续发送状态更新时,可能会发生这种情况。订阅/accepted和/rejected回复主题以确认每个状态更新都已处理完毕,然后再发送下一次更新。有关更多详细信息,请参阅DataConflict 错误 UpdateCommandExecution。
InternalError 是 发生内部服务器错误。使用指数退避重试请求。

以下是发布到该/rejected主题的错误响应示例:

{ "clientToken": "client-token-1", "executionId": "2bd65c51-4cfd-49e4-9310-d5cbfdbc8554", "error": "DataConflict", "errorMessage": "The command execution was modified concurrently" }