检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
设备鉴权 接口说明 设备鉴权接口，鉴权通过后建立设备与平台间才能处理业务连接。鉴权成功后平台返回access_token。调用属性上报、消息上报等其他接口时，都需要携带access_token信息。如果access_token超期，需要重新认证设备获取access_token。如
地址推送消息。 回调地址可以使用域名吗？ 可以，IP和域名都支持。使用域名时，如果域名绑定多个IP，需要做好DNS解析，确保DNS解析后的IP地址可达。这种情况下，推荐使用IP地址作为回调地址。 应用服务器只有内网地址，能否订阅成功？ 企业版支持使用内网地址进行订阅。应用服务器需
Forbidden, 4.12 Precondition Failed 物联网平台向设备订阅资源，设备获取到物联网平台下发订阅时的token，调用属性上报等其他接口时，都需要携带token信息。 Operation CoAP Method URI Success Failure Observe
平台消息下发 功能介绍 设备无法按照产品模型中定义的格式进行指令下发时，可使用此接口下发自定义格式的数据给设备。在此之上也可以使用平台封装的标准格式，即在应用侧API的下发设备消息中payload_format填写为“standard”，或者在设备详情页的云端下发-消息下发中下发时选择“按系统格式”。
发布Topic是指设备主动向平台上报自己的属性或消息，详细见设备属性上报接口文档。 在模拟器中实现了上报Topic、属性上报功能。 输入要上报的JSON message，上报luminance属性为30。发布Topic后，Demo界面显示如下： 设备上报属性成功后可在“设备详情”页面查看到上报的属性： 图15 查看上报数据-MQTT
收设备上报到服务端的消息。 MessageDecoder 上行数据的消息解码，将TCP原始码流转换为具体JSON对象。 MessageEncoder 下行数据的消息编码，将对象数据转换为TCP原始码流。 UpLinkHandler 设备上行数据处理类。把TCP协议数据转成平台格式数据，并调用SDK接口进行上报
property：report（设备属性上报） device.message：report（设备消息上报） device.message.status：update（设备消息状态变更） batchtask：update （批量任务状态变更） product：create（产品添加）
权更加精细，可以精确到某个操作、资源和条件，能够满足企业对权限最小化的安全管控要求。 如果您要允许或是禁止某个接口的操作权限，请使用策略。 账号具备所有接口的调用权限，如果使用账号下的IAM用户发起API请求时，该IAM用户必须具备调用该接口所需的权限，否则，API请求将调用失败
该场景主要描述的是应用侧或控制台可以给离线设备下发缓存命令，待设备上线后执行，控制台通过设备影子配置属性，待设备上线后上报的属性不匹配的话，会自动下发属性修改的指令，直至修改成功。 核心知识点：产品模型、编辑码插件、设备影子、属性上报、属性修改。 最佳实践参考：预置设备影子自动调节空调温度。
当设置满足全部条件时，不能同时设置设备属性触发和定时触发，只支持同时设置多种设备属性触发。 触发类型：目前只支持设备属性触发和定时触发。 设备属性触发：设备上报属性时触发。 选择服务：选择对应的服务类型。 选择属性：选择满足条件后上报数据的设备属性。 说明： 属性的数据类型为int和decimal时，支持选择多种判断符号。
PUB OK”，表明上报成功，您可以在设备详情页面查看上报的属性值。 属性上报前需要自定义产品模型或使用平台预置的产品模型。详细操作说明请参考在线开发产品模型，平台预置产品模型。 qos：对应MQTT的qos，建议使用0； topic：平台预置的Topic。更多Topic请参考T
应用侧API参考 使用前必读 如何调用API API概览 API 权限与授权项 应用示例 附录
objects 参数说明：用户自定义属性，可选。用户可以通过该参数配置用户自定义属性。可以配置的最大自定义属性数量为20。 表5 UserPropDTO 参数 是否必选 参数类型 描述 prop_key 否 String 参数说明：用户自定义属性键。 取值范围：长度不超过128，只
备进行批量操作 对多个设备进行批量下发设备控制命令。 批量MQTT设备同步命令下发 单个MQTT设备同步命令下发 属性设置和属性查询分别参考查询设备属性和修改设备属性接口。 图1 命令下发流程图 应用调用下发设备命令接口，下发请求到物联网平台，命令下发消息样例如下： POST h
自定义，如iotda-obs。 规则描述 自定义，如数据转发至OBS存储。 数据来源 选择“设备属性”。 触发事件 自动匹配“设备属性上报”。 资源空间 选择“所有资源空间”。 图2 新建属性上报流转规则-数据转发至OBS 单击“设置转发目标”页签，单击“添加”，设置转发目标。 参数名
start_time 否 String 设备代理开始生效的时间，使用UTC时区，格式：yyyyMMdd'T'HHmmss'Z' end_time 否 String 设备代理失效的时间，必须大于start_time，使用UTC时区，格式：yyyyMMdd'T'HHmmss'Z' 响应参数
发布Topic 发布Topic是指设备主动向平台上报自己的属性或消息，详细见设备属性上报接口文档。 在微信小程序中实现了上报属性数据的功能。 发布Topic后，Demo界面显示如下： 图6 上报数据 设备上报属性成功后可在设备详情页面查看到上报的属性： 图7 查看上报数据-MQTT 订阅Topic
内部函数 使用说明 华为云IoTDA提供了多个内部函数供用户在模板中使用，使用时请认真阅读每个函数的功能定义，包括入参类型，参数长度，返回值类型等。 整个函数必须是合法的Json格式。 函数中可使用${}变量占位符或者"Ref"函数引用入参定义的参数值。 函数所使用的参数必须在模板参数中声明。
或华为云其他云服务上进行存储和处理。 设备属性上报 API 说明 设备属性上报 用于设备按产品模型中定义的格式将属性数据上报给平台。 网关上报子设备属性 用于批量设备上报属性数据给平台。网关设备可以用此接口同时上报最多50个子设备的属性数据。 父主题： 设备侧HTTPS接口参考
现当设备离线达到5分钟后上报告警到应用运维管理平台，设备上线1分钟后恢复该告警。 本文中使用的产品模型和设备仅为示例，您可以使用自己的产品模型和设备进行操作。 访问设备接入服务，单击“立即使用”进入设备接入控制台。选择您的实例，单击实例卡片进入。 选择左侧导航栏的“产品”，单击页
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
