检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
设备请求引导消息 接口功能 设备向发放服务请求对应设备接入实例的引导信息。 Topic 表1 上报Topic说明 Topic $oc/devices/{device_id}/sys/bootstrap/up 消息发送方 设备 消息接收方 设备发放平台 示例 设备向发放服务发送的payload为空。
事件时间。UTC时间，格式：yyyyMMdd'T'HHmmss'Z'。 设备上报数据不带该参数或参数格式错误时，则数据上报时间以平台时间为准。 paras 必选 Object 参数解释： 设备服务的事件列表，具体字段在设备关联的产品模型中定义。 paras参数列表 字段名 必选/可选 类型
509证书认证的设备 X.509是一种用于通信实体鉴别的数字证书，物联网平台支持设备使用自己的X.509证书进行认证鉴权。使用X.509认证技术时，设备无法被仿冒，避免了密钥被泄露的风险。 注册X.509证书认证的设备前，您需要先在物联网平台上传设备的CA证书，然后在注册设备时将设备证
单账号调用该接口的 TPS 限制最大为1/S(每秒1次请求数)。 使用场景 设备检索：在所有设备-设备列表界面通过类SQL语句方式，检索指定的设备进行后续管理操作。 设备动态分组：通过设备动态分组的类SQL语句规则，过滤出来符合条件的设备自动加入到群组进行管理。 操作步骤 访问设备接入服务
header）中的主要参数“Topic name”，指当设备上报到物联网平台，发布者为设备时所对应的Topic。详细请参考Topic定义。 有效载荷（Payload）中的主要参数为完整的数据上报和命令下发的消息内容，目前是一个JSON对象。 Topic说明 设备使用MQTT协议接入时
在上传软固件包时，需要填写如下信息： 参数名称 说明 固件(软件)版本 固件(软件)包的版本。（设备升级完成后需要上报升级版本号，平台检查设备上报的版本号是否与此参数一致，一致为升级成功。） 选择产品 选择对应设备的产品模型。 支持设备源版本 支持升级的设备的源版本号。手动输入，如需输入多个，可以在输入完一个版本后，单击“回车”按键，再输入下一个。
设备命令ID，用于唯一标识一条命令，在下发设备命令时由物联网平台分配获得。 service_id String 设备命令所属的设备服务ID，在设备关联的产品模型中定义。 command_name String 设备命令名称，在设备关联的产品模型中定义。 expire_time Integer 物联网平台缓存命令的时长，
自定义模板鉴权是指用户可以使用平台提供的内部函数实现自定义的鉴权方式，而不需使用平台默认鉴权方式，对接入平台的设备进行身份认证，用户可以通过平台预置的函数灵活编排鉴权方式。 应用场景 迁移场景：当设备从第三方物联网平台迁移到华为云IoTDA时，通过配置平台提供的自定义鉴权模板可以兼容原来的鉴权方式，设备侧无需改动实现无缝迁移。
在物联网平台中，某一类具有相同能力或特征的设备的合集被称为一款产品。 操作步骤 访问设备接入服务，单击“管理控制台”进入设备接入控制台。选择您的实例，单击实例卡片进入。 单击左侧导航栏“产品”，单击页面左侧的“创建产品”。根据页面提示填写参数，然后单击“确定”，完成产品的创建。 基本信息 所属资源空间
每个IoTDA实例最多支持创建5个异常数据转发目标。 支持异常数据转发目标的规则数据来源：设备、设备属性、设备消息、设备消息状态、设备状态、批量任务、产品和设备异步命令状态。 支持配置异常数据转发的正常转发目标类型：数据接入服务（DIS）、分布式消息服务（Kafka）、对象存储服务（OBS）、应用与数据集成平台（ROMA
使用场景 全球设备，单点发放 无需人工干预，在设备出厂时对设备的接入信息进行硬编码，设备统一烧录全球统一的设备发放接入信息，通过全球统一的设备发放服务实现跨区域的自动发放能力。 多用户隔离 设备出厂前统一在设备发放管理和接入，根据配置实现出厂后接入到不同用户的IoT平台。 动态完成不同批次设备初始化配置
获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 Instance-Id 否 String 参数说明：实例ID。物理多租下各实例的唯一标识，建议携带该参数，在使用专业版时
关权限，即列表内任意一个网关下的子设备可以通过组里任意一个网关上线然后进行数据上报。 取值范围：列表内填写设备id，列表内最少有2个设备id，最多有10个设备id，设备id取值范围：长度不超过128，只允许字母、数字、下划线（_）、连接符（-）的组合，建议不少于4个字符。 effective_time_range
修改设备属性 功能介绍 设备的产品模型中定义了物联网平台可向设备下发的属性，应用服务器可调用此接口向指定设备下发属性。平台负责将属性以同步方式发送给设备，并将设备执行属性结果同步返回。 注意：此接口适用于MQTT设备，暂不支持NB-IoT设备。 调用方法 请参见如何调用API。 URI
下发设备消息 功能介绍 物联网平台可向设备下发消息，应用服务器可调用此接口向指定设备下发消息，以实现对设备的控制。应用将消息下发给平台后，平台返回应用响应结果，平台再将消息发送给设备。平台返回应用响应结果不一定是设备接收结果，建议用户应用通过订阅设备消息状态变更通知，订阅后平台会将设备接收结果推送给订阅的应用。
解冻设备 功能介绍 应用服务器可调用此接口解冻设备，解除冻结后，设备可以连接上线。该接口仅支持解冻单个设备，如需批量解冻设备，请参见 创建批量任务。 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/devices/{device_id}/unfreeze
平台消息下发 功能介绍 设备无法按照产品模型中定义的格式进行指令下发时，可使用此接口下发自定义格式的数据给设备。在此之上也可以使用平台封装的标准格式，即在应用侧API的下发设备消息中payload_format填写为“standard”，或者在设备详情页的云端下发-消息下发中下发时选择“按系统格式”。
设备接入服务如何获取设备数据？ 全新升级后的设备接入服务获取设备数据，需要通过规则引擎，将数据转发至其他服务获取。例如转发至OBS存储，转发至DIS或DMS后再发送至应用服务器。 父主题： 方案咨询
设备Topic策略使用前必读 设备策略主要用于对发布/订阅的非oc开头自定义topic中的数据进行传输限制。能够管理客户端发布/订阅主题的授权。借助策略功能，可以保证非$oc开头的自定义Topic的通信安全。设备Topic策略用于发布、订阅机制的协议，比如说设备侧的MQTT、MQTTS协议。目前华南友好局点支持。
header）：Topic name，设备发往设备发放平台时，为平台的Topic name，设备接收消息时，为设备的Topic name，具体参见Topic说明。 有效载荷（Payload）中的主要参数填写：为完整的数据上报和命令下发的消息内容，目前是一个JSON对象。 Topic说明 设备发放平台作为消
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
