检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
重置设备指纹 功能介绍 应用服务器可调用此接口重置设备指纹。携带指定设备指纹时将之重置为指定值；不携带时将之置空，后续设备第一次接入时，该设备指纹的值将设置为第一次接入时的证书指纹。 URI POST /v5/iotps/{project_id}/devices/{device_
509证书认证，并关联已认证的设备CA证书； 3. 开发设备端，将X.509证书及其私钥烧录到设备上； 4. 设备在与平台双向认证过程中，设备验证平台证书，平台使用设备CA证书验证设备证书并验证设备证书与设备的关联关系。 X.509双向证书认证 X.509证书双向认证过程，涉及到设备发放（平台）和设备两端，过程如下图所示。
描述 device_id String 设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。 最小长度：0 最大长度：256 secret String 设备秘钥。 最小长度：8 最大长度：32 请求示例 操作设备（重引导设备） POST https://{endp
息完成接入鉴权。 设备名称 设备发放时，设备名称将作为主要的筛选条件之一，建议按照统一的规则规划不同地区的设备名称。 例如：北京地区设备，设备名称都携带Beijing；香港地区设备，设备名称都携带Hongkong。 设备ID 设备ID默认为产品ID+“_”+设备标识码，用户也可自己定义。
删除设备 功能介绍 应用服务器可调用此接口在物联网平台上删除指定设备。若设备下连接了非直连设备，则必须把设备下的非直连设备都删除后，才能删除该设备。若设备已发放成功，此接口将级联删除设备接入实例中的该设备。 URI DELETE /v5/iotps/{project_id}/devices/{device_id}
最大长度：24 device_id 否 String 设备ID，支持模糊查询。 最小长度：4 最大长度：128 device_name 否 String 设备名称。 最小长度：0 最大长度：256 status 否 String 设备引导状态。 请求参数 表3 请求Header参数 参数
结合函数服务通过自定义策略发放证书认证的设备 场景说明 本文以MQTT.fx的设备模拟器替代真实的设备，结合函数工作流服务（FunctionGraph），带您快速体验结合函数服务使用设备发放服务，通过自定义策略将设备发放到指定的物联网平台（设备接入实例）上。 整体流程 使用证书认证的设备采用自定义策略发放设备操作流程如下图所示。
删除设备CA证书 功能介绍 应用服务器可调用此接口在物联网平台删除设备的CA证书 URI DELETE /v5/iotps/{project_id}/certificates/{certificate_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是
首先确认用户是否开通设备接入服务（物联网平台）。 在设备发放平台创建设备的发放清单（包括预注册设备以及添加发放策略）。 设备出厂时预置设备发放平台地址，设备上电后，设备发放服务通过使用标准 X.509证书验证或者根据设备密钥验证设备的标识，把设备发放到对应的设备接入平台。 设备发放将设备接入平台连接信息返回给设备。
创建静态策略详情 注册设备 在设备发放控制台，注册MQTT设备，其中安全模式选择密钥模式（如果需要下发初始化配置，那么对应在初始设备配置选项中填写对应的JSON字符串，设备发放不理解该字段，只是透传该JSON字符串，由设备理解解析。如果不需要下发改字段则不填）。 图3 注册设备 图4 创建密钥模式静态策略设备
添加静态跨region策略 注册设备 在设备发放控制台，注册MQTT设备，其中安全模式选择密钥模式（如果需要下发初始化配置，那么对应在初始设备配置选项中填写对应的JSON字符串，设备发放不理解该字段，只是透传该JSON字符串，由设备理解解析。如果不需要下发该字段则不填）。 图6 注册设备 图7 创建密钥模式静态策略设备
device_type String 设备类型。 最小长度：0 最大长度：255 model String 设备型号。 最小长度：0 最大长度：255 protocol_type String 设备使用的协议类型。 最小长度：0 最大长度：20 industry String 设备所属行业。 最小长度：0
X.509认证设备。 图3 注册设备 图4 注册云证书设备 下载设备证书 设备注册成功后，单击设备进入设备详情页面，单击“下载”按钮下载设备证书，并烧录到设备。 图5 下载云证书设备证书 连接鉴权 MQTT.fx 是目前主流的MQTT桌面客户端，它支持 Windows, Mac,
状态码 状态码 编码 状态说明 200 OK 请求已成功。 202 Accept 任务提交成功，当前系统繁忙，下发的任务会延迟处理。 204 No Content 请求已成功，无内容返回。 300 multiple choices 被请求的资源存在多个可供选择的响应。 400 Bad
String 设备属性名称。 required Boolean 设备属性是否必选。 data_type String 设备属性的数据类型。 enum_list Array of strings 设备属性的枚举值列表。 数组长度：0 - 1000 min String 设备属性的最小值。
有些设备可能没有证书，又需要使用设备发放功能。对于此类设备，设备发放提供密钥注册组功能。 密钥认证类型的设备组是一个安全性不完备的方案，建议使用证书作为注册组的认证方式。 每个设备的设备代码应该只包含该设备的相应派生设备密钥。 不要在设备代码中包含你的注册组密钥。 泄露的注册组密钥可能会危及所有使用该密钥进行身份验证的设备的安全。
String 注册组名称。 最小长度：1 最大长度：256 provision_info 是 AddProvisionInfo object 新增设备组，设备的发放信息。 表4 AddProvisionInfo 参数 是否必选 参数类型 描述 allocation_strategy_type
注册组 MQTT证书接入的设备，可以在设备发放创建一个注册组，绑定对应的CA证书和自定义策略，可以实现批量设备的自注册，实现设备一键上电即可上云的动作，可在注册组详情中查看该注册组下所有的设备。 进入“设备-注册组列表”界面，单击左上角“新增注册组”。 图1 新增注册组 按照下方参数说明填写关键参数信息后，完成创建。
查询注册组详情 功能介绍 应用服务器可调用此接口查询物联网平台中注册组详情。 URI GET /v5/iotps/{project_id}/registration-groups/{registration_group_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id
设备 注册设备 注册组
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
