检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
命令下发 概述 为能有效地对设备进行管理，设备的产品模型中定义了物联网平台可向设备下发的命令，应用服务器可以调用物联网平台应用侧API接口向设备下发命令，以实现对设备的远程控制。 物联网平台有同步命令下发和异步命令下发两种命令下发机制，如下表所示。 表1 命令下发概述 命令下发机制
添加设备组 功能介绍 应用服务器可调用此接口新建设备组，一个华为云账号下最多可有1,000个设备组，包括父设备组和子设备组。设备组的最大层级关系不超过5层，即群组形成的关系树最大深度不超过5。 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/device-group
创建规则触发条件 功能介绍 应用服务器可调用此接口在物联网平台创建一条规则触发条件。 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/routing-rule/rules 表1 路径参数 参数 是否必选 参数类型 描述 project_id
创建设备策略 功能介绍 应用服务器可调用此接口在物联网平台创建一个策略，该策略需要绑定到设备和产品下才能生效。 一个实例最多能创建50个设备策略。 仅标准版实例、企业版实例支持该接口调用，基础版不支持。 调用方法 请参见如何调用API。 URI POST /v5/iot/{pro
查询批量任务列表 功能介绍 应用服务器可调用此接口查询物联网平台中批量任务列表，每一个任务又包括具体的任务内容、任务状态、任务完成情况统计等。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/batchtasks 表1 路径参数 参数 是否必选
创建设备代理 功能介绍 应用服务器可调用此接口在物联网平台创建一个动态设备代理规则，用于子设备自主选择网关设备上线和上报消息，即代理组下的任意网关下的子设备均可以通过代理组里其他设备上线(网关更新子设备状态 )然后进行数据上报(网关批量设备属性上报 )。 单实例最多可以配置10个设备代理
修改设备代理 功能介绍 应用服务器可调用此接口修改物联网平台中指定设备代理的基本信息。 调用方法 请参见如何调用API。 URI PUT /v5/iot/{project_id}/device-proxies/{proxy_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id
属性下发 概述 属性下发分为查询设备属性和修改属性参数两种，查询设备属性用于应用侧或平台主动获取设备属性数据，修改属性参数用于应用侧或平台设置设备属性值并同步到设备侧。设备接收到属性下发指令后需要立即响应，如果设备没有响应，平台会认为属性下发执行超时。 使用场景 用于平台主动获取或修改设备属性值。
下发设备消息 功能介绍 物联网平台可向设备下发消息，应用服务器可调用此接口向指定设备下发消息，以实现对设备的控制。应用将消息下发给平台后，平台返回应用响应结果，平台再将消息发送给设备。平台返回应用响应结果不一定是设备接收结果，建议用户应用通过订阅设备消息状态变更通知，订阅后平台会将设备接收结果推送给订阅的应用。
更新指定id的自定义鉴权 功能介绍 应用服务器可调用此接口在物联网平台更新指定id的自定义鉴权。 调用方法 请参见如何调用API。 URI PUT /v5/iot/{project_id}/device-authorizers/{authorizer_id} 表1 路径参数 参数
查询设备 功能介绍 应用服务器可调用此接口查询物联网平台中指定设备的详细信息。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/devices/{device_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id
创建自定义鉴权 功能介绍 应用服务器可调用此接口在物联网平台创建一个自定义鉴权。自定义鉴权是指用户可以通过函数服务自定义实现鉴权逻辑，以对接入平台的设备进行身份认证。 单个实例最大可配置10个自定义鉴权 仅标准版实例、企业版实例支持该接口调用，基础版不支持。 调用方法 请参见如何调用API。
灵活搜索设备列表 功能介绍 接口说明 应用服务器使用SQL语句调用该接口，灵活的搜索所需要的设备资源列表 限制 仅标准版实例、企业版实例支持该接口调用，基础版不支持。 单账号调用该接口的 TPS 限制最大为1/S(每秒1次请求数) 类SQL语法使用说明 类SQL语句由select
查询批量任务 功能介绍 应用服务器可调用此接口查询物联网平台中指定批量任务的信息，包括任务内容、任务状态、任务完成情况统计以及子任务列表等。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/batchtasks/{task_id} 表1
MQTT设备OTA升级 MQTT协议设备软件升级流程 MQTT协议SOTA升级流程的详细说明： 1～2. 用户在设备管理服务的控制台上传软件包，并在控制台或者应用服务器上创建软件升级任务。 3. 平台感知设备是否在线，当设备在线时立即触发升级协商流程。当设备不在线时，等待设备上线
HTTPS协议接入 概述 HTTPS是基于HTTP协议，通过SSL加密的一种安全通信协议。物联网平台支持HTTPS协议通信。 使用限制 描述 限制 支持的HTTP协议版本 支持 Hypertext Transfer Protocol — HTTP/1.0 协议 支持 Hypertext
使用HTTP/HTTPS转发 概述 订阅推送的示意图如下图所示： 物联网平台采用HTTPS协议向应用服务器进行消息推送时，物联网平台需要校验应用服务器的真实性，需要在物联网平台上加载CA证书，该证书由应用服务器侧提供（调测时可自行制作调测证书，商用时建议更换为商用证书，否则会带来安全风险）。
验证设备CA证书 功能介绍 应用服务器可调用此接口在物联网平台验证设备的CA证书，目的是为了验证用户持有设备CA证书的私钥 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/certificates/{certificate_id}/action
查询产品 功能介绍 应用服务器可调用此接口查询已在物联网平台的创建的指定产品模型详细信息，包括产品模型的服务、属性、命令等。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/products/{product_id} 表1 路径参数 参数
修改设备 功能介绍 应用服务器可调用此接口修改物联网平台中指定设备的基本信息。 调用方法 请参见如何调用API。 URI PUT /v5/iot/{project_id}/devices/{device_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
