Todos los productos
Search
Centro de documentos

EventBridge:CreateRule

Última actualización: Oct 28, 2026

Crea una regla de eventos.

Descripción de la operación

Crea una regla de eventos.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

  • Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.

  • API: La API que debe invocarse para llevar a cabo la acción.

  • Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.

  • Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.

    • En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.

    • Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.

  • Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.

  • Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

eventbridge:CreateRule

create

*Rule.

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

Ninguna Ninguna

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

EventBusName

string

Sí

El nombre del bus de eventos.

MyEventBus

Description

string

No

La descripción del bus de eventos.

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

RuleName

string

Sí

El nombre de la regla de eventos.

SMQRule

Status

string

No

El estado de la regla. Valores válidos:

  • ENABLE: la regla está habilitada. Este es el estado predeterminado.

  • DISABLE: la regla está deshabilitada.

ENABLE

FilterPattern

string

Sí

El patrón de eventos en formato JSON. Se admiten los siguientes patrones:

  • Patrón stringEqual

  • Patrón stringExpression Cada campo admite hasta cinco expresiones en una estructura de mapa.

{ "source": [ { "prefix": "acs." } ], "type": [ { "prefix": "oss:ObjectReplication" } ], "subject": [ { "prefix": "acs:oss:cn-hangzhou:123456789098****:my-movie-bucket/", "suffix": ".txt" } ] }

EventTargets

array<object>

No

La lista de destinos de eventos.

array<object>

No

El destino del evento.

Id

string

Sí

El ID personalizado del destino del evento.

Mlm123456JHd2RsRoKw

Type

string

Sí

El tipo de destino del evento. Para obtener más información, consulte Parámetros del destino del evento.

acs.mns.queue

Endpoint

string

No

La URL del endpoint para la entrega.

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

PushRetryStrategy

string

No

La política de reintentos para el envío de eventos. Valores válidos:

  • BACKOFF_RETRY: política de reintentos con retroceso. El sistema realiza 3 reintentos, con un intervalo aleatorio de 10 a 20 segundos entre cada reintento.

  • EXPONENTIAL_DECAY_RETRY: reintento con decaimiento exponencial. El sistema realiza 176 reintentos, con un intervalo que aumenta exponencialmente hasta 512 segundos. El tiempo total de reintento es de 1 día. Los intervalos específicos son 1, 2, 4, 8, 16, 32, 64, 128, 256, 512 y, a continuación, 512 segundos para los 167 reintentos restantes.

BACKOFF_RETRY

DeadLetterQueue

object

No

La cola de mensajes muertos. Los eventos no procesados o los eventos que superan el recuento de reintentos se escriben en la cola de mensajes muertos. Los tipos de cola admitidos incluyen ApsaraMQ for RocketMQ, Simple Message Queue (anteriormente MNS), ApsaraMQ for Kafka y buses de eventos de EventBridge.

Arn

string

No

El ARN de la cola de mensajes muertos. Los eventos no procesados o los eventos que superan el recuento de reintentos se escriben en la cola de mensajes muertos. Se admiten Simple Message Queue (anteriormente MNS) y ApsaraMQ for RocketMQ.

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

Network

string

No

El tipo de red.

PrivateNetwork

VpcId

string

No

El ID de la VPC donde reside la cola de mensajes muertos.

vpc-2z****

VSwitchIds

string

No

El ID del vSwitch.

vsw-m12345****

SecurityGroupId

string

No

El ID del grupo de seguridad.

sg-2d****

ErrorsTolerance

string

No

La estrategia de tolerancia a fallos. Valores válidos:

  • ALL: permite la tolerancia a fallos. Las excepciones no bloquean la ejecución. Si se agota la estrategia de reintentos, los mensajes se entregan a la cola de mensajes muertos o se descartan según la configuración.

  • NONE: deshabilita la tolerancia a fallos. Las excepciones bloquean la ejecución cuando se agota la estrategia de reintentos.

ALL

ParamList

array<object>

No

Los parámetros del destino del evento.

object

No

Los parámetros del destino del evento.

ResourceKey

string

No

El parámetro de recurso del destino del evento. Para obtener más información, consulte Límites.

body

Form

string

No

El formato del parámetro del destino del evento. Para obtener más información, consulte Límites.

TEMPLATE

Value

string

No

El valor del parámetro del destino del evento.

{"key"="value"}

Template

string

No

El estilo de plantilla de parámetros del destino del evento.

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

ConcurrentConfig

object

No

La configuración de control de concurrencia.

Concurrency

integer

No

El número de ejecuciones simultáneas.

2

Solicitudes de ejemplo.

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}!" } ] } ] }

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

Message

string

El mensaje de error.

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

RequestId

string

El ID de la solicitud.

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

Data

object

Los datos devueltos.

RuleARN

string

El ARN de la regla de eventos, que se utiliza para la autorización.

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

Code

string

El código de respuesta. Un valor de Success indica que la solicitud se realizó correctamente. Otros valores indican códigos de error. Para obtener más información, consulte Códigos de error.

Success

Success

boolean

Indica si la operación se realizó correctamente.

true

Ejemplos

Respuesta exitosa

JSON Formato

{
  "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
}

Códigos de error

Código de estado HTTP

Código de error

Mensaje de error

Descripción

403 ServiceNotEnable Service not enable

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.