云端NVR

  • 密钥克隆

    最近更新时间:2019-02-25 14:51:41

    描述

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

    请求

    请求语法

    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>", 
        "deviceAccessKey": "<deviceAccessKey>" 
    }
    

    请求参数

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

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

    参数名称 必填 字段类型 说明
    fromDevice string 密钥所在的设备
    cleanSelfKeys bool 布尔值 克隆前是否清空本设备的密钥
    deleteDevice bool 布尔值 克隆后是否删除老的设备
    deviceAccessKey string 可选 指定要克隆的key,不指定则会克隆老设备上的所有密钥

    响应

    响应头

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

    响应元素

    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