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 dengan menggunakan 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 dengan menggunakan 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.
-
Dalam kotak dialog, pilih tipe kluster yang ingin Anda buat, 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. Anda dapat menyalin dan menggunakannya.
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 (-). Nama 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 mengatur
Pro XL, Pro 2XL, dan Pro 4XL adalah tiga tingkatan yang disediakan oleh ACK Pro Provisioned Control Plane. Dengan mengalokasikan sebelumnya dan memperbaiki resource lapisan kontrol, tingkatan ini memastikan bahwa konkurensi API dan kemampuan penjadwalan Pod tetap pada tingkat tinggi yang deterministik. Tingkatan ini cocok untuk pelatihan dan inferensi AI, kluster berskala 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 mengatur
|
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 dari 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, yang 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 aktif ini. Saat membuat tipe kluster terkelola ACK, jika Anda tidak menentukan |
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 Anda membuat kluster terkelola tanpa node. |
|
|
string |
No |
vSwitch untuk node kluster. Bidang ini wajib saat Anda 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 lagi. Saat Anda memilih Terway sebagai plugin jaringan, Anda harus menentukan vSwitch untuk alokasi alamat IP Pod. Setiap vSwitch Pod berkorespondensi dengan vSwitch node pekerja, dan vSwitch Pod serta vSwitch node pekerja harus berada di zona yang sama. Catatan
Mask 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 menentukan vSwitch untuk alokasi alamat IP Pod. Setiap vSwitch Pod berkorespondensi dengan vSwitch node pekerja, dan vSwitch Pod serta vSwitch node pekerja harus berada di zona yang sama. Catatan
Mask 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 Pod, yang harus berupa blok CIDR privat yang valid, khususnya blok CIDR berikut dan subnetnya: 10.0.0.0/8, 172.16-31.0.0/12-16, dan 192.168.0.0/16. Blok CIDR tidak boleh tumpang tindih dengan blok CIDR VPC atau blok CIDR yang digunakan oleh kluster Kubernetes yang ada di VPC. Anda tidak dapat mengubah blok CIDR ini setelah kluster dibuat. Untuk informasi lebih lanjut 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 Service. Rentang valid: 10.0.0.0/16-24, 172.16-31.0.0/16-24, dan 192.168.0.0/16-24. Blok CIDR 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. Anda tidak dapat mengubah blok CIDR ini setelah kluster dibuat. Nilai default: 172.19.0.0/20. |
172.21.0.0/20 |
| security_group_id |
string |
No |
ID grup keamanan. Tentukan parameter ini saat Anda menggunakan grup keamanan yang ada untuk membuat kluster. Parameter ini saling eksklusif dengan |
sg-bp1bdue0qc1g7k**** |
| is_enterprise_security_group |
boolean |
No |
Apakah akan mengaktifkan pembuatan otomatis grup keamanan lanjutan. Parameter ini berlaku ketika Catatan
Saat Anda menggunakan grup keamanan dasar, jumlah total node dan Pod Terway di kluster tidak boleh melebihi 2.000. Kami menyarankan Anda menggunakan grup keamanan lanjutan saat membuat kluster tipe jaringan Terway.
Nilai default: |
true |
| snat_entry |
boolean |
No |
Pengaturan untuk mengonfigurasi SNAT untuk VPC. Nilai valid:
Catatan
Jika Anda tidak mengaktifkan opsi ini saat membuat kluster dan nantinya memerlukan akses Internet, 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. Saat 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 untuk akses kluster. |
||
| endpoint_type |
string |
No |
||
| load_balancer_id |
string |
No |
||
| 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. Jika akses nama domain internal tidak diaktifkan, komponen sistem sisi node mengakses API Server melalui alamat IP CLB. |
|
| bind_vpcs |
array |
No |
VPC tempat resolusi catatan DNS internal berlaku. |
|
|
string |
No |
VPC tempat resolusi catatan DNS 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. Saat 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 shared dan Internet-facing tidak didukung. |
lb-wz9t256gqa3vbouk**** |
| ssh_flags |
boolean |
No |
Apakah akan mengaktifkan logon SSH publik. Ini 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. Untuk informasi lebih lanjut, lihat Zona waktu yang didukung. |
Asia/Shanghai |
| node_cidr_mask |
string |
No |
Jumlah alamat IP per node, ditentukan dengan menentukan mask CIDR jaringan. Parameter ini 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 untuk retensi 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 melakukan pembuatan otomatis proyek. Jika Anda memilih pembuatan otomatis, proyek 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 kube, 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 kube, 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 fitur RRSA.
|
true |
| cluster_domain |
string |
No |
Nama domain lokal kluster. Aturan penamaan: Nama 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 cloud 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 O&M 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 cluster automatic upgrade.
|
true |
| channel |
string |
No |
Cluster automatic upgrade frequency. Nilai yang valid:
|
stable |
| addons |
array |
No |
Daftar komponen kluster. Tentukan komponen yang akan diinstal saat membuat kluster dengan 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 Anda tidak mengaktifkan layanan log, Anda tidak dapat menggunakan fitur audit kluster.
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 dengan 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 untuk kluster khusus ACK. |
|
| charge_type |
string |
No |
Metode penagihan untuk node lapisan kontrol.
Nilai default: |
PostPaid |
| period |
integer |
No |
Durasi langganan untuk node lapisan kontrol. Parameter ini valid dan wajib saat 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 untuk node lapisan kontrol. Parameter ini valid dan wajib saat metode penagihan adalah Nilai valid: |
Month |
| auto_renew |
boolean |
No |
Apakah akan mengaktifkan perpanjangan otomatis untuk node lapisan kontrol. Parameter ini valid saat metode penagihan adalah
Nilai default: true. |
true |
| auto_renew_period |
integer |
No |
Periode perpanjangan otomatis untuk 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. Kata sandi harus memiliki panjang 8 hingga 30 karakter dan harus berisi setidaknya tiga dari tipe karakter berikut: huruf besar, huruf kecil, angka, dan karakter khusus. |
******** |
| system_disk_category |
string |
No |
Tipe cloud disk sistem node.
Nilai default: |
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 terkait dengan ukuran cloud disk. Untuk informasi lebih lanjut, lihat Cloud disk ESSD (SSD standar). |
PL1 |
| system_disk_provisioned_iops |
integer |
No |
IOPS baca/tulis yang disediakan untuk cloud disk sistem node. Nilai valid: 0~min{50.000, 1000kapasitas-kinerja dasar}. Kinerja dasar=min{1.800+50kapasitas, 50000}. Parameter ini hanya berlaku ketika |
1000 |
| system_disk_bursting_enabled |
boolean |
No |
Apakah akan mengaktifkan burst (ledakan kinerja) untuk cloud disk sistem node.
Parameter ini hanya berlaku 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.
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 untuk node.
|
none |
| runtime |
string |
No |
Bidang ini sudah tidak digunakan lagi. Runtime kontainer untuk node lapisan kontrol. Nilai valid: containerd: Runtime containerd, didukung oleh semua versi kluster. |
containerd |
| node_port_range |
string |
No |
Bidang ini sudah tidak digunakan lagi. 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 lagi. Gunakan parameter SAN sertifikat kustom. Beberapa alamat IP atau nama domain dipisahkan oleh koma (,). |
cs.aliyun.com |
runtime
deprecated
|
runtime |
No |
The container runtime for the cluster. Supports 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 containers. |
|
node_name_mode
deprecated
|
string |
No |
This field is deprecated. For node pool configurations, use the |
null |
user_data
deprecated
|
string |
No |
This field is deprecated. Custom node data. |
IyEvdXNyL2Jpbi9iYXNoCmVjaG8gIkhlbGxvIEFD**** |
image_id
deprecated
|
string |
No |
This field is deprecated. For cluster control plane configurations, use the The custom image for nodes. 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 to which you want to add the whitelist. We recommend that you add the container pod CIDR block and node CIDR block to the RDS whitelist directly. Setting RDS instances may fail because the instances are not in a running state. |
|
|
string |
No |
The list of RDS instances to which you want to add the whitelist. We recommend that you add the container pod CIDR block and node CIDR block to the RDS whitelist directly. Setting RDS instances may fail because the instances are not in a running state. |
rm-2zev748xi27xc**** |
|
taints
deprecated
|
array |
No |
This field is deprecated. For node pool configurations, use 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 |
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 cluster 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 cluster 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 cluster control plane node configurations, use the MLPS 2.0 security hardening. For more information, see ACK MLPS 2.0 security hardening. Valid values:
Default value: |
false |
security_hardening_os
deprecated
|
boolean |
No |
This field is deprecated. For cluster 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 cluster control plane configurations, use the |
false |
cpu_policy
deprecated
|
string |
No |
This field is deprecated. For cluster control plane configurations, use the The CPU management policy for nodes. 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, we recommend that you select 3 vSwitches in different zones. The number of specified instance types must match |
|
|
string |
No |
The list of vSwitch IDs for master nodes. The number of vSwitches ranges from [1,3]. To ensure high availability, we recommend that you select 3 vSwitches in different zones. The number of specified instance types must match |
vsw-2ze3ds0mdip0hdz8i**** |
|
key_pair
deprecated
|
string |
No |
This field is deprecated. For cluster control plane configurations, use the The key pair name. Mutually exclusive with |
security-key |
login_password
deprecated
|
string |
No |
This field is deprecated. For cluster control plane configurations, use the The SSH logon password. Mutually exclusive with |
null |
master_count
deprecated
|
integer |
No |
This field is deprecated. For cluster 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 cluster 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 |
ecs.n4.xlarge |
|
master_system_disk_category
deprecated
|
string |
No |
This field is deprecated. For cluster 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 cluster 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 cluster 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 is related to the cloud disk size. For more information, see ESSD cloud disks (standard SSDs). |
PL1 |
master_system_disk_snapshot_policy_id
deprecated
|
string |
No |
This field is deprecated. For cluster 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 cluster 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 cluster control plane configurations, use the The billing cycle 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 cluster 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 cluster 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 cluster control plane configurations, use the The auto-renewal epoch 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 managed cluster with zero nodes, the |
|
|
string |
No |
The list of vSwitches for worker nodes. Valid values: [1,20]. To ensure high availability, we recommend that you select vSwitches in different zones. When creating a managed cluster with zero nodes, the |
vsw-2ze3ds0mdip0hdz8i**** |
|
worker_instance_types
deprecated
|
array |
No |
This field is deprecated. For node pool configurations, use the The instance configurations for worker nodes. |
|
|
string |
No |
The instance types for worker nodes. At least one instance type must be specified. 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-priority instance type. |
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 The performance level (PL) of the ESSD used as the system cloud disk can be configured when the system cloud disk is an ESSD cloud disk. 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 set. |
||
| 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 (standard SSDs). |
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 cycle. |
Month |
worker_period
deprecated
|
integer |
No |
This field is deprecated. Use the period parameter under scaling_group in nodepool for node pool configuration instead. The subscription duration of worker nodes. This parameter takes effect and is required only when worker_instance_charge_type is set to PrePaid. Valid values: 1, 2, 3, 6, 12, 24, 36, 48, and 60. Default value: 1. |
1 |
worker_auto_renew
deprecated
|
boolean |
No |
This field is deprecated. Use the auto_renew parameter under scaling_group in nodepool for node pool configuration instead. Specifies whether to enable auto-renewal for worker nodes. This parameter takes effect only when worker_instance_charge_type is set to PrePaid. Valid values:
Default value: |
true |
worker_auto_renew_period
deprecated
|
integer |
No |
This field is deprecated. Use the auto_renew_period parameter under scaling_group in nodepool for node pool configuration instead. The auto-renewal epoch of worker nodes. This parameter takes effect and is required only when the subscription billing method is selected. Valid values: 1, 2, 3, 6, and 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 you use existing nodes to create a cluster, specify a list of ECS instances. These instances are added to the cluster as worker nodes. Catatan
This field is required when you use existing instances to create a cluster. |
|
|
string |
No |
When you use existing nodes to create a cluster, specify a list of ECS instances. These instances are added to the cluster as worker nodes. Catatan
This field is required when you use existing instances to create a cluster. |
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 to existing instances when creating a cluster. 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 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 Simple 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. When cluster creation fails, rollback is not performed by default. You must manually clean up the failed cluster. Specifies whether to roll back the cluster when creation fails. Valid values:
Default value: |
true |
timeout_mins
deprecated
|
integer |
No |
This field is deprecated. When cluster creation fails, rollback is not performed by default. You must manually clean up the failed cluster. The timeout period for cluster creation, in minutes. Default value: |
60 |
image_type
deprecated
|
string |
No |
This field is deprecated. Use the image_type parameter under 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 Announcement on 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 Announcement 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, and 60. Default value: 1. This field was changed on October 15, 2024. For more information, see Announcement 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 Announcement 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 upfront billing method and auto-renewal are selected. When Default value: 1. This field was changed on October 15, 2024. For more information, see Announcement 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 a registered cluster. |
|
|
string |
No |
The access control list for the API server SLB of a 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.