检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
subject Subject Object 订阅的主题信息，即订阅的资源变化事件。 callbackurl String 订阅的回调地址，用于接收对应资源事件的通知消息。 channel String 物联网平台推送通知消息时使用的协议通道。使用“http”填充，表示该订阅推送协议通道为http(s)协议。
true，级联删除，即删除直连设备和其下的非直连设备。 false，删除直连设备，但是不删其下的非直连设备，并将非直连设备的属性变为直连设备属性。 appId 必选 String query 如果是本应用的设备，此参数值可以填写null，否则填写授权应用的appId。 accessToken
“true”，级联删除，即删除直连设备和其下的非直连设备。 “false”，删除直连设备，但是不删其下的非直连设备，并将非直连设备的属性变为直连设备属性。 appId 可选 String query 如果是本应用的设备，此参数值可以填写None，否则填写授权应用的appId。 accessToken
查询设备组详情 典型场景 第三方应用可调用此接口查询当前已创建的所有设备组列表信息，以了解当前设备组的分组和使用情况。 接口功能 支持第三方应用在物联网平台查询已创建的所有设备组信息。 接口描述 1 QueryDeviceGroupsOutDTO queryDeviceGroup
应用服务器在物联网平台订阅了软件升级结果通知后（订阅的通知类型为swUpgradeResultNotify），当设备的软件升级任务执行完成时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
应用服务器在物联网平台订阅了固件升级结果通知后（订阅的通知类型为fwUpgradeResultNotify），当设备的固件升级任务执行完成时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
知后（订阅的通知类型为fwUpgradeStateChangeNotify），当设备进行固件升级，升级任务的状态发生变化时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
body 事件推送时的回填信息，对应规则的condition中的transInfo。 ActionResult结构体说明： 参数 必选/可选 类型 位置 描述 type 必选 String body 规则动作的类型。 id 可选 String body action的ID。 exception
No或IMEI作为nodeId。 说明： 若使用IMEI作为nodeId，根据不同厂家的芯片有不同填写要求。 高通芯片设备的唯一标识为urn:imei:xxxx，xxxx为IMEI号 海思芯片设备的唯一标识为IMEI号 其他厂家芯片的设备唯一标识请联系模组厂家确认。 name 可选 String(256)
平台支持从第三方服务器下载软/固件包吗？ 不支持。目前只支持将软/固件包直接上传至物联网平台，上传的位置为控制台的“设备管理 > 软件库 > 固件包管理”和“设备管理 > 软件库 > 软件包管理”。 父主题： 软/固件升级（联通用户专用）
知后（订阅的通知类型为swUpgradeStateChangeNotify），当设备进行软件升级，升级任务的状态发生变化时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
String body 访问物联网平台的应用ID，在物联网平台创建应用时由平台分配获得。此处填写授权应用的appId。 deviceType 必选 String body 设备的类型。 manufacturerName 必选 String body 设备模型的厂商名称。 manufacturerId
header 访问物联网平台的应用ID，在物联网平台创建应用时由平台分配获得。 Authorization 必选 String header 访问物联网平台的认证信息，值为“Bearer {accessToken}”，其中{accessToken}为调用鉴权接口返回的accessToken。
设备影子状态变更通知 接口说明 应用服务器在物联网平台订阅了设备影子状态变更通知后（订阅的通知类型为deviceDesiredPropertiesModifyStatusChanged），当平台中的设备影子向设备同步数据成功或失败时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。
header 访问物联网平台的应用ID，在物联网平台创建应用时由平台分配获得。 Authorization 必选 String header 访问物联网平台的认证信息，值为“Bearer {accessToken}”，其中{accessToken}为调用鉴权接口返回的accessToken。
设备组，并把设备归类到不同的设备组内，进行分组管理。一个设备可以归属到多个设备组内。 在对设备进行某些操作时（如升级设备软固件、批量下发命令等），可通过设备组来指定要进行操作的设备。 接口功能 支持第三方应用在物联网平台创建设备组，用于对设备进行分组管理。 接口描述 1 CreateDeviceGroupOutDTO
设备组，并把设备归类到不同的设备组内，进行分组管理。一个设备可以归属到多个设备组内。 在对设备进行某些操作时（如升级设备软固件、批量下发命令等），可通过设备组来指定要进行操作的设备。 接口功能 支持第三方应用在物联网平台创建设备组，用于对设备进行分组管理。 接口描述 1 def
EN_IOTA_HUB_RESULT_TYPE 添加/删除执行结果。 EN_IOTA_HUB_IE_DEVICEID 1 String 添加成功后分配的设备ID。 EN_IOTA_HUB_RESULT_TYPE： 枚举项 枚举值 描述 EN_IOTA_HUB_RESULT_SUCCESS 0
用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。 URI 请求方法 POST URI 由应用服务器下发命令请求消息中的callbackurl决定。 传输协议 HTTPS/HTTP 请求参数 参数 必选/可选 类型 位置 描述 deviceId 必选 String
} encode接口说明 encode接口的入参是JSON格式的数据，是平台下发的命令或应答。 平台的下行报文可以分为两种情况： 平台对设备上报数据的应答（对应图中的消息②） 表2 平台收到设备的上报数据后对设备的应答encode接口的入参结构定义 字段名 类型 参数描述 是否必填
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
