检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
设备逻辑ID，在设备添加时由平台分配。 DATATRANS_IE_SERVICEID 服务ID。 DATATRANS_IE_METHOD 服务方法。 DATATRANS_IE_CMDCONTENT 命令内容。 示例 开发者注册广播接收器对设备命令接收结果进行相应的处理。 1 2 3 4 5 6
创建设备组 接口说明 应用服务器可调用此接口在物联网平台上创建设备组，并把设备归类到不同的设备组内，进行分组管理。在对设备进行某些操作时（如升级设备软固件、批量下发命令等），可通过设备组来指定要进行操作的设备。 注意事项 一个设备只能归属一个设备组。 URI 请求方法 POST URI
修改设备命令 典型场景 第三方应用向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行，此时第三方应用可调用此接口修改该命令的状态信息。当前仅支持把命令状态修改为CANCELED状态，即撤销命令的执行。 接口功能 支持第三方应用修改指定命令的状态
设备命令响应通知 典型场景 第三方应用在物联网平台订阅了设备命令响应通知后（订阅的通知类型为commandRsp），当平台向设备下发命令，并收到设备返回的命令响应消息（如命令执行成功或者执行失败，设备要向平台返回指定内容响应）时，平台会向第三方应用推送通知消息。 接口功能 支持物
设备消息确认通知 接口说明 应用服务器在物联网平台订阅了设备消息确认通知后（订阅的通知类型为messageConfirm），当平台向设备下发命令，并收到设备返回的命令确认消息（如命令已送达、已执行等）时，平台会向应用服务器推送通知消息。 仅适用于使用MQTT协议接入的设备，例如集成了AgentLite
FAILED表示命令执行失败 TIMEOUT表示命令下发执行超时 CANCELED表示命令已经被撤销执行 result ObjectNode 下发命令执行的详细结果。 creationTime String(20) 命令的创建时间。 executeTime String(20) 命令执行的时间。
“SUCCESSFUL”表示命令已经成功执行 “FAILED”表示命令执行失败 “TIMEOUT”表示命令下发执行超时 “CANCELED”表示命令已经被撤销执行 result ObjectNode 下发命令执行的详细结果。 creationTime String(20) 命令的创建时间。 executeTime
命令下发 创建设备命令 查询设备命令 修改设备命令 批量创建设备命令 创建设备命令撤销任务 查询设备命令撤销任务 设备命令下发 父主题： 应用侧API参考（联通用户专用）
为什么设备上报一条数据后应用服务器会收到多条推送？ 可能有以下几种情况： 如果订阅的“notifyType”为“deviceDataChanged”，且多条消息推送的内容不同，可能是因为设备上报的数据包含了多个service（即“data”参数内包括多个JSON对象），物联网平台会将其拆成多条消息推送。
模拟器下发命令成功，调用API下发命令失败？ 根据API参考的创建设备命令接口，检查url、body、header的参数信息是否正确。 分别通过用模拟器和调用API接口下发相同的命令，比对历史命令中，两条命令的json消息体的差异。 父主题： 应用集成（联通用户专用）
若子设备不再需要接入物联网平台，应用服务器可调用此接口解绑网关下的子设备。 此功能通过设备命令下发接口向网关下发命令实现，具体删除子设备命令需网关提前实现（即网关收到什么命令会触发删除子设备的流程），并已在设备的Profile文件中定义。当网关收到平台下发的删除子设备命令时，则启动内部业务流程，删除子设备。
String 服务ID。 EN_IOTA_DATATRANS_IE_METHOD 4 String 服务方法。 EN_IOTA_DATATRANS_IE_CMDCONTENT 5 String 命令内容，以Json格式进行拼装的服务命令参数，开发者根据对应服务命令的定义进行Json解析，从而获取命令参数值。
NB设备命令状态变化通知 典型场景 第三方应用通过物联网平台创建设备命令时，如果设置了callbackurl回调地址，当命令状态变化时（执行失败，执行成功，超时，发送，已送达），平台会向第三方应用推送通知消息。 接口功能 支持物联网平台在命令状态发生变化时向第三方应用推送通知消息。
接收设备命令 接口功能 调用设备命令接收接口来处理平台下发的控制命令。 接口描述 1 DataTransService.TOPIC_COMMAND_RECEIVE; 接口所属类 DataTransService 示例 开发者需要实现Agent Lite提供的观察者接口。 1
平台支持从第三方服务器下载软/固件包吗？ 不支持。目前只支持将软/固件包直接上传至物联网平台，上传的位置为控制台的“设备管理 > 软件库 > 固件包管理”和“设备管理 > 软件库 > 软件包管理”。 父主题： 软/固件升级（联通用户专用）
查询设备服务能力 接口说明 应用服务器若需要了解设备可上报哪些服务属性数据，以及设备支持下发哪些命令，可调用此接口在物联网平台查询设备的Profile文件中定义的设备服务能力信息。 URI 请求方法 GET URI /iocm/app/data/v1.1.0/deviceCapabilities
在同一个应用下，平台可以将不同设备上报的数据，推送到两个服务器吗？ 可以。只要回调地址不同，均可以接收到平台推送的数据。 父主题： 订阅推送（联通用户专用）
设备服务调用 典型场景 设备Profile文件中定义了物联网平台可向设备下发的命令，第三方应用可调用此接口向设备下发命令，配置或修改设备的服务属性，以实现对设备的控制。 物联网平台不对设备命令进行缓存而是直接下发命令，设备不在线时命令下发失败。下发命令的具体格式需要第三方应用与设
用户对单个设备进行软件升级有两种方式： 应用服务器通过调用的“创建软件升级任务”API接口，创建单个设备的升级任务，详情请参考创建软件升级任务。 通过控制台，创建单个设备的软件升级任务。 设备升级前，请在“设备详情 > 命令”中，检查是否存在还在执行的命令，若存在，需要先等待所有命令执行后或是取消等待执行的命令，才可以创建设备升级任务。
定义每个服务具备的属性、命令以及命令的参数。 以水表为例，水表具有多种能力，如上报水流、告警、电量、连接等各种数据，并且能够接受服务器下发的各种命令。Profile文件在描述水表的能力时，可以将水表的能力划分五个服务，每个服务都需要定义各自的上报属性或命令。说明如下： 服务名 描述
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
