全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
云服务器 ECS

ImportKeyPair

更新时间:2017-09-13 14:33:57

描述

导入由其他工具产生的 RSA 密钥对的公钥部分,并保存公钥到阿里云,在导入时,可以指定密钥对的名称和描述。请妥善保存密钥对的私钥部分,不要向阿里云导入私钥。

密钥对的总个数:每用户每个 Region 不超过 500 个。

导入的密钥对必须支持下列任一种加密方式:

  • rsa
  • dsa
  • ssh-rsa
  • ssh-dss
  • ecdsa
  • ssh-rsa-cert-v00@openssh.com
  • ssh-dss-cert-v00@openssh.com
  • ssh-rsa-cert-v01@openssh.com
  • ssh-dss-cert-v01@openssh.com
  • ecdsa-sha2-nistp256-cert-v01@openssh.com
  • ecdsa-sha2-nistp384-cert-v01@openssh.com
  • ecdsa-sha2-nistp521-cert-v01@openssh.com

请求参数

名称 类型 是否必须 描述
Action String 操作接口名,系统规定参数,取值:ImportKeyPair。
RegionId String 密钥对所在的地域 ID。RegionId 的列表详见 地域列表
PublicKeyBody String 密钥对的公钥内容。
KeyPairName String 密钥对名称,必须保持唯一。[2,128] 英文或中文字符,必须以大小字母或中文开头,可包含数字、点号(.)、下划线(_)或连字符(-),密钥对名称会展示在控制台。不能以 http://https:// 开头。

返回参数

名称 类型 描述
KeyPairName String 密钥对名称。
KeyPairFingerPrint String 密钥对的指纹。在 RFC4716 中定义的公钥指纹格式:MD5 信息摘要算法 http://tools.ietf.org/html/rfc4716

错误码

错误代码 描述 HTTP 状态码 语义
MissingParameter The input parameter “RegionId” that is mandatory for processing this request is not supplied. 400 缺少 RegionId 值(实际情况也可能是该用户无权使用此 Region)。RegionId 的列表详见 地域列表
InvalidPublicKeyBody.Malformed The PublicKeyBody format is not supported. 400 指定的 PublicKeyBody 格式不正确。
MissingParameter The input parameter “PublicKeyBody” that is mandatory for processing this request is not supplied. 400 缺少 PublicKeyBody 值。
InvalidKeyPairName.Malformed Specified Key Pair name is not valid. 400 指定的 KeyPairName 格式不合法或者已存在。
QuotaExceed.KeyPair The key pair quota exceeds. 403 安全组个数超过额度限制。
InvalidRegionId.NotFound The specified RegionId does not exist. 404 指定的 RegionId 不存在。RegionId 的列表详见 地域列表

示例

请求示例

  1. https://ecs.aliyuncs.com/?action= ImportKeyPair
  2. &RegionId=cn-qingdao
  3. & PublicKeyBody=xxxxxxxxxxxxxx
  4. & KeyPairName=test
  5. &<公共请求参数>

返回示例

XML 格式

  1. <ImportKeyPairResponse>
  2. <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
  3. <KeyPairName >test</KeyPairName >
  4. <KeyPairFingerPrint> 89:f0:ba:62:ac:b8:aa:e1:61:5e:fd:81:69:86:6d:6b:f0:c0:5a:d7</ KeyPairFingerPrint>
  5. </ImportKeyPairResponse>

JSON 格式

  1. {
  2. "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
  3. KeyPairName”:”test
  4. KeyPairFingerPrint”: 89:f0:ba:62:ac:b8:aa:e1:61:5e:fd:81:69:86:6d:6b:f0:c0:5a:d7
  5. }
本文导读目录