检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
使用前必读 概述 物联网平台把自身丰富的管理能力通过API的形式对外开放，包括接入点管理、证书管理、设备管理、 产品管理、注册组管理、策略管理等，帮助用户快速构筑基于物联网平台的行业应用。您可以根据本文档提供的API来使用物联网平台的服务，平台支持的全部API请参见API列表。 调用说明
查询静态策略请求示例 GET https://{endpoint}/v5/iotps/{project_id}/allocation-strategies/base/599d1975-ec30-4a5f-a390-ef388a1fbc70 查询证书策略请求示例 GET https://{endp
静态策略结构体。策略类型为静态策略(base)时必填。 cert_strategy_info 否 CertStrategyInfoReq object 证书策略结构体。策略类型为证书策略(certificates)时必填。 function_strategy_info 否 FunctionStrategyReq
最大长度：64 请求示例 查询静态策略请求示例 GET https://{endpoint}/v5/iotps/{project_id}/allocation-strategies/base 查询证书策略请求示例 GET https://{endpoint}/v5/iotps/{pr
应用服务器可调用此接口重置设备指纹。携带指定设备指纹时将之重置为指定值；不携带时将之置空，后续设备第一次接入时，该设备指纹的值将设置为第一次接入时的证书指纹。 URI POST /v5/iotps/{project_id}/devices/{device_id}/reset-fingerprint
设备证书名称，CA证书选择云证书管理服务的CA证书接入需要填写该字段。此名称会也即设备证书使用者的CommanName device_cert_validity Integer 生成设备证书的有效期。CA证书选择云证书管理服务的CA证书可填写该字段。 最小值：1 最大值：10 device_cert_id String
添加文件”，上传此前“制作CA证书”步骤中生成的“CA证书（rootCA.crt文件）”，单击“确定”。 图4 上传CA证书详情页 上传的CA证书初始状态为“未验证”，需要完成“验证CA证书”过程，方可正常使用该CA证书。 表3 证书状态表 CA证书状态 说明 已验证 可正常使用。
设备引导请求 终端节点 区域名称 区域 终端节点（Endpoint） 端口 协议 华北-北京四 cn-north-4 iot-bs.cn-north-4.myhuaweicloud.com 8883 MQTTS 下载并修改华为SDK示例代码进行设备引导（这里以java sdk代码为示例）。
String 项目ID。 最小长度：1 最大长度：32 strategy_type 是 String 策略类型。支持静态策略(base)、证书策略(certificates)、自定义策略(functions)多种策略类型。 缺省值：base strategy_id 是 String
fx接入设备发放示例 MQTT 密钥设备使用静态策略发放示例 MQTT X.509证书认证设备使用证书策略发放示例 MQTT 注册组自定义策略发放示例 MQTT 华为云X.509证书认证设备使用证书策略发放示例 MQTT 华为云证书注册组发放示例 MQTT 注册组静态策略发放示例 MQTT 注册组密钥认证静态策略发放示例
Access，IoTDA） 创建产品 创建自定义策略时需要使用函数 函数工作流服务（FunctionGraph） 创建并初始化函数 创建证书策略使用云证书时，需要去云证书管理服务创建云证书 云证书管理服务（Cloud Certificate Manager Service，CCM） 创建私有CA
查询单个设备CA证书 应用服务器可调用此接口在物联网平台查询设备的CA证书。 更新单个设备CA证书 应用服务器可调用此接口在物联网平台更新设备的CA证书。 生成CA证书验证码/验证设备CA证书 应用服务器可调用此接口在物联网平台生成CA证书验证码或验证设备的CA证书。 设备管理 API 说明
实例，可以通过再次发放动态修改接入地址。 本场景涉及的功能也适用于多个商用环境间的迁移。 提供在线签发设备证书能力 设备发放能提供在线签发设备证书能力，设备厂商无需加密管理设备的CA证书和设备证书，或者具备PKI证书颁发能力，通过设备发放在线签发设备证书，实现设备的安全认证。 具体使用示例参考MQTT
策略类型。目前支持静态策略(base)，证书策略(certificates)和自定义策略(functions) 缺省值：functions certificate_id 否 String 证书id。使用第三方上传CA，证书ID为设备发放服务生成的证书id，使用云证书CA，证书ID为云证书服务生成的证书ID。 最小长度：0
exist 证书名已存在 请确认证书信息是否正确 400 IoTDP.100216 certificate parsing error 证书解析失败 请确认证书内容是否正确 400 IoTDP.100217 certificate already exists 证书已存在 请更换证书
subjectCnName String 证书使用者CN NAME。 caCertName String 证书名。 fingerprint String 证书指纹。 表9 DeviceCertPara 名称 类型 说明 subjectCnName String 证书使用者CN NAME。 issuerCnName
集成LiteOS的设备（LwM2M） 支持 证书 数字证书保证系统内各服务及系统与外部通信的安全性，防止通信数据在传输过程被篡改造成安全风险。 100 策略 自定义策略最多可添加的实例数 10 静态策略最多可添加的实例数 20 证书策略最多可添加的实例数 20
策略 策略用于控制设备按照指定策略或规则发放至不同的物联网平台。当前支持自定义策略、证书策略、静态策略。 自定义策略 证书策略 静态策略
备标识码、引导服务端PSK。 原生MQTT协议设备，需要烧录设备发放平台接入地址、设备ID、设备密钥。 设备发放 3. 证书：用于证书策略发放的设备需要上传证书，防止通信数据在传输过程被篡改造成安全风险。 4. 策略：策略用于控制设备按照指定策略或规则发放至不同的物联网平台。 5
描述 certificate_id String CA证书id 最小长度：0 最大长度：256 cert_type String 证书类型 strategy_type String 策略类型。目前支持静态策略(base)，证书策略(certificates)和自定义策略(functions)。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
