检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
创建设备命令 接口说明 设备Profile文件中定义了物联网平台可向设备下发的命令，应用服务器可调用此接口向设备下发命令，配置或修改设备的服务属性，以实现对设备的控制。 物联网平台有两种命令下发机制： 立即下发：平台收到命令后立即下发给设备，保证实时性，不保证串行性。 缓存下发：平台收到命令后缓存起来
消息结构体说明 转发设备上报的属性 根据定义的产品模型，上报设备属性至平台。结构体描述如下： 表1 属性上报规则转发结构体 参数名称 类型 描述 device_id String 设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。 services services
绑定设备通知 典型场景 第三方应用在物联网平台订阅了绑定设备通知后（订阅的通知类型为bindDevice），当直连设备接入并绑定物联网平台时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了绑定设备通知的第三方应用推送通知消息。 注意事项 1. 应用在订阅平台业务数据时需要订阅接口描述中的指定回调地址
创建应用（联通用户专用） 非联通用户请查看设备接入服务。 应用可以理解为在物联网平台中为用户的业务划分一个项目空间，当用户在开发中心、线下环境里完成应用服务器侧的开发、物联网平台侧的开发以及设备侧的开发后，就需要在控制台上创建应用，将开发完的应用服务器与真实设备接入到这个项目空间中
注册设备通知 典型场景 第三方应用在物联网平台订阅了注册设备通知后（订阅的通知类型为deviceAdded），当第三方应用通过“注册直连设备”接口在平台注册设备时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了注册设备通知的第三方应用推送通知消息。 注意事项 1
设备信息变化通知 典型场景 第三方应用在物联网平台订阅了设备信息变化通知后（订阅的通知类型为deviceInfoChanged），当设备的配置或状态信息（如设备厂商信息、位置信息、版本信息、在线状态信息等）发生变化时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备信息变化通知的第三方应用推送通知消息
体验开发中心（联通用户专用） 非联通用户请查看设备接入服务。 本文通过“智慧路灯”为示例，通过开发中心提供的设备模拟器和应用模拟器替代真实的设备和应用，带您快速体验设备上报数据到物联网平台和远程下发控制命令到设备的全过程。 假设： 路灯设备上报一条数据消息，包含路灯的光照强度（Light_Intensity
设备绑定 接口功能 设备第一次接入物联网平台时需要进行绑定操作，上层应用通过调用该接口传入设备序列号或者MAC地址以及设备信息来绑定到物联网平台。 在绑定前需要调用绑定配置接口设置物联网平台的IP与端口。 设备绑定是指设备第一次接入物联网平台的过程，需要开发者先在物联网平台注册直连设备
创建设备命令撤销任务 典型场景 第三方应用向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行（DEFAULT状态），此时第三方应用可调用此接口撤销指定设备的所有未下发的命令，对于已下发成功的命令不可撤销。 接口功能 支持第三方应用创建设备命令撤销任务
修改设备命令 典型场景 第三方应用向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行，此时第三方应用可调用此接口修改该命令的状态信息。当前仅支持把命令状态修改为CANCELED状态，即撤销命令的执行。 接口功能 支持第三方应用修改指定命令的状态信息
修改设备命令 典型场景 第三方应用向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行，此时第三方应用可调用此接口修改该命令的状态信息。当前仅支持把命令状态修改为CANCELED状态，即撤销命令的执行。 接口功能 支持第三方应用修改指定命令的状态信息
创建设备命令撤销任务 典型场景 第三方应用向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行（DEFAULT状态），此时第三方应用可调用此接口撤销指定设备的所有未下发的命令，对于已下发成功的命令不可撤销。 接口功能 支持第三方应用创建设备命令撤销任务
API列表 应用安全接入 API 说明 鉴权 应用服务器进行认证鉴权，获取接入Token。 刷新token 在Token过期前，获取新的Token。 设备管理 API 说明 注册设备（验证码方式） 在物联网平台注册一个设备，仅适用于使用LWM2M/CoAP协议或Agent Lite
商用对接（联通用户专用） 非联通用户请查看设备接入服务。 当产品发布到产品中心后，我们在“开发中心”定义好的产品就可以在“设备管理服务”中使用了。由于开发中心所在的平台环境为测试环境，设备管理服务所在的平台环境为商用环境，两个环境的数据不能互通，已对接测试环境的设备/应用服务器要迁移商用环境
查询设备命令 典型场景 第三方应用向设备下发命令后，可调用此接口在物联网平台查询下发命令的状态及内容信息，以了解命令的执行情况。 接口功能 支持第三方应用在物联网平台查询下发命令的状态和内容信息，可查询指定时间段内本应用下的所有下发命令，或者指定设备的所有下发命令。 接口描述 1
网关与子设备（联通用户专用） 非联通用户请查看设备接入服务。 概述 物联网平台支持设备直连，也支持设备挂载在网关上，作为网关的子设备，由网关直连。 针对未实现TCP/IP协议栈的设备，由于无法直接同物联网平台通信，它需要通过网关进行数据转发，如下图所示。 接入流程 Agent Lite
查询设备命令撤销任务 典型场景 第三方应用创建了设备命令撤销任务后，可调用此接口查询设备命令撤销任务的详细信息和执行状态，以了解撤销任务的执行情况。 接口功能 支持第三方应用在物联网平台查询设备命令撤销任务信息和状态，可指定条件查询单个或多个撤销任务。 接口描述 1 def queryDeviceCmdCancelTask
查询设备命令撤销任务 典型场景 第三方应用创建了设备命令撤销任务后，可调用此接口查询设备命令撤销任务的详细信息和执行状态，以了解撤销任务的执行情况。 接口功能 支持第三方应用在物联网平台查询设备命令撤销任务信息和状态，可指定条件查询单个或多个撤销任务。 接口描述 1 QueryDeviceCmdCancelTaskOutDTO2
查询设备命令 典型场景 第三方应用向设备下发命令后，可调用此接口在物联网平台查询下发命令的状态及内容信息，以了解命令的执行情况。 接口功能 支持第三方应用在物联网平台查询下发命令的状态和内容信息，可查询指定时间段内本应用下的所有下发命令，或者指定设备的所有下发命令。 接口描述 1
修改设备命令 接口说明 应用服务器向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行，此时应用服务器可调用此接口修改该命令的状态信息。仅能修改还处于PENDING状态的命令，且当前仅支持把命令状态修改为CANCELED状态，即撤销命令的执行。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
