检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
NET SDK使用指南 物联网平台提供C#语言的应用侧SDK供开发者使用。本文介绍.NET SDK的安装和配置，及使用.NET SDK调用应用侧API的示例。 SDK获取和安装 安装.NET开发环境。 访问.NET官网，下载并按说明安装.NET开发环境。 华为云.NET SDK适用于：
expires 可选 Integer 参数解释： url的超期时间。 sign 可选 String 参数解释： 上传OBS升级包时输入的SHA256算法计算出的升级包签名值。 custom_info 可选 String 参数解释： 推送给设备的自定义信息。 task_id 可选 String 参数解释：
<私钥文件> | openssl md5 若两个MD5值不同，则证书和私钥文件内容不匹配，建议您填写正确的设备证书和私钥文件。 图5 比较MD5计算样例 排查设备与证书指纹的绑定关系。 启用该设备的消息跟踪，通过消息跟踪定位后续原因。 如何设置设备名称？ 在设备接入服务的控制台添加设备时，支持配置设备名称。
查询设备属性 功能介绍 设备的产品模型中定义了物联网平台可向设备下发的属性，应用服务器可调用此接口向设备发送指令用以查询设备的实时属性, 并由设备将属性查询的结果同步返回给应用服务器。 注意：此接口适用于MQTT设备，暂不支持NB-IoT设备。 调用方法 请参见如何调用API。 URI
pack、.exe、.bat、.img格式的文件。 取值范围：长度不超过1024。 sign 否 String 参数说明：SHA256算法计算出的升级包签名值。添加该升级包完成，并创建升级任务后，物联网平台向设备下发升级通知时，会下发该签名给设备。 取值范围：长度为64，只允许大小写字母a到f、数字的组合。
not allowed. Max group depths (5) reached. 该设备组深度已达上限（5），不允许再次注册子设备组。 请更换深度较小的父设备组的ID进行注册，该群组深度已达上限，不允许再注册子群组。 403 IOTDA.003005 Operation not
修改设备属性 功能介绍 设备的产品模型中定义了物联网平台可向设备下发的属性，应用服务器可调用此接口向指定设备下发属性。平台负责将属性以同步方式发送给设备，并将设备执行属性结果同步返回，如果设备没有响应，平台会返回给应用服务器超时，平台超时时间是20秒。 注意：此接口适用于MQTT设备，暂不支持NB-IoT设备。
设备侧获取平台的设备影子数据 功能介绍 用于设备向平台获取设备影子数据。用户可以通过应用服务器或物联网控制台配置设备影子预期数据，设备上线时订阅该topic，可以获取到平台设备影子数据，以此来同步设备属性期望值，从而完成设备属性值的修改。 简单交互逻辑介绍如下： ① 应用调用“配
查询设备影子数据 功能介绍 应用服务器可调用此接口查询指定设备的设备影子信息，包括对设备的期望属性信息（desired区）和设备最新上报的属性信息（reported区）。 设备影子介绍： 设备影子是一个用于存储和检索设备当前状态信息的JSON文档。 每个设备有且只有一个设备影子，由设备ID唯一标识
设备影子 概述 物联网平台支持创建设备的“影子”。设备影子是一个JSON文件，用于存储设备的在线状态、设备最近一次上报的设备属性值、应用服务器期望下发的配置。每个设备有且只有一个设备影子，设备可以获取和设置设备影子以此来同步设备属性值，这个同步可以是影子同步给设备，也可以是设备同步给影子。
命令下发 概述 为能有效地对设备进行管理，设备的产品模型中定义了物联网平台可向设备下发的命令，应用服务器可以调用物联网平台应用侧API接口向设备下发命令，以实现对设备的远程控制。 物联网平台有同步命令下发和异步命令下发两种命令下发机制，如下表所示。 表1 命令下发概述 命令下发机制
设备消息上报 接口说明 用于设备将自定义数据上报给平台，平台将设备上报的消息转发给应用服务器或华为云其他云服务上进行存储和处理。 URI 请求方法 POST URI /v5/devices/{device_id}/sys/messages/up 传输协议 HTTPS 请求参数 名称
MQTT over WebSocket 使用说明 概述 本文以JavaScript为例，介绍基于WebSocket的MQTTS/MQTT协议接入平台，使应用程序或者小程序可以快速接入到平台，通过平台接口实现“属性上报”、“订阅接收命令”等功能。 本文中使用的代码为样例代码，仅用于
上传批量任务文件 功能介绍 应用服务器可调用此接口上传批量任务文件，用于创建批量任务。当前支持批量创建设备任务、批量删除设备任务、批量冻结设备任务、批量解冻设备任务的文件上传。 批量注册设备模板 批量删除设备模板 批量冻结设备模板 批量解冻设备模板 调用方法 请参见如何调用API。
审计与日志 审计 云审计服务（Cloud Trace Service，CTS），是华为云安全解决方案中专业的日志审计服务，提供对各种云资源操作记录的收集、存储和查询功能，可用于支撑安全分析、合规审计、资源跟踪和问题定位等常见应用场景。CTS的详细介绍和开通配置方法，请参见CTS快速入门。
{"Fn::ArraySelect": [index, [StringArray]]} 表1 参数说明 参数名称 类型 说明 index int 整型，数组元素索引值，从0开始计算。 StringArray String[] 字符串数组元素。 返回值 String 索引为index的元素。 示例如下： { "Fn::ArraySelect":
创建设备代理 功能介绍 应用服务器可调用此接口在物联网平台创建一个动态设备代理规则，用于子设备自主选择网关设备上线和上报消息，即代理组下的任意网关下的子设备均可以通过代理组里其他设备上线(网关更新子设备状态 )然后进行数据上报(网关批量设备属性上报 )。 单实例最多可以配置10个设备代理
广播通信概述 概述 广播通信常用于一对多的消息通信。多个设备订阅相同的广播Topic，应用服务器调用广播消息下发的接口指定广播Topic的名称，就可以给已订阅该广播Topic的所有在线设备发布消息。广播模式的典型用途是根据设备的类别向设备发送通知。 例如，地震局给指定区域内的所有公民发送地震预警信息。
使用前必读 概述 MQTT是一种底层传输协议，一般用于网络通信，它提供有序有的、可靠的、双向字节流传输，支持设备到云端和云端到设备之间的消息传递，是基于发布/订阅模模式的“轻量级”通信协议。MQTT最大优点在于，可以以极少的代码和有限的带宽，为连接远程设备提供实时可靠的消息服务。
LwM2M/CoAP协议接入 概述 LwM2M（Lightweight M2M，轻量级M2M），由开发移动联盟（OMA）提出，是一种轻量级的、标准通用的物联网设备管理协议，可用于快速部署客户端/服务器模式的物联网业务。LwM2M为物联网设备的管理和应用建立了一套标准，它提供了轻便
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
