Gunakan CreateClusterNodePool untuk Provisioning Node Pool ENS - ENS - Alibaba Cloud - ENS

Membuat kelompok node untuk sebuah kluster. Kelompok node adalah kumpulan logis dari node yang memiliki atribut yang sama, memungkinkan manajemen terpusat dan operasi O&M seperti peningkatan node dan skalabilitas elastis. Anda dapat menggunakan kemampuan O&M otomatis dari kelompok node, termasuk patching kerentanan CVE OS secara otomatis, pemulihan node rusak secara otomatis, serta peningkatan versi kubelet dan containerd secara otomatis, untuk mengurangi biaya O&M.

Deskripsi operasi

Frekuensi panggilan per pengguna: 10 panggilan per detik.

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

ens:CreateClusterNodePool

create

*Semua Sumber daya.

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
ClusterId	string	Yes	ID kluster.	eck-xxxxxxxx
NodepoolInfo	object	Yes	Konfigurasi kelompok node.
Name	string	Yes	Nama kelompok node.	test1
ScalingGroup	object	Yes	Konfigurasi grup penskalaan.
DesiredSize	integer	No	Jumlah instans yang diinginkan.	3
KeyPairName	string	No	Pasangan kunci untuk instans. Parameter ini saling eksklusif dengan kata sandi.	key-pair-name
VswitchIds	array	Yes	vSwitch yang digunakan oleh instans.
	string	No	ID vSwitch untuk node kluster. Wilayah ENS dari vswitch_ids harus sama dengan nilai ens_region_id.	vsw-58eu2p6v64qw8ihhit1wz7wgv
InstanceChargeType	string	No	Tipe penagihan instans. Valid values: PostPaid : Bayar sesuai pemakaian. PrePaid : Berlangganan.	PostPaid
InstanceTypes	array	Yes	Daftar tipe instans untuk node dalam kelompok node.
	string	No	Tipe instans.	ens.sn1.small
SystemDiskCategory	string	No	Tipe cloud disk sistem. Nilai valid: local_ssd, local_hdd, cloud_efficiency, dan cloud_ssd. Valid values: cloud_efficiency : Cloud disk ultra. cloud_ssd : Cloud disk SSD. local_hdd : HDD lokal. local_ssd : SSD lokal.	cloud_efficiency
SystemDiskSize	integer	No	Ukuran cloud disk sistem. Unit: GB. Nilai minimum: 20. Nilai harus merupakan kelipatan 10.	80
ImageId	string	Yes	ID image instans.	m-6734fzvcwcv2o8jj201cpa7ox
DataDisks	array<object>	No	Ukuran cloud disk data.
	object	No	Tipe cloud disk.
Category	string	No	Tipe cloud disk. Valid values: cloud_efficiency : Cloud disk ultra. cloud_ssd : Cloud disk SSD. local_hdd : HDD lokal. local_ssd : SSD lokal.	cloud_efficiency
Size	integer	No	Ukuran cloud disk data. Unit: GB. Nilai minimum: 20. Nilai meningkat sebesar 10.	80
Password	string	No	Kata sandi yang digunakan saat kelompok node membuat instans. Parameter ini saling eksklusif dengan pasangan kunci.	some-test-password
KubernetesConfig	object	No	Konfigurasi terkait kluster.
PreUserData	string	No	Skrip yang dieksekusi setelah mesin dibuat dan sebelum bergabung dengan kluster. Konten harus dienkripsi Base64.	ZWNobyBvawo=
UserData	string	No	Skrip yang dieksekusi setelah mesin dibuat dan setelah bergabung dengan kluster. Konten harus dienkripsi Base64.	ZWNobyBvawo=

Elemen respons

Element	Type	Description	Example
	object	Skema Respons.
Nodepool	object	Konfigurasi kelompok node.
ClusterId	string	ID kluster.	eck-d2666c5f
NodepoolInfo	object	Informasi kelompok node.
Name	string	Nama kluster.	test1
EnsRegionId	string	ID wilayah ENS kluster.	cn-guiyang-14
NodepoolId	string	ID kelompok node.	np1176939548ac49e59febe82dcbf1ad56
ScalingGroup	object	ID kelompok sumber daya tempat grup penskalaan yang baru dibuat berada. Catatan Grup penskalaan yang baru dibuat ditetapkan ke kelompok sumber daya yang ditentukan. Jika parameter ini tidak ditentukan, grup penskalaan ditetapkan ke kelompok sumber daya default.
VswitchIds	array	ID vSwitch untuk node kluster.
	string	ID vSwitch untuk node kluster.	vsw-58eu2p6v64qw8ihhit1wz7wgv
DataDisks	array<object>	Informasi cloud disk data node.
	object	Informasi cloud disk data node.
Category	string	Kategori cloud disk.	cloud_efficiency
Size	integer	Ukuran cloud disk data. Unit: GB.	80
InstanceChargeType	string	Metode penagihan instans.	PrePaid
InstanceTypes	array	Daftar tipe instans untuk node di kelompok node.
	string	Tipe instans node di kelompok node.	ens.sn1.small
SystemDiskCategory	string	Tipe disk cloud sistem node.	cloud_efficiency
SystemDiskSize	integer	Ukuran cloud disk sistem. Unit: GB.	80
ImageId	string	ID image mesin virtual lapisan kontrol.	m-67bdk1kpu1ylmt7k33h5dbiov
KeyPairName	string	Nama pasangan kunci.	key-pair-name
Password	string	Kata sandi logon instans.	**********
KubernetesConfig	object	Konfigurasi terkait Kubernetes.
PreUserData	string	Skrip yang berjalan setelah instans dibuat tetapi sebelum bergabung dengan kluster. Konten harus dienkode Base64.	ZWNobyBvawo=
UserData	string	Skrip yang berjalan setelah instans dibuat dan bergabung dengan kluster. Konten harus dienkode Base64.	ZWNobyBvawo=
Status	object	Informasi status kelompok node.
State	string	Status kelompok node. Nilai valid: active: Kelompok node telah mencapai status yang diinginkan. scaling: Kelompok node sedang melakukan skala keluar. removing_nodes: Kelompok node sedang melakukan skala masuk.	active
TotalNodes	integer	Jumlah total instans, termasuk instans yang sedang dibuat, digunakan, atau dihapus.	10
DesiredNodes	integer	Jumlah instans yang diharapkan.	10
ServingNodes	integer	Jumlah instans yang digunakan.	10
InitialNodes	integer	Jumlah instans yang sedang dibuat.	0
RemovingNodes	integer	Jumlah instans yang sedang dihapus.	0
FailedNodes	integer		0
RequestId	string	ID permintaan.	C0003E8B-B930-4F59-ADC0-0E209A9012A8

Contoh

Respons sukses

JSONformat

{
  "Nodepool": {
    "ClusterId": "eck-d2666c5f",
    "NodepoolInfo": {
      "Name": "test1",
      "EnsRegionId": "cn-guiyang-14",
      "NodepoolId": "np1176939548ac49e59febe82dcbf1ad56"
    },
    "ScalingGroup": {
      "VswitchIds": [
        "vsw-58eu2p6v64qw8ihhit1wz7wgv"
      ],
      "DataDisks": [
        {
          "Category": "cloud_efficiency",
          "Size": 80
        }
      ],
      "InstanceChargeType": "PrePaid",
      "InstanceTypes": [
        "ens.sn1.small"
      ],
      "SystemDiskCategory": "cloud_efficiency",
      "SystemDiskSize": 80,
      "ImageId": "m-67bdk1kpu1ylmt7k33h5dbiov",
      "KeyPairName": "key-pair-name",
      "Password": "**********"
    },
    "KubernetesConfig": {
      "PreUserData": "ZWNobyBvawo=",
      "UserData": "ZWNobyBvawo="
    },
    "Status": {
      "State": "active",
      "TotalNodes": 10,
      "DesiredNodes": 10,
      "ServingNodes": 10,
      "InitialNodes": 0,
      "RemovingNodes": 0,
      "FailedNodes": 0
    }
  },
  "RequestId": "C0003E8B-B930-4F59-ADC0-0E209A9012A8"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.