检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
我是设备用户（联通用户专用） 非联通用户请查看设备接入服务。 作为设备用户，您既是设备的购买者，又可能是设备的实际管理者，通常您需要考虑两件事： 在采购设备时，如何评估设备满足您的业务需求并且具备接入物联网平台的能力。关于此方面的知识，您可以参考设备能力评估。 在进行日常管理时，
删除指定版本包 接口说明 对于不需要继续使用和保留的设备版本包，应用服务器可调用此接口在物联网平台上删除指定的版本包，可根据版本包ID删除指定的版本包文件，在调用该接口前需要通过“查询版本包列表”接口查询获得要删除的版本包ID。 URI 请求方法 DELETE URI /iodm/northbound/v1
查询指定批量任务信息 典型场景 第三方应用通过“创建批量任务”接口创建了设备的批量操作任务后，可调用此接口查询该批量任务的信息，包括任务的当前状态、子任务完成情况等。 接口功能 支持第三方应用通过任务ID查询单个批量任务的信息。 接口描述 1 QueryOneTaskOutDTO
注册设备通知 典型场景 第三方应用在物联网平台订阅了注册设备通知后（订阅的通知类型为deviceAdded），当第三方应用通过“注册直连设备”接口在平台注册设备时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了注册设备通知的第三方应用推送通知消息。 注意事项 1
设备信息变化通知 典型场景 第三方应用在物联网平台订阅了设备信息变化通知后（订阅的通知类型为deviceInfoChanged），当设备的配置或状态信息（如设备厂商信息、位置信息、版本信息、在线状态信息等）发生变化时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订
查询指定批量任务信息 典型场景 第三方应用通过“创建批量任务”接口创建了设备的批量操作任务后，可调用此接口查询该批量任务的信息，包括任务的当前状态、子任务完成情况等。 接口功能 支持第三方应用通过任务ID查询单个批量任务的信息。 接口描述 1 def queryOneTask(self
创建批量任务 典型场景 第三方应用若需要对多个设备进行批量操作时，可调用此接口创建设备的批量操作任务，当前仅支持给批量设备下发缓存命令。 接口功能 支持第三方应用在物联网平台创建设备的批量操作任务。 接口描述 1 def createBatchTask(self, btcInDTO
自助测试（联通用户专用） 非联通用户请查看设备接入服务。 自助测试提供了端到端的测试用例，帮助开发者自助完成产品的基础能力测试，如数据上报、命令下发等。旨在通过物联网检测技术帮助开发者发现自身产品中存在的缺陷或问题，缩短产品上市时间。测试完成后，开发中心将生成测试报告，用于进行产
发布数据 接口功能 当直连设备（网关）有数据需要发布或者非直连设备发布数据到网关时，网关需要调用设备服务数据发布接口将数据发布到物联网平台。其与数据上报功能上的区别在于，发布数据的topic固定为“/cloud/signaltrans/v2/categories/data”；“p
设备消息上报通知 接口说明 应用服务器在物联网平台订阅了设备消息上报通知后（订阅的资源为device.message，事件为report），当设备上报消息数据时，平台会向应用服务器推送通知消息。 注意事项 应用服务器收到推送消息时，请务必返回响应码。 URI 请求方法 POST URI
查询指定版本包 典型场景 在进行设备版本升级前，第三方应用可调用此接口在物联网平台查询某个版本升级包的信息，确保设备要升级的版本包已上传到平台。 接口功能 支持第三方应用在物联网平台根据版本包ID查询指定版本包信息，在调用该接口前需要通过“查询版本包列表”接口查询获得版本包ID。
创建批量任务 典型场景 第三方应用若需要对多个设备进行批量操作时，可调用此接口创建设备的批量操作任务，当前仅支持给批量设备下发缓存命令。 接口功能 支持第三方应用在物联网平台创建设备的批量操作任务。 接口描述 1 BatchTaskCreateOutDTO createBatch
创建批量任务 接口说明 应用服务器若需要对多个设备进行批量操作时，可调用此接口创建设备的批量操作任务，当前仅支持给批量设备下发缓存命令。 URI 请求方法 POST URI /iocm/app/batchtask/v1.1.0/tasks 传输协议 HTTPS 请求参数 参数 必选/可选
修改规则 接口说明 应用服务器可调用此接口修改物联网平台中指定规则的配置。 调试 您可以在API Explorer中直接运行调试该接口。 URI 请求方法 PUT URI /v5/iot/{project_id}/rules/{rule_id} 传输协议 HTTPS 请求参数 名称
创建数据转发规则 接口说明 应用服务器可调用此接口在物联网平台创建一条规则，当指定设备上报的数据满足条件时，触发规则。 调试 您可以在API Explorer中直接运行调试该接口。 URI 请求方法 POST URI /v5/iot/{project_id}/rules 传输协议
接收设备命令 接口功能 注册设备命令接收广播来接收处理平台下发的控制命令。 接口描述 1 IOTA_TOPIC_SERVICE_COMMAND_RECEIVE/{deviceId}; 参数说明 枚举项 枚举值 类型 描述 EN_IOTA_DATATRANS_IE_RESULT 0
设备数据变化通知 典型场景 第三方应用在物联网平台订阅了设备数据变化通知后（订阅的通知类型为deviceDataChanged），当设备上报单个服务属性数据时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备数据变化通知的第三方应用推送通知消息。 注意事项 1
查询指定版本包 典型场景 在进行设备版本升级前，第三方应用可调用此接口在物联网平台查询某个版本升级包的信息，确保设备要升级的版本包已上传到平台。 接口功能 支持第三方应用在物联网平台根据版本包ID查询指定版本包信息，在调用该接口前需要通过“查询版本包列表”接口查询获得版本包ID。
查询设备影子 典型场景 若设备处于离线或异常状态时，第三方应用无法通过命令下发的方式向设备下发配置。此时可把要下发的配置设置到设备影子，当设备重新上线时，设备影子会把配置下发给设备。第三方应用可调用此接口查看设备影子上的设备配置信息及最新的设备上报数据信息。 接口功能 支持第三方
查询规则 接口说明 应用服务器可调用此接口查询物联网平台中指定规则的配置信息。 调试 您可以在API Explorer中直接运行调试该接口。 URI 请求方法 GET URI /v5/iot/{project_id}/rules/{rule_id} 传输协议 HTTPS 请求参数
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
