AttachInstances - Container Service for Kubernetes - Alibaba Cloud Documentation Center

Menambahkan Instance ECS Elastic Compute Service (ECS) yang ada ke kluster Container Service for Kubernetes (ACK). Anda dapat memanggil operasi ini untuk menambahkan Instance ECS sebagai node worker ke kluster ACK setelah membelinya, atau menambahkan kembali Instans node ke kelompok node setelah dihapus.

Deskripsi operasi

Sebelum memanggil operasi ini, baca Batasan untuk memastikan bahwa Instans ECS yang akan ditambahkan memenuhi persyaratan.

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:AttachInstances

update

*Cluster

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

None

Sintaks permintaan

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

Path Parameters

Parameter	Type	Required	Description	Example
ClusterId	string	Yes	ID kluster.	c106f377e16f34eb1808d6b9362c9****

Parameter permintaan

Parameter	Type	Required	Description	Example
body	object	No	Parameter badan permintaan.
instances	array	Yes	Daftar Instans ECS yang akan ditambahkan.
	string	No	ID Instans ECS yang akan ditambahkan.	i-2zed0sswuau6o89b****
key_pair	string	No	Nama pasangan kunci untuk Instans yang akan ditambahkan. Anda hanya perlu menentukan salah satu dari key_pair atau password. Anda juga dapat mengosongkan kedua parameter tersebut. Catatan Setelah menentukan `nodepool_id`, parameter ini tidak didukung.	security-key
password	string	No	Kata sandi logon SSH untuk Instans yang akan ditambahkan. Anda hanya perlu menentukan salah satu dari key_pair atau password. Anda juga dapat mengosongkan kedua parameter tersebut. Kata sandi harus memenuhi persyaratan berikut: Panjang kata sandi harus 8 hingga 30 karakter. Kata sandi harus mengandung huruf besar, huruf kecil, angka, dan karakter khusus secara bersamaan. Kata sandi tidak boleh mengandung garis miring terbalik (\) atau tanda kutip ganda ("). Kata sandi dienkripsi selama transmisi untuk tujuan keamanan.	Hello1234
format_disk	boolean	No	Apakah akan menyimpan data kontainer dan image pada data cloud disk. Nilai valid: `true`: Menyimpan data kontainer dan image pada data cloud disk. `false`: Tidak menyimpan data kontainer dan image pada data cloud disk. Nilai default: `false`. Aturan pemasangan data cloud disk: Jika Instance ECS memiliki data cloud disk yang terpasang dan sistem file dari data cloud disk terakhir belum diinisialisasi, sistem akan memformat data cloud disk secara otomatis ke EXT4 untuk menyimpan konten /var/lib/docker dan /var/lib/kubelet (direktori data default untuk runtime kontainer Docker dan komponen kubelet). Jika Instance ECS tidak memiliki data cloud disk yang terpasang, tidak ada data cloud disk baru yang dipasang. Catatan Jika Anda memilih untuk menyimpan data pada data cloud disk dan Instance ECS sudah memiliki data cloud disk yang terpasang, data yang ada pada data cloud disk 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: `false`.	false
is_edge_worker	boolean	No	Apakah node yang akan ditambahkan merupakan edge node (node ENS). Nilai valid: `true`: Node yang akan ditambahkan merupakan edge node. `false`: Node yang akan ditambahkan bukan edge node. Nilai default: `false`. Catatan Jika node merupakan edge node, tetapkan parameter ini ke `true` untuk mengidentifikasi tipe node sebagai node ENS.	false
nodepool_id	string	No	ID kelompok node. Jika Anda tidak menentukan parameter ini, node akan ditambahkan ke kelompok node default.	np615c0e0966124216a0412e10afe0****
image_id	string	No	ID gambar kustom. Jika Anda menentukan ID gambar kustom, image cloud disk sistem instans akan diganti dengan gambar kustom. Jika Anda tidak menentukan parameter ini, image sistem default akan digunakan. Catatan Setelah menentukan `nodepool_id`, parameter ini tidak didukung.	aliyun_2_1903_x64_20G_alibase_20200529.vhd
cpu_policy	string	No	Kebijakan manajemen CPU node. Kebijakan berikut didukung untuk kluster versi 1.12.6 atau yang lebih baru: `static`: Memungkinkan pod dengan karakteristik Sumber daya tertentu pada node diberikan afinitas CPU dan eksklusivitas yang ditingkatkan. `none`: Menggunakan skema afinitas CPU default yang ada. Nilai default: `none`. Catatan Setelah menentukan `nodepool_id`, parameter ini tidak didukung.	none
user_data	string	No	Data pengguna instans node. Untuk informasi lebih lanjut, lihat Membuat data pengguna instans. Catatan Setelah menentukan `nodepool_id`, parameter ini tidak didukung.	IyEvdXNyL2Jpbi9iYXNoCmVjaG8gIkhlbGxvIEFDSyEi
rds_instances	array	No	Daftar instans ApsaraDB RDS.
	string	No	ID instans ApsaraDB RDS. Catatan Setelah menentukan `nodepool_id`, parameter ini tidak didukung.	rm-67yawhau****
runtime	runtime	No	Runtime kontainer. Catatan Setelah menentukan `nodepool_id`, parameter ini tidak didukung. name: Nama runtime kontainer. ACK mendukung tiga runtime kontainer berikut: containerd: Direkomendasikan. Didukung oleh semua versi kluster. Sandboxed-Container.runv: runtime kontainer sandbox yang menyediakan isolasi lebih tinggi. Didukung oleh kluster versi 1.24 atau yang lebih lama. docker: Didukung oleh kluster versi 1.22 atau yang lebih lama. Nilai default: containerd. containerd: Versi runtime kontainer. Nilai default: versi terbaru. Untuk informasi lebih lanjut mengenai perubahan pada runtime kontainer sandbox, lihat Catatan rilis untuk runtime kontainer sandbox.
tags	array	No	Label node. Aturan definisi label: Label adalah pasangan kunci-nilai yang peka terhadap huruf besar/kecil. Anda dapat menetapkan hingga 20 label. Kunci label tidak boleh duplikat dan panjangnya dapat mencapai 64 karakter. Nilai label dapat kosong dan panjangnya dapat mencapai 128 karakter. Kunci dan nilai label tidak boleh diawali dengan `aliyun`, `acs:`, `https://`, atau `http://`. Untuk informasi lebih lanjut, lihat Label dan Selector. Catatan Setelah menentukan `nodepool_id`, parameter ini tidak didukung.
	tag	No	Label node.

Elemen respons

Element	Type	Description	Example
	object	Parameter badan respons.
list	array<object>	Daftar hasil penambahan node.
	object	Detail hasil penambahan node.
code	string	Kode status hasil penambahan node.	200
instanceId	string	ID Instans ECS.	i-2ze0lgm3y6iylcbt****
message	string	Deskripsi hasil penambahan node.	successful
task_id	string	ID tugas.	T-5a544aff80282e39ea00****

Contoh

Respons sukses

JSONformat

{
  "list": [
    {
      "code": "200",
      "instanceId": "i-2ze0lgm3y6iylcbt****",
      "message": "successful"
    }
  ],
  "task_id": "T-5a544aff80282e39ea00****"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.