IoT视频云

  • IoT视频云 > API Reference > 设备管理 >设备密钥 >密钥克隆

    密钥克隆

    最近更新时间: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 
            }
        ]
    }
    
    以上内容是否对您有帮助?
  • Icon free helper
    Close