Crea una regla de eventos.
Descripción de la operación
Crea una regla de eventos.
Pruébelo ahora
Test
Autorización de RAM
|
Action |
Nivel de acceso |
Tipo de recurso |
Clave de condición |
Acción dependiente |
|
eventbridge:CreateRule |
create |
*Rule.
|
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 |
| FilterPattern |
string |
Sí |
El patrón de eventos en formato JSON. Se admiten los siguientes patrones:
|
{ "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 |
| 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 |
| 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.