Gunakan CreateRule untuk membuat aturan event - EventBridge - Alibaba Cloud - EventBridge

Membuat aturan event.

Deskripsi operasi

Membuat aturan event.

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

eventbridge:CreateRule

create

*Rule.

acs:eventbridge:{#regionId}:{#accountId}:eventbus/{#EventBusName}/rule/{#RuleName}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
EventBusName	string	Yes	Nama EventBridge.	MyEventBus
Description	string	No	Deskripsi EventBridge.	Filter rule for Simple Message Queue (formerly MNS) (SMQ)
RuleName	string	Yes	Nama aturan event.	SMQRule
Status	string	No	Status aturan. Nilai valid: ENABLE: Aturan diaktifkan. Ini adalah status default. DISABLE: Aturan dinonaktifkan.	ENABLE
FilterPattern	string	Yes	Pola peristiwa dalam format JSON. Pola berikut didukung: Pola stringEqual Pola stringExpression Setiap bidang mendukung hingga lima ekspresi dalam struktur map.	{ "source": [ { "prefix": "acs." } ], "type": [ { "prefix": "oss:ObjectReplication" } ], "subject": [ { "prefix": "acs:oss:cn-hangzhou:123456789098****:my-movie-bucket/", "suffix": ".txt" } ] }
EventTargets	array<object>	No	Daftar target event.
	array<object>	No	Target event.
Id	string	Yes	ID kustom target event.	Mlm123456JHd2RsRoKw
Type	string	Yes	Tipe target event. Untuk informasi selengkapnya, lihat Parameter target event.	acs.mns.queue
Endpoint	string	No	URL titik akhir untuk pengiriman.	acs:mns:cn-hangzhou:123456789098****:queues/myqueue
PushRetryStrategy	string	No	Kebijakan percobaan ulang untuk mendorong event. Nilai valid: BACKOFF_RETRY: kebijakan percobaan ulang backoff. Sistem melakukan percobaan ulang 3 kali, dengan interval acak 10 hingga 20 detik di antara setiap percobaan ulang. EXPONENTIAL_DECAY_RETRY: percobaan ulang peluruhan eksponensial. Sistem melakukan percobaan ulang 176 kali, dengan interval yang meningkat secara eksponensial hingga 512 detik. Total pengatur waktu percobaan ulang adalah 1 hari. Interval spesifiknya adalah 1, 2, 4, 8, 16, 32, 64, 128, 256, 512, lalu 512 detik untuk 167 percobaan ulang sisanya.	BACKOFF_RETRY
DeadLetterQueue	object	No	Dead-letter queue. Event yang tidak diproses atau event yang melebihi jumlah percobaan ulang akan ditulis ke dead-letter queue. Jenis antrian yang didukung meliputi ApsaraMQ for RocketMQ, Simple Message Queue (sebelumnya MNS), ApsaraMQ for Kafka, dan event bus EventBridge.
Arn	string	No	Nama Sumber Daya Alibaba Cloud antrian dead-letter. Event yang tidak diproses atau event yang melebihi jumlah percobaan ulang ditulis ke antrian dead-letter. Simple Antrian Pesan (sebelumnya MNS) dan ApsaraMQ for RocketMQ didukung.	acs:mns:cn-hangzhou:123456789098****:/queues/deadletterqueue
Network	string	No	Jenis jaringan.	PrivateNetwork
VpcId	string	No	ID VPC tempat antrian dead-letter berada.	vpc-2z****
VSwitchIds	string	No	ID vSwitch.	vsw-m12345****
SecurityGroupId	string	No	ID grup keamanan.	sg-2d****
ErrorsTolerance	string	No	Strategi toleransi kesalahan. Nilai valid: ALL: mengizinkan toleransi kesalahan. Pengecualian tidak memblokir eksekusi. Jika strategi percobaan ulang habis, Paket dikirim ke antrian dead-letter atau dibuang berdasarkan konfigurasi. NONE: menonaktifkan toleransi kesalahan. Pengecualian memblokir eksekusi ketika strategi percobaan ulang habis.	ALL
ParamList	array<object>	No	Parameter target event.
	object	No	Parameter target event.
ResourceKey	string	No	Parameter Sumber daya target event. Untuk informasi selengkapnya, lihat Batas.	body
Form	string	No	Format parameter target event. Untuk informasi selengkapnya, lihat Batas.	TEMPLATE
Value	string	No	Nilai parameter target event.	{"key"="value"}
Template	string	No	Gaya templat parameter target event.	The value of ${key} is ${value}!
ConcurrentConfig	object	No	Konfigurasi kontrol konkurensi.
Concurrency	integer	No	Jumlah eksekusi konkuren.	2

Permintaan sampel.

POST /openapi/createRule HTTP/1.1 Host: 123456789098****.eventbridge.cn-hangzhou.aliyuncs.com Date: Sat, 18 Apr 2020 05:30:41 GMT x-eventbridge-version: 2020-04-01 Authorization: acs vZ3VL0SuJdHi****:Jo2PbT******azYAYoYslKLvWzg= Content-Type: application/json;charset=UTF-8 Content-Length: 26

{ "EventBusName":"default", "RuleName":"MNSRule", "Description":"Filtering rule for MNS", "Status":"ENABLE", "filterPattern":"{"source": [{"prefix": "acs."}],"type": [{"prefix":"oss:ObjectReplication"}],"subject":[{"prefix":"acs:oss:cn-hangzhou:123456789098****:my-movie-bucket/", "suffix":".txt"}]}", "EventTargets":[ { "Id":"1", "Type":"acs.mns.queue", "Endpoint":"acs:mns:cn-hangzhou:123456789098****:queues/myqueue", "PushRetryStrategy":"BACKOFF_RETRY", "DeadLetterQueue":{ "Arn":"acs:mns:cn-hangzhou:123456789098****:/queues/rule-deadletterqueue" }, "ParamList":[ { "resourceKey":"queue", "form":"CONSTANT", "value":"myqueue" }, { "resourceKey":"body", "form":"TEMPLATE", "value":"{"key"="value"}", "template":"The value of ${key} is ${value}!" } ] } ] }

Elemen respons

Element	Type	Description	Example
	object
Message	string	Pesan error.	Remote error. requestId: [xxxx], error code: [xxx], message: [The target in event rule is invalid! Endpoint is xxx
RequestId	string	ID permintaan.	1AD6D598-7506-5D2C-81EA-30E3241A903A
Data	object	Data yang dikembalikan.
RuleARN	string	ARN aturan event, yang digunakan untuk otorisasi.	acs:eventbridge:cn-hangzhou:123456789098****:eventbus/default/rule/MNSRule
Code	string	Kode tanggapan. Nilai Success menunjukkan bahwa permintaan berhasil. Nilai lain menunjukkan kode error. Untuk informasi selengkapnya, lihat Kode error.	Success
Success	boolean	Apakah operasi berhasil.	true

Contoh

Respons sukses

JSONformat

{
  "Message": "Remote error. requestId: [xxxx], error code: [xxx], message: [The target in event rule is invalid! Endpoint is xxx",
  "RequestId": "1AD6D598-7506-5D2C-81EA-30E3241A903A",
  "Data": {
    "RuleARN": "acs:eventbridge:cn-hangzhou:123456789098****:eventbus/default/rule/MNSRule"
  },
  "Code": "Success",
  "Success": true
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
403	ServiceNotEnable	Service not enable

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.