CreateLifecycleHook - Auto Scaling - Alibaba Cloud Documentation Center

Deskripsi operasi

Sebuah grup penskalaan dapat memiliki maksimal 6 kait siklus hidup. Ketika aktivitas penskalaan terjadi pada grup penskalaan yang memiliki kait siklus hidup, kait siklus hidup akan menjeda aktivitas penskalaan selama satu epoch. Anda dapat menentukan epoch tunggu menggunakan parameter HeartbeatTimeout. Selama epoch tunggu, Anda dapat melakukan operasi seperti inisialisasi konfigurasi Instance ECS dan mengambil data Instance ECS.
Selama aktivitas scale-out, Instans ECS memasuki status tunggu setelah ditambahkan ke daftar putih Instance RDS, dan ditambahkan ke grup server backend Instance SLB setelah status tunggu berakhir. Selama aktivitas scale-down, Instans ECS memasuki status tunggu setelah dihapus dari grup server backend Instance SLB, dan dihapus dari daftar putih Instance RDS setelah status tunggu berakhir.
Anda dapat mengonfigurasi metode Notifikasi untuk kait siklus hidup. Metode Notifikasi yang didukung mencakup Topik MNS, Antrian MNS, dan Templat OOS. Jika Anda mengonfigurasi Templat OOS, buat Peran RAM untuk layanan OOS. Untuk informasi selengkapnya, lihat Pengaturan izin RAM untuk OOS.

Catatan

Jika grup penskalaan memiliki Instans ECS yang sudah ada dan Templat OOS yang dikonfigurasi digunakan untuk menambahkan atau menghapus Instans dari daftar putih database selain RDS, Anda harus menambahkan Instans ECS yang sudah ada secara manual ke daftar putih database tersebut.

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

create

*ScalingGroup

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

None

Parameter permintaan

Parameter	Type	Required	Description	Example
ScalingGroupId	string	Yes	ID grup penskalaan.	asg-bp1eyv4qn8ssgv43****
LifecycleHookName	string	No	Nama kait siklus hidup. Nama harus unik di dalam grup penskalaan. Panjang nama harus 2 hingga 64 karakter dan dapat berisi huruf, angka, garis bawah (_), tanda hubung (-), dan titik (.). Nama harus diawali dengan huruf, angka, atau karakter Tionghoa. Nilai default: nilai LifecycleHookId.	lifecyclehook****
LifecycleTransition	string	Yes	Jenis aktivitas penskalaan yang berlaku untuk kait siklus hidup. Nilai valid: SCALE_OUT: aktivitas scale-out grup penskalaan. SCALE_IN: aktivitas scale-down grup penskalaan.	SCALE_OUT
DefaultResult	string	No	Aksi yang akan diambil setelah status tunggu berakhir. Nilai valid: CONTINUE: melanjutkan respons terhadap aktivitas scale-out atau scale-down. ABANDON: merilis Instans ECS yang dibuat selama aktivitas scale-out, atau menghapus Instans ECS dari grup penskalaan selama aktivitas scale-down. ROLLBACK: untuk aktivitas scale-down, sistem menolak rilis Instans ECS dan melakukan rollback. Untuk aktivitas scale-out, sistem merilis Instans ECS yang dibuat, yang memiliki efek sama dengan ABANDON. Ketika aktivitas scale-down (SCALE_IN) memicu beberapa kait siklus hidup dalam sebuah grup penskalaan, jika DefaultResult dari satu kait siklus hidup diatur ke ABANDON atau ROLLBACK dan status tunggu kait tersebut berakhir, status tunggu kait siklus hidup lainnya akan berakhir lebih awal. Dalam kasus lain, aksi yang akan diambil ditentukan oleh kait siklus hidup terakhir yang status tunggunya berakhir. Nilai default: CONTINUE.	CONTINUE
HeartbeatTimeout	integer	No	Periode tunggu yang ditetapkan kait siklus hidup untuk aktivitas grup penskalaan. Setelah status tunggu habis waktu, aksi berikutnya akan dilakukan. Nilai valid: 30 hingga 21600. Unit: detik. Setelah kait siklus hidup dibuat, Anda dapat memanggil RecordLifecycleActionHeartbeat untuk memperpanjang periode tunggu Instans ECS, atau memanggil CompleteLifecycleAction untuk mengakhiri status tunggu aktivitas penskalaan lebih awal. Nilai default: 600.	600
NotificationMetadata	string	No	Informasi Notifikasi yang dikirim ke NotificationArn (Penerima Notifikasi) ketika kait siklus hidup menjeda aktivitas penskalaan. Parameter ini membantu Anda mengelola dan menandai informasi Notifikasi dari berbagai kategori. Anda juga harus menentukan NotificationArn. Panjang nilai dapat mencapai 4.096 karakter. Jika NotificationArn diatur ke Templat OOS, termasuk Templat publik atau Templat kustom, NotificationMetadata harus diatur ke string JSON yang sesuai dengan parameter Templat OOS. Sebagai contoh, `{"dbInstanceId": "dds-bp17661e0135**", "modifyMode": "Append"}`, di mana `dbInstanceId` dan `modifyMode` adalah parameter yang didefinisikan dalam Templat OOS. Beberapa parameter Templat OOS memiliki nilai default. NotificationMetadata harus menentukan parameter yang tidak memiliki nilai default. Jika Anda menentukan parameter yang memiliki nilai default, nilai yang ditentukan akan menimpa nilai default asli. Namun, pertahankan nilai default untuk parameter berikut, yang digunakan untuk mengambil informasi relevan selama aktivitas penskalaan: regionId: Wilayah tempat aktivitas penskalaan dilakukan. Nilai default: ${regionId}. instanceIds: daftar Instans yang terkait dengan aktivitas penskalaan. Nilai default: ${instanceIds}. lifecycleHookId: ID kait siklus hidup. Nilai default: ${lifecycleHookId}. lifecycleActionToken: pengidentifikasi status tunggu untuk aktivitas penskalaan, yang digunakan untuk mengakhiri aktivitas yang sedang dijeda saat ini lebih awal. Nilai default: ${lifecycleActionToken}. scalingGroupId: ID grup penskalaan tempat aktivitas penskalaan berada. Nilai default: ${scalingGroupId}. lifecycleActionResult: aksi yang akan diambil setelah status tunggu kait siklus hidup berakhir, yang digunakan untuk mengakhiri aktivitas yang sedang dijeda saat ini lebih awal ketika Templat OOS gagal. Ketika DefaultResult diatur ke ROLLBACK, nilai default adalah ROLLBACK. Dalam kasus lain, nilai default adalah ABANDON. Catatan** Anda dapat mengatur nilai lifecycleActionResult untuk menimpa nilai default saat ini. Nilai valid: ABANDON, CONTINUE, ROLLBACK, dan ${lifecycleActionResult}. ${lifecycleActionResult} menunjukkan bahwa nilai lifecycleActionResult konsisten dengan nilai DefaultResult. Anda dapat memperoleh informasi detail mengenai parameter Templat yang sesuai di Konsol OOS.	Test lifecycle hook.
NotificationArn	string	No	Nama Sumber Daya Alibaba Cloud (ARN) Penerima Notifikasi kait siklus hidup. Jika parameter ini tidak diatur, tidak ada Notifikasi yang dikirim. Metode Notifikasi berikut didukung ketika Anda mengatur parameter ini: Antrian MNS. Nilai dalam format `acs:mns:{region-id}:{account-id}:queue/{queuename}`. Topik MNS. Nilai dalam format `acs:mns:{region-id}:{account-id}:topic/{topicname}`. Templat OOS. Nilai dalam format `acs:oos:{region-id}:{account-id}:template/{templatename}`. EventBridge. Nilai dalam format `acs:eventbridge:{region-id}:{account-id}:eventbus/default`. Variabel dalam format tersebut memiliki arti berikut: region-id: ID wilayah grup penskalaan. account-id: ID akun Alibaba Cloud. ID akun Pengguna RAM tidak didukung. queuename: nama Antrian MNS. topicname: nama Topik MNS. templatename: nama Templat OOS.	acs:mns:cn-beijing:161456884340**:queue/modifyLifecycleHo**

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
LifecycleHookId	string	ID kait siklus hidup.	ash-bp1at9ufhmcf9cmy****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "LifecycleHookId": "ash-bp1at9ufhmcf9cmy****"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.