Membuat kluster ACK, termasuk kluster khusus ACK, kluster Layanan Kontainer Serverless ACK, kluster Edge ACK, dan kluster terdaftar. Saat membuat kluster, Anda mengonfigurasi informasi kluster, komponen kluster, dan resource cloud terkait ACK.
Deskripsi operasi
Menghasilkan parameter permintaan OpenAPI dari konsol
Saat memanggil operasi CreateCluster untuk membuat kluster, jika panggilan API gagal karena kombinasi parameter permintaan yang salah, Anda dapat menghasilkan kombinasi parameter permintaan yang diperlukan dari konsol. Lakukan langkah-langkah berikut:
-
Masuk ke Konsol Container Service dan pilih Daftar Kluster di panel navigasi sebelah kiri.
-
Pada halaman Daftar Kluster, klik Templat Kluster.
-
Di kotak dialog, pilih tipe kluster yang ingin dibuat, klik Buat, lalu konfigurasikan informasi kluster pada halaman konfigurasi kluster.
-
Setelah konfigurasi selesai, pada halaman Konfirmasi Konfigurasi, klik Kode Setara di sudut kanan atas. Kotak dialog menampilkan kombinasi parameter yang diperlukan untuk membuat kluster, yang dapat Anda salin dan gunakan.
Coba sekarang
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
cs:CreateCluster |
create |
*Cluster
|
|
None |
Sintaks permintaan
POST /clusters HTTP/1.1
Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| body |
object |
No |
Parameter badan permintaan. |
cluster-demo |
| name |
string |
Yes |
Nama kluster kustom. Panjang nama harus 1 hingga 63 karakter dan dapat berisi angka, karakter Mandarin, huruf, dan tanda hubung (-). Tidak boleh dimulai dengan tanda hubung (-). |
cluster-demo |
| region_id |
string |
Yes |
ID wilayah kluster. Untuk informasi lebih lanjut, lihat Wilayah yang didukung oleh Container Service. |
cn-beijing |
| cluster_type |
string |
No |
|
Kubernetes |
| cluster_spec |
string |
No |
Setelah Anda menetapkan
Pro XL, Pro 2XL, dan Pro 4XL adalah tiga tingkatan yang disediakan oleh ACK Pro Provisioned Control Plane. Dengan pra-alokasi dan penetapan resource lapisan kontrol, mereka memastikan bahwa konkurensi API dan kemampuan penjadwalan Pod tetap pada tingkat tinggi yang deterministik, cocok untuk pelatihan dan inferensi AI, kluster skala sangat besar, dan beban kerja kritis. Untuk informasi tentang biaya manajemen untuk kluster Pro dan Provisioned Control Plane, lihat Biaya manajemen kluster. |
ack.pro.small |
| profile |
string |
No |
Saat Anda menetapkan
|
Default |
| kubernetes_version |
string |
No |
Versi kluster, yang konsisten dengan versi garis dasar komunitas Kubernetes. Kami menyarankan Anda memilih versi terbaru. Jika Anda tidak menentukan parameter ini, versi terbaru digunakan secara default. Anda dapat membuat kluster dengan tiga versi terbaru. Panggil operasi DescribeKubernetesVersionMetadata untuk mengkueri versi kluster yang didukung. Untuk informasi lebih lanjut tentang versi Kubernetes yang didukung oleh ACK, lihat Ikhtisar rilis versi Kubernetes. |
1.32.1-aliyun.1 |
| auto_mode |
object |
No |
Konfigurasi mode terkelola cerdas. |
|
| enable |
boolean |
No |
Apakah akan mengaktifkan mode terkelola cerdas.
|
true |
| tags |
array |
No |
Tag node. Aturan definisi tag:
|
|
| tag |
No |
Tag node. Aturan definisi tag:
|
||
| resource_group_id |
string |
No |
ID kelompok sumber daya kluster, digunakan untuk mengisolasi resource yang berbeda. |
rg-acfm3mkrure**** |
| deletion_protection |
boolean |
No |
Apakah akan mengaktifkan perlindungan penghapusan kluster, yang mencegah kluster dihapus secara tidak sengaja melalui konsol atau API. Nilai valid:
Nilai default: |
true |
| zone_ids |
array |
No |
ID zona wilayah tempat kluster berada. Parameter ini khusus untuk tipe kluster terkelola ACK. |
|
|
string |
No |
ID zona wilayah tempat kluster berada. vSwitch dibuat secara otomatis di zona ini melalui pembuatan otomatis. Saat membuat tipe kluster terkelola ACK, jika |
cn-beijing-h |
|
| vpcid |
string |
No |
VPC yang digunakan oleh kluster. Anda harus menyediakan VPC saat membuat kluster. |
vpc-2zeik9h3ahvv2zz95**** |
| vswitch_ids |
array |
No |
vSwitch untuk node kluster. Bidang ini wajib saat membuat kluster terkelola tanpa node. |
|
|
string |
No |
vSwitch untuk node kluster. Bidang ini wajib saat membuat kluster terkelola tanpa node. |
vsw-2ze3ds0mdip0hdz8i**** |
|
| ip_stack |
string |
No |
Tumpukan protokol IP kluster. |
可选值: ipv4(单栈) dual(双栈),默认值为ipv4。 |
pod_vswitch_ids
deprecated
|
array |
No |
Bidang ini sudah tidak digunakan. Saat Anda memilih Terway sebagai plugin jaringan, Anda harus menetapkan vSwitch untuk alokasi IP Pod. Setiap vSwitch Pod berkorespondensi dengan vSwitch node pekerja, dan vSwitch Pod serta vSwitch node pekerja harus berada di zona yang sama. Catatan
Masker blok CIDR vSwitch Pod tidak boleh melebihi 19 dan tidak boleh melebihi 25. Jika tidak, jumlah alamat IP Pod yang tersedia di jaringan kluster sangat terbatas, yang memengaruhi penggunaan kluster normal. |
|
|
string |
No |
Saat Anda memilih Terway sebagai plugin jaringan, Anda harus menetapkan vSwitch untuk alokasi IP Pod. Setiap vSwitch Pod berkorespondensi dengan vSwitch node pekerja, dan vSwitch Pod serta vSwitch node pekerja harus berada di zona yang sama. Catatan
Masker blok CIDR vSwitch Pod tidak boleh melebihi 19 dan tidak boleh melebihi 25. Jika tidak, jumlah alamat IP Pod yang tersedia di jaringan kluster sangat terbatas, yang memengaruhi penggunaan kluster normal. |
vsw-2ze97jwri7cei0mpw**** |
|
| container_cidr |
string |
No |
Blok CIDR jaringan Pod. Harus berupa blok CIDR pribadi yang valid, khususnya blok CIDR berikut dan subnetnya: 10.0.0.0/8, 172.16-31.0.0/12-16, 192.168.0.0/16. Tidak boleh tumpang tindih dengan blok CIDR VPC atau blok CIDR yang digunakan oleh kluster Kubernetes yang ada di VPC. Tidak dapat diubah setelah pembuatan. Untuk informasi tentang perencanaan jaringan kluster, lihat Perencanaan jaringan kluster terkelola ACK. Catatan
Bidang ini wajib untuk kluster Flannel. |
172.20.0.0/16 |
| service_cidr |
string |
No |
Blok CIDR jaringan Service. Rentang valid: 10.0.0.0/16-24, 172.16-31.0.0/16-24, 192.168.0.0/16-24. Tidak boleh tumpang tindih dengan blok CIDR VPC 10.1.0.0/21 atau blok CIDR yang digunakan oleh kluster Kubernetes yang ada di VPC. Tidak dapat diubah setelah pembuatan. Nilai default: 172.19.0.0/20. |
172.21.0.0/20 |
| security_group_id |
string |
No |
ID grup keamanan. Tentukan parameter ini saat membuat kluster dengan grup keamanan yang ada. Saling eksklusif dengan |
sg-bp1bdue0qc1g7k**** |
| is_enterprise_security_group |
boolean |
No |
Apakah akan menggunakan pembuatan otomatis grup keamanan lanjutan. Berlaku ketika Catatan
Saat menggunakan grup keamanan dasar, jumlah total node dan Pod Terway di kluster tidak boleh melebihi 2000. Oleh karena itu, saat membuat kluster tipe jaringan Terway, kami menyarankan menggunakan grup keamanan lanjutan.
Nilai default: |
true |
| snat_entry |
boolean |
No |
Pengaturan untuk mengonfigurasi SNAT untuk VPC. Nilai valid:
Catatan
Jika ini tidak diaktifkan selama pembuatan kluster dan akses Internet diperlukan nanti, Anda dapat mengaktifkannya secara manual. Nilai default: |
false |
| control_plane_endpoints_config |
object |
No |
Konfigurasi titik akhir kluster. |
|
| load_balancers_config |
array<object> |
No |
Konfigurasi titik akhir kluster. Ketika bidang ini ditentukan, parameter endpoint_public_access dan load_balancer_id tidak berlaku. ACK hanya mendukung pembuatan otomatis instans NLB. Untuk menentukan CLB/NLB, gunakan load_balancers_config untuk menentukan ID instans. |
|
|
object |
No |
Konfigurasi penyeimbangan beban akses kluster. |
||
| endpoint_type |
string |
No |
Tipe titik akhir. |
private |
| load_balancer_id |
string |
No |
ID instans NLB. |
nlb-0ogk9aaxxxxxxx |
| internal_dns_config |
object |
No |
Konfigurasi DNS internal untuk kluster. Berlaku untuk kluster terkelola ACK. Nama domain internal digunakan oleh komponen sistem sisi node seperti kubelet dan kube-proxy untuk mengakses API Server. Ketika akses nama domain internal tidak diaktifkan, komponen sistem sisi node mengakses API Server melalui alamat IP CLB. |
|
| bind_vpcs |
array |
No |
VPC tempat resolusi rekaman nama domain internal berlaku. |
|
|
string |
No |
VPC tempat resolusi rekaman nama domain internal berlaku. |
vpc-xxxx |
|
| endpoint_public_access |
boolean |
No |
Apakah akan mengaktifkan akses jaringan publik. Mengekspos API Server melalui EIP untuk akses jaringan publik ke kluster.
Nilai default: |
true |
| load_balancer_id |
string |
No |
ID instans CLB untuk akses API Server. Ketika parameter ini ditentukan, pembuatan otomatis CLB API Server tidak dilakukan. Catatan
Pastikan instans CLB tidak memiliki dependensi lain (seperti listener atau server backend). Instans CLB berbagi dan menghadap Internet tidak didukung. |
lb-wz9t256gqa3vbouk**** |
| ssh_flags |
boolean |
No |
Apakah akan mengaktifkan logon SSH publik. Digunakan untuk logon ke node master kluster khusus ACK. Parameter ini tidak berlaku untuk kluster terkelola.
Nilai default: |
true |
| timezone |
string |
No |
Zona waktu yang digunakan oleh kluster. Lihat Zona waktu yang didukung. |
Asia/Shanghai |
| node_cidr_mask |
string |
No |
Jumlah alamat IP per node, ditentukan dengan menentukan masker CIDR jaringan. Hanya berlaku untuk kluster tipe jaringan Flannel. Nilai default: |
25 |
| proxy_mode |
string |
No |
Modus kube-proxy.
Nilai default: |
ipvs |
| controlplane_log_ttl |
string |
No |
Jumlah hari retensi log untuk log komponen lapisan kontrol. |
30 |
| controlplane_log_project |
string |
No |
Proyek Simple Log Service untuk log komponen lapisan kontrol. Anda dapat menggunakan proyek yang ada untuk penyimpanan log atau membiarkan sistem membuat proyek secara otomatis. Jika Anda memilih pembuatan otomatis, proyek Simple Log Service bernama |
k8s-log-xxx |
| controlplane_log_components |
array |
No |
Daftar nama komponen yang menentukan komponen lapisan kontrol mana yang akan dikumpulkan lognya. Secara default, log dikumpulkan dari kube-apiserver, kube-controller-manager, penjadwal, dan cloud-controller-manager. |
|
|
string |
No |
Daftar nama komponen yang menentukan komponen lapisan kontrol mana yang akan dikumpulkan lognya. Secara default, log dikumpulkan dari kube-apiserver, kube-controller-manager, penjadwal, dan cloud-controller-manager. |
["apiserver","kcm","scheduler"] |
|
| audit_log_config |
object |
No |
Konfigurasi log audit kluster. |
|
| enabled |
boolean |
No |
Apakah akan mengaktifkan fitur log audit kluster.
|
true |
| sls_project_name |
string |
No |
Proyek SLS yang berisi penyimpanan log log audit kluster.
|
k8s-log-c2345xxxxxxxxxxxx |
| rrsa_config |
object |
No |
Konfigurasi RRSA. |
|
| enabled |
boolean |
No |
Apakah akan mengaktifkan RRSA.
|
true |
| cluster_domain |
string |
No |
Domain lokal kluster. Aturan penamaan: Domain terdiri dari satu atau lebih bagian yang dipisahkan oleh titik (.). Setiap bagian dapat memiliki panjang hingga 63 karakter dan dapat berisi huruf kecil, angka, dan tanda hubung (-). Setiap bagian harus dimulai dan diakhiri dengan huruf kecil atau angka. |
cluster.local |
| encryption_provider_key |
string |
No |
ID kunci KMS yang digunakan untuk mengenkripsi disk data. Untuk informasi lebih lanjut, lihat Key Management Service. Catatan
Fitur ini hanya berlaku di kluster terkelola ACK Pro. |
0fe64791-55eb-4fc7-84c5-c6c7cdca**** |
| service_account_issuer |
string |
No |
ServiceAccount adalah kredensial akses untuk komunikasi antara Pod dan API Server kluster. Untuk informasi lebih lanjut tentang |
kubernetes.default.svc |
| api_audiences |
string |
No |
ServiceAccount adalah kredensial akses untuk komunikasi antara Pod dan API Server kluster. Untuk informasi lebih lanjut tentang |
kubernetes.default.svc |
| extra_sans |
array |
No |
SAN (Subject Alternative Name) sertifikat API Server kustom. |
|
|
string |
No |
SAN sertifikat. Mendukung alamat IP atau nama domain kustom. |
192.168.xx.xx |
|
| maintenance_window | maintenance_window |
No |
Jendela pemeliharaan kluster. |
|
| operation_policy |
object |
No |
Kebijakan O&M otomatis kluster. |
|
| cluster_auto_upgrade |
object |
No |
Konfigurasi peningkatan otomatis kluster. |
|
| enabled |
boolean |
No |
Apakah akan mengaktifkan peningkatan otomatis kluster.
|
true |
| channel |
string |
No |
Frekuensi peningkatan otomatis kluster. Nilai valid:
|
stable |
| addons |
array |
No |
Daftar komponen kluster. Tentukan komponen yang akan diinstal saat membuat kluster menggunakan Komponen jaringan: Wajib. Pilih antara tipe jaringan Flannel dan Terway:
Komponen penyimpanan: Opsional. Hanya tipe
Komponen log: Opsional. Kami menyarankan Anda mengaktifkan komponen ini. Jika layanan log tidak diaktifkan, fitur audit kluster tidak tersedia.
Komponen Ingress: Opsional. Kluster khusus ACK menginstal komponen Ingress
Pusat Insiden: Opsional. Diaktifkan secara default. Pusat Insiden menyediakan kemampuan penyimpanan, kueri, dan peringatan untuk event Kubernetes. penyimpanan log yang terkait dengan Pusat Insiden Kubernetes gratis selama 90 hari. Untuk informasi lebih lanjut tentang kebijakan gratis, lihat Membuat dan menggunakan pusat insiden Kubernetes. Contoh mengaktifkan Pusat Insiden: [{"name":"ack-node-problem-detector","config":"{"sls_project_name":"your_sls_project_name"}"}]. |
|
| addon |
No |
Daftar komponen kluster. Tentukan komponen yang akan diinstal saat membuat kluster menggunakan |
||
| nodepools |
array |
No |
Daftar kelompok node. |
|
| nodepool |
No |
Konfigurasi kelompok node. |
||
| user_ca |
string |
No |
CA kluster kustom. |
-----BEGIN CERTIFICATE-----**** |
| control_plane_config |
object |
No |
Konfigurasi lapisan kontrol kluster khusus ACK. |
|
| charge_type |
string |
No |
Metode penagihan node lapisan kontrol.
Nilai default: |
PostPaid |
| period |
integer |
No |
Durasi langganan node lapisan kontrol. Valid dan wajib ketika metode penagihan adalah Nilai valid: {1, 2, 3, 6, 12, 24, 36, 48, 60}. Unit: bulan. Nilai default: 1. |
1 |
| period_unit |
string |
No |
Unit periode langganan node lapisan kontrol. Valid dan wajib ketika metode penagihan adalah Nilai valid: |
Month |
| auto_renew |
boolean |
No |
Apakah akan mengaktifkan perpanjangan otomatis untuk node lapisan kontrol. Berlaku ketika metode penagihan adalah
Nilai default: true. |
true |
| auto_renew_period |
integer |
No |
Periode perpanjangan otomatis node lapisan kontrol. Nilai valid: {1, 2, 3, 6, 12}. Unit: bulan. Nilai default: 1. |
1 |
| instance_types |
array |
No |
Tipe instans node. |
|
|
string |
No |
Tipe instans node. |
ecs.g6.large |
|
| image_type |
string |
No |
Tipe image sistem operasi. |
AliyunLinux3 |
| image_id |
string |
No |
ID image. |
aliyun_3_x64_20G_alibase_20240819.vhd |
| key_pair |
string |
No |
Nama key pair. Saling eksklusif dengan login_password. |
ack |
| login_password |
string |
No |
Kata sandi logon SSH. Harus 8 hingga 30 karakter dan mengandung setidaknya tiga dari berikut: huruf besar, huruf kecil, angka, dan karakter khusus. Saling eksklusif dengan key_pair. |
******** |
| system_disk_category |
string |
No |
Tipe disk sistem node.
|
cloud_ssd |
| system_disk_size |
integer |
No |
Ukuran cloud disk sistem node. Nilai valid: [40,500]. Unit: GiB. Nilai default: |
120 |
| system_disk_snapshot_policy_id |
string |
No |
Kebijakan cadangan snapshot otomatis untuk node. |
sp-2zej1nogjvovnz4z**** |
| system_disk_performance_level |
string |
No |
Tingkat kinerja cloud disk sistem node. Parameter ini hanya berlaku untuk cloud disk ESSD. Tingkat kinerja bervariasi berdasarkan ukuran cloud disk. Untuk informasi lebih lanjut, lihat Cloud disk ESSD. |
PL1 |
| system_disk_provisioned_iops |
integer |
No |
IOPS baca/tulis yang disediakan untuk cloud disk sistem node. Nilai valid: 0 hingga min{50.000, 1000 × kapasitas - kinerja dasar}. Kinerja dasar = min{1.800 + 50 × kapasitas, 50000}. Parameter ini hanya didukung ketika |
1000 |
| system_disk_bursting_enabled |
boolean |
No |
Apakah akan mengaktifkan burst (lonjakan performa) untuk cloud disk sistem node.
Parameter ini hanya didukung ketika |
true |
| deploymentset_id |
string |
No |
ID set penyebaran. |
ds-bp10b35imuam5amw**** |
| cloud_monitor_flags |
boolean |
No |
Apakah akan menginstal CloudMonitor pada node.
Nilai default: false. |
false |
| instance_metadata_options | InstanceMetadataOptions |
No |
Konfigurasi akses metadata instans untuk Instance ECS. |
|
| soc_enabled |
boolean |
No |
Apakah akan mengaktifkan penguatan keamanan MLPS 2.0.
Nilai default: false. |
false |
| security_hardening_os |
boolean |
No |
Apakah akan mengaktifkan penguatan keamanan OS Alibaba Cloud.
Nilai default: false. |
false |
| cpu_policy |
string |
No |
Kebijakan manajemen CPU node.
Nilai default: none. |
none |
| runtime |
string |
No |
Bidang ini sudah tidak digunakan. Runtime kontainer untuk node lapisan kontrol. Nilai valid: containerd: Runtime Containerd, yang mendukung semua versi kluster. [_single.params.body.props |
containerd |
| node_port_range |
string |
No |
Bidang ini sudah tidak digunakan. Range port layanan node. |
30000-32767 |
| size |
integer |
No |
Jumlah node lapisan kontrol. Nilai valid: |
3 |
custom_san
deprecated
|
string |
No |
Bidang ini sudah tidak digunakan. Gunakan parameter Subject Alternative Name (SAN) sertifikat kustom. Pisahkan beberapa alamat IP atau nama domain dengan koma (,). |
cs.aliyun.com |
runtime
deprecated
|
runtime |
No |
The container runtime of the cluster. Supported runtimes include containerd, sandboxed containers, and Docker. Catatan
Kubernetes 1.24 no longer supports Docker as a built-in container runtime. For more information, see Comparison among Docker, containerd, and sandboxed container runtimes. |
|
node_name_mode
deprecated
|
string |
No |
Bidang ini sudah tidak digunakan. Untuk konfigurasi kelompok node, gunakan parameter |
null |
user_data
deprecated
|
string |
No |
This field is deprecated. The custom node data. |
IyEvdXNyL2Jpbi9iYXNoCmVjaG8gIkhlbGxvIEFD**** |
image_id
deprecated
|
string |
No |
This field is deprecated. For control plane configurations, use the The custom node image. The system image is used by default. When a custom image is selected, it replaces the default system image. For more information, see Custom images. |
m-bp16z7xko3vvv8gt**** |
rds_instances
deprecated
|
array |
No |
This field is deprecated. For node pool configurations, use the The list of RDS instances. Select the RDS instances that you want to add to the whitelist. Go to the RDS console to add the container pod CIDR block and node CIDR block. Configuring RDS instances may fail if the instances are not in the running state. |
|
|
string |
No |
The list of RDS instances. Select the RDS instances that you want to add to the whitelist. Go to the RDS console to add the container pod CIDR block and node CIDR block. Configuring RDS instances may fail if the instances are not in the running state. |
rm-2zev748xi27xc**** |
|
taints
deprecated
|
array |
No |
This field is deprecated. For node pool configurations, use the The node taint information. Taints and tolerations work together to prevent pods from being scheduled to inappropriate nodes. For more information, see taint-and-toleration. |
|
| taint |
No |
The node taint information. Taints and tolerations work together to prevent pods from being scheduled to inappropriate nodes. For more information, see taint-and-toleration. |
||
cloud_monitor_flags
deprecated
|
boolean |
No |
This field is deprecated. For control plane node configurations, use the Specifies whether to install the CloudMonitor agent on the cluster. Valid values:
Default value: |
false |
platform
deprecated
|
string |
No |
This field is deprecated. For node pool configurations, use the The operating system distribution. Valid values:
Default value: |
CentOS |
os_type
deprecated
|
string |
No |
This field is deprecated. For control plane node configurations, use the The operating system platform type. Valid values:
Default value: |
Linux |
soc_enabled
deprecated
|
boolean |
No |
This field is deprecated. For control plane node configurations, use the MLPS 2.0 security hardening. For more information, see ACK MLPS 2.0 security hardening usage instructions. Valid values:
Default value: |
false |
security_hardening_os
deprecated
|
boolean |
No |
This field is deprecated. For control plane configurations, use the Alibaba Cloud OS security hardening. Valid values:
Default value: |
false |
cis_enabled
deprecated
|
boolean |
No |
This field is deprecated. For control plane configurations, use the |
false |
cpu_policy
deprecated
|
string |
No |
This field is deprecated. For control plane configurations, use the The node CPU management policy. The following policies are supported for cluster versions 1.12.6 and later:
Default value: |
none |
node_port_range
deprecated
|
string |
No |
The node service port range. Valid values: [30000,65535]. Default value: |
30000~32767 |
master_vswitch_ids
deprecated
|
array |
No |
This field is deprecated. Use the The list of vSwitch IDs for master nodes. The number of vSwitches ranges from [1,3]. To ensure high availability, select three vSwitches distributed across different zones. The number of specified instance types must match the value of |
|
|
string |
No |
The list of vSwitch IDs for master nodes. The number of vSwitches ranges from [1,3]. To ensure high availability, select three vSwitches distributed across different zones. The number of specified instance types must match the value of |
vsw-2ze3ds0mdip0hdz8i**** |
|
key_pair
deprecated
|
string |
No |
This field is deprecated. For control plane configurations, use the The key pair name. Mutually exclusive with |
security-key |
login_password
deprecated
|
string |
No |
This field is deprecated. For control plane configurations, use the The SSH logon password. Mutually exclusive with |
null |
master_count
deprecated
|
integer |
No |
This field is deprecated. For control plane configurations, use the The number of master nodes. Valid values: Default value: |
3 |
master_instance_types
deprecated
|
array |
No |
This field is deprecated. For control plane configurations, use the The instance types for master nodes. For more information, see Instance families. |
|
|
string |
No |
The instance types for master nodes. The number of specified instance types must match the value of |
ecs.n4.xlarge |
|
master_system_disk_category
deprecated
|
string |
No |
This field is deprecated. For control plane configurations, use the The system cloud disk type for master nodes. Valid values:
Default value: |
cloud_ssd |
master_system_disk_size
deprecated
|
integer |
No |
This field is deprecated. For control plane configurations, use the The system cloud disk size for master nodes. Valid values: [40,500]. Unit: GiB. Default value: |
120 |
master_system_disk_performance_level
deprecated
|
string |
No |
This field is deprecated. For control plane configurations, use the The performance level of the system cloud disk for cluster master nodes. This parameter takes effect only for ESSD cloud disks. The performance level varies based on the cloud disk size. For more information, see ESSD cloud disks. |
PL1 |
master_system_disk_snapshot_policy_id
deprecated
|
string |
No |
This field is deprecated. For control plane configurations, use the The automatic snapshot policy ID for the master node system cloud disk. |
sp-2zej1nogjvovnz4z**** |
master_instance_charge_type
deprecated
|
string |
No |
This field is deprecated. For control plane configurations, use the The billing method for master nodes. Valid values:
Default value: |
PrePaid |
master_period_unit
deprecated
|
string |
No |
This field is deprecated. For control plane configurations, use the The billing period unit for master nodes. This parameter is required when the billing method is Valid values: |
Month |
master_period
deprecated
|
integer |
No |
This field is deprecated. For control plane configurations, use the The subscription duration for master nodes. This parameter takes effect and is required only when Valid values: {1, 2, 3, 6, 12, 24, 36, 48, 60}. Default value: 1. |
1 |
master_auto_renew
deprecated
|
boolean |
No |
This field is deprecated. For control plane configurations, use the Specifies whether to enable auto-renewal for master nodes. This parameter takes effect only when
Default value: |
true |
master_auto_renew_period
deprecated
|
integer |
No |
This field is deprecated. For control plane configurations, use the The auto-renewal period for master nodes. This parameter takes effect and is required when the subscription billing method is selected. Valid values: {1, 2, 3, 6, 12}. Default value: 1. |
1 |
num_of_nodes
deprecated
|
integer |
No |
This field is deprecated. For node pool configurations, use the The number of worker nodes. Valid values: [0, 100]. |
3 |
worker_vswitch_ids
deprecated
|
array |
No |
This field is deprecated. For node pool configurations, use the The list of vSwitches used by cluster nodes. Each node corresponds to one value. When creating a zero-node managed cluster, the |
|
|
string |
No |
The list of vSwitches for worker nodes. Valid values: [1,20]. To ensure high availability, select vSwitches in different zones. When creating a zero-node managed cluster, the |
vsw-2ze3ds0mdip0hdz8i**** |
|
worker_instance_types
deprecated
|
array |
No |
This field is deprecated. For node pool configurations, use the The instance configuration for worker nodes. |
|
|
string |
No |
The instance types for worker nodes. Specify at least one instance type. For more information, see Instance families. Catatan
The priority of instance types decreases as their position in the array increases. When an instance cannot be created with a higher-priority instance type, the system automatically selects the next instance type in the list. |
ecs.n4.large |
|
worker_system_disk_category
deprecated
|
string |
No |
This field is deprecated. For node pool configurations, use the The system cloud disk type for worker nodes. For more information, see Block storage overview. Valid values:
Default value: |
cloud_efficiency |
worker_system_disk_size
deprecated
|
integer |
No |
This field is deprecated. For node pool configurations, use the The system cloud disk size for worker nodes. Unit: GiB. Valid values: [40,500]. The value must be greater than or equal to max{40, ImageSize}. Default value: |
120 |
worker_system_disk_snapshot_policy_id
deprecated
|
string |
No |
This field is deprecated. For node pool configurations, use the The automatic snapshot policy ID for the worker node system cloud disk. |
sp-2zej1nogjvovnz4z**** |
worker_system_disk_performance_level
deprecated
|
string |
No |
This field is deprecated. For node pool configurations, use the When the system cloud disk is an ESSD, you can set the performance level (PL) of the ESSD. For more information, see ESSD cloud disks. Valid values:
|
PL1 |
worker_data_disks
deprecated
|
array<object> |
No |
This field is deprecated. For node pool configurations, use the The data cloud disk type, size, and other configurations for worker nodes. |
|
|
object |
No |
The data cloud disk configuration. |
||
| category |
string |
Yes |
The data cloud disk type. |
cloud_essd |
| encrypted |
string |
No |
Specifies whether to encrypt the data cloud disk. Valid values:
Default value: |
true |
| size |
string |
Yes |
The data cloud disk size. Valid values: 40 to 32767. Unit: GiB. |
120 |
| performance_level |
string |
No |
The performance level of the node data cloud disk. This parameter takes effect only for ESSD cloud disks. |
PL1 |
worker_instance_charge_type
deprecated
|
string |
No |
This field is deprecated. For node pool configurations, use the The billing method for worker nodes. Valid values:
Default value: pay-as-you-go. |
PrePaid |
worker_period_unit
deprecated
|
string |
No |
This field is deprecated. For node pool configurations, use the The billing period unit for worker nodes. This parameter is required when the billing method is Valid values: |
Month |
worker_period
deprecated
|
integer |
No |
This field is deprecated. For node pool configurations, use the The subscription duration for worker nodes. This parameter takes effect and is required only when `worker_ |
1 |
worker_auto_renew
deprecated
|
boolean |
No |
This field is deprecated. Use the Specifies whether to enable auto-renewal for worker nodes. This parameter takes effect only when
Default value: |
true |
worker_auto_renew_period
deprecated
|
integer |
No |
This field is deprecated. Use the The auto-renewal epoch for worker nodes. This parameter takes effect and is required only when the subscription billing method is selected. Valid values: {1, 2, 3, 6, 12}. |
1 |
instances
deprecated
|
array |
No |
This field is deprecated. Selecting existing nodes during cluster creation is not supported. To add existing nodes to a cluster, create a node pool first and call the AttachInstancesToNodePool operation. When creating a cluster with existing nodes, specify a list of ECS instances. These instances are added to the cluster as worker nodes. Catatan
This field is required when creating a cluster with existing instances. |
|
|
string |
No |
When creating a cluster with existing nodes, specify a list of ECS instances. These instances are added to the cluster as worker nodes. Catatan
This field is required when creating a cluster with existing instances. |
i-2ze4zxnm36vq00xn**** |
|
format_disk
deprecated
|
boolean |
No |
This field is deprecated. Selecting existing nodes during cluster creation is not supported. To add existing nodes to a cluster, create a node pool first and call the AttachInstancesToNodePool operation. Specifies whether to mount data cloud disks when creating a cluster with existing instances. Valid values:
Default value: Data cloud disk mounting rules:
|
false |
keep_instance_name
deprecated
|
boolean |
No |
This field is deprecated. Selecting existing nodes during cluster creation is not supported. To add existing nodes to a cluster, create a node pool first and call the AttachInstancesToNodePool operation. Specifies whether to retain instance names when creating a cluster with existing instances.
Default value: |
true |
service_discovery_types
deprecated
|
array |
No |
This field is deprecated. The in-cluster service discovery type, used to specify the service discovery method in
Default value: disabled. |
|
|
string |
No |
The in-cluster service discovery type, used to specify the service discovery method in
Default value: disabled. |
PrivateZone |
|
nat_gateway
deprecated
|
boolean |
No |
This field is deprecated. Use the |
true |
zone_id
deprecated
|
string |
No |
This field is deprecated. Use the The active zone ID of the region where the cluster resides. This parameter is specific to ACK managed clusters. When creating an ACK managed cluster, if |
cn-beiji**** |
logging_type
deprecated
|
string |
No |
This field is deprecated. Enables the log service for the cluster. This parameter takes effect only for ACK Serverless clusters, and the value must be |
SLS |
disable_rollback
deprecated
|
boolean |
No |
This field is deprecated. By default, rollback is not performed when cluster creation fails. You must manually clean up the failed cluster. Specifies whether to roll back when cluster creation fails. Valid values:
Default value: |
true |
timeout_mins
deprecated
|
integer |
No |
This field is deprecated. By default, rollback is not performed when cluster creation fails. You must manually clean up the failed cluster. The cluster creation timeout period, in minutes. Default value: |
60 |
image_type
deprecated
|
string |
No |
This field is deprecated. For cluster control plane configuration, use the The operating system distribution type. We recommend that you use this field to specify the node operating system. Valid values:
Default value: |
AliyunLinux |
load_balancer_spec
deprecated
|
string |
No |
This parameter is deprecated. CLB uses pay-by-usage billing. This parameter does not take effect. The load balancing specification. Valid values:
Default value: |
slb.s2.small |
enable_rrsa
deprecated
|
boolean |
No |
This field is deprecated. Use the Specifies whether to enable the RRSA feature.
|
false |
charge_type
deprecated
|
string |
No |
This field is deprecated. The billing method of the CLB instance used by the API server. Default value: PostPaid. Valid values:
Penting
For more information, see Notice on Classic Load Balancer (CLB) billing item adjustments. |
PostPaid |
period_unit
deprecated
|
string |
No |
This field is deprecated. The billing cycle. This parameter is required when the billing method is PrePaid. Valid values: Month. Currently, only monthly billing cycles are supported. This field was changed on October 15, 2024. For more information, see Notice on behavior changes of the CreateCluster parameter. |
Month |
period
deprecated
|
integer |
No |
This field is deprecated. The subscription duration. This parameter takes effect and is required only when charge_type is set to PrePaid. Valid values: {1, 2, 3, 6, 12, 24, 36, 48, 60}. Default value: 1. This field was changed on October 15, 2024. For more information, see Notice on behavior changes of the CreateCluster parameter. |
1 |
auto_renew
deprecated
|
boolean |
No |
This field is deprecated. Specifies whether to enable auto-renewal. This parameter takes effect only when
Default value: This field was changed on October 15, 2024. For more information, see Notice on behavior changes of the CreateCluster parameter. |
true |
auto_renew_period
deprecated
|
integer |
No |
This field is deprecated. The auto-renewal epoch. This parameter takes effect only when the subscription billing method and auto-renewal are selected. When Default value: 1. This field was changed on October 15, 2024. For more information, see Notice on behavior changes of the CreateCluster parameter. |
1 |
access_control_list
deprecated
|
array |
No |
This field is deprecated. The access control list for the API server SLB of the registered cluster. |
|
|
string |
No |
The access control list for the API server SLB of the registered cluster. |
192.168.XX.XX/24 |
Elemen respons
|
Element |
Type |
Description |
Example |
|
object |
The response body. |
||
| cluster_id |
string |
The cluster ID. |
cb95aa626a47740afbf6aa099b650**** |
| request_id |
string |
The request ID. |
687C5BAA-D103-4993-884B-C35E4314**** |
| task_id |
string |
The task ID. |
T-5a54309c80282e39ea**** |
Contoh
Respons sukses
JSONformat
{
"cluster_id": "cb95aa626a47740afbf6aa099b650****",
"request_id": "687C5BAA-D103-4993-884B-C35E4314****",
"task_id": "T-5a54309c80282e39ea****"
}
Kode kesalahan
Lihat Error Codes untuk daftar lengkap.
Catatan rilis
Lihat Release Notes untuk daftar lengkap.