All Products
Search
Document Center

Auto Scaling:ApplyScalingGroup

Last Updated:Jun 12, 2026

Membuat dan mengelola grup penskalaan dengan memanggil operasi API ApplyScalingGroup menggunakan file konfigurasi.

Deskripsi operasi

ApplyScalingGroup mendukung format definisi resource Kubernetes Deployment untuk membuat grup penskalaan Elastic Container Instance (ECI) dengan cepat. Operasi ini juga mendukung anotasi ekstensi YAML Kubernetes khusus ECI. Untuk informasi lebih lanjut, lihat daftar anotasi yang didukung.

Pemetaan antara konfigurasi YAML dan grup penskalaan: Nama grup penskalaan dipetakan oleh triplet namespace, kind, dan name dalam definisi YAML. Dalam satu wilayah, konfigurasi YAML hanya dapat dipetakan ke satu grup penskalaan. Contoh: Jika Anda menggunakan konfigurasi YAML Deployment dengan nama nginx di bawah namespace default, konfigurasi tersebut dipetakan ke grup penskalaan bernama k8s_default_Deployment_nginx di wilayah yang sama.

Logika untuk mengelola grup penskalaan berdasarkan konfigurasi YAML:

  • Jika grup penskalaan yang dipetakan oleh konfigurasi YAML sudah ada, grup penskalaan akan diperbarui berdasarkan konfigurasi YAML.

  • Jika grup penskalaan yang dipetakan oleh konfigurasi YAML tidak ada, grup penskalaan akan dibuat berdasarkan konfigurasi YAML.

Sebelum memulai

  1. Jika konfigurasi YAML tidak menentukan anotasi untuk virtual private cloud (VPC), vSwitch, atau grup keamanan, sistem akan membuat secara otomatis VPC default, vSwitch default di dalam VPC tersebut, dan grup keamanan Penyesuaian Skala Otomatis default bernama ess-default-sg. Kebijakan grup keamanan membuka port TCP 22 dan 3389 serta protokol ICMP (IPv4) secara default. Jika Anda memerlukan port atau protokol lain, sesuaikan kebijakan grup keamanan.

  2. Saat menggunakan gambar publik, aktifkan akses jaringan publik dengan mengatur anotasi Pod k8s.aliyun.com/eci-with-eip untuk mengaktifkan EIP.

  3. Setelah ApplyScalingGroup menerapkan konfigurasi YAML, grup penskalaan dan konfigurasi penskalaan akan langsung berlaku. Jika replicas diatur ke nilai lebih dari 0, pembuatan otomatis resource akan dipicu.

Anotasi yang didukung

Anotasi ini merujuk pada ECI Pod Annotation.

ParameterContohDeskripsi
k8s.aliyun.com/ess-scaling-group-min-size1Jumlah minimum instans dalam grup penskalaan. Nilai default: 0.
k8s.aliyun.com/ess-scaling-group-max-size20Jumlah maksimum instans dalam grup penskalaan. Nilai default: max(replicas, 30).
k8s.aliyun.com/eci-ntp-server100.100..Server NTP.
k8s.aliyun.com/eci-use-specs2-4GiTipe instans dengan 2 vCPU dan memori 4 GiB. Untuk informasi lebih lanjut, lihat Membuat Pod dengan beberapa tipe instans.
k8s.aliyun.com/eci-vswitchvsw-bp1xpiowfm5vo8o3c****ID vSwitch. Anda dapat menentukan beberapa vSwitch untuk mengimplementasikan fitur multi-zona.
k8s.aliyun.com/eci-security-groupsg-bp1dktddjsg5nktv****ID grup keamanan. Persyaratan:
  • Anda dapat menentukan satu atau beberapa grup keamanan, maksimum 5.

  • Grup keamanan yang ditentukan harus berada di VPC yang sama.

  • Grup keamanan yang ditentukan harus memiliki tipe yang sama.

k8s.aliyun.com/eci-sls-enable"false"Atur ke false untuk menonaktifkan fitur pengumpulan log.

Saat Anda mengumpulkan log menggunakan SLS CRD, jika Pod tertentu tidak memerlukan pengumpulan log, konfigurasikan anotasi ini untuk menonaktifkan fitur pengumpulan log dan mencegah sistem membuat instans Logtail secara otomatis yang dapat memboroskan resource.

k8s.aliyun.com/eci-spot-strategySpotAsPriceGoKebijakan penawaran untuk instans spot. Nilai valid:
  • SpotWithPriceLimit: menetapkan harga maksimum per jam kustom untuk instans spot. Anda juga harus mengatur k8s.aliyun.com/eci-spot-price-limit.

  • SpotAsPriceGo: menggunakan kebijakan penawaran otomatis yang mengikuti harga pasar saat ini.

k8s.aliyun.com/eci-spot-price-limit"0.5"Harga maksimum per jam untuk instans spot, akurat hingga tiga tempat desimal.

Anotasi ini hanya berlaku jika k8s.aliyun.com/eci-spot-strategy diatur ke SpotWithPriceLimit.

k8s.aliyun.com/eci-with-eip"true"Atur ke true untuk membuat dan menyambungkan EIP secara otomatis.
k8s.aliyun.com/eci-data-cache-bucketdefaultBucket DataCache. Anotasi ini diperlukan saat Anda membuat Pod menggunakan DataCache.
k8s.aliyun.com/eci-data-cache-plPL1Tingkat kinerja (PL) cloud disk yang dibuat berdasarkan DataCache.

ESSD digunakan secara default, dan PL default adalah PL1.

k8s.aliyun.com/eci-data-cache-provisionedIops"40000"IOPS baca/tulis yang disediakan untuk cloud disk ESSD AutoPL. Rentang aktif: 0 hingga min{50000, 1000 × kapasitas - garis dasar}. Garis dasar = min{1800 + 50 × kapasitas, 50000}. Untuk informasi lebih lanjut, lihat Cloud disk ESSD AutoPL.

Jika anotasi ini ditambahkan, cloud disk yang dibuat berdasarkan DataCache adalah cloud disk ESSD AutoPL.

k8s.aliyun.com/eci-data-cache-burstingEnabled"true"Apakah akan mengaktifkan burst (lonjakan performa) untuk cloud disk ESSD AutoPL. Untuk informasi lebih lanjut, lihat Cloud disk ESSD AutoPL.

Jika anotasi ini ditambahkan, cloud disk yang dibuat berdasarkan DataCache adalah cloud disk ESSD AutoPL.

k8s.aliyun.com/eci-custom-tags"env:test,name:alice"String tag yang akan dilampirkan. Anda dapat melampirkan hingga 3 tag. Pisahkan kunci tag dan nilai tag dengan titik dua (:), dan pisahkan beberapa tag dengan koma (,).

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

ess:ApplyScalingGroup

create

*全部资源

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

Content

string

Yes

Konten file konfigurasi.

apiVersion: apps/v1 kind: Deployment metadata: name: nginx-deployment labels: app: nginx spec: replicas: 3 selector: matchLabels: app: nginx template: metadata: labels: app: nginx annotations: k8s.aliyun.com/eip-bandwidth: 10 k8s.aliyun.com/eci-with-eip: true spec: containers: - name: nginx image: nginx:1.14.2 ports: - containerPort: 80

RegionId

string

No

ID wilayah.

cn-hangzhou

Elemen respons

Element

Type

Description

Example

object

Skema Respons.

RequestId

string

ID permintaan.

CC107349-57B7-4405-B1BF-9BF5AF7F****

ScalingGroupId

string

ID grup penskalaan yang berlaku.

asg-bp1igpak5ft1flyp****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "CC107349-57B7-4405-B1BF-9BF5AF7F****",
  "ScalingGroupId": "asg-bp1igpak5ft1flyp****"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.