StartInstanceRefresh - Auto Scaling - Alibaba Cloud Documentation Center

Merefresh instans dalam grup penskalaan saat Anda perlu menerapkan konfigurasi penskalaan baru atau memperbarui image instans dalam grup penskalaan.

Deskripsi operasi

Grup penskalaan hanya dapat memiliki satu tugas refresh instans yang berjalan pada satu waktu.
Saat ini, fitur ini hanya didukung untuk grup penskalaan ECS yang kebijakan scale-out-nya diatur ke Priority Policy. Grup penskalaan yang menggunakan vCPU-based Capacity Calculation dan grup penskalaan yang mode reclaim instans-nya diatur ke Shutdown and Reclaim Mode atau Forced Shutdown and Reclaim Mode tidak mendukung fitur ini.
Selama refresh instans, operasi scale-out dan scale-in normal dapat dilakukan. Namun, operasi scale-out menggunakan konfigurasi yang diinginkan yang ditentukan dalam tugas refresh instans.
Instans yang ditambahkan secara manual ke grup penskalaan, instans dalam keadaan siaga, dan instans dalam keadaan dilindungi diabaikan oleh tugas refresh instans dan tidak berpartisipasi dalam refresh instans.

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

update

*ScalingGroup.

acs:ess:{#regionId}:{#accountId}:scalinggroup/{#ScalingGroupId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah grup penskalaan.	cn-hangzhou
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan token, tetapi Anda harus memastikan bahwa token tersebut unik di antara permintaan yang berbeda. Token hanya dapat berisi karakter ASCII dan tidak boleh melebihi 64 karakter. Untuk informasi lebih lanjut, lihat Cara memastikan idempotensi.	123e4567-e89b-12d3-a456-42665544****
ScalingGroupId	string	Yes	ID grup penskalaan.	asg-bp18p2yfxow2dloq****
MinHealthyPercentage	integer	No	Persentase minimum instans yang harus tetap dalam layanan di grup penskalaan selama refresh instans. Nilai valid: 0 hingga 100. Nilai default: 80.	80
MaxHealthyPercentage	integer	No	Persentase maksimum yang dapat dilampaui oleh jumlah instans dalam grup penskalaan terhadap kapasitas grup penskalaan selama refresh instans. Nilai valid: 100 hingga 200. Nilai default: 120. Catatan Jika Anda mengatur MinHealthyPercentage dan MaxHealthyPercentage ke 100, satu instans direfresh sekaligus.	100
DesiredConfiguration	object	No	Konfigurasi yang diinginkan untuk refresh instans. Catatan Anda tidak dapat menentukan ScalingConfigurationId, ImageId, LaunchTemplateId, dan Containers secara bersamaan. Anda harus menentukan salah satunya. Tugas refresh melewatkan instans dalam grup penskalaan yang sudah cocok dengan konfigurasi yang diinginkan.
ImageId	string	No	ID image. Catatan Setelah tugas refresh instans selesai, konfigurasi image dalam konfigurasi aktif grup penskalaan diperbarui ke image ini. Parameter ini tidak didukung ketika sumber konfigurasi instans grup penskalaan adalah template peluncuran. Image yang berisi cloud disk data tidak didukung.	m-2ze8cqacj7opnf***
ScalingConfigurationId	string	No	ID konfigurasi penskalaan. Catatan Setelah tugas refresh instans selesai, konfigurasi penskalaan aktif grup penskalaan diperbarui ke konfigurasi ini.	asc-2zed7lqn4ts4****
LaunchTemplateId	string	No	ID template peluncuran. Parameter ini menentukan bahwa grup penskalaan memperoleh informasi konfigurasi peluncuran dari template peluncuran.	lt-2ze2qli30u***
LaunchTemplateVersion	string	No	Versi template peluncuran. Nilai valid: Nomor versi template tetap. Default: selalu menggunakan versi template default. Latest: selalu menggunakan versi template terbaru. Catatan Jika versi diatur ke Default atau Latest, tugas refresh instans tidak mendukung rollback.	8
LaunchTemplateOverrides	array<object>	No	Informasi tipe instans yang memperluas template peluncuran.
	object	No	Informasi tipe instans yang memperluas template peluncuran.
InstanceType	string	No	Tipe instans yang menggantikan tipe instans yang ditentukan dalam template peluncuran.	ecs.g7.2xlarge
Containers	array<object>	No	Daftar kontainer yang disertakan dalam instans.
	array<object>	No	Daftar kontainer yang disertakan dalam instans.
Name	string	No	Nama kontainer kustom.	nginx
Image	string	No	Gambar kontainer.	registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:latest
Commands	array	No	Perintah startup kontainer. Maksimum 20 perintah didukung. Setiap perintah dapat berisi hingga 256 karakter.
	string	No	Perintah startup kontainer. Perintah dapat berisi hingga 256 karakter.	sleep
Args	array	No	Argumen untuk perintah startup kontainer. Maksimum 10 argumen didukung.
	string	No	Argumen untuk perintah startup kontainer.	100
EnvironmentVars	array<object>	No	Informasi variabel lingkungan.
	object	No	Informasi variabel lingkungan.
Key	string	No	Nama variabel lingkungan. Nama harus memiliki panjang 1 hingga 128 karakter dan dapat berisi angka, huruf, dan garis bawah (_). Tidak dapat dimulai dengan angka.	PATH
Value	string	No	Nilai variabel lingkungan. Nilai dapat memiliki panjang 0 hingga 256 karakter.	/usr/local/bin
FieldRefFieldPath	string	No	Catatan Parameter ini tidak tersedia secara publik.	fieldPath
SkipMatching	boolean	No	Apakah akan melewatkan instans yang cocok dengan konfigurasi yang diinginkan. Catatan Sistem menentukan apakah instans cocok berdasarkan ID konfigurasi penskalaan yang diinginkan, bukan dengan membandingkan item konfigurasi tertentu. Nilai valid: true: Melewatkan instans yang cocok. Ketika tugas refresh instans dimulai, sistem memeriksa konfigurasi setiap instans. Instans yang sudah dibuat dengan konfigurasi yang diinginkan tidak direfresh. false: Tidak melewatkan instans yang cocok. Setelah tugas refresh instans dimulai, semua instans dalam grup penskalaan direfresh. Nilai default: true.	true
Checkpoints	array<object>	No	Checkpoint untuk tugas refresh. Menentukan bahwa tugas secara otomatis dijeda selama durasi yang ditentukan oleh CheckpointPauseTime ketika persentase instans baru mencapai nilai yang ditentukan selama refresh instans.
	object	No	Checkpoint untuk tugas refresh. Menentukan bahwa tugas secara otomatis dijeda selama durasi yang ditentukan oleh CheckpointPauseTime ketika persentase instans baru mencapai nilai yang ditentukan selama refresh instans.
Percentage	integer	No	Persentase instans baru terhadap total instans dalam grup penskalaan. Tugas secara otomatis dijeda ketika persentase ini tercapai. Nilai valid: 1 hingga 100 (%). Catatan Nilai harus ditentukan dalam urutan menaik, dan nilai persentase terakhir harus 100.	20
CheckpointPauseTime	integer	No	Durasi jeda ketika checkpoint tugas refresh tercapai. Unit: minutes. Nilai valid: 1 hingga 2880. Nilai default: 60.	10
Strategy	string	No	Strategi eksekusi untuk tugas refresh instans. Nilai valid: Rolling: Tugas refresh instans membuat instans baru dan melepaskan instans lama untuk merefresh instans. ReplaceSystemDisk: Memperbarui cloud disk sistem pada instans yang ada dengan menentukan DesiredConfiguration.image untuk menggantikan cloud disk sistem instans. Nilai default: Rolling.	Rolling

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
InstanceRefreshTaskId	string	ID tugas refresh instans.	ir-a12ds234fasd*****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "InstanceRefreshTaskId": "ir-a12ds234fasd*****"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.