All Products
Search
Document Center

Auto Scaling:ModifyLifecycleHook

Last Updated:May 25, 2026

Memodifikasi kait siklus hidup. Jika kait siklus hidup yang ada tidak lagi memenuhi kebutuhan bisnis Anda, Anda dapat memanggil operasi ModifyLifecycleHook untuk mengubah informasi seperti event penskalaan, periode timeout, dan aksi default kait tersebut. Sebelum memodifikasi kait siklus hidup, Anda dapat menemukannya berdasarkan ID, nama, atau grup penskalaan.

Catatan penggunaan

Anda dapat menggunakan salah satu metode berikut untuk menentukan kait siklus hidup yang ingin dimodifikasi:

  • Tentukan ID kait siklus hidup dengan parameter LifecycleHookId. Saat menggunakan metode ini, parameter ScalingGroupId dan LifecycleHookName akan diabaikan.

  • Tentukan ScalingGroupId dan LifecycleHookName. Nama setiap kait siklus hidup bersifat unik dalam satu grup penskalaan.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kemudahan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi ini untuk berbagai SDK.

Parameter permintaan

Parameter

Tipe

Wajib

Contoh

Deskripsi

Action

String

Ya

ModifyLifecycleHook

Operasi yang ingin Anda lakukan. Tetapkan nilainya ke ModifyLifecycleHook.

LifecycleHookId

String

Tidak

ash-bp1fxuqyi98w0aib****

ID kait siklus hidup yang ingin Anda modifikasi.

ScalingGroupId

String

Tidak

asg-bp18p2yfxow2dloq****

ID grup penskalaan tempat kait siklus hidup tersebut berada.

LifecycleHookName

String

Tidak

test_SCAL****

Nama kait siklus hidup yang ingin Anda modifikasi.

DefaultResult

String

Tidak

CONTINUE

Aksi yang dilakukan Auto Scaling setelah kait siklus hidup mengalami timeout. Nilai yang valid:

  • CONTINUE: Auto Scaling melanjutkan respons terhadap permintaan penskalaan.

  • ABANDON: Auto Scaling melepaskan Instance Elastic Compute Service (ECS) selama event scale-out, atau menghapus instance ECS dari grup penskalaan selama event scale-in.

  • ROLLBACK: Selama event scale-in, Auto Scaling menolak permintaan untuk melepaskan instance ECS dan memutar balik perubahan. Selama event scale-out, pengaturan ROLLBACK berperilaku identik dengan pengaturan ABANDON.

Jika sebuah grup penskalaan memiliki beberapa kait siklus hidup yang aktif dan Anda menetapkan DefaultResult salah satu kait siklus hidup ke ABANDON atau ROLLBACK, aturan berikut berlaku untuk event scale-in: Ketika kait siklus hidup yang memiliki DefaultResult bernilai ABANDON atau ROLLBACK mengalami timeout, kait siklus hidup lainnya juga mengalami timeout lebih awal. Dalam kasus lain, Auto Scaling hanya melakukan aksi setelah semua kait siklus hidup mengalami timeout. Aksi yang dilakukan Auto Scaling ditentukan oleh nilai DefaultResult yang Anda tetapkan pada kait siklus hidup yang paling akhir mengalami timeout.

HeartbeatTimeout

Integer

Tidak

600

Periode waktu sebelum kait siklus hidup mengalami timeout. Setelah kait siklus hidup mengalami timeout, Auto Scaling melakukan aksi default. Nilai yang valid: 30 hingga 21600. Satuan: detik.

Anda dapat memanggil operasi RecordLifecycleActionHeartbeat untuk memperpanjang periode timeout kait siklus hidup. Anda juga dapat memanggil operasi CompleteLifecycleAction untuk mengakhiri periode timeout kait siklus hidup lebih awal.

LifecycleTransition

String

Tidak

SCALE_IN

Jenis event penskalaan tempat Anda menerapkan kait siklus hidup. Nilai yang valid:

  • SCALE_OUT: event scale-out.

  • SCALE_IN: event scale-in.

NotificationMetadata

String

Tidak

Tes

String tetap yang ingin Anda sertakan dalam Notifikasi. Ketika kait siklus hidup berlaku, Auto Scaling mengirimkan Notifikasi. Nilai parameter ini tidak boleh melebihi panjang 4.096 karakter.

Auto Scaling mengirimkan nilai NotificationMetadata bersama dengan Notifikasi. Hal ini membantu Anda mengkategorikan Notifikasi Anda. Jika Anda menentukan NotificationMetadata, Anda harus menentukan NotificationArn.

NotificationArn

String

Tidak

acs:mns:cn-beijing:161456884340****:queue/modifyLifecycleHo****

Nama Sumber Daya Alibaba Cloud (ARN) dari penerima Notifikasi. Daftar berikut menjelaskan format nilai parameter ini:

  • Jika Anda menentukan antrian Simple Message Queue (SMQ, sebelumnya MNS) sebagai penerima Notifikasi, tentukan nilainya dalam format acs:mns:{region-id}:{account-id}:queue/{queuename}.

  • Jika Anda menentukan topik SMQ sebagai penerima Notifikasi, tentukan nilainya dalam format acs:mns:{region-id}:{account-id}:topic/{topicname}.

  • Jika Anda menggunakan templat CloudOps Orchestration Service (OOS), tentukan nilainya dalam format acs:oos:{region-id}:{account-id}:template/{templatename}.

  • Jika Anda menentukan event bus yang disediakan oleh EventBridge sebagai penerima Notifikasi, tentukan nilainya dalam format acs:eventbridge:{region-id}:{account-id}:eventbus/default.

Variabel dalam format nilai di atas memiliki makna sebagai berikut:

  • region-id: ID wilayah grup penskalaan.

  • account-id: ID Akun Alibaba Cloud.

  • queuename: nama antrian SMQ.

  • topicname: nama topik SMQ.

  • templatename: nama templat OOS.

RegionId

String

Tidak

cn-beijing

ID wilayah grup penskalaan.

LifecycleHookStatus

String

Tidak

Active

Status yang ingin Anda tetapkan untuk kait siklus hidup. Nilai yang valid:

  • Active: mengaktifkan kait siklus hidup.

  • InActive: menonaktifkan kait siklus hidup.

Jika Anda tidak menentukan parameter ini, status kait siklus hidup tetap tidak berubah setelah Anda memanggil operasi ini.

Catatan

Secara default, kait siklus hidup baru secara otomatis berada dalam status Active.

Parameter respons

Parameter

Tipe

Contoh

Deskripsi

RequestId

String

473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

ID permintaan.

Contoh

Contoh permintaan

http(s)://ess.aliyuncs.com/?Action=ModifyLifecycleHook
&LifecycleHookId=ash-bp1fxuqyi98w0aib****
&ScalingGroupId=asg-bp18p2yfxow2dloq****
&LifecycleHookName=test_SCALE_IN
&DefaultResult=CONTINUE
&HeartbeatTimeout=600
&LifecycleTransition=SCALE_IN
&NotificationMetadata=Test
&NotificationArn=acs:mns:cn-beijing:161456884340****:queue/modifyLifecycleHo****
&RegionId=cn-beijing
&LifecycleHookStatus=Active
&<Common request parameters>

Contoh respons sukses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyLifecycleHookResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</ModifyLifecycleHookResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

Kode kesalahan

Daftar kode kesalahan lengkap tersedia di Kode kesalahan layanan.

Kode status HTTP

Kode kesalahan

Deskripsi

Deskripsi

400

InvalidParamter

The specified value of parameter is not valid.

Nilai parameter tidak valid.

400

InvalidLifecycleHookId.NotExist

The specified lifecycleHookId not exist.

Nilai LifecycleHookId tidak valid.

400

InvalidLifecycleHookName.NotExist

The specified lifecycleHookName you provided not exist.

Nilai LifecycleHookName tidak valid.

400

InvalidNotificationArn

The specified parameter NotificationArn is invalid.

Nilai NotificationArn tidak valid.

400

UnsupportedNotificationType.CurrentRegion

The NotificationType is not supported in the special region which scalingGroup belongs to.

Penerima notifikasi tidak didukung di wilayah saat ini.

400

LifecycleHook

The specified queue does not exist.

Antrian SMQ yang ditentukan tidak ada.

400

TopicNotExist

The specified topic does not exist.

Topik SMQ yang ditentukan tidak ada.