跳转到主要内容
API Explorer|API Explorer
告警与响应相关接口/告警事件
POSTAlerting起始版本 1.0同步需要认证

确认告警事件

确认告警事件指示已调查。

调试可用性

在线调试

使用当前认证信息和示例参数提交 Mock 请求。

路径参数

请求参数

路径参数

  • eventIdString必填

    事件标识符确认。

请求体字段

  • acknowledgedByString必填

    用户正在确认告警。

    示例： admin

  • commentString必填

    评论。

    示例： Investigating the issue

响应状态

200 OK

该 API 成功时返回以下响应结构。

  • uuidString

    资源的UUID，唯一标识该资源。

    示例： event-001

  • ruleUuidString

    规则UUID。

    示例： rule-abc123

  • ruleNameString

    规则名称。

    示例： High CPU Usage

  • resourceTypeString

    资源类型。

    示例： vm

  • resourceUuidString

    资源UUID。若指定，资源会使用该字段值作为UUID。

    示例： res-abc123

  • metricNameString

    监控项名称。

    示例： cpu_usage_percent

  • currentValueLong

    当前值。

    示例： 95.3

  • thresholdLong

    阈值。

    示例： 90

  • operatorString

    比较运算符。

    示例： >

  • severityString

    告警级别。

    示例： critical

  • stateString

    当前状态。

    示例： firing

  • messageString

    错误返回消息。

    示例： CPU usage is 95.3%

  • fingerprintString

    指纹标识。

    示例： fp-abc123

  • sourceString

    来源信息。

    示例： prometheus

  • notifiedAtString

    已通知时间。

    示例： 2026-01-15T08:00:00Z

  • resolvedAtString

    已恢复时间。

    示例： 2026-01-15T08:00:00Z

  • acknowledgedByString

    用户由已确认事件。

    示例： admin

  • acknowledgedAtString

    已确认时间。

    示例： 2026-01-15T08:00:00Z

  • createDateString

    创建时间。

    示例： 2026-01-15T08:00:00Z

请求地址

POST/api/v1/alerting/events/{eventId}/acknowledge

/api/v1/alerting/events/{eventId}/acknowledge

操作 ID

AcknowledgeAlertEvent

永久链接

请求示例

curl -X POST '{host}/api/v1/alerting/events/{eventId}/acknowledge' -H 'Authorization: Bearer {token}' -H 'Content-Type: application/json' -d '{"acknowledgedBy":"admin","comment":"Investigating the issue"}'

响应示例

200
{
  "uuid": "event-001",
  "ruleUuid": "rule-abc123",
  "ruleName": "High CPU Usage",
  "resourceType": "vm",
  "resourceUuid": "res-abc123",
  "metricName": "cpu_usage_percent",
  "currentValue": 95.3,
  "threshold": 90.0
}

变更历史

此 API 暂无变更历史记录。

查看全部变更历史