Gunakan CreateMetricRuleBlackList API untuk membuat kebijakan blacklist metrik - Cloud Monitor - Alibaba Cloud - Cloud Monitor

Membuat kebijakan blacklist.

Deskripsi operasi

Background information

CloudMonitor blocks alert notifications based on the blacklist policies that take effect. To block alert notifications when the value of a metric that belongs to a cloud service reaches the threshold that you specified, add the metric to a blacklist policy.
CloudMonitor allows you to create blacklist policies only based on threshold metrics. You cannot create blacklist policies based on system events. For more information about the cloud services and the thresholds of the metrics that are supported by CloudMonitor, see Appendix 1: Metrics.

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

create

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
Name	string	Yes	Nama kebijakan blacklist.	Blacklist-01
Namespace	string	Yes	Namespace layanan cloud. Untuk informasi selengkapnya tentang namespace berbagai layanan cloud, lihat Lampiran 1: Metrik.	acs_ecs_dashboard
Category	string	Yes	Kategori layanan cloud. Misalnya, Database Apsara for Redis mencakup kategori berikut: Database Apsara for Redis (arsitektur standar), Database Apsara for Redis (arsitektur kluster), dan Database Apsara for Redis (arsitektur pemisahan baca/tulis). Dalam hal ini, nilai valid parameter ini untuk Database Apsara for Redis meliputi `kvstore_standard`, `kvstore_sharding`, dan `kvstore_splitrw`.	ecs
ScopeType	string	No	Cakupan (dalam OAuth) efektif kebijakan blacklist. Nilai valid: USER (default): Kebijakan blacklist hanya berlaku untuk akun Alibaba Cloud saat ini. GROUP: Kebijakan blacklist hanya berlaku untuk kelompok aplikasi yang ditentukan. Untuk informasi tentang cara mengkueri ID kelompok aplikasi, lihat DescribeMonitorGroups.	USER
ScopeValue	string	No	ID kelompok aplikasi. Nilai parameter ini berupa array JSON. Catatan Parameter ini harus ditentukan saat `ScopeType` diatur ke `GROUP`.	["67**","78**"]
EnableStartTime	string	No	Pengatur waktu saat kebijakan blacklist mulai berlaku. Unit: milliseconds.	1640237400000
EnableEndTime	string	No	Pengatur waktu saat kebijakan blacklist kedaluwarsa. Unit: milliseconds.	1640608200000
EffectiveTime	string	No	Pengatur waktu saat kebijakan blacklist berlaku. Jika Anda tidak mengonfigurasi parameter ini, kebijakan blacklist berlaku secara permanen. Jika Anda mengonfigurasi parameter ini, kebijakan blacklist hanya berlaku dalam pengatur waktu yang ditentukan. Contoh: `03:00-04:59`: Kebijakan blacklist berlaku dari pukul 03:00 hingga 05:00 waktu setempat. Pukul 05:00 waktu setempat tidak termasuk. `03:00-04:59 UTC+0700`: Kebijakan blacklist berlaku dari pukul 03:00 hingga 05:00 (UTC+7). Pukul 05:00 (UTC+7) tidak termasuk.	03:00-04:59
Instances	array	Yes	ID instans milik layanan cloud yang ditentukan.
	string	No	The IDs of the instances that belong to the specified cloud service. Valid values of N: 1 to 100.	{"instanceId":"i-bp1ew0zfkjblsuwx****"}
Metrics	array<object>	No	Metrik instans. Jika Anda tidak mengonfigurasi parameter ini, kebijakan blacklist berlaku untuk semua metrik layanan cloud yang ditentukan. Jika Anda mengonfigurasi parameter ini, kebijakan blacklist hanya berlaku untuk metrik saat ini.
	object	No	None
MetricName	string	Yes	The metric name. Valid values of N: 1 to 10.	disk_utilization
Resource	string	No	The extended dimension of the instance. For example, `{"device":"C:"}` specifies that the blacklist policy is applied to all C disks of the specified Elastic Compute Service (ECS) instance. Valid values of N: 1 to 10.	{"device":"C:"}

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

Elemen respons

Element	Type	Description	Example
	object	None
Code	string	The status code. Catatan The status code 200 indicates that the request was successful.	200
Message	string	The error message.	The request has failed due to a temporary failure of the server.
RequestId	string	The request ID.	5C637FA3-3959-3352-8BE6-78CE2ED2D33D
Success	boolean	Indicates whether the request was successful. Valid values: true false	true
Id	string	The ID of the blacklist policy.	93514c96-ceb8-47d8-8ee3-93b6d98b****

Contoh

Respons sukses

JSONformat

{
  "Code": "200",
  "Message": "The request has failed due to a temporary failure of the server.",
  "RequestId": "5C637FA3-3959-3352-8BE6-78CE2ED2D33D",
  "Success": true,
  "Id": "93514c96-ceb8-47d8-8ee3-93b6d98b****"
}

Kode kesalahan

HTTP status code	Error code	Error message
400	ParameterInvalid	Illegal parameters.
500	InternalError	The request processing has failed due to some unknown error.
403	AccessForbidden	User not authorized to operate on the specified resource.
404	ResourceNotFound	The specified resource is not found.
409	ResourceConflict	Concurrent modification of resources.
409	ResourceExist	Resources already exist.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.