检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
删除设备 接口功能 当有新设备需要从网关移除时，通过调用设备删除接口将非直连设备从物联网平台删除。 接口描述 1 public static boolean rmvDevice(int cookie, String deviceId); 接口所属类 HubService 参数说明
查询设备服务能力 典型场景 第三方应用若需要了解设备可上报哪些服务属性数据，以及设备支持下发哪些命令，可调用此接口在物联网平台查询设备的Profile文件中定义的设备服务能力信息。 接口功能 支持第三方应用在物联网平台查询设备的服务属性、设备命令等服务能力信息。 接口描述 1 Q
查询设备服务能力 典型场景 第三方应用若需要了解设备可上报哪些服务属性数据，以及设备支持下发哪些命令，可调用此接口在物联网平台查询设备的Profile文件中定义的设备服务能力信息。 接口功能 支持第三方应用在物联网平台查询设备的服务属性、设备命令等服务能力信息。 接口描述 1 def
物联网平台判断设备上线或上报数据。 物联网平台将设备属性同步到设备。 设备返回响应消息。 当设备上报数据时，物联网平台修改report属性值为设备上报的设备属性值。 查询设备属性值 设备影子保存的是设备最新的设备属性值，一旦设备属性值产生变化，设备会将设备属性值同步到设备影子。用户便
体验开发中心（联通用户专用） 非联通用户请查看设备接入服务。 本文通过“智慧路灯”为示例，通过开发中心提供的设备模拟器和应用模拟器替代真实的设备和应用，带您快速体验设备上报数据到物联网平台和远程下发控制命令到设备的全过程。 假设： 路灯设备上报一条数据消息，包含路灯的光照强度（Light_Int
可选 String 设备MAC地址。 location 可选 String 设备的位置。 deviceType 必选 String 设备类型。 model 必选 String 型号。 直连设备：与Profile中定义的model保持一致即可。 Z-Wave设备： ProductType
应用服务器下发命令失败，收到403的错误，提示回调地址冲突？ 通过开发中心的“订阅调试”界面或者调用“批量查询订阅”接口查看订阅地址。 同一个应用下，各订阅类型的回调地址的IP和端口号需要一致。 查看应用侧调用创建设备命令接口带的参数callbackurl，与订阅回调地址的IP和端口号是否一致。如果不一致，则修改为一致。
设备服务调用 典型场景 设备Profile文件中定义了物联网平台可向设备下发的命令，第三方应用可调用此接口向设备下发命令，配置或修改设备的服务属性，以实现对设备的控制。 物联网平台不对设备命令进行缓存而是直接下发命令，设备不在线时命令下发失败。下发命令的具体格式需要第三方应用与设
查询单个设备信息 典型场景 已在物联网平台注册的设备，第三方应用若需要查看某个设备的详细信息（如厂商、型号、版本、状态和服务属性等信息），可调用此接口在物联网平台查询获取。 接口功能 支持第三方应用在物联网平台根据设备ID查询指定设备的详细信息，包括配置信息、状态信息、服务属性信息等。
查询单个设备信息 典型场景 已在物联网平台注册的设备，第三方应用若需要查看某个设备的详细信息（如厂商、型号、版本、状态和服务属性等信息），可调用此接口在物联网平台查询获取。 接口功能 支持第三方应用在物联网平台根据设备ID查询指定设备的详细信息，包括配置信息、状态信息、服务属性信息等。
query 分页查询参数，查询结果分页显示时指定要查看的页信息，默认0，查询第一页，取值范围为大于等于0的整数。 “gatewayId”与“pageNo”不能同时为空。 pageSize 可选 Integer query 分页查询参数，查询结果分页显示时每页显示的记录数，默认值为25，取值范围为1-250的整数。
d与设备的deviceId一致。当设备是非直连设备时，gatewayId为设备所关联的直连设备（即网关）的deviceId。 service 必选 DeviceServiceData body 设备的服务数据，具体参见DeviceServiceData结构体。 DeviceServiceData结构体说明：
wayId与设备的deviceId一致。当设备是非直连设备时，gatewayId为设备所关联的直连设备（即网关）的deviceId。 services 必选 List<DeviceProperty> 设备的服务信息列表。 表2 TagV5DTO 名称 必选/可选 类型 说明 tag_key
查询设备影子 接口说明 若设备处于离线或异常状态时，应用服务器无法通过命令下发的方式向设备下发配置。此时可把要下发的配置设置到设备影子，当设备重新上线时，设备影子会把配置下发给设备。应用服务器可调用此接口查看设备影子上的设备配置信息及最新的设备上报数据信息。 注意事项 当前仅使用
更新设备状态 接口功能 通过该接口更新设备的状态信息，包括直连设备与所管理的非直连设备。设备离线、上线均可通过该接口刷新设备状态信息。 直连设备状态通过设备的登录状态进行管理，当直连设备连接断开则表示设备离线，当直连设备连接或重连成功，则表示设备上线，无需通过该接口进行刷新。故建
更新设备状态 接口功能 通过该接口更新设备的状态信息，包括直连设备与所管理的非直连设备。设备离线、上线均可通过该接口刷新设备状态信息。 直连设备状态通过设备的登录状态进行管理，当直连设备连接断开则表示设备离线，当直连设备连接或重连成功，则表示设备上线，无需通过该接口进行刷新。故建
设备消息确认通知 接口说明 应用服务器在物联网平台订阅了设备消息确认通知后（订阅的通知类型为messageConfirm），当平台向设备下发命令，并收到设备返回的命令确认消息（如命令已送达、已执行等）时，平台会向应用服务器推送通知消息。 仅适用于使用MQTT协议接入的设备，例如集成了AgentLite
String(256) 设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。 gatewayId String(256) 网关ID，用于标识一个网关设备。当设备是直连设备时，gatewayId与设备的deviceId一致。当设备是非直连设备时，gatewayId为设备所关联的直连设备（即网关）的deviceId。
设备命令响应通知 接口说明 应用服务器在物联网平台订阅了设备命令响应通知后（订阅的通知类型为commandRsp），当平台向设备下发命令，并收到设备返回的命令响应消息（如命令执行成功或者执行失败，设备要向平台返回指定内容响应）时，平台会向应用服务器推送通知消息。 仅适用于使用MQ
设备数据变化通知 典型场景 第三方应用在物联网平台订阅了设备数据变化通知后（订阅的通知类型为deviceDataChanged），当设备上报单个服务属性数据时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备数据变化通知的第三方应用推送通知消息。 注意事项 1
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
