检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
使用前必读 MQTT概述 MQTT标准规范参见《mqtt-v3.1.1-os.pdf》。 MQTT的语法和接口细节，请以此标准为准。设备发放目前仅支持MQTTS/HTTPS这种安全接入的设备进行发放，暂不支持MQTT/HTTP这种非安全接入的设备进行发放。 MQTT消息分为固定报头（Fixed
设备不存在 请确认设备信息填写是否正确 400 IoTDP.100211 node id already exists. 设备标识码已存在 请确认设备信息填写是否正确 400 IoTDP.100212 Device cannot update. 设备信息不可更新 当前设备信息不可更新 400
注册设备 注册设备用于将设备基本信息导入设备发放平台中，用于后续发放至不同的物联网平台，支持批量注册和单个注册。设备注册成功后，可在“设备-注册”中查看设备的详细信息。 所需“产品”来自 设备接入服务 创建的产品，相关信息参见 创建产品。 单个/批量导入 进入“设备-注册”界面，单击右上角“注册”或“批量注册”。
查询接入点详情 功能介绍 查询接入点接入信息。 URI GET /v5/iotps/{project_id}/access-points/{access_point_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。 最小长度：1
码控制不同的设备接入不同的IoT平台。设备上电后收到设备发放下发的新的物联网平台连接地址，直接连接新的地址，免去二次烧录设备信息，同时还支持初始化的设备信息同步。
设备数量不多； 对设备身份标识和认证信息可提前规划； 产线侧与应用侧可紧密配合。 设备数量多； 对设备身份标识和认证信息可提前规划。 设备数量较多； 设备能力强； 对设备注册的灵活性要求高。 过程 应用侧通过多次调用单个注册API将设备信息（包括但不限于身份标识和认证信息）逐一注册到平台； 产
MQTT CONNECT连接鉴权 接口功能 设备发放平台设备侧支持MQTT协议的connect消息接口，接口规范参考MQTT标准规范，鉴权通过后建立设备与平台间的MQTT连接。 设备发放平台目前只支持MQTTS接入，设备通过connect消息接口和平台建立MQTT连接时，需要使用
查询产品 功能介绍 应用服务器可调用此接口查询已导入物联网平台的指定产品模型详细信息，包括产品模型的服务、属性、命令等。 URI GET /v5/iotps/{project_id}/products/{product_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id
es Array of RegistrationGroupDevices objects 注册组信息。 数组长度：0 - 1000 page Page object 查询结果的分页信息。 表5 RegistrationGroupDevices 参数 参数类型 描述 device_id
修改注册组 功能介绍 应用服务器可调用此接口修改物联网平台中指定注册组的基本信息。 URI PUT /v5/iotps/{project_id}/registration-groups/{registration_group_id} 表1 路径参数 参数 是否必选 参数类型 描述
String 设备的描述信息。 最小长度：1 最大长度：2048 product_id 否 String 设备关联的产品ID，用于唯一标识一个产品模型。 auth_info 否 AuthInfoWithoutSecret object 设备的接入认证信息。 provision_info
registration_groups Array of RegistrationGroupInfoDTO objects 注册组信息。 数组长度：0 - 1000 page Page object 查询结果的分页信息。 表5 RegistrationGroupInfoDTO 参数 参数类型 描述 certificate_id
查询产品列表 功能介绍 应用服务器可调用此接口查询已导入物联网平台的产品模型信息列表，了解产品模型的概要信息。 URI GET /v5/iotps/{project_id}/products 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。
设备出厂时预置设备发放平台地址，设备上电后，设备发放服务通过使用标准 X.509证书验证或者根据设备密钥验证设备的标识，把设备发放到对应的设备接入平台。 设备发放将设备接入平台连接信息返回给设备。 设备通过收到的设备接入平台连接信息连接到设备接入平台。
devices Array of QueryDeviceSimplify objects 设备信息列表。 数组长度：0 - 1000 page Page object 查询结果的分页信息。 表5 QueryDeviceSimplify 参数 参数类型 描述 device_id String
GATEWAY：直连设备或网关。 UNKNOWN：未知。 description String 设备的描述信息。 最小长度：0 最大长度：2048 auth_info AuthInfo object 设备的接入认证信息。 product_id String 设备关联的产品ID，用于唯一标识一个产品模型。
使用场景 全球设备，单点发放 无需人工干预，在设备出厂时对设备的接入信息进行硬编码，设备统一烧录全球统一的设备发放接入信息，通过全球统一的设备发放服务实现跨区域的自动发放能力。 多用户隔离 设备出厂前统一在设备发放管理和接入，根据配置实现出厂后接入到不同用户的IoT平台。 动态完成不同批次设备初始化配置
客户端程序，单击“设置”。 填写 Connection Profile 相关信息和 General 信息。其中General 信息可以用工具默认的参数配置。 填写 User Credentials 信息。 其中Username 和Password 参数参考MQTT CONNECT连接鉴权参数说明。
设备接收引导信息 接口功能 设备接收发放服务下发的引导信息。 Topic 表1 下发Topic说明 Topic $oc/devices/{device_id}/sys/bootstrap/down 消息发送方 设备发放平台 消息接收方 设备 参数说明 表2 下发参数说明 参数 必选/可选
设备请求引导消息 接口功能 设备向发放服务请求对应设备接入实例的引导信息。 Topic 表1 上报Topic说明 Topic $oc/devices/{device_id}/sys/bootstrap/up 消息发送方 设备 消息接收方 设备发放平台 示例 设备向发放服务发送的payload为空。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
