All Products
Search
Document Center

Container Service for Kubernetes:AttachInstancesToNodePool

Last Updated:Jun 12, 2026

Menambahkan Instance ECS yang ada ke dalam kelompok node di kluster ACK. Anda dapat memanggil operasi ini untuk menambahkan Instance ECS yang ada sebagai node pekerja ke kluster atau untuk menambahkan kembali instans node ke kelompok node setelah dihapus.

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

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

  • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

  • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

  • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

  • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

    • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

    • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

  • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

  • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

cs:AttachInstancesToNodePool

update

*Cluster

acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}

None None

Sintaks permintaan

POST /clusters/{ClusterId}/nodepools/{NodepoolId}/attach HTTP/1.1

Path Parameters

Parameter

Type

Required

Description

Example

ClusterId

string

Yes

ID kluster.

c82e6987e2961451182edacd74faf****

NodepoolId

string

Yes

ID kelompok node.

np31da1b38983f4511b490fc62108a****

Parameter permintaan

Parameter

Type

Required

Description

Example

body

object

No

Parameter badan permintaan.

instances

array

No

Daftar Instans ECS yang akan ditambahkan.

string

No

ID Instans ECS yang akan ditambahkan.

i-2zed0sswuau6o89b****

password

string

No

Kata sandi logon SSH instans yang akan ditambahkan.

******

format_disk

boolean

No

Apakah akan menyimpan data kontainer dan image pada cloud disk data. Nilai valid:

  • true: Menyimpan data kontainer dan image pada cloud disk data.

  • false: Tidak menyimpan data kontainer dan image pada cloud disk data.

Nilai default: false.

Aturan pemasangan cloud disk data:

  • Jika Instance ECS memiliki cloud disk data yang terpasang dan sistem file dari cloud disk data terakhir belum diinisialisasi, sistem akan memformat cloud disk data secara otomatis sebagai EXT4 untuk menyimpan konten /var/lib/docker dan /var/lib/kubelet.

  • Jika Instance ECS tidak memiliki cloud disk data yang terpasang, tidak ada cloud disk data baru yang dipasang.

Catatan

Jika Anda memilih untuk menyimpan data pada cloud disk data dan Instance ECS sudah memiliki cloud disk data yang terpasang, data yang ada pada cloud disk data akan hilang. Cadangkan data Anda terlebih dahulu.

false

keep_instance_name

boolean

No

Apakah akan mempertahankan nama instans asli. Nilai valid:

  • true: Mempertahankan nama instans.

  • false: Tidak mempertahankan nama instans.

Nilai default: true.

true

Elemen respons

Element

Type

Description

Example

object

Badan respons.

request_id

string

ID permintaan.

D7631D83-6E98-1949-B665-766A62xxxxxx

task_id

string

ID tugas.

T-5a54309c80282e39eaxxxxxx

Contoh

Respons sukses

JSONformat

{
  "request_id": "D7631D83-6E98-1949-B665-766A62xxxxxx",
  "task_id": "T-5a54309c80282e39eaxxxxxx"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.