All Products
Search

This Product

    Auto Scaling:ModifyAlarm

    Document Center

    Auto Scaling:ModifyAlarm

    Last Updated:Sep 17, 2026

    Mengubah tugas yang dipicu event.

    Deskripsi operasi

    Deskripsi operasi

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

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

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

      • Untuk informasi selengkapnya tentang data deret waktu yang didukung oleh tugas yang dipicu event untuk 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 tugas yang dipicu event.

    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 bervariasi berdasarkan 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 (Kbit/menit).

      • IntranetRx: (ECS) lalu lintas masuk melalui jaringan internal (Kbit/menit).

      • VpcInternetTx: (ECS) lalu lintas keluar melalui Internet (Kbit/menit).

      • VpcInternetRx: (ECS) lalu lintas masuk melalui Internet (Kbit/menit).

      • SystemDiskReadBps: (ECS) BPS baca cloud disk sistem (byte/detik).

      • SystemDiskWriteBps: (ECS) BPS tulis cloud disk sistem (byte/detik).

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

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

      • 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) (jumlah/detik).

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

      • PackagesNetOut: (Agen) Jumlah paket yang dikirim oleh antarmuka jaringan publik (NIC) (jumlah/detik).

      • PackagesNetIn: (Agen) Jumlah paket yang diterima oleh antarmuka jaringan publik (NIC) (jumlah/detik).

      • EciPodCpuUtilization: Pemanfaatan CPU (%).

      • EciPodMemoryUtilization: Pemanfaatan memori (%).

      • LoadBalancerRealServerAverageQps: (ALB) QPS rata-rata per server di kelompok server (jumlah/detik).

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

    MemoryUtilization
    MetricType

    string

    No

    Tipe pemantauan. 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

    Hanya grup penskalaan tipe ECS yang mendukung periode statistik 15 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. Saat ekspresi ambang batas terpenuhi sebanyak jumlah yang ditentukan, aturan penskalaan akan dipicu.

    80
    ComparisonOperator

    string

    No

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

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

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

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

    • Nilai data deret waktu 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 saat MetricType diatur ke custom.

    4055401
    Effective

    string

    No

    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.

    Catatan

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

    Contoh dan deskripsi:

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

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

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

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

    array

    No

    Pengenal unik aturan penskalaan yang terkait dengan tugas yang dipicu event.

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

    string

    No

    Pengenal unik aturan penskalaan yang terkait dengan tugas yang dipicu event.

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

    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 dimensi yang terkait dengan data deret waktu. Nilai valid bervariasi berdasarkan tipe pemantauan tugas yang dipicu event:

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

    • 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 node data deret waktu pemantauan QPS ALB.

    device
    DimensionValue

    string

    No

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

    • Jika Dimension.N.DimensionKey adalah nilai kustom, yang berarti tugas yang dipicu event bertipe pemantauan kustom (MetricType=custom), nilai valid tidak dibatasi dan dapat Anda tentukan.

    • Jika Dimension.N.DimensionKey adalah 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 yang terhubung ke VPC klasik, eth0 mewakili antarmuka jaringan internal. Untuk instans VPC, hanya antarmuka jaringan eth0 yang ada.

        • eth1: untuk instans yang terhubung ke VPC klasik, eth1 mewakili antarmuka jaringan publik.

      • state:

        • TCP_TOTAL: jumlah total Koneksi TCP.

        • ESTABLISHED: jumlah Koneksi TCP yang terbentuk.

    eth0
    Expression

    array<object>

    No

    Informasi tentang aturan alert multi-data deret waktu.

    object

    No

    Informasi tentang aturan alert multi-data deret waktu.

    MetricName

    string

    No

    Nama data deret waktu pemantauan untuk aturan alert multi-data deret waktu. Nilai valid bervariasi berdasarkan tipe pemantauan node 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 (Kbit/menit).

      • IntranetRx: (ECS) lalu lintas masuk melalui jaringan internal (Kbit/menit).

      • VpcInternetTx: (ECS) lalu lintas keluar melalui Internet (Kbit/menit).

      • VpcInternetRx: (ECS) lalu lintas masuk melalui Internet (Kbit/menit).

      • SystemDiskReadBps: (ECS) BPS baca cloud disk sistem (byte/detik).

      • SystemDiskWriteBps: (ECS) BPS tulis cloud disk sistem (byte/detik).

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

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

      • 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) (jumlah/detik).

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

      • PackagesNetOut: (Agen) Jumlah paket yang dikirim oleh antarmuka jaringan publik (NIC) (jumlah/detik).

      • PackagesNetIn: (Agen) Jumlah paket yang diterima oleh antarmuka jaringan publik (NIC) (jumlah/detik).

      • EciPodCpuUtilization: Pemanfaatan CPU (%).

      • EciPodMemoryUtilization: Pemanfaatan memori (%).

      • LoadBalancerRealServerAverageQps: (ALB) QPS rata-rata per server di kelompok server (jumlah/detik).

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

    CpuUtilization
    ComparisonOperator

    string

    No

    Operator perbandingan antara nilai data deret waktu dan ambang batas untuk aturan alert multi-data deret waktu. Parameter ini menentukan kondisi di mana nilai data deret waktu memenuhi ambang batas. Nilai valid:

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

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

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

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

    Nilai default: >=.

    >=
    Period

    integer

    No

    Periode statistik untuk data deret waktu dalam aturan alert multi-data deret waktu, dalam detik. Nilai valid:

    Catatan

    Hanya grup penskalaan tipe ECS yang mendukung periode statistik 15 detik.

    Nilai default: 300.

    300
    Statistics

    string

    No

    Metode yang digunakan untuk mengagregasi data deret waktu dalam aturan alert 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 alert multi-data deret waktu. Saat ekspresi ambang batas terpenuhi sebanyak jumlah yang ditentukan, aturan penskalaan akan dipicu.

    40.0
    ExpressionsLogicOperator

    string

    No

    Operator logika antara kondisi alert multi-data deret waktu. Nilai valid:

    • &&: Alert dipicu hanya saat semua data deret waktu pemantauan memenuhi kondisi alert. Alert dipicu hanya saat semua ekspresi dalam aturan alert multi-data deret waktu dievaluasi menjadi true.

    • ||: Alert dipicu saat data deret waktu pemantauan mana pun memenuhi kondisi alert.

    Nilai default: &&.

    &&

    Elemen respons

    Element

    Type

    Description

    Example

    object

    AlarmTaskId

    string

    ID tugas yang dipicu event.

    asg-bp1hvbnmkl10vll5****
    RequestId

    string

    ID permintaan.

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

    Contoh

    Respons sukses

    JSONformat

    {
  "AlarmTaskId": "asg-bp1hvbnmkl10vll5****",
  "RequestId": "BACACF83-7070-4953-A8FD-D81F89F1****"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.