All Products
Search

This Product

    Auto Scaling:CreateAlarm

    Document Center

    Auto Scaling:CreateAlarm

    Last Updated:Jun 12, 2026

    Memanggil operasi CreateAlarm untuk membuat tugas yang dipicu event untuk workload dengan pola lalu lintas yang melonjak atau tidak terduga. Setelah tugas dikaitkan dengan data deret waktu pemantauan CloudMonitor, tugas ini secara dinamis menyesuaikan jumlah Instans ECS atau instans ECI dalam grup penskalaan dan memantau data deret waktu pemantauan Instans secara real time untuk membantu Anda mengelola dan memelihara resource cloud dengan lebih baik.

    Deskripsi operasi

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

    • Saat membuat tugas yang dipicu event, tentukan data deret waktu (MetricName) beserta informasi dimensi (Dimensions.DimensionKey dan Dimensions.DimensionValue) untuk menentukan cakupan agregasi data data deret waktu pemantauan dalam grup penskalaan. Misalnya, tentukan user_id dan scaling_group untuk mengagregasi data data deret waktu pemantauan dari semua Instans ECS atau instans ECI di bawah pengguna dan grup penskalaan yang ditentukan.

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

      • Untuk informasi selengkapnya tentang data deret waktu pemantauan 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 Dimensions.DimensionKey dan Dimensions.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:CreateAlarm

    create

    *ScalingGroup

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

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    ID wilayah grup penskalaan.

    cn-hangzhou
    Name

    string

    No

    Nama tugas yang dipicu event.

    TestAlarmTask
    Description

    string

    No

    Deskripsi tugas yang dipicu event.

    Test alarm task.
    ScalingGroupId

    string

    Yes

    ID grup penskalaan yang dikaitkan dengan tugas yang dipicu event.

    asg-bp18p2yfxow2dloq****
    MetricName

    string

    No

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

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

    • Jika tugas yang dipicu event menggunakan pemantauan sistem (MetricType=system), nilai valid adalah sebagai berikut:

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

      • ConcurrentConnections: (ECS) jumlah koneksi bersamaan ke Instans ECS.

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

      • SystemDiskWriteOps: (ECS) IOPS tulis cloud disk sistem (operasi/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 NIC internal (jumlah/detik).

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

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

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

      • EciPodCpuUtilization: Pemanfaatan CPU (%).

      • EciPodMemoryUtilization: Pemanfaatan memori (%).

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

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

    CpuUtilization
    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 data deret waktu. Unit: detik. Nilai valid:

    • 15

    • 60

    • 120

    • 300

    • 900

    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 data deret waktu. Nilai valid:

    • Average: nilai rata-rata.

    • Minimum: nilai minimum.

    • Maximum: nilai maksimum.

    Nilai default: Average.

    Average
    Threshold

    number

    No

    Ambang batas data deret waktu pemantauan. Alert dipicu dan aturan penskalaan yang terkait dijalankan ketika ekspresi ambang batas terpenuhi sebanyak jumlah yang ditentukan.

    80.0
    ComparisonOperator

    string

    No

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

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

    • Nilai data deret waktu yang diagregasi kurang dari atau sama dengan ambang batas. Nilai: <=.

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

    • Nilai data deret waktu yang diagregasi kurang dari ambang batas. Nilai: <.

    Nilai default: >=.

    >=
    EvaluationCount

    integer

    No

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

    Nilai default: 3.

    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

    Periode efektif tugas yang dipicu event. Secara default, tugas ini efektif setiap saat.

    Parameter ini mengikuti Ekspresi cron dalam format default 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 yang ditentukan dalam parameter ini default ke zona waktu UTC+8. Anda dapat menambahkan informasi zona waktu TZ=+yy sebelum Ekspresi cron untuk menentukan zona waktu, di mana y mewakili offset zona waktu. Misalnya, TZ=+00 * * 1-2 * * ? menunjukkan bahwa tugas yang dipicu event efektif antara pukul 01:00 dan 02:59 setiap hari di zona waktu UTC+0.

    Contoh:

    • * * * * * ? : efektif setiap saat.

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

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

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

    array

    No

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

    string

    No

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

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

    array<object>

    No

    Informasi dimensi yang dikaitkan dengan data deret waktu.

    object

    No

    Informasi dimensi yang dikaitkan dengan data deret waktu.

    DimensionKey

    string

    No

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

    • Jika tugas yang dipicu event menggunakan pemantauan kustom (MetricType=custom), Anda dapat menentukan nilai apa pun.

    • Jika tugas yang dipicu event menggunakan pemantauan sistem (MetricType=system), nilai valid adalah sebagai berikut:

      • user_id: ID akun Anda.

      • scaling_group: grup penskalaan yang dipantau.

      • device: tipe Perangkat pengontrol 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 dikaitkan dengan data deret waktu. Nilai valid bergantung pada nilai Dimensions.DimensionKey:

    • Jika Dimensions.DimensionKey diatur ke nilai kustom, yang berarti tugas yang dipicu event menggunakan pemantauan kustom (MetricType=custom), Anda dapat menentukan nilai apa pun.

    • Jika Dimensions.DimensionKey diatur ke nilai yang ditentukan sistem, yang berarti tugas yang dipicu event menggunakan pemantauan sistem (MetricType=system), nilai valid adalah sebagai berikut:

      • user_id: diisi secara otomatis oleh sistem.

      • scaling_group: diisi secara otomatis oleh sistem.

      • device:

        • eth0: untuk Instans jaringan klasik, eth0 mewakili NIC internal. Untuk Instans VPC, hanya NIC eth0 yang ada.

        • eth1: untuk Instans jaringan klasik, eth1 mewakili NIC publik.

      • state:

        • TCP_TOTAL: jumlah total koneksi TCP.

        • ESTABLISHED: jumlah koneksi TCP yang terbentuk.

      • rulePool: ID kelompok server ALB, misalnya, sgp-xxxxx.

    eth0
    Expressions

    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 dalam aturan alert multi-data deret waktu. Nilai valid bergantung pada tipe pemantauan tugas yang dipicu event:

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

    • Jika tugas yang dipicu event menggunakan pemantauan sistem (MetricType=system), nilai valid adalah sebagai berikut:

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

      • ConcurrentConnections: (ECS) jumlah koneksi bersamaan ke Instans ECS.

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

      • SystemDiskWriteOps: (ECS) IOPS tulis cloud disk sistem (operasi/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 NIC internal (jumlah/detik).

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

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

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

      • EciPodCpuUtilization: Pemanfaatan CPU (%).

      • EciPodMemoryUtilization: Pemanfaatan memori (%).

      • LoadBalancerRealServerAverageQps: (ALB) QPS rata-rata per server dalam 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 yang diagregasi dan ambang batas dalam aturan alert multi-data deret waktu. Parameter ini menentukan kondisi di mana nilai data deret waktu yang diagregasi memenuhi ambang batas. Nilai valid:

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

    • Nilai data deret waktu yang diagregasi kurang dari atau sama dengan ambang batas. Nilai: <=.

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

    • Nilai data deret waktu yang diagregasi kurang dari ambang batas. Nilai: <.

    Nilai default: >=.

    >=
    Period

    integer

    No

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

    • 15

    • 60

    • 120

    • 300

    • 900

    Catatan

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

    Nilai default: 300.

    900
    Statistics

    string

    No

    Metode yang digunakan untuk mengagregasi data data deret waktu dalam aturan alert multi-data deret waktu. Nilai valid:

    • Average: nilai rata-rata.

    • Minimum: nilai minimum.

    • Maximum: nilai maksimum.

    Nilai default: Average.

    Average
    Threshold

    number

    No

    Ambang batas data deret waktu pemantauan dalam aturan alert multi-data deret waktu. Alert dipicu dan aturan penskalaan yang terkait dijalankan ketika ekspresi ambang batas terpenuhi sebanyak jumlah yang ditentukan.

    40.0
    ExpressionsLogicOperator

    string

    No

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

    • &&: alert dipicu hanya ketika semua data deret waktu pemantauan memenuhi kondisi alert. Dengan kata lain, alert dipicu hanya ketika semua ekspresi dalam aturan alert multi-data deret waktu dievaluasi menjadi true.

    • ||: alert dipicu ketika salah satu data deret waktu pemantauan memenuhi kondisi alert.

    Nilai default: &&.

    &&

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Parameter tanggapan untuk membuat tugas yang dipicu event.

    AlarmTaskId

    string

    ID tugas yang dipicu event.

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

    string

    ID permintaan.

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

    Contoh

    Respons sukses

    JSONformat

    {
  "AlarmTaskId": "asg-bp1hvbnmkl10vll5****_f95ce797-dc2e-4bad-9618-14fee7d1****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.