检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
查询设备服务能力 典型场景 第三方应用若需要了解设备可上报哪些服务属性数据，以及设备支持下发哪些命令，可调用此接口在物联网平台查询设备的Profile文件中定义的设备服务能力信息。 接口功能 支持第三方应用在物联网平台查询设备的服务属性、设备命令等服务能力信息。 接口描述 1 def
参数 必选/可选 类型 位置 描述 fileId 必选 String path 版本包ID，在上传版本包后获得。 accessToken 必选 String header 填写鉴权接口获取的accessToken。 响应参数 void 错误码 Http状态码 错误码 错误描述 说明
描述 fileId 必选 String path 版本包ID，在上传版本包后获得。 accessToken 必选 String header 如果调用了定时刷新token接口，此参数值可以填写null，否则要填写鉴权接口获取的accessToken。 响应参数 void 错误码 Http状态码
创建软件升级任务 典型场景 若需要对设备进行软件版本升级，第三方应用可调用此接口为多个设备创建软件升级任务，升级前请确保目标版本包已上传到物联网平台。当前仅支持对NB-IoT设备进行软件版本升级。 接口功能 支持第三方应用在物联网平台为多个设备进行软件版本升级，当前仅支持对NB-IoT设备进行软件版本升级。
3 String 服务ID。 EN_IOTA_DATATRANS_IE_METHOD 4 String 服务方法。 EN_IOTA_DATATRANS_IE_CMDCONTENT 5 String 命令内容，以Json格式进行拼装的服务命令参数，开发者根据对应服务命令的定义进行Json解析，从而获取命令参数值。
创建软件升级任务 典型场景 若需要对设备进行软件版本升级，第三方应用可调用此接口为多个设备创建软件升级任务，升级前请确保目标版本包已上传到物联网平台。当前仅支持对NB-IoT设备进行软件版本升级。 接口功能 支持第三方应用在物联网平台为多个设备进行软件版本升级，当前仅支持对NB-IoT设备进行软件版本升级。
任务列表信息，具体参见OperationInfo结构体。 pageNo Integer 查询结果的页码。 pageSize Integer 查询结果每页的记录数量。 totalCount Integer 查询结果的总记录数。 OperationInfo结构体说明： 参数 类型 描述 operationId
发布数据的包体。 接口返回值 参见函数标准返回值 返回结果 广播名称 广播参数 成员 描述 IOTA_TOPIC_MQTT_DATA_PUB_RSP HW_MSG对象 EN_IOTA_DATATRANS_IE_RESULT 数据发布结果。 成功：0。 失败：1。 示例 1 2 3 HW_BYTES
serviceId 必选 String(1-64) body 命令对应的服务ID，用于标识一个服务。要与profile中定义的serviceId保持一致。 method 必选 String(1-128) body 命令服务下具体的命令名称，服务属性等。要与profile中定义的命令名保持一致。 paras
2*eDRX周期+120秒 由于终端设备的省电模式是在运营商网络侧设置的，物联网平台无法从终端设备和网络侧获取到设备的省电模式，需要先从运营商处获取设备当前使用的省电模式，然后在控制台上（“应用详情”->“服务设置”）为应用配置对应的省电模式。创建的应用默认配置为PSM模式。 对于NB-IoT设备
pcServiceProperties 必选 String 服务属性，该参数必须带结束符‘\0’。 接口返回值 参见函数标准返回值 返回结果 广播名称 广播参数 成员 描述 IOTA_TOPIC_DATATRANS_REPORT_RSP/{deviceId} HW_MSG对象 EN_IOTA_DATATRANS_IE_RESULT
查询单个设备信息 接口说明 已在物联网平台注册的设备，应用服务器若需要查看某个设备的详细信息（如厂商、型号、版本、状态和服务属性等信息），可调用此接口在物联网平台查询获取。 URI 请求方法 GET URI /iocm/app/dm/v1.4.0/devices/{deviceId}
设备如何发送文件至物联网平台？ 目前设备上报文件的场景比较少，如需实现该功能，可以通过集成Agent Lite，然后把文件通过base64编码成String后上传给平台（平台单个消息最大为4KB，超过4KB分多次发送），然后推送给应用，再进行base64解码。 父主题： 设备集成（联通用户专用）
修改设备影子 典型场景 物联网平台支持创建设备的“影子”。设备影子用于存储设备最新上报的服务属性数据，以及第三方应用对服务属性的配置（服务属性为设备Profile文件中定义的service属性）。若设备处于离线或异常状态时，第三方应用无法通过命令下发的方式向设备下发配置，此时可把
下发给设备，正等待设备反馈日志收集结果，设备处理完成后会给平台返回处理结果，根据反馈的结果变更为Success或Fail状态；如果超过30分钟未收到反馈结果，则状态变更为Fail。 Success：表示日志收集成功，根据设备反馈的日志收集执行结果，如果收集日志成功，则变更为Success状态。
serviceId 必选 String(1-64) body 命令对应的服务ID，用于标识一个服务。要与profile中定义的serviceId保持一致。 method 必选 String(1-128) body 命令服务下具体的命令名称，要与profile中定义的命令名保持一致。 paras
query 见下表QueryDeviceGroupsInDTO的描述。 accessToken 必选 String header 填写鉴权接口获取的accessToken。 QueryDeviceGroupsInDTO 参数 必选/可选 类型 位置 描述 accessAppId 可选
注册设备（密码方式） 接口说明 在设备接入物联网平台前，应用服务器需要调用此接口在物联网平台注册设备，获取设备ID和密码。在设备接入物联网平台时携带设备ID和密码，完成设备的接入认证。 此注册设备接口适用于使用MQTT协议接入的设备。 URI 请求方法 POST URI /iocm/app/reg/v2
修改设备影子 典型场景 物联网平台支持创建设备的“影子”。设备影子用于存储设备最新上报的服务属性数据，以及第三方应用对服务属性的配置（服务属性为设备Profile文件中定义的service属性）。若设备处于离线或异常状态时，第三方应用无法通过命令下发的方式向设备下发配置，此时可把
子设备的状态会一直显示在线。 8、网关调用“设备服务数据上报”接口上报网关和子设备的数据，接口里的参数填写网关和子设备的相关设备信息。 9、网关调用“设备命令接收”接口，接收并处理应用服务器或物联网平台下发的命令。 10、应用服务器调用删除子设备接口，给网关下发删除子设备命令，网
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
