StartInstanceRefresh - Auto Scaling - Alibaba Cloud Documentation Center

Menyegarkan instans dalam grup penskalaan ketika Anda perlu menerapkan konfigurasi penskalaan baru atau memperbarui image instans dalam grup penskalaan.

Deskripsi operasi

Hanya satu node penyegaran instans yang dapat berjalan dalam sebuah grup penskalaan pada satu waktu.
Fitur ini hanya mendukung grup penskalaan ECS yang kebijakan scale-out-nya diatur ke Kebijakan Prioritas. Grup penskalaan yang menggunakan Perhitungan Kapasitas Berbasis vCPU dan grup penskalaan yang pola pencabutan instansnya diatur ke Pola Shutdown dan Revoke atau Pola Forced Shutdown dan Revoke tidak mendukung fitur ini.
Selama penyegaran instans, operasi scale-out dan scale-in normal dapat dilakukan. Namun, operasi scale-out menggunakan konfigurasi yang diinginkan dari penyegaran instans.
Instans yang ditambahkan secara manual ke grup penskalaan, instans dalam keadaan siaga, dan instans dengan status perlindungan diabaikan oleh node penyegaran instans dan tidak berpartisipasi dalam penyegaran 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
ScalingGroupId	string	Yes	ID grup penskalaan.	asg-bp18p2yfxow2dloq****
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 berbagai permintaan. Token hanya dapat berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter. Untuk informasi lebih lanjut, lihat Cara memastikan idempotensi.	123e4567-e89b-12d3-a456-42665544****
RegionId	string	Yes	ID wilayah grup penskalaan.	cn-hangzhou
MinHealthyPercentage	integer	No	Persentase minimum instans yang harus tetap aktif dalam layanan di grup penskalaan selama penyegaran instans. Nilai valid: 0 hingga 100. Nilai default: 80.	80
MaxHealthyPercentage	integer	No	Persentase maksimum jumlah instans dalam grup penskalaan yang dapat melebihi kapasitas grup penskalaan selama penyegaran instans. Nilai valid: 100 hingga 200. Nilai default: 120. Catatan Ketika MinHealthyPercentage = MaxHealthyPercentage = 100, satu instans disegarkan pada satu waktu.	100
DesiredConfiguration	object	No	Konfigurasi yang diinginkan untuk penyegaran instans. Catatan Anda tidak dapat menentukan ScalingConfigurationId, ImageId, LaunchTemplateId, dan Containers secara bersamaan. Jika parameter ini dibiarkan kosong, konfigurasi yang saat ini aktif dari grup penskalaan akan digunakan untuk penyegaran. Setelah tugas penyegaran instans selesai, konfigurasi penskalaan aktif dari grup penskalaan diperbarui ke konfigurasi ini.
ImageId	string	No	ID image. Catatan Setelah tugas penyegaran instans selesai, image dalam konfigurasi yang saat ini aktif dari grup penskalaan diperbarui ke image ini. Parameter ini tidak didukung ketika sumber konfigurasi instans dari grup penskalaan adalah template peluncuran. Image yang berisi cloud disk data tidak didukung.	m-2ze8cqacj7opnf***
ScalingConfigurationId	string	No	ID konfigurasi penskalaan.	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 default template. Latest: selalu menggunakan versi terbaru template. Catatan Rollback tidak didukung untuk tugas penyegaran instans ketika versi diatur ke Default atau Latest.	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. Catatan Parameter ini hanya berlaku ketika parameter LaunchTemplateId menentukan template peluncuran.	ecs.c5.2xlarge
Containers	array<object>	No	Daftar kontainer dalam instans. Catatan Parameter ini hanya didukung untuk grup penskalaan Elastic Container Instance (ECI). Hanya konfigurasi kontainer yang namanya cocok dengan `Container.Name` dalam daftar kontainer konfigurasi penskalaan saat ini yang disegarkan.
	array<object>	No	Daftar kontainer 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. Maksimal 20 perintah didukung. Setiap perintah dapat berisi hingga 256 karakter.
	string	No	Perintah startup kontainer. Maksimal 20 perintah didukung. Setiap perintah dapat berisi hingga 256 karakter.	sleep
Args	array	No	Argumen untuk perintah startup kontainer. Maksimal 10 argumen didukung.
	string	No	Argumen untuk perintah startup kontainer. Maksimal 10 argumen didukung.	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 (_). Nama tidak boleh diawali 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 untuk digunakan.	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 individual. Nilai valid: true: Instans yang sudah dibuat dengan konfigurasi yang diinginkan dilewati. false: Semua instans dalam grup penskalaan pada saat tugas penyegaran dimulai disegarkan. Nilai default: true.	true
Checkpoints	array<object>	No	Checkpoint untuk tugas penyegaran. Menentukan bahwa tugas secara otomatis dijeda selama CheckpointPauseTime menit ketika persentase instans baru mencapai nilai yang ditentukan selama penyegaran instans.
	object	No	Checkpoint untuk tugas penyegaran. Menentukan bahwa tugas secara otomatis dijeda selama `CheckpointPauseTime` menit ketika persentase instans baru mencapai nilai yang ditentukan selama penyegaran instans.
Percentage	integer	No	Persentase instans baru terhadap total instans dalam grup penskalaan saat tugas secara otomatis dijeda. Nilai valid: 1 hingga 100 (%). Catatan Nilai harus ditentukan dalam urutan menaik, dan nilai persentase terakhir harus 100.	20
CheckpointPauseTime	integer	No	Durasi jeda tugas ketika checkpoint tercapai. Unit: menit. Nilai valid: 1 hingga 2880. Nilai default: 60.	10
Strategy	string	No	Strategi eksekusi untuk tugas penyegaran instans. Nilai valid: Rolling: Tugas penyegaran instans membuat instans baru dan melepaskan instans lama untuk menyegarkan instans. ReplaceSystemDisk: Cloud disk sistem dari instans yang ada diganti dengan menentukan DesiredConfiguration.image untuk memperbarui cloud disk sistem. Nilai default: Rolling.	Rolling

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
InstanceRefreshTaskId	string	ID tugas penyegaran 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.