All Products
Search

This Product

    Auto Scaling:CreateAlarm

    Document Center

    Auto Scaling:CreateAlarm

    Last Updated:Sep 10, 2026

    Membuat 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 kustom ke CloudMonitor terlebih dahulu. Untuk informasi lebih lanjut, lihat Tugas yang dipicu event dengan tipe Pemantauan kustom.

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

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

      • Untuk informasi lebih lanjut mengenai data deret waktu Pemantauan yang didukung oleh tugas yang dipicu event dengan tipe Pemantauan sistem (MetricType=system), lihat Tugas yang dipicu event dengan tipe 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 lebih lanjut, 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:CreateAlarm

    create

    *ScalingGroup

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

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    ID wilayah kelompok 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 kelompok penskalaan yang terkait dengan tugas yang dipicu event.

    asg-bp18p2yfxow2dloq****
    MetricName

    string

    No

    Nama data deret waktu Pemantauan. Nilai valid bervariasi berdasarkan tipe Pemantauan tugas yang dipicu event:

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

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

      • 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 (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 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 lebih lanjut, lihat Tugas yang dipicu event dengan tipe Pemantauan sistem.

    CpuUtilization
    MetricType

    string

    No

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

    • 15

    • 60

    • 120

    • 300

    • 900

    Catatan

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

    Nilai default: 300.

    300
    Statistics

    string

    No

    Metode yang digunakan untuk mengagregasi data deret waktu Pemantauan. 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. Peringatan dipicu dan aturan penskalaan dijalankan ketika ekspresi ambang batas terpenuhi sebanyak jumlah yang ditentukan.

    80.0
    ComparisonOperator

    string

    No

    Operator perbandingan antara nilai agregat data deret waktu Pemantauan dan ambang batas. Parameter ini menentukan hubungan yang memenuhi kondisi. Nilai valid:

    • Nilai agregat lebih besar dari atau sama dengan ambang batas. Nilai: >=.

    • Nilai agregat lebih kecil dari atau sama dengan ambang batas. Nilai: <=.

    • Nilai agregat lebih besar dari ambang batas. Nilai: >.

    • Nilai agregat lebih kecil 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 Pemantauan kustom berada. Parameter ini hanya diperlukan ketika MetricType diatur ke custom.

    4055401
    Effective

    string

    No

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

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

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

    • ?: menentukan tidak ada nilai.

    Catatan

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

    Contoh:

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

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

    • TZ=+00 * * 1-2 * * ?: berlaku antara pukul 01:00 dan 02:59 di pengatur waktu 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:1406926****:scalingrule/asr-bp163l21e07uhn****

    string

    No

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

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

    array<object>

    No

    Daftar dimensi yang terkait dengan data deret waktu Pemantauan.

    object

    No

    Daftar dimensi yang terkait dengan data deret waktu Pemantauan.

    DimensionKey

    string

    No

    Kunci dimensi yang terkait dengan data deret waktu Pemantauan. Nilai valid bervariasi berdasarkan tipe Pemantauan tugas yang dipicu event:

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

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

      • user_id: ID akun Anda.

      • scaling_group: kelompok penskalaan yang akan dipantau.

      • Perangkat: tipe Perangkat pengontrol 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 Pemantauan. Nilai valid ditentukan oleh Dimension.N.DimensionKey:

    • Jika Dimension.N.DimensionKey adalah nilai kustom, yang berarti tugas yang dipicu event menggunakan tipe Pemantauan kustom (MetricType=custom), Anda dapat menentukan nilai apa pun.

    • Jika Dimension.N.DimensionKey adalah nilai yang ditentukan sistem, yang berarti tugas yang dipicu event menggunakan tipe Pemantauan sistem (MetricType=system), nilai valid:

      • user_id: diisi secara otomatis oleh sistem.

      • scaling_group: diisi secara otomatis oleh sistem.

      • Perangkat:

        • eth0: untuk Instans jaringan klasik, eth0 mewakili NIC internal. Untuk Instans yang terhubung ke 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. Contoh: sgp-xxxxx.

    eth0
    Expression

    array<object>

    No

    Informasi mengenai aturan peringatan multi-data deret waktu.

    object

    No

    Informasi mengenai aturan peringatan multi-data deret waktu.

    MetricName

    string

    No

    Nama data deret waktu Pemantauan dalam aturan peringatan multi-data deret waktu. Nilai valid bervariasi berdasarkan tipe Pemantauan tugas yang dipicu event:

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

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

      • 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 (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 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 lebih lanjut, lihat Tugas yang dipicu event dengan tipe Pemantauan sistem.

    CpuUtilization
    ComparisonOperator

    string

    No

    Operator perbandingan antara nilai agregat data deret waktu Pemantauan dan ambang batas dalam aturan peringatan multi-data deret waktu. Parameter ini menentukan hubungan yang memenuhi kondisi. Nilai valid:

    • Nilai agregat lebih besar dari atau sama dengan ambang batas. Nilai: >=.

    • Nilai agregat lebih kecil dari atau sama dengan ambang batas. Nilai: <=.

    • Nilai agregat lebih besar dari ambang batas. Nilai: >.

    • Nilai agregat lebih kecil dari ambang batas. Nilai: <.

    Nilai default: >=.

    >=
    Period

    integer

    No

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

    • 15

    • 60

    • 120

    • 300

    • 900

    Catatan

    Hanya kelompok penskalaan tipe ECS yang mendukung periode statistik 15 detik. Nilai default: 300.

    900
    Statistics

    string

    No

    Metode yang digunakan untuk mengagregasi data deret waktu Pemantauan dalam aturan peringatan 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 peringatan multi-data deret waktu. Peringatan dipicu dan aturan penskalaan dijalankan ketika ekspresi ambang batas terpenuhi sebanyak jumlah yang ditentukan.

    40.0
    ExpressionsLogicOperator

    string

    No

    Hubungan antara beberapa kondisi peringatan data deret waktu. Nilai valid:

    • &&: peringatan dipicu hanya ketika semua data deret waktu Pemantauan memenuhi kondisi peringatan. Peringatan dipicu hanya ketika semua ekspresi dalam aturan peringatan multi-data deret waktu dievaluasi menjadi true.

    • ||: peringatan dipicu ketika salah satu data deret waktu Pemantauan memenuhi kondisi peringatan.

    Nilai default: &&.

    &&

    Elemen respons

    Element

    Type

    Description

    Example

    object

    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.