All Products
Search

This Product

    Cloud Monitor:PutResourceMetricRules

    Document Center

    Cloud Monitor:PutResourceMetricRules

    Last Updated:Jun 29, 2026

    Membuat beberapa aturan peringatan ambang batas untuk metrik tertentu dari Sumber daya tertentu.

    Deskripsi operasi

    Topik ini memberikan contoh cara membuat aturan peringatan ambang batas untuk metrik cpu_total dari instans ECS i-uf6j91r34rnwawoo**** di namespace acs_ecs_dashboard. Kelompok kontak peringatan diatur ke ECS_Group, nama aturan peringatan diatur ke test123, ID aturan peringatan diatur ke a151cd6023eacee2f0978e03863cc1697c89508****, metode statistik untuk level Critical diatur ke Average, operator perbandingan untuk level Critical diatur ke GreaterThanOrEqualToThreshold, ambang batas untuk level Critical diatur ke 90, dan jumlah percobaan ulang untuk level Critical diatur ke 3.

    Catatan

    Per 15 Agustus 2024, validasi Statistik ditambahkan. Anda hanya dapat mengatur nilai statistik ke nilai Statistik yang sesuai dengan metrik. Untuk informasi selengkapnya tentang cara mendapatkan nilai parameter ini, lihat Metrik pemantauan layanan Alibaba Cloud.

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

    create

    *All Resource

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    Rules

    array<object>

    Yes

    Daftar aturan peringatan ambang batas.

    Nilai valid N: 1 hingga 50.

    array<object>

    No

    Tidak ada.

    Escalations.Info.Threshold

    string

    No

    Ambang batas untuk peringatan level Info.

    Catatan

    Anda harus menentukan setidaknya satu dari level peringatan berikut: Critical, Warn, atau Info. Untuk level peringatan yang ditentukan, Anda harus mengatur semua parameter berikut: Statistics, ComparisonOperator, Threshold, dan Times.

    90
    MetricName

    string

    No

    Nama metrik.

    Nilai valid N: 1 hingga 50.

    Untuk informasi selengkapnya tentang cara mengkueri nama metrik, lihat Metrik pemantauan layanan Alibaba Cloud.

    cpu_total
    Escalations.Warn.Threshold

    string

    No

    Ambang batas untuk peringatan level Warn.

    Nilai valid N: 1 hingga 50.

    Catatan

    Anda harus menentukan setidaknya satu dari level peringatan berikut: Critical, Warn, atau Info. Untuk level peringatan yang ditentukan, Anda harus mengatur semua parameter berikut: Statistics, ComparisonOperator, Threshold, dan Times.

    90
    EffectiveInterval

    string

    No

    Periode efektif aturan peringatan.

    Nilai valid N: 1 hingga 50.

    00:00-23:59
    NoEffectiveInterval

    string

    No

    Rentang pengatur waktu saat aturan peringatan tidak berlaku.

    Nilai valid N: 1 hingga 50.

    00:00-06:00
    RuleId

    string

    Yes

    ID aturan peringatan.

    Nilai valid N: 1 hingga 50.

    Anda dapat memasukkan ID aturan peringatan baru atau menggunakan ID aturan peringatan yang ada di CloudMonitor. Untuk informasi selengkapnya tentang cara mengkueri ID aturan peringatan, lihat DescribeMetricRuleList.

    Catatan

    Jika Anda memasukkan ID aturan peringatan baru, aturan peringatan ambang batas akan dibuat.

    a151cd6023eacee2f0978e03863cc1697c89508****
    Escalations.Critical.Times

    integer

    No

    Jumlah percobaan ulang untuk peringatan level Critical.

    Nilai valid N: 1 hingga 50.

    Catatan

    Anda harus menentukan setidaknya satu dari level peringatan berikut: Critical, Warn, atau Info. Untuk level peringatan yang ditentukan, Anda harus mengatur semua parameter berikut: Statistics, ComparisonOperator, Threshold, dan Times.

    3
    Escalations.Critical.Threshold

    string

    No

    Ambang batas untuk peringatan level Critical.

    Nilai valid N: 1 hingga 50.

    Catatan

    Anda harus menentukan setidaknya satu dari level peringatan berikut: Critical, Warn, atau Info. Untuk level peringatan yang ditentukan, Anda harus mengatur semua parameter berikut: Statistics, ComparisonOperator, Threshold, dan Times.

    90
    Escalations.Critical.Statistics

    string

    No

    Metode statistik untuk peringatan level Critical.

    Nilai valid N: 1 hingga 50.

    Nilai parameter ini ditentukan oleh kolom Statistics yang sesuai dengan MetricName dari layanan Alibaba Cloud yang ditentukan. Contoh: Maximum, Minimum, dan Average. Untuk informasi selengkapnya tentang cara mendapatkan nilai parameter ini, lihat Metrik pemantauan layanan Alibaba Cloud.

    Catatan

    Anda harus menentukan setidaknya satu dari level peringatan berikut: Critical (critical), Warn (warning), atau Info (information). Untuk level peringatan yang ditentukan, Anda harus mengatur semua parameter berikut: Statistics, ComparisonOperator, Threshold, dan Times.

    Average
    Escalations.Warn.ComparisonOperator

    string

    No

    Operator perbandingan untuk peringatan level Warn. Nilai valid:

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

    • GreaterThanThreshold: lebih besar dari ambang batas.

    • LessThanOrEqualToThreshold: kurang dari atau sama dengan ambang batas.

    • LessThanThreshold: kurang dari ambang batas.

    • NotEqualToThreshold: tidak sama dengan ambang batas.

    • EqualToThreshold: sama dengan ambang batas.

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

    • LessThanYesterday: kurang dari nilai pengatur waktu yang sama kemarin.

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

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

    • GreaterThanLastPeriod: lebih besar dari nilai pada periode terakhir.

    • LessThanLastPeriod: kurang dari nilai pada periode terakhir.

    Nilai valid N: 1 hingga 50.

    Catatan

    Anda harus menentukan setidaknya satu dari level peringatan berikut: Critical, Warn, atau Info. Untuk level peringatan yang ditentukan, Anda harus mengatur semua parameter berikut: Statistics, ComparisonOperator, Threshold, dan Times.

    GreaterThanOrEqualToThreshold
    Escalations.Info.Times

    integer

    No

    Jumlah percobaan ulang untuk peringatan level Info.

    Nilai valid N: 1 hingga 50.

    Catatan

    Anda harus menentukan setidaknya satu dari level peringatan berikut: Critical, Warn, atau Info. Untuk level peringatan yang ditentukan, Anda harus mengatur semua parameter berikut: Statistics, ComparisonOperator, Threshold, dan Times.

    3
    Resources

    string

    Yes

    Informasi instans, seperti [{"instanceId":"i-uf6j91r34rnwawoo****"}] atau [{"userId":"100931896542****"}].

    Nilai valid N: 1 hingga 50.

    Untuk informasi selengkapnya tentang dimensi yang didukung, lihat Metrik pemantauan layanan Alibaba Cloud.

    [{"instanceId":"i-uf6j91r34rnwawoo****"}]
    SilenceTime

    integer

    No

    Periode bisu.

    Unit: seconds. Nilai default: 86400.

    Nilai valid N: 1 hingga 50.

    Catatan

    Periode bisu menentukan interval pengiriman Pemberitahuan peringatan kembali jika peringatan belum dihapus.

    86400
    Webhook

    string

    No

    URL callback tempat permintaan POST dikirim saat peringatan Pemicu.

    Nilai valid N: 1 hingga 50.

    https://alert.aliyun.com.com:8080/callback
    ContactGroups

    string

    Yes

    Kelompok kontak peringatan. Pemberitahuan peringatan dikirim ke kontak peringatan dalam kelompok kontak peringatan.

    Nilai valid N: 1 hingga 50.

    Catatan

    Kelompok kontak peringatan berisi satu atau beberapa kontak peringatan. Untuk informasi selengkapnya tentang cara membuat kontak peringatan dan kelompok kontak peringatan, lihat PutContact dan PutContactGroup.

    ECS_Group
    Namespace

    string

    Yes

    Namespace data layanan Alibaba Cloud.

    Nilai valid N: 1 hingga 50.

    Untuk informasi selengkapnya tentang cara mengkueri namespace data layanan Alibaba Cloud, lihat Metrik pemantauan layanan Alibaba Cloud.

    acs_ecs_dashboard
    EmailSubject

    string

    No

    Subjek email peringatan.

    Nilai valid N: 1 hingga 50.

    ECS instance alert
    Period

    string

    No

    Periode statistik metrik.

    Unit: seconds. Nilai default: periode pelaporan asli metrik.

    Nilai valid N: 1 hingga 50.

    Catatan

    Untuk informasi selengkapnya tentang cara mengkueri periode statistik metrik, lihat Metrik pemantauan layanan Alibaba Cloud.

    60
    RuleName

    string

    Yes

    Nama aturan peringatan.

    Nilai valid N: 1 hingga 50.

    Anda dapat memasukkan nama aturan peringatan baru atau menggunakan nama aturan peringatan yang ada di CloudMonitor. Untuk informasi selengkapnya tentang cara mengkueri nama aturan peringatan, lihat DescribeMetricRuleList.

    Catatan

    Jika Anda memasukkan nama aturan peringatan baru, aturan peringatan ambang batas akan dibuat.

    test123
    Escalations.Info.Statistics

    string

    No

    Metode statistik untuk peringatan level Info.

    Nilai valid N: 1 hingga 50.

    Nilai parameter ini ditentukan oleh kolom Statistics yang sesuai dengan MetricName dari layanan Alibaba Cloud yang ditentukan. Contoh: Maximum, Minimum, dan Average. Untuk informasi selengkapnya tentang cara mendapatkan nilai parameter ini, lihat Metrik pemantauan layanan Alibaba Cloud.

    Catatan

    Anda harus menentukan setidaknya satu dari level peringatan berikut: Critical (critical), Warn (warning), atau Info (information). Untuk level peringatan yang ditentukan, Anda harus mengatur semua parameter berikut: Statistics, ComparisonOperator, Threshold, dan Times.

    Average
    Escalations.Warn.Times

    integer

    No

    Jumlah percobaan ulang untuk peringatan level Warn.

    Nilai valid N: 1 hingga 50.

    Catatan

    Anda harus menentukan setidaknya satu dari level peringatan berikut: Critical, Warn, atau Info. Untuk level peringatan yang ditentukan, Anda harus mengatur semua parameter berikut: Statistics, ComparisonOperator, Threshold, dan Times.

    3
    Escalations.Info.ComparisonOperator

    string

    No

    Operator perbandingan untuk peringatan level Info. Nilai valid:

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

    • GreaterThanThreshold: lebih besar dari ambang batas.

    • LessThanOrEqualToThreshold: kurang dari atau sama dengan ambang batas.

    • LessThanThreshold: kurang dari ambang batas.

    • NotEqualToThreshold: tidak sama dengan ambang batas.

    • EqualToThreshold: sama dengan ambang batas.

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

    • LessThanYesterday: kurang dari nilai pengatur waktu yang sama kemarin.

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

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

    • GreaterThanLastPeriod: lebih besar dari nilai pada periode terakhir.

    • LessThanLastPeriod: kurang dari nilai pada periode terakhir.

    Nilai valid N: 1 hingga 50.

    Catatan

    Anda harus menentukan setidaknya satu dari level peringatan berikut: Critical, Warn, atau Info. Untuk level peringatan yang ditentukan, Anda harus mengatur semua parameter berikut: Statistics, ComparisonOperator, Threshold, dan Times.

    GreaterThanOrEqualToThreshold
    Interval

    string

    No

    Periode pemicu aturan peringatan.

    Unit: seconds.

    Nilai valid N: 1 hingga 50.

    Catatan

    Untuk informasi selengkapnya tentang cara mengkueri periode statistik metrik, lihat Metrik pemantauan layanan Alibaba Cloud.

    60
    Escalations.Critical.ComparisonOperator

    string

    No

    Operator perbandingan untuk peringatan level Critical. Nilai valid:

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

    • GreaterThanThreshold: lebih besar dari ambang batas.

    • LessThanOrEqualToThreshold: kurang dari atau sama dengan ambang batas.

    • LessThanThreshold: kurang dari ambang batas.

    • NotEqualToThreshold: tidak sama dengan ambang batas.

    • EqualToThreshold: sama dengan ambang batas.

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

    • LessThanYesterday: kurang dari nilai pengatur waktu yang sama kemarin.

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

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

    • GreaterThanLastPeriod: lebih besar dari nilai pada periode terakhir.

    • LessThanLastPeriod: kurang dari nilai pada periode terakhir.

    Nilai valid N: 1 hingga 50.

    Catatan

    Anda harus menentukan setidaknya satu dari level peringatan berikut: Critical, Warn, atau Info. Untuk level peringatan yang ditentukan, Anda harus mengatur semua parameter berikut: Statistics, ComparisonOperator, Threshold, dan Times.

    GreaterThanOrEqualToThreshold
    Escalations.Warn.Statistics

    string

    No

    Metode statistik untuk peringatan level Warn.

    Nilai valid N: 1 hingga 50.

    Nilai parameter ini ditentukan oleh kolom Statistics yang sesuai dengan MetricName dari layanan Alibaba Cloud yang ditentukan. Contoh: Maximum, Minimum, dan Average. Untuk informasi selengkapnya tentang cara mendapatkan nilai parameter ini, lihat Metrik pemantauan layanan Alibaba Cloud.

    Catatan

    Anda harus menentukan setidaknya satu dari level peringatan berikut: Critical (critical), Warn (warning), atau Info (information). Untuk level peringatan yang ditentukan, Anda harus mengatur 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 diambil.

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

    • OK: Status dianggap normal.

    Nilai valid N: 1 hingga 50.

    KEEP_LAST_STATE
    Labels

    array<object>

    No

    Saat metrik mencapai kondisi peringatan dan peringatan Pemicu, label ditulis ke metrik dan ditampilkan dalam Pemberitahuan peringatan.

    object

    No

    Tidak ada.

    Key

    string

    No

    Kunci label.

    tagKey1
    Value

    string

    No

    Nilai label.

    Catatan

    Nilai label mendukung parameter templat. Parameter templat diganti dengan nilai label aktual.

    ECS
    SendOK

    boolean

    No

    Apakah akan mengirim notifikasi pemulihan.

    true

    Untuk informasi selengkapnya tentang parameter permintaan umum, lihat Parameter umum.

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Tidak ada.

    Code

    string

    Kode status HTTP.

    Catatan

    Nilai 200 menunjukkan keberhasilan.

    200
    Message

    string

    Paket error.

    The request processing has failed due to some unknown error.
    RequestId

    string

    ID permintaan.

    15D1440E-BF24-5A41-93E4-36864635179E
    Success

    boolean

    Menunjukkan apakah operasi berhasil. Nilai valid:

    • true: Operasi berhasil.

    • false: Operasi gagal.

    true
    FailedListResult

    object

    Target

    array<object>

    Daftar hasil gagal untuk pengaturan aturan peringatan pada Sumber daya.

    array<object>

    Tidak ada.

    RuleId

    string

    ID aturan peringatan.

    a151cd6023eacee2f0978e03863cc1697c89508****
    Result

    object

    Hasil kegagalan.

    Code

    string

    Kode status.

    404
    Message

    string

    Pesan error.

    The request processing has failed due to some unknown error.
    Success

    boolean

    Apakah operasi berhasil. Nilai valid:

    • true: Berhasil.

    • false: Gagal.

    false

    Contoh

    Respons sukses

    JSONformat

    {
  "Code": "200",
  "Message": "The request processing has failed due to some unknown error.",
  "RequestId": "15D1440E-BF24-5A41-93E4-36864635179E",
  "Success": true,
  "FailedListResult": {
    "Target": [
      {
        "RuleId": "a151cd6023eacee2f0978e03863cc1697c89508****",
        "Result": {
          "Code": "404",
          "Message": "The request processing has failed due to some unknown error.",
          "Success": false
        }
      }
    ]
  }
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 %s %s
    422 %s %s
    499 %s %s
    500 InternalError The request processing has failed due to some unknown error.
    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.