跳转到主要内容
ZStack
告警与响应相关接口/告警通道与集成

更新告警集成事件渠道

替换事件通知渠道。将 `channelUuids` 设为空可清除第三方投递渠道；控制台通知仍会自动发送。资源通知策略和渠道模板保持不变。

PUT/api/v1/alerting/integrations/{platformUuid}/event-channels

操作 ID

UpdateAlertIntegrationEventChannels

起始版本

1.2.8

执行模式

同步

认证信息

需要认证

认证信息

调用该 API 时需要在请求头中携带以下认证信息。

Authorizationstring必填

Bearer 令牌

X-Tenant-IDstring

X-Tenant-ID

请求参数

application/json

路径参数

  • platformUuid
    String必填

    需要替换事件通知渠道绑定的平台的UUID。

请求体字段

  • channelUuids
    List

    已启用的第三方渠道UUID列表。设为空可清除所有显式绑定。

    示例： item1,item2

响应状态

200 OK
200 OK

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

  • uuid
    String

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

    示例： integ-001

  • platformUuid
    String

    平台UUID。

    示例： plat-001-abc

  • targetState
    String

    目标状态。

    示例： enabled

  • currentState
    String

    当前状态。

    示例： enabled

  • webhookUrl
    String

    Webhook地址。

    示例： https://zcf.example.com/api/v1/alerting/receive

  • webhookId
    String

    Webhook唯一标识。

    示例： wh-plat-001

  • lastReconcileAt
    String

    最近一次协调时间。

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

  • driftCount
    Integer

    漂移数量。

    示例： 20

  • lastError
    String

    最近一次协调的错误消息。

    示例： timeout after 30s

  • createDate
    String

    创建时间。

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

  • lastOpDate
    String

    最近一次操作时间。

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

  • platformName
    String

    平台名称。

    示例： Production ZStack

  • productType
    String

    产品类型。

    示例： zstack

  • lastReceiveAt
    String

    最近一次接收时间。

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

  • parseFailureCount
    Integer

    解析失败数量。

    示例： 10

  • unknownEventCount
    Integer

    未知事件数量。

    示例： 10

  • defaultEventCatalogCount
    Integer

    默认事件目录数量。

    示例： 10

  • eventChannelUuids
    List

    显式配置的第三方事件通知渠道；控制台通知始终隐式启用。

    示例： item1,item2

  • latestAlertAt
    String

    最新告警时间。

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

  • receivedEventCount24h
    Integer

    过去 24 小时内（含时间边界）接收的去重原生事件记录；不包含资源告警。

    示例： 10

变更历史

查看全部变更历史

  • 变更时间

    新增响应字段 latestAlertAt, receivedEventCount24h
    查看 API