匯入由其他工具產生的 RSA 金鑰組的公開金鑰部分。匯入金鑰組後,我們會為您保管公開金鑰部分,您需要自行妥善保存金鑰組的私密金鑰部分。

描述

調用該介面時,您需要注意:

  • 您在每個地域的金鑰組數最高為 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。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。
PublicKeyBody String 金鑰組的公開金鑰內容。
KeyPairName String 金鑰組名稱。必須保持名稱唯一性。
  • 長度為 [2, 128] 個字元。
  • 必須以大小字母或中文開頭,可包含數字、小數點(.)、底線(_)或者短橫線(-)。
  • 支援所有的字元集編碼格式。
  • 不能以 http:// 和 https:// 開頭。

返回參數

名稱 類型 描述
KeyPairName String 金鑰組名稱。
KeyPairFingerPrint String 金鑰組的指紋。根據 RFC4716 定義的公開金鑰指紋格式,採用 MD5 資訊摘要演算法。更多詳情,請參閱 RFC4716

樣本

請求樣本
https://ecs.aliyuncs.com/?Action=ImportKeyPair
&RegionId=cn-qingdao
&PublicKeyBody=xxxxxxxxxxxxxx
&KeyPairName=test
&<公共請求參數>
返回樣本

XML 格式

<ImportKeyPairResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <KeyPairName>test</KeyPairName>
    <KeyPairFingerPrint> 89:f0:ba:62:ac:b8:aa:e1:61:5e:fd:81:69:86:6d:6b:f0:c0:5a:d7</KeyPairFingerPrint>
</ImportKeyPairResponse>
JSON 格式
{
    "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
    "KeyPairName": "test"
    "KeyPairFingerPrint": "89:f0:ba:62:ac:b8:aa:e1:61:5e:fd:81:69:86:6d:6b:f0:c0:5a:d7"
}

錯誤碼

以下為本介面特有的錯誤碼。更多錯誤碼,請訪問 API 錯誤中心

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
MissingParameter The input parameter “RegionId” that is mandatory for processing this request is not supplied. 400 您必須指定 RegionId參數。
InvalidPublicKeyBody.Malformed The PublicKeyBody format is not supported. 400 指定的 PublicKeyBody 格式不正確。
InvalidKeyPairName.Malformed Specified Key Pair name is not valid. 400 指定的 KeyPairName不合法或者已重複。
InvalidRegionId.NotFound The specified RegionId does not exist. 404 指定的 RegionId 不存在。