检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
注册设备 功能介绍 应用服务器可调用此接口在物联网平台注册一个设备,仅在注册后设备才可以接入物联网平台。 URI POST /v5/iotps/{project_id}/devices 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。
e-4396-852c-164aefa6638f 响应示例 无 状态码 状态码 描述 204 No Content 400 Bad Request 403 Forbidden 错误码 请参见错误码。 父主题: 设备CA证书管理
0-4a5f-a390-ef388a1fbc70 响应示例 无 状态码 状态码 描述 204 No Content 400 Bad Request 500 Internal Server Error 错误码 请参见错误码。 父主题: 发放策略管理
添加证书策略详情 注册设备 在设备发放控制台,注册MQTT设备,其中安全模式选择X.509认证模式,选择对应的CA证书,填写证书指纹,注册X.509认证设备。 图7 注册设备 图8 创建证书模式证书策略设备 证书指纹是根据证书生成的唯一识别证书的标识。如果支持设备自注册,在设备首次认
per.huaweicloud.com/endpoint。 最小长度:1 最大长度:128 region_name String 华为云区域名称。节选自https://developer.huaweicloud.com/endpoint。 最小长度:1 最大长度:128 edition
创建静态策略详情 注册设备 本次以注册单个MQTT密钥设备为示例,登录设备发放控制台,进入到“设备”页面,单击“注册”,选择对应接入点的产品进行设备注册,设备名称为“Model1_001”,填写设备的密钥,发放策略选择“静态策略”,创建设备。 实际使用中,用户可以使用批量注册功能注册大量设备
URI-scheme: 表示用于传输请求的协议,当前所有API均采用HTTPS协议。 Endpoint: 指定承载REST服务端点的服务器域名或IP,不同服务不同区域的Endpoint不同,您可以从地区和终端节点获取。 例如IAM服务在“华北-北京一”区域的Endpoint为“iam
String 关键字来源。设备发放静态策略的匹配信息来源。 deviceName: 设备名称,默认的匹配方式,设备信息在被创建后,设备名称包涵设置的关键字,即可按照该行策略指定的发放应用进行实例发放。 payload: 数据上报,如果设备在连接后,进行发放publish时。上报Topic
"20190301T1910Z", "expiry_date" : "20190301T1910Z" } 状态码 状态码 描述 200 OK 400 Bad Request 403 Forbidden 错误码 请参见错误码。 父主题: 设备CA证书管理
timeout 否 Integer 设备验证码的有效时间,单位:秒,默认值:0 若设备在有效时间内未接入物联网平台并激活,则平台会删除该设备的注册信息。若设置为“0”,则表示设备验证码不会失效(建议填写为“0”)。 最小值:0 最大值:2147483647 缺省值:0 表5 ProvisionInfoUpdateReq
String 关键字来源。设备发放静态策略的匹配信息来源。 deviceName: 设备名称,默认的匹配方式,设备信息在被创建后,设备名称包涵设置的关键字,即可按照该行策略指定的发放应用进行实例发放。 payload: 数据上报,如果设备在连接后,进行发放publish时。上报Topic
参数 是否必选 参数类型 描述 fingerprint 否 String 参数说明:设备指纹。设置改字段时平台将设备指纹重置为指定值;不携带时将之置空,后续设备第一次接入时,该设备指纹的值将设置为第一次接入时的证书指纹。 取值范围:长度为40的十六进制字符串或者长度为64的十六进制字符串。
另一种更加高效的方案是,使用设备发放的注册组功能实现设备免注册安全极简地接入物联网平台。 本文基于设备发放注册组功能,使用证书策略,带您快速体验设备免注册安全极简接入物联网平台。 表1 方案对比 设备注册方案 基于单个注册 批量注册 免注册安全极简接入 适用场景 设备数量不多; 对设备身份标识和认证信息可提前规划;
timeout Integer 设备验证码的有效时间,单位:秒,默认值:0 若设备在有效时间内未接入物联网平台并激活,则平台会删除该设备的注册信息。若设置为“0”,则表示设备验证码不会失效(建议填写为“0”)。 缺省值:0 表6 ProvisionInfoBaseResp 参数 参数类型
"d4922d8a-6c8e-4396-852c-164aefa6638f" } } 状态码 状态码 描述 200 OK 403 Forbidden 400 Bad Request 500 Internal Server Error 错误码 请参见错误码。 父主题: 设备CA证书管理
最大长度:24 start_time 否 String 查询设备注册时间在startTime之后的记录,格式:yyyyMMdd'T'HHmmss'Z',如20151212T121212Z。 end_time 否 String 查询设备注册时间在endTime之前的记录,格式:yyyyMMdd
"20190301T1910Z" } 状态码 状态码 描述 201 Created 403 Forbidden 400 Bad Request 错误码 请参见错误码。 父主题: 设备CA证书管理
删除注册组 功能介绍 应用服务器可调用此接口在物联网平台上删除指定注册组。 URI DELETE /v5/iotps/{project_id}/registration-groups/{registration_group_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id
删除注册组 功能介绍 应用服务器可调用此接口在物联网平台上删除指定注册组。 URI DELETE /v5/iotps/{project_id}/registration-groups 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id。
"20190301T1910Z", "expiry_date" : "20190301T1910Z" } 状态码 状态码 描述 200 OK 400 Bad Request 403 Forbidden 错误码 请参见错误码。 父主题: 设备CA证书管理