All Products
Search
Document Center

EventBridge:CreateRule

Last Updated:Jun 11, 2026

Membuat aturan event.

Deskripsi operasi

Creates an event rule.

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 None

Parameter permintaan

Parameter

Type

Required

Description

Example

EventBusName

string

Yes

Nama EventBridge.

MyEventBus

Description

string

No

Deskripsi aturan event.

Filter rule for Simple Message Queue (formerly MNS) (SMQ)

RuleName

string

Yes

Nama aturan event.

SMQRule

Status

string

No

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

ENABLE

FilterPattern

string

Yes

Pola peristiwa dalam format JSON. Jenis pola yang didukung adalah stringEqual dan stringExpression. Setiap bidang dapat memuat maksimal 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

An event target.

Id

string

Yes

The custom ID of the event target.

Mlm123456JHd2RsRoKw

Type

string

Yes

The type of the event target. For more information, see Event target parameters.

acs.mns.queue

Endpoint

string

No

The delivery endpoint for events.

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

PushRetryStrategy

string

No

The push retry strategy. Valid values:
BACKOFF_RETRY: A backoff retry strategy where the system makes three retry attempts at random intervals of 10 to 20 seconds.
EXPONENTIAL_DECAY_RETRY: An exponential decay retry strategy where the system makes 176 retry attempts over 24 hours. The interval starts at 1 second and doubles with each of the first 10 attempts (up to 512 seconds). Subsequent retries occur every 512 seconds.

BACKOFF_RETRY

DeadLetterQueue

object

No

The dead-letter queue. If an event fails to be processed or exceeds the retry limit, it is sent to the dead-letter queue. Supported services for the dead-letter queue include Message Queue for Apache RocketMQ, Message Service (MNS), Message Queue for Apache Kafka, and EventBridge event buses.

Arn

string

No

The Alibaba Cloud Resource Name (ARN) of the dead-letter queue. Events that fail to be processed or exceed the retry limit are sent to this ARN. Supported services for this parameter include Message Service (MNS) and Message Queue for Apache RocketMQ.

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

Network

string

No

The network type.

VpcId

string

No

The VPC ID.

VSwitchIds

string

No

The vSwitch ID.

SecurityGroupId

string

No

The security group ID.

ErrorsTolerance

string

No

The fault tolerance policy. Valid values:
ALL: Enables fault tolerance. Execution continues even if an error occurs. After all retry attempts fail, the event is sent to the dead-letter queue (if configured) or discarded.
NONE: Disables fault tolerance. Execution is blocked if an error occurs and all retry attempts fail.

ALL

ParamList

array<object>

No

The parameters for the event target.

object

No

A single parameter for the event target.

ResourceKey

string

No

The name of the target parameter. For more information, see Limits.

body

Form

string

No

The format of the event target parameter. For more information, see Limits.

TEMPLATE

Value

string

No

The value of the event target parameter.

{"key"="value"}

Template

string

No

The template for the event target parameter.

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

ConcurrentConfig

object

No

The concurrency control configuration.

Concurrency

integer

No

The maximum number of concurrent executions for the event target.

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

The error message.

Remote error. requestId: [xxxx], error code: [xxx], message: [The target in event rule is invalid! Endpoint is xxx

RequestId

string

The request ID.

1AD6D598-7506-5D2C-81EA-30E3241A903A

Data

object

The response data.

RuleARN

string

The ARN of the event rule, which is used for authorization.

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

Code

string

The response code. The value Success indicates that the request is successful. Other values indicate that the request failed. For more information about error codes, see Error codes.

Success

Success

boolean

Indicates whether the operation is successful. A value of true indicates that the operation is successful.

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.