All Products
Search
Document Center

:ImportKeyPair

Last Updated:May 22, 2026

Mengimpor kunci publik dari pasangan kunci yang dienkripsi dengan algoritma Rivest–Shamir–Adleman (RSA) dan dihasilkan oleh alat pihak ketiga. Setelah pasangan kunci diimpor, Alibaba Cloud menyimpan kunci publik tersebut. Anda harus menyimpan kunci privat sendiri dan menjaga kerahasiaannya.

Catatan penggunaan

Perhatikan hal-hal berikut:

  • Anda dapat membuat hingga 500 pasangan kunci di setiap wilayah.
  • Pasangan kunci yang akan diimpor harus mendukung salah satu metode enkripsi berikut:
    • 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

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kemudahan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi untuk berbagai SDK.

Parameter permintaan

Parameter

Type

Required

Contoh

Description

Action String Yes ImportKeyPair

Operasi yang ingin Anda lakukan. Tetapkan nilainya ke ImportKeyPair.

RegionId String Yes cn-hangzhou

ID wilayah. Anda dapat memanggil operasi DescribeRegions untuk mengambil daftar wilayah terbaru.

KeyPairName String Yes testKeyPairName

Nama pasangan kunci. Nama harus unik. Panjang nama harus antara 2 hingga 128 karakter. Nama harus dimulai dengan huruf dan tidak boleh dimulai dengan http:// atau https://. Nama dapat berisi huruf, angka, titik dua (:), garis bawah (_), dan tanda hubung (-).

PublicKeyBody String Yes ABC1234567

Kunci publik dari pasangan kunci.

ResourceGroupId String No rg-bp67acfmxazb4p****

ID kelompok sumber daya tempat pasangan kunci akan ditambahkan.

Tag.N.Key String No TestKey

Kunci tag N yang akan ditambahkan ke pasangan kunci. Nilai valid N: 1 hingga 20. Kunci tag tidak boleh berupa string kosong. Panjang kunci tag maksimal 128 karakter dan tidak boleh mengandung http:// atau https://. Kunci tag tidak boleh dimulai dengan acs: atau aliyun.

Tag.N.Value String No TestValue

Nilai tag N yang akan ditambahkan ke pasangan kunci. Nilai valid N: 1 hingga 20. Nilai tag boleh berupa string kosong. Panjang nilai tag maksimal 128 karakter dan tidak boleh mengandung http:// atau https://. Nilai tag tidak boleh dimulai dengan acs:.

Parameter respons

Parameter

Type

Contoh

Description

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

ID permintaan.

KeyPairName String testKeyPairName

Nama pasangan kunci yang akan ditambahkan ke instans.

KeyPairFingerPrint String 89:f0:ba:62:ac:b8:aa:e1:61:5e:fd:81:69:86:6d:6b:f0:c0:5a:**

Sidik jari pasangan kunci. Algoritma message-digest 5 (MD5) digunakan berdasarkan format sidik jari kunci publik yang didefinisikan dalam RFC 4716.

Contoh

Contoh permintaan

https://ecs.aliyuncs.com/?Action=ImportKeyPair
&RegionId=cn-qingdao
&PublicKeyBody=ABC1234567
&KeyPairName=testKeyPairName
&<Common request parameters>

Contoh respons sukses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

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

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "KeyPairName" : "testKeyPairName",
  "KeyPairFingerPrint" : "89:f0:ba:62:ac:b8:aa:e1:61:5e:fd:81:69:86:6d:6b:f0:c0:5a:**"
}

Kode kesalahan

Kode status HTTP

Kode kesalahan

Pesan kesalahan

Description

400 InvalidKeyPairName.Malformed Specified Key Pair name is not valid. Nama pasangan kunci yang ditentukan tidak valid.
400 InvalidPublicKeyBody.Malformed The PublicKeyBody format is not supported. Format kunci publik tidak didukung.
400 KeyPair.AlreadyExist The key pair already exist. Pasangan kunci dengan nama yang sama sudah ada. Nama pasangan kunci harus unik.
403 QuotaExceed.KeyPair The key pair quota exceeds. Jumlah maksimum pasangan kunci telah tercapai.
404 InvalidResourceGroup.NotFound The ResourceGroup provided does not exist in our records. Kelompok sumber daya tidak ditemukan.
500 InternalError The request processing has failed due to some unknown error. Terjadi kesalahan internal. Coba lagi nanti.

Untuk daftar lengkap kode kesalahan, lihat Kode kesalahan layanan.