全部产品
Search
文档中心

EventBridge:CreateRule

更新时间:Dec 23, 2025

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

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter

Type

Required

Description

Example

EventBusName

string

Yes

Nama event bus.

MyEventBus

Description

string

No

Deskripsi event bus.

SMQ的过滤规则

RuleName

string

Yes

Nama aturan event.

SMQRule

Status

string

No

Status aturan. Nilai yang valid: ENABLE: Aturan diaktifkan. Ini adalah nilai default. DISABLE: Aturan dinonaktifkan.

ENABLE

FilterPattern

string

Yes

Pola event, dalam format JSON. Nilai yang valid: Pola stringEqual. Pola stringExpression. Setiap bidang dapat memiliki 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

Titik akhir tempat event dikirimkan.

acs:mns:cn-hangzhou:123456789098****:queues/myqueue

PushRetryStrategy

string

No

Kebijakan retry untuk mendorong event. Nilai yang valid: BACKOFF_RETRY: Retry dengan backoff. Sistem mencoba mengirim ulang event sebanyak tiga kali. Interval antara dua percobaan berturut-turut adalah nilai acak antara 10 detik dan 20 detik. EXPONENTIAL_DECAY_RETRY: Retry dengan peluruhan eksponensial. Sistem mencoba mengirim ulang event sebanyak 176 kali. Interval antara dua percobaan berturut-turut meningkat secara eksponensial hingga 512 detik. Total waktu retry adalah satu hari. Interval retry spesifiknya adalah: 1, 2, 4, 8, 16, 32, 64, 128, 256, 512, 512, ..., dan 512 detik. Interval 512 detik berlaku untuk 167 retry terakhir.

BACKOFF_RETRY

DeadLetterQueue

object

No

Antrian pesan gagal. Event yang tidak diproses atau melebihi jumlah retry dituliskan ke antrian pesan gagal. Antrian pesan gagal dapat berupa antrian Message Queue for Apache RocketMQ, antrian Simple Message Queue (formerly MNS), topik Message Queue for Apache Kafka, atau event bus EventBridge.

Arn

string

No

Nama Sumber Daya Alibaba Cloud (ARN) dari antrian pesan gagal. Event yang tidak diproses atau melebihi jumlah retry dituliskan ke antrian pesan gagal. Simple Message Queue (formerly MNS) dan Message Queue for Apache RocketMQ didukung.

acs:mns:cn-hangzhou:123456789098****:/queues/deadletterqueue 或 acs:mq:cn-hangzhou:123456789098****:/instances/MQ_INST_123456789098****_BX8QbBPL/topic/deadlettertopic 或 acs:alikafka:cn-hangzhou:123456789098****:instance/alikafka_post-cn-123456/topic/deadlettertopic 或 acs:eventbridge:cn-hangzhou:123456789098****:eventbus/deadletterbus

Network

string

No

VpcId

string

No

VSwitchIds

string

No

SecurityGroupId

string

No

ErrorsTolerance

string

No

Kebijakan toleransi kesalahan. Nilai yang valid: ALL: Toleransi kesalahan diizinkan. Jika terjadi kesalahan, eksekusi tidak diblokir. Setelah kebijakan retry habis, pesan dikirim ke antrian pesan gagal atau dibuang. NONE: Toleransi kesalahan tidak diizinkan. Jika terjadi kesalahan dan kebijakan retry habis, eksekusi diblokir.

ALL

ParamList

array<object>

No

Parameter target event.

object

No

Parameter target event.

ResourceKey

string

No

Parameter resource target event. Untuk informasi selengkapnya, lihat Batasan.

body

Form

string

No

Format parameter target event. Untuk informasi selengkapnya, lihat Batasan.

TEMPLATE

Value

string

No

Nilai parameter target event.

{"key"="value"}

Template

string

No

Templat parameter target event.

The value of ${key} is ${value}!

ConcurrentConfig

object

No

Konfigurasi kontrol konkurensi.

Concurrency

integer

No

Konkurensi.

2

Contoh permintaan

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":"The filter 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 kesalahan.

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. Ini digunakan untuk otorisasi.

acs:eventbridge:cn-hangzhou:123456789098****:eventbus/default/rule/MNSRule

Code

string

Kode respons. Nilai 200 menunjukkan bahwa permintaan berhasil. Untuk informasi selengkapnya tentang kode kesalahan lainnya, lihat Kode kesalahan.

Success

Success

boolean

Nilai `true` menunjukkan bahwa panggilan 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.