> ## Documentation Index
> Fetch the complete documentation index at: https://docs.molesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 触发规则

> 不评估条件，直接为规则开启一个事件。

```http theme={null}
POST /api/v1/alerts/rules/{id}/trigger
```

不评估条件，直接为规则开启一个事件。该调用适合演练通知与升级，或手动提出事件。已停用的规则也可以使用。调用需要 `alerts.manage`，请求体为空。

* 规则已有处于 `open` 或 `acknowledged` 状态的事件时，调用原样返回该事件。重复调用是安全的。
* 否则，调用创建状态为 `open` 的事件，并发送触发通知事件。
* 严重程度依次取规则的 `severity`、名为 `severity` 的标签，最后是 `warning`。调用忽略 `thresholds`。
* 注解 `manual_triggered_by` 保存调用用户的标识符，`triggering_query.sample_values` 为空。

已启用的规则在下一次评估时，如果条件未命中，会解决该事件。已停用的规则会让事件保持开启，直到用户将其解决。

```bash cURL theme={null}
curl -X POST http://localhost:5080/api/v1/alerts/rules/$RULE_ID/trigger \
  -H "authorization: Bearer $MS_JWT"
```

```json 200 theme={null}
{
  "id": "3KEDNEyqouYJeBDTLTMTBui7XHW",
  "org_id": "<organization-id>",
  "rule_id": "3KEDBLvTYO6DnWi8H9S9MNLpPT7",
  "escalation_policy_id": "default",
  "status": "open",
  "severity": "critical",
  "summary": "High error rate",
  "fingerprint": "2b7f5329675de7077c74ffa2646a36cd3adf16f80f523270332894d1ff630632",
  "current_step": 0,
  "current_loop": 0,
  "current_step_started_at": 1790000000000000,
  "assignees": [],
  "labels": { "team": "checkout" },
  "annotations": { "manual_triggered_by": "<user-id>" },
  "trace_ids": [],
  "host_ids": [],
  "affected_services": [],
  "triggering_query": {
    "language": "sql",
    "statement": "SELECT count(*) AS c FROM app WHERE level = 'error'",
    "sample_values": []
  },
  "created_at": 1790000000000000,
  "acknowledged_at": null,
  "acknowledged_by": null,
  "resolved_at": null,
  "resolved_by": null
}
```

响应是一个事件，各字段说明见[列出事件](https://docs.molesignal.com/zh-Hans/api/alerting/list-incidents.md)。

**错误**

| 状态码 | 原因 |
| - | - |
| `403` | Token 缺少 `alerts.manage`。 |
| `404` | 规则不存在。 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.