云服务器BCC

    导入密钥对

    • 该接口用于用户自行导入创建密钥对。
    • 请求参数中导入的密钥对必须支持下列任一种加密方式:

      • rsa
      • dsa
      • ssh-rsa
      • ssh-dss
      • ecdsa

    请求结构

    PUT /v{version}/keypair?import HTTP/1.1
    Host: bcc.bj.baidubce.com
    Authorization: authorization string
    
    {
        "name": "keypair01",
        "description": "some description",
        "publicKey": "your-pulicKey"
    }

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    version String URL参数 API版本号
    name String RequestBody 待创建的密钥对名称
    description String RequestBody 待创建的密钥对的描述
    publicKey String RequestBody 公钥内容

    返回头域

    除公共头域,无其它特殊头域。

    返回参数

    参数名称 类型 描述
    keypair KeypairModel 密钥对对象

    错误码

    错误码 错误描述 HTTP状态码 中文解释
    Keypair.KeypairNameInvalid Keypair name is invalid. 400 密钥对名称格式不正确
    Keypair.KeypairDescriptionInvalid Keypair description is invalid. 400 密钥对描述格式不正确
    Keypair.KeypairQuotaExceedLimit Keypair number exceeds the limit. 413 密钥对数目超限
    Keypair.KeypairPublicKeyExist Keypair already exist. 400 公钥已存在
    Keypair.PublicKeyFormatInvalid Public key format is invalid. 400 公钥格式不正确

    请求示例

    POST /v2/keypair?import HTTP/1.1
    Host: bcc.bj.baidubce.com
    Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
    {
        "name": "keypair01",
        "description": "some description",
        "publicKey": "your-publicKey"
    }

    返回示例

    HTTP/1.1 200 OK
    x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
    Date: Wed, 03 Dec 2014 06:42:19 GMT
    Content-Type: application/json;charset=UTF-8
    Server: BWS
    {
        "keypair":{
            "instanceCount":0,
            "name":"keypair01",
            "description":"from import",
            "createdTime":"2019-01-30T11:52:41Z",
            "publicKey":"publicKey",
            "fingerPrint":"fingerPrint",
            "regionId":"bj",
            "keypairId":"keypairId"
        }
    }  
    上一篇
    创建密钥对
    下一篇
    绑定密钥对