All Products
Search

This Product

    Cloud Monitor:CreateGroupMetricRules

    Document Center

    Cloud Monitor:CreateGroupMetricRules

    Last Updated:Jun 26, 2026

    Membuat aturan peringatan secara batch untuk kelompok aplikasi tertentu dengan memanggil operasi CreateGroupMetricRules.

    Deskripsi operasi

    Topik ini memberikan contoh cara membuat aturan peringatan untuk metrik pemantauan cpu_total dari Elastic Computing Service (ECS) dalam kelompok aplikasi 123456. ID aturan peringatan adalah 456789, nama aturan peringatan adalah ECS_Rule1, tingkat keparahan peringatan adalah Critical, metode statistik adalah Average, operator perbandingan adalah GreaterThanOrEqualToThreshold, ambang batas adalah 90, dan jumlah percobaan ulang adalah 3. Tanggapan menunjukkan bahwa aturan peringatan ECS_Rule1 telah dibuat.

    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

    cms:CreateGroupMetricRules

    create

    *GroupMetricRule

    acs:cms::{#accountId}:group/{#groupId}

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    GroupId

    integer

    Yes

    ID kelompok aplikasi.

    Untuk informasi tentang cara mendapatkan ID kelompok aplikasi, lihat DescribeMonitorGroups.

    3607****
    GroupMetricRules

    array<object>

    No

    Daftar aturan peringatan berbasis metrik untuk kelompok aplikasi.

    array<object>

    No

    Aturan peringatan berbasis metrik untuk kelompok aplikasi.

    Escalations.Info.Threshold

    string

    No

    Ambang batas untuk peringatan tingkat Info.

    Nilai valid N: 1 hingga 200.

    Catatan

    Tetapkan setidaknya satu tingkat keparahan peringatan Critical, Warn, atau Info. Untuk setiap tingkat keparahan peringatan yang ditentukan, Anda harus menetapkan semua parameter berikut: Statistics, ComparisonOperator, Threshold, dan Times.

    10
    MetricName

    string

    Yes

    Nama metrik.

    Nilai valid N: 1 hingga 200.

    Untuk informasi tentang cara mendapatkan nama metrik, lihat DescribeMetricMetaList atau Pemantauan layanan cloud.

    cpu_total
    Escalations.Warn.Threshold

    string

    No

    Ambang batas untuk peringatan tingkat Warn.

    Nilai valid N: 1 hingga 200.

    Catatan

    Tetapkan setidaknya satu tingkat keparahan peringatan Critical, Warn, atau Info. Untuk setiap tingkat keparahan peringatan yang ditentukan, Anda harus menetapkan semua parameter berikut: Statistics, ComparisonOperator, Threshold, dan Times.

    20
    EffectiveInterval

    string

    No

    Periode efektif aturan peringatan. Nilai valid N: 1 hingga 200.

    05:31-23:59
    NoEffectiveInterval

    string

    No

    Periode pengatur waktu saat aturan peringatan tidak efektif. Nilai valid N: 1 hingga 200.

    00:00-05:30
    RuleId

    string

    Yes

    ID aturan peringatan.

    Nilai valid N: 1 hingga 200.

    456789
    Escalations.Critical.Times

    integer

    No

    Jumlah kali metrik pemantauan harus mencapai ambang batas peringatan sebelum Pemberitahuan peringatan tingkat Critical dikirim.

    Nilai valid N: 1 hingga 200.

    Catatan

    Pengaturan untuk setidaknya satu tingkat keparahan peringatan Critical, Warn (peringatan), atau Info harus ditentukan. Untuk setiap tingkat keparahan peringatan yang ditentukan, Anda harus menetapkan semua parameter berikut: Statistics, ComparisonOperator, Threshold, dan Times.

    3
    Dimensions

    string

    No

    Dimensi pemantauan Sumber daya yang ditentukan.

    Nilainya adalah kumpulan pasangan kunci:nilai, seperti {"userId":"120886317861****"} dan {"instanceId":"i-2ze2d6j5uhg20x47****"}.

    [{"instanceId":"i-m5e1qg6uo38rztr4****"}]
    Escalations.Critical.Threshold

    string

    No

    Ambang batas yang memicu Pemberitahuan peringatan tingkat Critical.

    Nilai valid N: 1 hingga 200.

    Catatan

    Tetapkan setidaknya satu tingkat keparahan peringatan Critical, Warn, atau Info. Untuk setiap tingkat keparahan peringatan yang ditentukan, Anda harus menetapkan semua parameter berikut: Statistics, ComparisonOperator, Threshold, dan Times.

    90
    Escalations.Critical.Statistics

    string

    No

    Metode statistik untuk peringatan tingkat Critical.

    Nilai valid N: 1 hingga 200.

    Nilai valid parameter ini ditentukan oleh kolom Statistics yang sesuai dengan MetricName layanan Alibaba Cloud yang ditentukan, seperti Maximum, Minimum, dan Average. Untuk informasi tentang cara mendapatkan nilai valid, lihat Pemantauan layanan cloud.

    Catatan

    Tetapkan setidaknya satu tingkat keparahan peringatan Critical, Warn, atau Info. Untuk setiap tingkat keparahan peringatan yang ditentukan, Anda harus menetapkan semua parameter berikut: Statistics, ComparisonOperator, Threshold, dan Times.

    Average
    Escalations.Warn.ComparisonOperator

    string

    No

    Operator perbandingan untuk peringatan tingkat Warn. Nilai valid:

    • GreaterThanOrEqualToThreshold: lebih besar dari atau sama dengan ambang batas.

    • GreaterThanThreshold: lebih besar dari ambang batas.

    • LessThanOrEqualToThreshold: lebih kecil dari atau sama dengan ambang batas.

    • LessThanThreshold: lebih kecil dari ambang batas.

    • NotEqualToThreshold: tidak sama dengan ambang batas.

    • GreaterThanYesterday: lebih besar dari nilai pengatur waktu yang sama kemarin.

    • LessThanYesterday: lebih kecil dari nilai pengatur waktu yang sama kemarin.

    • GreaterThanLastWeek: lebih besar dari nilai pengatur waktu yang sama minggu lalu.

    • LessThanLastWeek: lebih kecil dari nilai pengatur waktu yang sama minggu lalu.

    • GreaterThanLastPeriod: lebih besar dari nilai pada periode terakhir.

    • LessThanLastPeriod: lebih kecil dari nilai pada periode terakhir.

    Nilai valid N: 1 hingga 200.

    Catatan

    Tetapkan setidaknya satu tingkat keparahan peringatan Critical, Warn, atau Info. Untuk setiap tingkat keparahan peringatan yang ditentukan, Anda harus menetapkan semua parameter berikut: Statistics, ComparisonOperator, Threshold, dan Times.

    GreaterThanOrEqualToThreshold
    Escalations.Info.Times

    integer

    No

    Jumlah kali metrik pemantauan harus mencapai ambang batas peringatan sebelum Pemberitahuan peringatan tingkat Info dikirim.

    Nilai valid N: 1 hingga 200.

    Catatan

    Pengaturan untuk setidaknya satu tingkat keparahan peringatan Critical, Warn (peringatan), atau Info harus ditentukan. Untuk setiap tingkat keparahan peringatan yang ditentukan, Anda harus menetapkan semua parameter berikut: Statistics, ComparisonOperator, Threshold, dan Times.

    1
    SilenceTime

    integer

    No

    Periode bisu Pemberitahuan peringatan. Nilai valid N: 1 hingga 200.

    Unit: detik. Nilai default: 86400. Nilai minimum: 3600.

    86400
    Webhook

    string

    No

    URL callback tempat Pemberitahuan peringatan dikirim. Nilai valid N: 1 hingga 200.

    Tentukan URL yang dapat diakses secara publik. CloudMonitor mengirimkan permintaan POST untuk mendorong informasi peringatan ke URL ini. Hanya protokol HTTP yang didukung.

    https://www.aliyun.com
    Namespace

    string

    Yes

    Namespace layanan Alibaba Cloud.

    Nilai valid N: 1 hingga 200.

    Untuk informasi tentang cara mendapatkan namespace layanan Alibaba Cloud, lihat DescribeMetricMetaList atau Pemantauan layanan cloud.

    acs_ecs_dashboard
    EmailSubject

    string

    No

    Subjek email Pemberitahuan peringatan.

    Nilai valid N: 1 hingga 200.

    ECS instance
    Period

    string

    No

    Periode pelaporan data pemantauan.

    Nilai valid N: 1 hingga 200.

    Nilai Period harus 60 atau kelipatan 60. Unit: detik. Nilai default: 300.

    60
    RuleName

    string

    Yes

    Nama aturan peringatan.

    Nilai valid N: 1 hingga 200.

    ECS_Rule1
    Escalations.Info.Statistics

    string

    No

    Metode statistik untuk peringatan tingkat Info.

    Nilai valid N: 1 hingga 200.

    Nilai valid parameter ini ditentukan oleh kolom Statistics yang sesuai dengan MetricName layanan Alibaba Cloud yang ditentukan, seperti Maximum, Minimum, dan Average. Untuk informasi tentang cara mendapatkan nilai valid, lihat Pemantauan layanan cloud.

    Catatan

    Tetapkan setidaknya satu tingkat keparahan peringatan Critical, Warn, atau Info. Untuk setiap tingkat keparahan peringatan yang ditentukan, Anda harus menetapkan semua parameter berikut: Statistics, ComparisonOperator, Threshold, dan Times.

    Average
    Escalations.Warn.Times

    integer

    No

    Jumlah kali metrik pemantauan harus mencapai ambang batas peringatan sebelum Pemberitahuan peringatan tingkat Warn dikirim.

    Nilai valid N: 1 hingga 200.

    Catatan

    Pengaturan untuk setidaknya satu tingkat keparahan peringatan Critical, Warn (peringatan), atau Info harus ditentukan. Untuk setiap tingkat keparahan peringatan yang ditentukan, Anda harus menetapkan semua parameter berikut: Statistics, ComparisonOperator, Threshold, dan Times.

    3
    Escalations.Info.ComparisonOperator

    string

    No

    Operator perbandingan untuk peringatan tingkat Info. Nilai valid:

    • GreaterThanOrEqualToThreshold: lebih besar dari atau sama dengan ambang batas.

    • GreaterThanThreshold: lebih besar dari ambang batas.

    • LessThanOrEqualToThreshold: lebih kecil dari atau sama dengan ambang batas.

    • LessThanThreshold: lebih kecil dari ambang batas.

    • NotEqualToThreshold: tidak sama dengan ambang batas.

    • GreaterThanYesterday: lebih besar dari nilai pengatur waktu yang sama kemarin.

    • LessThanYesterday: lebih kecil dari nilai pengatur waktu yang sama kemarin.

    • GreaterThanLastWeek: lebih besar dari nilai pengatur waktu yang sama minggu lalu.

    • LessThanLastWeek: lebih kecil dari nilai pengatur waktu yang sama minggu lalu.

    • GreaterThanLastPeriod: lebih besar dari nilai pada periode terakhir.

    • LessThanLastPeriod: lebih kecil dari nilai pada periode terakhir.

    Nilai valid N: 1 hingga 200.

    Catatan

    Tetapkan setidaknya satu tingkat keparahan peringatan Critical, Warn, atau Info. Untuk setiap tingkat keparahan peringatan yang ditentukan, Anda harus menetapkan semua parameter berikut: Statistics, ComparisonOperator, Threshold, dan Times.

    GreaterThanOrEqualToThreshold
    Interval

    string

    No

    Periode deteksi aturan peringatan.

    Nilai valid N: 1 hingga 200.

    Unit: detik. Nilai default adalah frekuensi pelaporan minimum metrik.

    Catatan

    Pertahankan periode deteksi aturan peringatan agar konsisten dengan periode pelaporan data. Jika periode deteksi lebih pendek dari periode pelaporan data, peringatan mungkin tidak terpicu karena data tidak mencukupi.

    60
    Category

    string

    Yes

    Singkatan nama layanan Alibaba Cloud.

    Nilai valid N: 1 hingga 200.

    Untuk informasi tentang cara mendapatkan singkatan, lihat tag metricCategory pada parameter respons Labels dari operasi DescribeProjectMeta.

    ECS
    Escalations.Critical.ComparisonOperator

    string

    No

    Operator perbandingan untuk peringatan tingkat Critical. Nilai valid:

    • GreaterThanOrEqualToThreshold: lebih besar dari atau sama dengan ambang batas.

    • GreaterThanThreshold: lebih besar dari ambang batas.

    • LessThanOrEqualToThreshold: lebih kecil dari atau sama dengan ambang batas.

    • LessThanThreshold: lebih kecil dari ambang batas.

    • NotEqualToThreshold: tidak sama dengan ambang batas.

    • GreaterThanYesterday: lebih besar dari nilai pengatur waktu yang sama kemarin.

    • LessThanYesterday: lebih kecil dari nilai pengatur waktu yang sama kemarin.

    • GreaterThanLastWeek: lebih besar dari nilai pengatur waktu yang sama minggu lalu.

    • LessThanLastWeek: lebih kecil dari nilai pengatur waktu yang sama minggu lalu.

    • GreaterThanLastPeriod: lebih besar dari nilai pada periode terakhir.

    • LessThanLastPeriod: lebih kecil dari nilai pada periode terakhir.

    Nilai valid N: 1 hingga 200.

    Catatan

    Tetapkan setidaknya satu tingkat keparahan peringatan Critical, Warn, atau Info. Untuk setiap tingkat keparahan peringatan yang ditentukan, Anda harus menetapkan semua parameter berikut: Statistics, ComparisonOperator, Threshold, dan Times.

    GreaterThanOrEqualToThreshold
    Escalations.Warn.Statistics

    string

    No

    Metode statistik untuk peringatan tingkat Warn.

    Nilai valid N: 1 hingga 200.

    Nilai valid parameter ini ditentukan oleh kolom Statistics yang sesuai dengan MetricName layanan Alibaba Cloud yang ditentukan, seperti Maximum, Minimum, dan Average. Untuk informasi tentang cara mendapatkan nilai valid, lihat Pemantauan layanan cloud.

    Catatan

    Tetapkan setidaknya satu tingkat keparahan peringatan Critical, Warn, atau Info. Untuk setiap tingkat keparahan peringatan yang ditentukan, Anda harus menetapkan semua parameter berikut: Statistics, ComparisonOperator, Threshold, dan Times.

    Average
    NoDataPolicy

    string

    No

    Metode pemrosesan saat tidak ditemukan data pemantauan. Nilai valid:

    • KEEP_LAST_STATE (default): Tidak ada aksi yang dilakukan.

    • INSUFFICIENT_DATA: Peringatan dengan konten "Insufficient Data" terpicu.

    • OK: Status dianggap normal.

    Nilai valid N: 1 hingga 200.

    KEEP_LAST_STATE
    ContactGroups

    string

    No

    Kelompok kontak peringatan.

    Nilai valid N: 1 hingga 200.

    Untuk informasi tentang cara mendapatkan kelompok kontak peringatan, lihat DescribeContactGroupList.

    ECS_Group
    Labels

    array<object>

    No

    Kunci tag aturan peringatan.

    object

    No

    Kunci tag aturan peringatan.

    Key

    string

    No

    Kunci tag aturan peringatan. Tag disertakan dalam Pemberitahuan peringatan.

    Nilai valid N: 1 hingga 200.

    key1
    Value

    string

    No

    Nilai tag aturan peringatan. Tag disertakan dalam Pemberitahuan peringatan.

    Nilai valid N: 1 hingga 200.

    value1
    Options

    string

    No

    Pengaturan lanjutan.

    Format: {"key1":"value1","key2":"value2"}. Misalnya, {"NotSendOK":true} menentukan apakah akan mengirimkan Pemberitahuan pemulihan peringatan. Kuncinya adalah NotSendOK, dan nilainya adalah true (jangan kirim) atau false (kirim, yang merupakan nilai default).

    { "NotSendOK": true }

    Untuk informasi lebih lanjut tentang parameter permintaan umum, lihat Parameter umum.

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Code

    integer

    Kode status.

    Catatan

    Nilai 200 menunjukkan keberhasilan.

    200
    Message

    string

    Paket error.

    The Request is not authorization.
    RequestId

    string

    ID permintaan.

    461CF2CD-2FC3-4B26-8645-7BD27E7D0F1D
    Success

    boolean

    Apakah operasi berhasil. Nilai valid:

    • true: Operasi berhasil.

    • false: Operasi gagal.

    true
    Resources

    object

    AlertResult

    array<object>

    Daftar aturan peringatan.

    object

    Code

    integer

    Kode status aturan peringatan yang baru dibuat.

    Catatan

    Nilai 200 menunjukkan keberhasilan.

    200
    Message

    string

    Paket error aturan peringatan yang baru dibuat.

    Metric not found.
    Success

    boolean

    Apakah aturan peringatan berhasil dibuat. Nilai valid:

    • true: Berhasil.

    • false: Gagal.

    true
    RuleName

    string

    Nama aturan peringatan yang baru dibuat.

    ECS_Rule1
    RuleId

    string

    ID aturan peringatan yang baru dibuat.

    456789

    Contoh

    Respons sukses

    JSONformat

    {
  "Code": 200,
  "Message": "The Request is not authorization.",
  "RequestId": "461CF2CD-2FC3-4B26-8645-7BD27E7D0F1D",
  "Success": true,
  "Resources": {
    "AlertResult": [
      {
        "Code": 200,
        "Message": "Metric not found.",
        "Success": true,
        "RuleName": "ECS_Rule1",
        "RuleId": "456789"
      }
    ]
  }
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 %s %s
    412 %s %s
    500 %s %s
    500 500 %s
    403 %s %s
    404 %s %s
    409 %s %s

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.