空间更新 - Flashcat API

filters 说明见创建接口

curl --location --request POST 'https://api.flashcat.cloud/channel/update?app_key' \ --header 'Content-Type: application/json' \ --data-raw '{ "channel_id": 0, "channel_name": "string", "description": "string", "team_id": 0, "auto_resolve_timeout": 0, "is_private": true, "group": { "method": "i", "cases": [ { "if": [ { "key": "title", "oper": "IN", "vals": [ "string" ] } ], "equals": [ "string" ] } ], "equals": [ [ "title" ] ], "all_equals_required": true, "time_window": 0, "storm_threshold": 0 }, "flapping": { "is_disabled": true, "max_changes": "i", "in_mins": 0, "mute_mins": 0 } }'

请求参数

Authorization

在 query 添加参数

app_key

示例：

app_key: ********************

Header 参数

Content-Type

string

可选

示例值:

application/json

Body 参数application/json

channel_id

integer

协作空间ID

必需

channel_name

string

协作空间名称

可选

不传不更新

description

string

协作空间描述

可选

不传不更新

team_id

integer

负责团队ID

可选

不传不更新

auto_resolve_timeout

integer

自动恢复时长，单位秒

可选

不传不更新

>= 0<= 86400

is_private

boolean

是否私有访问

可选

不传不更新

group

object (Group)

告警聚合配置

可选

不传不更新

method

enum<string>

聚合方式

必需

枚举值:

ipn

cases

array[object (CaseEqual) {2}]

分支聚合维度

可选

仅按策略聚合时存在。优先从上至下匹配分支条件，匹配到即使用分支的维度进行聚合

<= 10 items

equals

array [array]

默认聚合维度

可选

仅按策略聚合时存在。如果所有分支都没有匹配上，则使用此维度兜底。注意此维度是多组聚合维度，任意一组维度满足，则告警被聚合

<= 5 items

all_equals_required

boolean

是否需要相同项全部存在

可选

仅按策略聚合时存在。默认为false。区别在于配置多个相同项时：- 开启，告警与故障中值都为空的聚合条件将视为不同项。- 不开启，告警与故障中值都为空的聚合条件将视为相同项。

time_window

integer

时间窗口，单位分钟，取值范围[0,60]

可选

为0，代表一直合并告警直到故障关闭

storm_threshold

integer

风暴阈值，聚合告警条数超过该阈值进行风暴预警。取值范围[0,10000]

可选

为0代表不设置风暴预警

flapping

object (Flapping)

flapping收敛配置

可选

不传不更新

is_disabled

boolean

是否关闭

必需

true 关闭，false 开启，默认值false

max_changes

enum<string>

时间窗口内相同故障最大发生次数

必需

范围[2,100]，默认值4。dedup_key相同时，认为故障相同。dedup_key来自于合并入的第一条告警的alert_key

枚举值:

ipn

in_mins

integer

统计时间窗口，单位分钟

必需

范围[1,1440]，默认值60

mute_mins

integer

静默时间窗口，单位分钟

必需

范围[0,1440]，默认值120。如果设置为0，代表不对后续触发的故障进行静默

示例

返回响应

🟢200成功

application/json

Body

error

object (DutyError)

可选

code

enum<string>

错误码

必需

枚举值:

InvalidParameterInvalidContentTypeUnauthorizedAccessDeniedMethodNotAllowedRequestTooFrequentlyRequestVerifyRequiredDangerousOperationRequestLockedRouteNotFoundBalanceNotEnoughUndonedOrderExistResourceNotFoundInternalErrorReferenceExist

message

string

错误描述

必需