edit-icon download-icon

ImportKeyPair

最終更新日: Dec 10, 2018

説明

他のキーペアジェネレータで作成した SSH キーペアの公開キーを Alibaba Cloud リージョンの 1 つにインポートします。公開キーがインポートされると、その公開キーが保護されます。ただし、自分で秘密キーを保存する必要があります。このインターフェイスを呼び出すときは、次の点を考慮してください。

  • 各 Alibaba Cloud リージョンで最大 500 のキーペアを作成できます。

  • SSH キーペアの暗号化方式は、次のいずれかでなければなりません。

    • rsa
    • dsa
    • ssh-rsa
    • ssh-dss
    • ecdsa
    • ssh-rsa-cert-v00@openssh.com
    • ssh-dss-cert-v00@openssh.com
    • ssh-rsa-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。
PublicKeyBody String はい SSH キーペアの公開キー。
KeyPairName String はい キーペアの名前。ユニークでなければなりません。
  • [2, 128] 文字の長さにすることができます。
  • すべての文字エンコーディングセットをサポートします。
  • 特殊文字、数字、http://、または https://で始めることはできません。
  • 数字、ピリオド(.)、アンダースコア(_)、ハイフン( - )を含めることができます。

レスポンスパラメータ

名前 説明
KeyPairName String キーペアの名前。
KeyPairFingerPrint String キーペアの指紋。公開キーフィンガープリント形式は RFC4716 で定義されており、MD5 メッセージダイジェストアルゴリズムを使用します。詳細は、RFC4716 を参照してください。

リクエストの例

  1. https://ecs.aliyuncs.com/?Action=ImportKeyPair
  2. &RegionId=cn-qingdao
  3. &PublicKeyBody=xxxxxxxxxxxxxx
  4. &KeyPairName=test
  5. &<Common Request parameter>

レスポンスの例

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. }

エラーコード

エラーコード エラーメッセージ 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は存在しません。