检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
接口说明 物联网平台支持创建设备的“影子”。设备影子用于存储设备最新上报的服务属性数据，以及应用服务器对服务属性的配置（服务属性为设备Profile文件中定义的service属性）。若设备处于离线或异常状态时，应用服务器无法通过命令下发的方式向设备下发配置，此时可把要下发的配置设置到设备
通知类型，比如设备业务数据、设备告警等，接口信息详见API参考文档。 在订阅场景下，物联网平台是客户端，应用服务器是服务端，物联网平台调用应用服务器的接口，并向应用服务器推送消息。在Java API Demo中，使用HTTP协议接收物联网平台的推送消息，不需要在物联网平台加载CA证书。
exceeds the upper limit. 查询数量超过最大限制 请排查请求参数是否符合华为云文档要求。 404 IOTDA.009003 The subscription subject can not be found. 查询不到该订阅记录 请确认请求中的参数是否正确。 500
subscribed IOTDA service. 没有找到IAM Token所对应的用户信息或该用户没有订阅设备接入服务（IOTDA） 请排查IAM Token所在用户是否订阅了设备接入服务(IOTDA)。 IOTDA.001000 The application does not exist
修改设备命令 接口说明 应用服务器向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行，此时应用服务器可调用此接口修改该命令的状态信息。仅能修改还处于PENDING状态的命令，且当前仅支持把命令状态修改为CANCELED状态，即撤销命令的执行。
删除设备通知 接口说明 应用服务器在物联网平台订阅了删除设备通知后（订阅的通知类型为deviceDeleted），当设备在物联网平台中被删除后，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
随机psk参数，若请求中携带了psk，则使用请求中的psk，否则由平台生成随机psk参数。 在物联网平台上查看注册的设备。 进阶体验 按照本页面的指导，使用Postman模拟应用服务器接入物联网平台后，您应该已经基本了解应用服务器如何通过调用物联网平台开放的接口与平台交互。 若您想要进一步体验设备管理服务，可
可选 Integer(>=0) query 分页查询参数，查询结果分页显示时指定要查看的页信息，默认值0，查询第一页，取值范围为大于等于0的整数。 pageSize 可选 Integer[1,1000] query 分页查询参数，查询结果分页显示时每页显示的记录数，默认值为1000，取值范围为1-1000的整数。
设备管理服务如何上传带插件的产品模型？ 设备管理平台不支持上传带插件的产品模型。 若您希望使用带插件的产品模型，请在开发中心开发或导入Profile和编解码插件，然后发布到产品中心； 发布成功后，在设备管理平台上新增产品模型时，选择“从产品中心导入”，选择自己发布的产品即可将Profile和编解码插件一并导入。
绑定设备通知 接口说明 应用服务器在物联网平台订阅了绑定设备通知后（订阅的通知类型为bindDevice），当设备接入并绑定物联网平台时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
软件升级状态变更通知 接口说明 应用服务器在物联网平台订阅了软件升级状态变更通知后（订阅的通知类型为swUpgradeStateChangeNotify），当设备进行软件升级，升级任务的状态发生变化时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。
可选 Integer(>=0) query 分页查询参数，查询结果分页显示时指定要查看的页信息，默认值0，查询第一页，取值范围为大于等于0的整数。 pageSize 可选 Integer[1,100] query 分页查询参数，查询结果分页显示时每页显示的记录数，默认值为10，取值范围为1-100的整数。
设备信息变化通知 接口说明 应用服务器在物联网平台订阅了设备信息变化通知后（订阅的通知类型为deviceInfoChanged），当设备的配置或状态信息（如设备厂商信息、位置信息、版本信息、在线状态信息等）发生变化时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。
设备消息确认通知 接口说明 应用服务器在物联网平台订阅了设备消息确认通知后（订阅的通知类型为messageConfirm），当平台向设备下发命令，并收到设备返回的命令确认消息（如命令已送达、已执行等）时，平台会向应用服务器推送通知消息。 仅适用于使用MQTT协议接入的设备，例如集成了AgentLite
设备影子状态变更通知 接口说明 应用服务器在物联网平台订阅了设备影子状态变更通知后（订阅的通知类型为deviceDesiredPropertiesModifyStatusChanged），当平台中的设备影子向设备同步数据成功或失败时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。
请检查上报的数据名称是否和产品模型定义的服务属性一致。 若设备为NB-IoT设备，请再参考NB模组无法正常上报数据怎么办？进行排查。 确定以上都不存在问题时，请检查设备和物联网平台之间的网络链路是否畅通，设备是否正常运行。 如果确认设备上报数据成功，但在设备管理服务的历史数据中无法查看到设备上报的数据，请请确保创建应用时已打开“存储历史数据”开关。
以通道ID参数值为准。通过调用DIS服务 查询通道列表接口获取。 stream_id 可选 String(256) DIS服务对应的通道ID，和通道名称参数中至少一个不为空，和通道名称参数都存在时，以本参数值为准。通过调用DIS服务 查询通道详情接口获取。 表10 ActionObsForwarding
}, ] } 查询和修改设备影子 查询设备影子 方法1：应用服务器调用查询设备影子接口。 方法2：登录物联网平台控制台，点击右上角“进入设备管理服务”。单击左下角，在设备列表中，单击具体的设备进入到设备的详情页面，在“设备影子”页签中，可以查看当前设备属性数据，包括“上报值”和“期望值”，如下图所示。
查询指定版本包 接口说明 在进行设备版本升级前，应用服务器可调用此接口在物联网平台查询某个版本升级包的信息，确保设备要升级的版本包已上传到平台，可根据版本包ID查询指定版本包信息，在调用该接口前需要通过“查询版本包列表”接口查询获得版本包ID。 URI 请求方法 GET URI /iodm/northbound/v1
Found 找不到资源。 409 Conflict 请求冲突。 500 Internal Server Error 服务内部错误。 503 Service Unavailable 服务不可用。 响应消息头 对应请求消息头，响应同样也有消息头，如Content-Type。 参数 是否必选 说明
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
