All Products
Search
Document Center

ENS:AttachKeyPair

Last Updated:Jun 11, 2026

Mengikat pasangan kunci SSH secara batch ke instance yang ditentukan. Hingga 30 instance per panggilan.

Deskripsi operasi

Deskripsi Permintaan

API batch yang digunakan untuk mengikat pasangan kunci ke instance. Hanya dapat dioperasikan pada instance yang telah dihentikan.

  • Jumlah instance yang diikat per panggilan tidak boleh melebihi 30.

  • Setidaknya salah satu dari key_pair_name dan key_pair_id tidak boleh kosong.

  • Mohon teruskan key_pair_id saat memanggil; key_pair_name akan dihentikan dukungannya.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter

Type

Required

Description

Example

KeyPairName

string

No

Nama pasangan kunci.

test-kp

InstanceIds

array

Yes

Daftar ID instance.

["i-50f8q9mbfjzlkuk9znjglnne3"]

string

No

ID instance.

i-xxx

KeyPairId

string

No

ID pasangan kunci - pengidentifikasi unik.

ssh-xxx

Elemen respons

Element

Type

Description

Example

object

Skema Respons

RequestId

string

ID permintaan.

xx-xx-xx-xx

KeyPairName

string

Nama pasangan kunci.

ssh-xxx

FailCount

integer

Jumlah instance yang gagal melepaskan ikatan pasangan kunci.

1

TotalCount

integer

Jumlah total instance untuk melepaskan ikatan pasangan kunci.

3

Results

array<object>

Kumpulan hasil keberhasilan atau kegagalan untuk melepaskan ikatan pasangan kunci.

object

Code

integer

Kode status operasi yang dikembalikan, di mana 200 menunjukkan bahwa operasi berhasil.

200

InstanceId

string

ID instance.

i-xxx

Message

string

Pesan operasi yang dikembalikan. Ketika code=200, message adalah successful.

successful

Success

boolean

Apakah operasi berhasil.

true

KeyPairId

string

ID pasangan kunci.

ssh-xxx

Contoh

Respons sukses

JSONformat

{
  "RequestId": "xx-xx-xx-xx",
  "KeyPairName": "ssh-xxx",
  "FailCount": 1,
  "TotalCount": 3,
  "Results": [
    {
      "Code": 200,
      "InstanceId": "i-xxx",
      "Message": "successful",
      "Success": true
    }
  ],
  "KeyPairId": "ssh-xxx"
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 NoPermission Permission denied.
400 InvalidParameter.%s The specified field %s invalid. Please check it again.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.