IoT视频云 > API 文档 > 设备密钥 >密钥克隆

密钥克隆

最近更新时间: 2019-10-30 17:16:09

描述

该接口用于把某个设备的密钥克隆给新的设备，不用重新对设备进行烧录新的密钥。

请求

请求语法

POST /v1/apps/<appid>/devices/<encodeDeviceName>/keys/clone HTTP/1.1
Host: linking.qiniuapi.com
Content-Type: application/json
Authorization: <QiniuToken>

{
    "fromDevice": "<fromDeviceName>", 
    "cleanSelfKeys": "<deleteKeys>", 
    "deleteDevice": "<deleteDevice>"
}

请求参数

参数名称	必填	字段类型	说明
appid	是	string	设备所属应用的appid，设备名称只能由 4-200 位英文字母和数字组成
encodeDeviceName	是	string	设备名称进行URL安全的Base64编码后得到的字符串

请求头
该请求操作的实现使用了所有操作的公共请求头。有关详细信息，请查阅公共请求头。
请求元素

参数名称	必填	字段类型	说明
fromDevice	是	string	密钥所在的设备
cleanSelfKeys	是	bool	布尔值克隆前是否清空本设备的密钥
deleteDevice	是	bool	布尔值克隆后是否删除老的设备

响应

响应头

该请求操作的实现使用了所有操作的公共响应头。有关详细信息，请查阅公共响应头。

响应元素

200 {
    "cloneKeys": [ 
        {
            "accessKey": "<deviceAccessKey>",
            "secretKey": "<deviceSecretKey>",
            "state": "<state>" 
        }
    ]
}

参数名称	说明
deviceAccessKey	设备端的 accessKey
deviceSecretKey	设备端的 secretKey
state	密钥对状态，1表示被禁用,0表示已启用

示例

请求示例

POST /v1/apps/test/devices/dGVzdGRldmljZTE=/keys/clone HTTP/1.1
Host: linking.qiniuapi.com
Authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=
Content-Type: application/json

{
    "fromDevice": "test123", 
    "cleanSelfKeys": false,   
    "deleteDevice": false 
}

响应示例

HTTP/1.1 200 OK
Access-Control-Allow-Origi: *
Connection: keep-alive
Content-Length: xxx
Content-Type: application/json
Date: Wed, 26 Sep 2018 11:42:10 GMT
Server: nginx/1.8.0
Vary: Accept-Encoding
X-Reqid: 6SAAABDWHM1o8FcV
X-Whom: cs1

200 {
    "cloneKeys": [
        {
            "accessKey": "Ves3WTXC8XnEHT0I_vacEQQz-9jrJZxNExcxxxxx",
            "secretKey": "eNFrLXKG3R8TJ-DJAxxxxxLwuEfQnw8krrDuZzoy",
            "state": 0 
        }
    ]
}

以上内容是否对您有帮助？