检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
发布数据 接口功能 当直连设备（网关）有数据需要发布或者非直连设备发布数据到网关时，网关需要调用设备服务数据发布接口将数据发布到物联网平台。其与数据上报功能上的区别在于，发布数据的topic固定为“/cloud/signaltrans/v2/categories/data”；“s
创建设备组 接口说明 应用服务器可调用此接口在物联网平台上创建设备组，并把设备归类到不同的设备组内，进行分组管理。在对设备进行某些操作时（如升级设备软固件、批量下发命令等），可通过设备组来指定要进行操作的设备。 注意事项 一个设备只能归属一个设备组。 URI 请求方法 POST URI
更新设备状态 接口功能 通过该接口更新设备的状态信息，包括直连设备与所管理的非直连设备。设备离线、上线均可通过该接口刷新设备状态信息。 直连设备状态通过设备的登录状态进行管理，当直连设备连接断开则表示设备离线，当直连设备连接或重连成功，则表示设备上线，无需通过该接口进行刷新。故建
返回结果 请求发送以后，您会收到响应，包含：状态码、响应消息头和响应消息体。 状态码 状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，物联网平台返回的状态码如下所示。 对于鉴权接口，如果调用后返回状态码为“200”，则表示请求成功。 状态码 编码 状态码说明 200
登录参数配置 接口功能 在登录前配置登录所需要的参数。 接口描述 1 2 HW_INT IOTA_ConfigSetStr(HW_INT iItem, HW_CHAR *pValue) HW_INT IOTA_ConfigSetUint(HW_INT iItem, HW_UINT
查询版本包列表 接口说明 在进行设备版本升级前，应用服务器可调用此接口查询已经上传到物联网平台的版本升级包列表信息，确保设备要升级的版本包已上传到平台，可根据条件查询满足要求的版本包。 URI 请求方法 GET URI /iodm/northbound/v1.5.0/category
软件升级结果变更通知 典型场景 第三方应用在物联网平台订阅了软件升级结果通知后（订阅的通知类型为swUpgradeResultNotify），当设备的软件升级任务执行完成时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了软件升级结果通知的第三方应用推送通知消息。
上报设备数据 接口功能 当直连设备（网关）有数据需要上报或者非直连设备上报数据到网关时，网关需要调用设备服务数据上报接口将数据上报到物联网平台。 上报设备数据接口的deviceId，requstId和serviceId由SDK组装为消息的header；servicePropert
软件升级结果变更通知 典型场景 第三方应用在物联网平台订阅了软件升级结果通知后（订阅的通知类型为swUpgradeResultNotify），当设备的软件升级任务执行完成时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了软件升级结果通知的第三方应用推送通知消息。
查询指定设备组 典型场景 第三方应用若需要查看某个设备组的信息，以了解该设备组的使用情况，可调用此接口查询指定设备组的信息。 接口功能 支持第三方应用在物联网平台根据设备组ID查询指定设备组的信息。 接口描述 1 def querySingleDeviceGroup(self, devGroupId
Json组件使用说明 该组件为Agent Lite提供给开发者的工具组件，如果开发者无法进行Json格式的编码和解码，则可以使用该组件进行编码和解码。主要用于上报数据组装与下发命令解析。 1. Json编码 使用Json组件进行编码的流程。 创建Json编码对象。 1 HW_JSONOBJ
数据类型说明 常用数据类型 类型名称 类型原型 HW_INT int HW_UINT unsigned int HW_CHAR char HW_UCHAR unsigned char HW_BOOL int HW_ULONG unsigned long HW_USHORT unsigned
查询指定设备组 典型场景 第三方应用若需要查看某个设备组的信息，以了解该设备组的使用情况，可调用此接口查询指定设备组的信息。 接口功能 支持第三方应用在物联网平台根据设备组ID查询指定设备组的信息。 接口描述 1 QuerySingleDeviceGroupOutDTO quer
查询指定版本包 接口说明 在进行设备版本升级前，应用服务器可调用此接口在物联网平台查询某个版本升级包的信息，确保设备要升级的版本包已上传到平台，可根据版本包ID查询指定版本包信息，在调用该接口前需要通过“查询版本包列表”接口查询获得版本包ID。 URI 请求方法 GET URI /iodm/northbound/v1
查询设备组详情 典型场景 第三方应用可调用此接口查询当前已创建的所有设备组列表信息，以了解当前设备组的分组和使用情况。 接口功能 支持第三方应用在物联网平台查询已创建的所有设备组信息。 接口描述 1 QueryDeviceGroupsOutDTO queryDeviceGroup
修改设备组 典型场景 若因业务变更需要修改设备组的信息，如设备组名称、设备组的设备数量限制等，第三方应用可调用此接口修改指定设备组的信息。 接口功能 支持第三方应用在物联网平台修改指定设备组的信息。 接口描述 1 def modifyDeviceGroup(self, mdgInDTO
查询设备组列表 接口说明 应用服务器可调用此接口查询当前已创建的所有设备组列表信息，以了解当前设备组的分组和使用情况。 URI 请求方法 GET URI /iocm/app/devgroup/v1.3.0/devGroups 传输协议 HTTPS 请求参数 参数 必选/可选 类型
修改设备组 典型场景 若因业务变更需要修改设备组的信息，如设备组名称、设备组的设备数量限制等，第三方应用可调用此接口修改指定设备组的信息。 接口功能 支持第三方应用在物联网平台修改指定设备组的信息。 接口描述 1 ModifyDeviceGroupOutDTO modifyDev
定时刷新token 典型场景 第三方应用通过调用此接口，定期刷新accessToken，刷新周期为鉴权方法返回值中的expiresIn，以保证accessToken不过期。accessToken由SDK管理，调用其他业务接口，accessToken可以直接传入null。 接口功能
绑定设备通知 典型场景 第三方应用在物联网平台订阅了绑定设备通知后（订阅的通知类型为bindDevice），当直连设备接入并绑定物联网平台时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了绑定设备通知的第三方应用推送通知消息。 注意事项 应用在订阅平台业务数据
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
