检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
为指定值；不携带时将之置空，后续设备第一次接入时，该设备指纹的值将设置为第一次接入时的证书指纹。 URI POST /v5/iotps/{project_id}/devices/{device_id}/reset-fingerprint 表1 路径参数 参数 是否必选 参数类型 描述
查询设备列表 功能介绍 应用服务器可调用此接口查询物联网平台中的设备信息列表。 URI GET /v5/iotps/{project_id}/devices 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。 最小长度：1 最大长度：32
查询产品列表 功能介绍 应用服务器可调用此接口查询已导入物联网平台的产品模型信息列表，了解产品模型的概要信息。 URI GET /v5/iotps/{project_id}/products 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。
获取设备CA证书列表 功能介绍 应用服务器可调用此接口在物联网平台获取设备的CA证书列表 URI GET /v5/iotps/{project_id}/certificates 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。 最小长度：1
查询发放策略列表 功能介绍 查询发放策略列表 URI GET /v5/iotps/{project_id}/allocation-strategies/{strategy_type} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。
最大长度：128 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 响应参数 状态码： 200 表3 响应Body参数
查询注册组列表 功能介绍 应用服务器可调用此接口查询物联网平台中的注册组信息列表。 URI GET /v5/iotps/{project_id}/registration-groups 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id。
最大长度：128 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选
删除设备接入实例中的该设备。 URI DELETE /v5/iotps/{project_id}/devices/{device_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。 最小长度：1 最大长度：32 device_id
功能简介 设备发放服务主要用于设备在多个IoT平台实例的发放、接入和迁移。设备在出厂时只需要烧录一个地址，然后在云上通过配置或者通过代码控制不同的设备接入不同的IoT平台。设备上电后收到设备发放下发的新的物联网平台连接地址，直接连接新的地址，免去二次烧录设备信息，同时还支持初始化的设备信息同步。
多应用的场景。存在多应用的用户需要使用该接口时，可以携带该参数查询指定应用下的设备列表，不携带该参数则会查询该用户下所有设备列表。 最小长度：1 最大长度：256 响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 device_id String 设备ID
Token的有效期为24小时，需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限。
ces 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id。 最小长度：1 最大长度：32 registration_group_id 是 String 注册组id，用于唯一标识一个注册组 最小长度：1 最大长度：256 表2 Query参数
都可以收到下发的初始化配置。一般来说：设备初始化配置会配合注册组使用。 业务迁移 设备有对接设备发放（设备适配了设备发放能力）。如果设备第一次发放成功接入后，根据业务需要重新接入到新的实例，可以通过再次发放动态修改接入地址。 本场景涉及的功能也适用于多个商用环境间的迁移。 提供在线签发设备证书能力
POST /v5/iotps/{project_id}/devices 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。 最小长度：1 最大长度：32 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token
csr 生成证书签名请求文件时，要求填写证书唯一标识名称（Distinguished Name，DN）信息，参数说明如下表1所示。 表1 证书签名请求文件列表 提示 参数名称 取值样例 Country Name (2 letter code) []: 国家/地区 CN State
使用密钥对生成证书签名请求文件： 生成证书签名请求文件时，要求填写证书唯一标识名称（Distinguished Name，DN）信息，参数说明如下表1 所示。 表1 证书签名请求文件参数说明 提示 参数名称 取值样例 Country Name (2 letter code) []: 国家/地区
MQTT 注册组自定义策略发放示例 获取设备发放终端节点 表1 设备发放节点列表 区域名称 区域 终端节点（Endpoint） 端口 协议 华北-北京四 cn-north-4 iot-bs.cn-north-4.myhuaweicloud.com 8883 MQTTS 整体流程 制作CA证书
备。建议每个设备名称的以策略的关键字开头（比如策略关键字为Model1，设备名称为Model1_XXX001）。 图3 设备列表 图4 注册设备产品列表 图5 创建密钥模式静态策略设备 设备引导请求 终端节点 区域名称 区域 终端节点（Endpoint） 端口 协议 华北-北京四
的设备。 进入“设备-注册组列表”界面，单击左上角“新增注册组”。 图1 新增注册组 按照下方参数说明填写关键参数信息后，完成创建。 表1 注册组关键参数列表 参数名称 说明 注册组名称 注册组的唯一标识。 选择证书 用于和注册组绑定，同一个证书只能同时绑定一个注册组，不能同时绑定多个注册组。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
