All Products
Search

This Product

    Cloud Monitor:PutGroupMetricRule

    Document Center

    Cloud Monitor:PutGroupMetricRule

    Last Updated:Jun 26, 2026

    Membuat atau mengubah aturan peringatan di kelompok aplikasi tertentu.

    Deskripsi operasi

    Topik ini memberikan contoh cara membuat aturan peringatan untuk metrik cpu_total dari Elastic Compute Service (ECS) di kelompok aplikasi 17285****. ID aturan peringatan adalah 123456, nama aturan peringatan adalah Rule_test, tingkat 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 telah dibuat. ID aturan peringatan adalah 123456.

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

    create

    *GroupMetricRule

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

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    GroupId

    string

    Yes

    ID kelompok aplikasi.

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

    17285****
    RuleId

    string

    Yes

    ID aturan peringatan.

    • Untuk membuat aturan peringatan untuk kelompok aplikasi, masukkan ID aturan peringatan.

    • Untuk mengubah aturan peringatan tertentu di kelompok aplikasi, dapatkan ID aturan peringatan. Untuk informasi tentang cara mendapatkan ID aturan peringatan, lihat DescribeMetricRuleList.

    123456
    Category

    string

    No

    Singkatan nama layanan Alibaba Cloud.

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

    ECS
    RuleName

    string

    Yes

    Nama aturan peringatan.

    • Untuk membuat aturan peringatan untuk kelompok aplikasi, masukkan nama aturan peringatan.

    • Untuk mengubah aturan peringatan tertentu di kelompok aplikasi, dapatkan nama aturan peringatan. Untuk informasi tentang cara mendapatkan nama aturan peringatan, lihat DescribeMetricRuleList.

    Rule_01
    Namespace

    string

    Yes

    Namespace layanan Alibaba Cloud.

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

    acs_ecs_dashboard
    MetricName

    string

    Yes

    Nama metrik.

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

    cpu_total
    Dimensions

    string

    No

    Dimensi tingkat pertama aturan peringatan di kelompok aplikasi.

    Format: kumpulan pasangan kunci:nilai, seperti {"userId":"120886317861****"} dan {"instanceId":"i-m5e1qg6uo38rztr4****"}.

    [{"instanceId":"i-m5e1qg6uo38rztr4****"}]
    ExtraDimensionJson

    string

    No

    Dimensi tingkat kedua atau ketiga aturan peringatan di kelompok aplikasi.

    Format: kumpulan pasangan key:value, seperti port:80 dan /dev/xvda:d-m5e6yphgzn3aprwu****.

    Jika dimensi tingkat pertama adalah {"instanceId":"i-m5e1qg6uo38rztr4****"}, dimensi tingkat kedua adalah cloud disk instans: {"/dev/xvda":"d-m5e6yphgzn3aprwu****"}.

    {"/dev/xvda":"d-m5e6yphgzn3aprwu****"}
    EffectiveInterval

    string

    No

    Periode efektif saat aturan peringatan berlaku.

    05:31-23:59
    NoEffectiveInterval

    string

    No

    Rentang waktu saat aturan peringatan tidak berlaku.

    00:00-05:30
    SilenceTime

    integer

    No

    Periode bisu saat CloudMonitor tidak berulang kali mengirim notifikasi peringatan untuk metrik yang sama.

    Unit: seconds. Nilai default: 86400.

    86400
    Period

    string

    No

    Periode pelaporan data pemantauan.

    Nilai Period adalah 60 atau kelipatan 60. Unit: seconds. Nilai default: 300.

    60
    Interval

    string

    No

    Periode deteksi aturan peringatan. Unit: seconds.

    Catatan

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

    60
    Webhook

    string

    No

    URL callback tempat permintaan dikirim saat peringatan terpicu.

    Masukkan URL yang dapat diakses melalui Internet. CloudMonitor mengirim permintaan POST untuk mendorong informasi peringatan ke URL ini. Hanya protokol HTTP yang didukung.

    https://www.aliyun.com
    EmailSubject

    string

    No

    Subjek email peringatan.

    ECS instance
    ContactGroups

    string

    No

    Kelompok kontak peringatan.

    ECS_Group
    Escalations.Critical.Statistics

    string

    No

    Metode statistik untuk peringatan tingkat Critical. Pisahkan beberapa metode statistik dengan koma (,).

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

    Average
    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.

    GreaterThanOrEqualToThreshold
    Escalations.Critical.Threshold

    string

    No

    Ambang batas untuk peringatan tingkat Critical.

    90
    Escalations.Critical.Times

    integer

    No

    Jumlah percobaan ulang untuk peringatan tingkat Critical.

    3
    Escalations.Warn.Statistics

    string

    No

    Metode statistik untuk peringatan tingkat Warn. Pisahkan beberapa metode statistik dengan koma (,).

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

    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.

    GreaterThanOrEqualToThreshold
    Escalations.Warn.Threshold

    string

    No

    Ambang batas untuk peringatan tingkat Warn.

    90
    Escalations.Warn.Times

    integer

    No

    Jumlah percobaan ulang untuk peringatan tingkat Warn.

    3
    Escalations.Info.Statistics

    string

    No

    Metode statistik untuk peringatan tingkat Info. Pisahkan beberapa metode statistik dengan koma (,).

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

    Average
    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.

    GreaterThanOrEqualToThreshold
    Escalations.Info.Threshold

    string

    No

    Ambang batas untuk peringatan tingkat Info.

    90
    Escalations.Info.Times

    integer

    No

    Jumlah percobaan ulang untuk peringatan tingkat Info.

    3
    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.

    KEEP_LAST_STATE
    Labels

    array<object>

    No

    Tag aturan peringatan.

    Tag disertakan dalam notifikasi peringatan.

    object

    No

    Tidak ada.

    Key

    string

    No

    Kunci tag aturan peringatan.

    key1
    Value

    string

    No

    Nilai tag aturan peringatan.

    value1
    Options

    string

    No

    Pengaturan lanjutan.

    Format: {"key1":"value1","key2":"value2"}. Contoh: {"NotSendOK":true}. Menentukan apakah akan mengirim notifikasi 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

    Tidak ada.

    Code

    string

    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
    Result

    object

    Hasil pembuatan atau pengubahan aturan peringatan.

    RuleId

    string

    ID aturan peringatan.

    123456

    Contoh

    Respons sukses

    JSONformat

    {
  "Code": "200",
  "Message": "The Request is not authorization.",
  "RequestId": "461CF2CD-2FC3-4B26-8645-7BD27E7D0F1D",
  "Success": true,
  "Result": {
    "RuleId": "123456"
  }
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 %s %s
    499 %s %s
    500 %s %s
    204 %s %s
    403 %s %s
    206 %s %s
    404 %s %s
    503 %s %s
    406 %s %s

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.