CreateKeyPair - - Alibaba Cloud Documentation Center

Membuat pasangan kunci SSH. Sistem menyimpan kunci publik dan mengembalikan kunci privat yang tidak terenkripsi dalam format PEM berbasis PKCS#8. Anda harus menyimpan kunci privat tersebut secara aman dan menjaga kerahasiaannya.

Catatan penggunaan

Selain memanggil CreateKeyPair, Anda dapat membuat pasangan kunci menggunakan alat pihak ketiga, lalu mengunggahnya ke wilayah Alibaba Cloud melalui operasi ImportKeyPair.

Anda dapat membuat hingga 500 pasangan kunci di setiap wilayah. Untuk informasi selengkapnya, lihat bagian “Batasan” dalam Gunakan Cloud Assistant untuk menjalankan perintah di kontainer.

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	Example	Description
Action	String	Yes	CreateKeyPair	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke CreateKeyPair.
RegionId	String	Yes	cn-hangzhou	ID wilayah tempat membuat pasangan kunci. Anda dapat memanggil operasi DescribeRegions untuk mengambil daftar wilayah terbaru.
KeyPairName	String	Yes	testKeyPairName	Nama pasangan kunci. Nama harus terdiri dari 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 (-).
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 untuk 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 untuk 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	Example	Description
PrivateKeyBody	String	MIIEpAIBAAKCAQEAtReyMzLIcBH78EV2zj****	Kunci privat dari pasangan kunci. Kunci privat dikodekan dengan format PEM dalam format PKCS#8.
KeyPairName	String	testKeyPairName	Nama pasangan kunci.
KeyPairId	String	ssh-bp67acfmxazb4p****	ID pasangan kunci SSH.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID permintaan.
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. Untuk informasi selengkapnya, lihat RFC 4716.

Contoh

Contoh permintaan

https://ecs.aliyuncs.com/?Action=CreateKeyPair
&RegionId=cn-hangzhou
&KeyPairName=testKeyPairName
&<Common request parameters>

Contoh respons sukses

XML format

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

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

JSON format

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

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

Kode kesalahan

Kode status HTTP	Kode kesalahan	Pesan kesalahan	Deskripsi
400	InvalidKeyPairName.Malformed	Specified Key Pair name is not valid.	Nama pasangan kunci yang ditentukan tidak valid.
400	KeyPair.AlreadyExist	The key pair already exist.	Pasangan kunci dengan nama yang sama sudah ada. Nama pasangan kunci harus unik.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	Kunci tag sudah ada. Kunci tag harus unik.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	Nilai Tag.N.Key tidak valid.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	Nilai Tag.N.Value tidak valid.
403	QuotaExceed.KeyPair	The key pair quota exceeds.	Jumlah maksimum pasangan kunci telah tercapai.
403	QuotaExceed.Tags	%s	Jumlah maksimum tag telah terlampaui. %s adalah variabel. Pesan kesalahan dikembalikan secara dinamis berdasarkan kondisi pemanggilan.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	Kelompok sumber daya tidak ditemukan.

Untuk daftar kode kesalahan, lihat Kode kesalahan layanan.