检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
平台设置设备属性 功能介绍 用于平台设置设备属性。设备的产品模型中定义了平台可向设备设置的属性，平台可调用此修改设备属性接口设置指定设备的属性数据。设备收到属性设置请求后，需要将执行结果返回给平台，如果设备没回响应平台会认为属性设置请求执行超时。 低配置且资源受限或者对网络流量有
备不回响应(平台则认为设备侧未适配影子设置流程，平台设置设备属性)，则平台有个5 分钟的保护期，避免过多流量冲击设备，保护期内设备属性上报时，平台比对reported和desired即使有差异，也不会下发差值。设备正常适配下发流程中的属性设置响应，平台则每次属性上报都会将差值下发给设备。
设备的产品模型中定义了物联网平台可向设备下发的属性，应用服务器可调用此接口向设备发送指令用以查询设备的实时属性, 并由设备将属性查询的结果同步返回给应用服务器。 注意：此接口适用于MQTT设备，暂不支持NB-IoT设备。 调用方法 请参见如何调用API。 URI GET /v5/io
物联网平台采用HTTPS协议向应用服务器进行消息推送时，物联网平台需要校验应用服务器的真实性，需要在物联网平台上加载CA证书，该证书由应用服务器侧提供（调测时可自行制作调测证书，商用时建议更换为商用证书，否则会带来安全风险）。 推送机制：物联网平台向应用服务器推送消息后，如果应用服务器接收消息成功，会向物联网平台返回200
通过泛协议SDK开发的插件镜像可以通过华为云的ECS服务器或者云容器实例进行部署和自运维。本章节介绍如何用华为云的云容器实例（CCI）进行 泛协议镜像的部署。 创建命名空间 登录云容器实例管理控制台。 在左侧导航栏中选择“命名空间”，在右侧页面中“通用计算型”命名空间下单击“创建”。 填写命名空间名称。 设置VPC，
图1 泛协议-泛协议接入 选择“云网关”，单击“新增云网关” 。端口填写为“8890”。镜像选择镜像名称为“protocol-plugin-hj212”的镜像。 图2 泛协议-部署成功HJ212 防火墙放通8890端口（TCP）。 父主题： HJ212协议接入
50 调用说明 物联网平台的Endpoint请参见：地区和终端节点。 使用“设备接入-> HTTPS(443)”对应的Endpoint，端口为443。 HTTPS设备与物联网平台通信 设备使用HTTPS协议接入平台时，平台和设备通过https接口调用通信。通过这些接口，平台和设
泛协议-泛协议接入 选择“云网关”，单击“新增云网关” 。端口填写为“8898”。镜像选择镜像名称为“protocol-plugin-sl651”的镜像。 图2 泛协议-部署成功SL651 防火墙和安全组需要放通8898端口（TCP）。 父主题： SL651协议接入
设备的产品模型中定义了物联网平台可向设备下发的命令，应用服务器可调用此接口向指定设备下发命令，以实现对设备的同步控制。平台负责将命令以同步方式发送给设备，并将设备执行命令结果同步返回, 如果设备没有响应，平台会返回给应用服务器超时，平台超时时间是20秒。如果命令下发需要超过20秒，建议采用消息下发。
AT+HMPKS 该指令用于设置服务器或者客户端证书。 指令 参数 参数缺省处理 AT响应结果 使用示例 AT+HMPKS =type, para1,[para2] type=0，表示平台证书，证书在para1中。 type=1，表示设备公钥证书，证书在para1中。 type=
设备消息上报 接口说明 用于设备将自定义数据上报给平台，平台将设备上报的消息转发给应用服务器或华为云其他云服务上进行存储和处理。 URI 请求方法 POST URI /v5/devices/{device_id}/sys/messages/up 传输协议 HTTPS 请求参数 名称
OK（连接成功） serverip：设备接入服务器地址或者BS服务器地址。 默认值：BS服务器地址 +HMCON ERR：code（连接失败，code表示失败原因码） serverport：设备接入服务器端口或者BS服务器端口。 默认值：MQTTS端口8883 - id：设备ID，最大长度256。
status，Event:update）、创建规则动作并激活规则后，当命令状态变更时，物联网平台会根据规则将结果发送到规则指定的服务器，如用户自定义的HTTP服务器，AMQP服务器，以及华为云的其他存储服务器等, 详情参考设备命令状态变更通知。 注意： 此接口适用于NB设备异步命令下发，暂不支持其他协议类型设备命令下发。
修改规则动作 功能介绍 应用服务器可调用此接口修改物联网平台中指定规则动作的配置。 调用方法 请参见如何调用API。 URI PUT /v5/iot/{project_id}/routing-rule/actions/{action_id} 表1 路径参数 参数 是否必选 参数类型
档。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/devices/{device_id}/shadow 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数说明：项目ID。获取方法请参见 获取项目ID
设备状态变更通知 功能介绍 应用服务器在调用物联网平台的创建规则触发条件（Resource:device.status，Event:update）、创建规则动作、修改规则触发条件接口配置并激活规则后，当物联网平台中的设备状态发生变更时，物联网平台会向应用服务器推送通知消息。 URI POST
置后的密钥。 图1 应用详情界面 应用服务器调用接口失败怎么处理？ 请检查应用服务器的网络连接情况，确保应用服务器网络正常。 检查请求中物联网平台的应用接入地址和端口是否正确。 使用“ping {物联网平台应用接入地址}”命令，查看应用服务器是否可以正常访问物联网平台的应用接入地址。
查询规则动作列表 功能介绍 应用服务器可调用此接口查询物联网平台中设置的规则动作列表。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/routing-rule/actions 表1 路径参数 参数 是否必选 参数类型 描述 project_id
调用订阅接口时，提示回调地址不合法？ 回调地址需要包含公网IP（或域名）、端口和文件路径： 正确示例：http://IP:PORT/filePath或http://IP:PORT/。 错误示例：http://IP:PORT或http://IP/filePath。 回调地址必须为https的吗？
数据转发至OBS长期存储 场景说明 对于设备上报的数据，可以选择让平台将设备上报数据推送给应用服务器，由应用服务器进行保存；还可以选择让平台将设备上报数据转发给对象存储服务（OBS），由OBS进行存储。 本示例为将所有设备上报的数据转发至OBS存储。 创建OBS桶 登录华为云官方网站，访问对象存储服务。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
