检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
设备侧对接 定义产品 访问设备接入服务，单击“管理控制台”进入设备接入控制台。选择您的实例，单击实例卡片进入。 在左侧导航栏选择“产品”，单击左侧“创建产品”。 图1 创建产品-HJ212 单击“更多-详情”进入产品详情页面，单击“基本信息”中“上传模型文件”，导入hj212_product_model.zip
统计设备下的历史命令总数 功能介绍 统计设备下的历史命令总数。 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/devices/{device_id}/async-commands-history/count 表1 路径参数 参数 是否必选
删除产品 功能介绍 应用服务器可调用此接口删除已导入物联网平台的指定产品模型。此接口仅删除了产品，未删除关联的插件，在产品下存在设备时，该产品不允许删除。 调用方法 请参见如何调用API。 URI DELETE /v5/iot/{project_id}/products/{product_id
网关删除子设备请求响应 功能介绍 平台将该网关删除的子设备列表信息通知给网关设备。平台收到网关删除子设备请求后会在30秒内通过此接口返回响应消息。网关与子设备关系，请查看网关与子设备。 Topic 下行: $oc/devices/{device_id}/sys/events/down
网关更新子设备状态 功能介绍 网关更新子设备状态，更新结果通过网关更新子设备状态响应接口通知网关设备。网关与子设备关系，请查看网关与子设备。 接口tps限制为直连设备并发建链的1.5倍。即为单个实例每秒最大建立请求连接数量为100*购买单元数量 *1.5。 该接口1次调用的tps为
查询产品 功能介绍 应用服务器可调用此接口查询已在物联网平台的创建的指定产品模型详细信息，包括产品模型的服务、属性、命令等。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/products/{product_id} 表1 路径参数 参数
修改产品 功能介绍 应用服务器可调用此接口修改已导入物联网平台的指定产品模型，包括产品模型的服务、属性、命令等。此接口仅修改了产品，未修改和安装插件，如果修改了产品中的service定义，且在平台中有对应的插件，请修改并重新安装插件。 调用方法 请参见如何调用API。 URI PUT
网关批量设备属性上报 功能介绍 用于批量设备上报属性数据给平台。网关设备可以用此接口同时上报多个子设备的属性数据。网关与子设备关系，请查看网关与子设备。 属性上报和消息上报的区别，请查看消息通信说明。 网关批量设备属性上报，单批次最多可上报100个子设备的属性数据。如果子设备数量超过
网关更新子设备状态响应 功能介绍 平台将该网关更新子设备状态结果以列表返回，平台收到网关更新子设备状态请求后会在30秒内通过此接口返回响应消息。网关与子设备关系，请查看网关与子设备。 Topic 下行: $oc/devices/{device_id}/sys/events/down
查询自定义鉴权详情 功能介绍 应用服务器可调用此接口在物联网平台查询指定自定义鉴权ID的详细信息。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/device-authorizers/{authorizer_id} 表1 路径参数 参数
更新CA证书 功能介绍 应用服务器可调用此接口在物联网平台上更新CA证书。仅标准版实例、企业版实例支持该接口调用，基础版不支持。 调用方法 请参见如何调用API。 URI PUT /v5/iot/{project_id}/certificates/{certificate_id}
物理多租下各实例的唯一标识，一般华为云租户无需携带该参数，仅在物理多租场景下从管理面访问API时需要携带该参数。您可以在IoTDA管理控制台界面，选择左侧导航栏“总览”页签查看当前实例的ID。
平台通知网关子设备新增 功能介绍 平台将该网关新增的子设备列表信息通知给网关设备。网关与子设备关系，请查看网关与子设备。 Topic 下行: $oc/devices/{device_id}/sys/events/down 参数说明 字段名 必选/可选 类型 参数描述 object_device_id
自定义模板示例 示例1 证书认证设备，不限制UserName与ClientId参数取值，从设备证书通用名称（Common Name）中取值设备ID。 表1 鉴权参数 参数 说明 Client ID 任意值 User Name 任意值 Password 空值 鉴权模板： { "template_name
网关新增子设备请求响应 功能介绍 平台将该网关新增的子设备列表信息通知给网关设备，平台收到网关新增子设备请求后会在30秒内通过此接口返回响应消息。网关与子设备关系，请查看网关与子设备。 Topic 下行: $oc/devices/{device_id}/sys/events/down
产品添加通知 功能介绍 应用服务器在调用物联网平台的创建规则触发条件（Resource:product，Event:create）、创建规则动作、修改规则触发条件接口配置并激活规则后，当物联网平台中的产品添加时，物联网平台会向应用服务器推送通知消息。 URI POST /由应用服务器创建产品添加通知规则的转发目标决定
删除设备CA证书 功能介绍 应用服务器可调用此接口在物联网平台删除设备CA证书 调用方法 请参见如何调用API。 URI DELETE /v5/iot/{project_id}/certificates/{certificate_id} 表1 路径参数 参数 是否必选 参数类型 描述
产品更新通知 功能介绍 应用服务器在调用物联网平台的创建规则触发条件（Resource:product，Event:update）、创建规则动作、修改规则触发条件接口配置并激活规则后，当物联网平台中的产品更新时，物联网平台会向应用服务器推送通知消息。 URI POST /由应用服务器创建产品更新通知规则的转发目标决定
C Demo使用说明 概述 本文以C语言为例，介绍通过MQTTS/MQTT协议接入平台，基于平台接口实现“属性上报”、“订阅接收命令”等功能。 本文中使用的代码为样例代码，仅用于体验平台通信功能，如需进行商用，可以参考资源获取获取对应语言的IoT Device SDK进行集成。 前提条件
创建设备隧道 功能介绍 用户可以通过该接口创建隧道（WebSocket协议），应用服务器和设备可以通过该隧道进行数据传输。 该API接口在基础版不支持。 该API调用后平台会向对应的MQTT/MQTTS设备下发隧道地址及密钥，同时给应用服务器也返回隧道地址及密钥，设备可以通过该地址及密钥创建
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
