All Products
Search

This Product

    Auto Scaling:ModifyAlarm

    Document Center

    Auto Scaling:ModifyAlarm

    Last Updated:Jun 12, 2026

    Mengubah tugas yang dipicu event.

    Deskripsi operasi

    • Jika Anda membuat tugas yang dipicu event dengan tipe Pemantauan kustom (MetricType=custom), Anda harus terlebih dahulu melaporkan data deret waktu Pemantauan kustom ke CloudMonitor. Untuk informasi selengkapnya, lihat Tugas yang dipicu event untuk Pemantauan kustom.

    • Saat Anda membuat tugas yang dipicu event, Anda harus menentukan data deret waktu (MetricName) dan mengonfigurasi informasi dimensi (Dimension.N.DimensionKey dan Dimension.N.DimensionValue) untuk menentukan cakupan (dalam OAuth) agregasi data deret waktu di grup penskalaan. Misalnya, Anda dapat menentukan user_id dan scaling_group untuk mengagregasi data deret waktu dari semua instans ECS atau instans Kontainer elastis yang berada di pengguna dan grup penskalaan yang ditentukan.

      • Data deret waktu dari tugas yang dipicu event Pemantauan kustom (MetricType=custom) bergantung pada data deret waktu Pemantauan kustom Anda.

      • Untuk informasi selengkapnya tentang data deret waktu yang didukung oleh tugas yang dipicu event Pemantauan sistem (MetricType=system), lihat Tugas yang dipicu event untuk Pemantauan sistem.

    Catatan

    Dalam informasi dimensi, user_id dan scaling_group diisi secara otomatis oleh sistem. Anda harus menentukan Perangkat dan state secara manual. Untuk informasi selengkapnya, lihat parameter Dimension.N.DimensionKey dan Dimension.N.DimensionValue.

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

    update

    *ScalingGroup

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

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    ID wilayah tempat tugas yang dipicu event berada.

    cn-qingdao
    AlarmTaskId

    string

    Yes

    ID tugas yang dipicu event.

    asg-bp1hvbnmkl10vll5****_f95ce797-dc2e-4bad-9618-14fee7d1****
    Name

    string

    No

    Nama tugas yang dipicu event.

    alarmtask****
    Description

    string

    No

    Deskripsi tugas yang dipicu event.

    Test alarm task.
    MetricName

    string

    No

    Nama data deret waktu. Nilai valid bergantung pada tipe Pemantauan tugas yang dipicu event:

    • Jika tugas yang dipicu event bertipe Pemantauan kustom (MetricType=custom), nilai valid adalah data deret waktu kustom Anda.

    • Jika tugas yang dipicu event bertipe Pemantauan sistem (MetricType=system), nilai valid:

      • CpuUtilization: (ECS) pemanfaatan CPU (%).

      • IntranetTx: (ECS) lalu lintas keluar melalui jaringan internal (KByte/min).

      • IntranetRx: (ECS) lalu lintas masuk melalui jaringan internal (KByte/min).

      • VpcInternetTx: (ECS) lalu lintas keluar melalui Internet (KByte/min).

      • VpcInternetRx: (ECS) lalu lintas masuk melalui Internet (KByte/min).

      • SystemDiskReadBps: (ECS) BPS baca cloud disk sistem (Byte/s).

      • SystemDiskWriteBps: (ECS) BPS tulis cloud disk sistem (Byte/s).

      • SystemDiskReadOps: (ECS) IOPS baca cloud disk sistem (jumlah/s).

      • SystemDiskWriteOps: (ECS) IOPS tulis cloud disk sistem (jumlah/s).

      • CpuUtilizationAgent: (Agen) pemanfaatan CPU (%).

      • GpuMemoryFreeUtilizationAgent: (Agen) laju idle Memori GPU (%).

      • GpuMemoryUtilizationAgent: (Agen) pemanfaatan Memori GPU (%).

      • MemoryUtilization: (Agen) pemanfaatan memori (%).

      • LoadAverage: (Agen) beban sistem rata-rata.

      • TcpConnection: (Agen) jumlah total Koneksi TCP.

      • TcpConnection: (Agen) jumlah Koneksi TCP yang terbentuk.

      • PackagesNetOut: (Agen) jumlah paket yang dikirim oleh antarmuka jaringan.

      • PackagesNetIn: (Agen) jumlah paket yang diterima oleh antarmuka jaringan.

      • EciPodCpuUtilization: pemanfaatan CPU (%).

      • EciPodMemoryUtilization: pemanfaatan memori (%).

    Untuk informasi selengkapnya, lihat Tugas yang dipicu event untuk Pemantauan sistem.

    MemoryUtilization
    MetricType

    string

    No

    Tipe data deret waktu. Nilai valid:

    • system: menggunakan data deret waktu sistem CloudMonitor.

    • custom: menggunakan data deret waktu kustom yang dilaporkan ke CloudMonitor.

    system
    Period

    integer

    No

    Periode statistik untuk data deret waktu, dalam detik. Nilai valid:

    Catatan

    Periode statistik 15 detik hanya berlaku untuk data deret waktu yang dikumpulkan oleh Agen CloudMonitor (data deret waktu yang namanya diawali dengan Agent) saat Pemantauan grup penskalaan tipe ECS. Untuk semua data deret waktu lainnya, periode statistik dapat diatur ke 60, 120, 300, atau 900 detik.

    300
    Statistics

    string

    No

    Metode yang digunakan untuk mengagregasi data deret waktu. Nilai valid:

    • Average: nilai rata-rata.

    • Minimum: nilai minimum.

    • Maximum: nilai maksimum.

    Average
    Threshold

    number

    No

    Ambang batas data deret waktu pemantauan dalam aturan alarm multi-data deret waktu. Aturan penskalaan akan dipicu untuk dieksekusi ketika ekspresi ambang batas terpenuhi sebanyak jumlah yang ditentukan.

    80
    ComparisonOperator

    string

    No

    Operator perbandingan antara nilai data deret waktu yang teragregasi dan ambang batas. Parameter ini menentukan kondisi di mana nilai data deret waktu yang teragregasi memenuhi ambang batas. Nilai valid:

    • Nilai data deret waktu yang teragregasi lebih besar dari atau sama dengan ambang batas. Nilai: >=.

    • Nilai data deret waktu yang teragregasi lebih kecil dari atau sama dengan ambang batas. Nilai: <=.

    • Nilai data deret waktu yang teragregasi lebih besar dari ambang batas. Nilai: >.

    • Nilai data deret waktu yang teragregasi lebih kecil dari ambang batas. Nilai: <.

    >=
    EvaluationCount

    integer

    No

    Jumlah kali berturut-turut ekspresi ambang batas harus terpenuhi sebelum aturan penskalaan dipicu. Misalnya, pemanfaatan CPU rata-rata harus lebih besar dari atau sama dengan 80% selama tiga periode statistik berturut-turut.

    3
    GroupId

    integer

    No

    ID kelompok aplikasi CloudMonitor tempat data deret waktu kustom berada. Parameter ini hanya diperlukan ketika MetricType diatur ke custom.

    4055401
    Effective

    string

    No

    Menentukan periode efektif tugas yang dipicu event.

    Parameter ini mengikuti Ekspresi cron. format default adalah X X X X X ?, di mana:

    • X: placeholder untuk bidang, yang mewakili detik, menit, jam, hari dalam bulan, dan bulan, secara berurutan. X dapat berupa nilai spesifik atau karakter khusus dengan makna logis. Untuk informasi selengkapnya tentang nilai valid X, lihat Ekspresi cron.

    • ?: menentukan tidak ada nilai tertentu.

    Catatan

    Nilai parameter ini berada di zona UTC+8 secara default. Anda dapat menambahkan informasi zona pengatur waktu TZ=+yy sebelum Ekspresi cron untuk menentukan zona pengatur waktu, di mana y mewakili nilai zona pengatur waktu. Misalnya, TZ=+00 * * 1-2 * * ? menentukan bahwa tugas yang dipicu event berlaku antara pukul 01:00 dan 02:59 setiap hari di zona pengatur waktu UTC+0.

    Contoh:

    • * * * * * ? : berlaku setiap saat.

    • * * 17-18 * * ? : berlaku antara pukul 17:00 dan 18:59 setiap hari di zona pengatur waktu UTC+8.

    • TZ=+00 * * 1-2 * * ?: berlaku antara pukul 01:00 dan 02:59 setiap hari di zona pengatur waktu UTC+0.

    TZ=+00 * * 1-2 * * ?
    AlarmActions

    array

    No

    Daftar pengenal unik aturan penskalaan yang terkait dengan tugas yang dipicu event.

    string

    No

    Daftar pengenal unik aturan penskalaan yang terkait dengan tugas yang dipicu event.

    ari:acs:ess:cn-hangzhou:140692647****:scalingrule/asr-bp163l21e07uhn****
    Dimensions

    array<object>

    No

    Informasi dimensi yang terkait dengan data deret waktu.

    object

    No

    Informasi dimensi yang terkait dengan data deret waktu.

    DimensionKey

    string

    No

    Kunci informasi dimensi yang terkait dengan data deret waktu. Nilai valid bergantung pada tipe Pemantauan tugas yang dipicu event:

    • Jika tugas yang dipicu event bertipe Pemantauan kustom (MetricType=custom), nilai valid tidak dibatasi. Anda dapat menentukan nilai kustom.

    • Jika tugas yang dipicu event bertipe Pemantauan sistem (MetricType=system), nilai valid:

      • user_id: ID akun Anda.

      • scaling_group: grup penskalaan yang dipantau.

      • device: tipe Perangkat antarmuka jaringan (NIC).

      • state: status koneksi TCP.

      • rulePool: kelompok server yang ditentukan untuk data deret waktu Pemantauan QPS ALB.

    device
    DimensionValue

    string

    No

    Nilai informasi dimensi yang terkait dengan data deret waktu. Nilai valid ditentukan oleh Dimension.N.DimensionKey:

    • Jika Dimension.N.DimensionKey diatur ke nilai kustom, yang berarti tugas yang dipicu event bertipe Pemantauan kustom (MetricType=custom), nilai valid tidak dibatasi. Anda dapat menentukan nilai kustom.

    • Jika Dimension.N.DimensionKey diatur ke nilai yang ditentukan sistem, yang berarti tugas yang dipicu event bertipe Pemantauan sistem (MetricType=system), nilai valid:

      • user_id: diisi secara otomatis oleh sistem.

      • scaling_group: diisi secara otomatis oleh sistem.

      • device:

        • eth0: untuk instans jaringan klasik, eth0 mewakili antarmuka jaringan internal. Untuk instans yang terhubung ke VPC, hanya antarmuka jaringan eth0 yang ada.

        • eth1: untuk instans jaringan klasik, eth1 mewakili antarmuka jaringan publik.

      • state:

        • TCP_TOTAL: jumlah total koneksi TCP.

        • ESTABLISHED: jumlah koneksi TCP yang terbentuk.

    eth0
    Expressions

    array<object>

    No

    Data deret waktu pemantauan dari tugas yang dipicu event multi-data deret waktu.

    object

    No

    Data deret waktu pemantauan dari tugas yang dipicu event multi-data deret waktu.

    MetricName

    string

    No

    Nama data deret waktu Pemantauan dalam tugas yang dipicu event multi-data deret waktu. Nilai valid bergantung pada tipe Pemantauan tugas yang dipicu event:

    • Jika tugas yang dipicu event bertipe Pemantauan kustom (MetricType=custom), nilai valid adalah data deret waktu kustom Anda.

    • Jika tugas yang dipicu event bertipe Pemantauan sistem (MetricType=system), nilai valid:

      • CpuUtilization: (ECS) pemanfaatan CPU (%).

      • IntranetTx: (ECS) lalu lintas keluar melalui jaringan internal (KByte/min).

      • IntranetRx: (ECS) lalu lintas masuk melalui jaringan internal (KByte/min).

      • VpcInternetTx: (ECS) lalu lintas keluar melalui Internet (KByte/min).

      • VpcInternetRx: (ECS) lalu lintas masuk melalui Internet (KByte/min).

      • SystemDiskReadBps: (ECS) BPS baca cloud disk sistem (Byte/s).

      • SystemDiskWriteBps: (ECS) BPS tulis cloud disk sistem (Byte/s).

      • SystemDiskReadOps: (ECS) IOPS baca cloud disk sistem (jumlah/s).

      • SystemDiskWriteOps: (ECS) IOPS tulis cloud disk sistem (jumlah/s).

      • CpuUtilizationAgent: (Agen) pemanfaatan CPU (%).

      • GpuUtilizationAgent: (Agen) Pemanfaatan GPU (%).

      • GpuMemoryFreeUtilizationAgent: (Agen) laju idle Memori GPU (%).

      • GpuMemoryUtilizationAgent: (Agen) pemanfaatan Memori GPU (%).

      • MemoryUtilization: (Agen) pemanfaatan memori (%).

      • LoadAverage: (Agen) beban sistem rata-rata.

      • TcpConnection: (Agen) jumlah total Koneksi TCP.

      • TcpConnection: (Agen) jumlah Koneksi TCP yang terbentuk.

      • PackagesNetOut: (Agen) jumlah paket yang dikirim oleh antarmuka jaringan (NIC).

      • PackagesNetIn: (Agen) jumlah paket yang diterima oleh antarmuka jaringan (NIC).

      • EciPodCpuUtilization: pemanfaatan CPU (%).

      • EciPodMemoryUtilization: pemanfaatan memori (%).

    Untuk informasi selengkapnya, lihat Tugas yang dipicu event untuk Pemantauan sistem.

    CpuUtilization
    ComparisonOperator

    string

    No

    Operator perbandingan antara nilai data deret waktu yang teragregasi dan ambang batas. Parameter ini menentukan kondisi di mana nilai data deret waktu yang teragregasi memenuhi ambang batas. Nilai valid:

    • Nilai data deret waktu yang teragregasi lebih besar dari atau sama dengan ambang batas. Nilai: >=.

    • Nilai data deret waktu yang teragregasi lebih kecil dari atau sama dengan ambang batas. Nilai: <=.

    • Nilai data deret waktu yang teragregasi lebih besar dari ambang batas. Nilai: >.

    • Nilai data deret waktu yang teragregasi lebih kecil dari ambang batas. Nilai: <.

    Nilai default: >=.

    >=
    Period

    integer

    No

    Periode statistik untuk data deret waktu dalam tugas yang dipicu event multi-data deret waktu, dalam detik. Nilai valid:

    Catatan

    Periode statistik 15 detik hanya berlaku untuk data deret waktu yang dikumpulkan oleh Agen CloudMonitor (data deret waktu yang namanya diawali dengan Agent) saat Pemantauan grup penskalaan tipe ECS. Untuk semua data deret waktu lainnya, periode statistik dapat diatur ke 60, 120, 300, atau 900 detik.

    Nilai default: 300.

    300
    Statistics

    string

    No

    Metode yang digunakan untuk mengagregasi data deret waktu dalam tugas yang dipicu event multi-data deret waktu. Nilai valid:

    • Average: nilai rata-rata.

    • Minimum: nilai minimum.

    • Maximum: nilai maksimum.

    Average
    Threshold

    number

    No

    Ambang batas data deret waktu pemantauan dalam aturan alarm multi-data deret waktu. Aturan penskalaan akan dipicu untuk dieksekusi ketika ekspresi ambang batas terpenuhi sebanyak jumlah yang ditentukan.

    40.0
    ExpressionsLogicOperator

    string

    No

    Hubungan antara kondisi alarm multi-data deret waktu. Nilai valid:

    • &&: Alarm hanya dipicu ketika semua data deret waktu pemantauan memenuhi kondisi alarm. Artinya, alarm hanya dipicu ketika semua ekspresi dalam aturan alarm multi-data deret waktu bernilai true.

    • ``: Alarm dapat dipicu jika salah satu data deret waktu memenuhi kondisi alarm.

    Nilai default: &&.

    &&

    Elemen respons

    Element

    Type

    Description

    Example

    object

    AlarmTaskId

    string

    ID tugas yang dipicu event.

    asg-bp1hvbnmkl10vll5****_83948190-acdd-483f-98f7-b77f4778****
    RequestId

    string

    ID permintaan.

    BACACF83-7070-4953-A8FD-D81F89F1****

    Contoh

    Respons sukses

    JSONformat

    {
  "AlarmTaskId": "asg-bp1hvbnmkl10vll5****_83948190-acdd-483f-98f7-b77f4778****",
  "RequestId": "BACACF83-7070-4953-A8FD-D81F89F1****"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.