文档首页/ 应用运维管理 AOM/ API（联盟区域）/ API/ 告警/ 修改静默规则
更新时间：2026-01-06 GMT+08:00
在线调试
CLI示例
查看PDF
分享

修改静默规则

功能介绍

修改静默规则。

调用方法

请参见如何调用API。

URI

PUT /v2/{project_id}/alert/mute-rules

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID，可以从控制台获取，也可以从调用API处获取。获取方式请参见：获取项目ID。

最小长度：32

最大长度：32

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

从IAM服务获取的用户Token。获取方式请参见：获取Token。

最小长度：1

最大长度：40960

Content-Type

是

String

消息体的类型（格式）。指定类型为“application/json”。

枚举值：

  • application/json
表3 请求Body参数

参数

是否必选

参数类型

描述

create_time

否

Long

创建时间

最小值：0

最大值：9999999999999

desc

否

String

规则描述

最小长度：0

最大长度：1024

match

是

Array<Array<Match>>

规则的匹配条件。串行条件和并行条件的最大数量限制为10。

数组长度：1 - 10

mute_config

是

MuteConfig object

规则的生效时间配置

name

是

String

规则名称。名称包含大小写字母、数字、特殊字符（_）、不能以下划线开头或结尾，最大长度为100。

最小长度：1

最大长度：100

timezone

否

String

时区

最小长度：1

最大长度：32

update_time

否

Long

修改时间

最小值：0

最大值：9999999999999

user_id

否

String

用户ID

最小长度：32

最大长度：32
表4 Match

参数

是否必选

参数类型

描述

key

是

String

指定按照Metadata中的key进行匹配

最小长度：1

最大长度：128

operate

是

String

指定匹配的方式：EXIST:存在，REGEX:正则，EQUALS:等于

最小长度：1

最大长度：100

枚举值：

  • EQUALS

  • REGEX

  • EXIST

value

否

Array of strings

要匹配的key对应的value，当operate为存在时，此值为空

最小长度：1

最大长度：256

数组长度：0 - 5
表5 MuteConfig

参数

是否必选

参数类型

描述

ends_at

否

Long

静默规则结束时间

最小值：0

最大值：999999999

scope

否

Array of integers

当type为每周或者每月时，scope不能为空

最小值：0

最大值：31

数组长度：1 - 100

starts_at

是

Long

静默规则开始时间

最小值：0

最大值：999999999

type

是

String

静默规则生效时间种类。FIXED：固定方式统计，DAILY：按日合计，WEEKLY：按周统计，MONTHLY：按月统计

最小长度：1

最大长度：100

枚举值：

  • FIXED

  • DAILY

  • WEEKLY

  • MONTHLY

响应参数

状态码：204

No Content 表示请求成功，但没有内容返回。

状态码：400

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码

最小长度：12

最大长度：12

error_msg

String

错误信息

最小长度：0

最大长度：1024

error_type

String

错误类型

最小长度：0

最大长度：128

trace_id

String

请求id

最小长度：32

最大长度：32

状态码：401

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码

最小长度：12

最大长度：12

error_msg

String

错误信息

最小长度：0

最大长度：1024

error_type

String

错误类型

最小长度：0

最大长度：128

trace_id

String

请求id

最小长度：32

最大长度：32

状态码：403

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码

最小长度：12

最大长度：12

error_msg

String

错误信息

最小长度：0

最大长度：1024

error_type

String

错误类型

最小长度：0

最大长度：128

trace_id

String

请求id

最小长度：32

最大长度：32

状态码：500

表9 响应Body参数

参数

参数类型

描述

error_code

String

响应码。

最小长度：13

最大长度：13

error_msg

String

响应信息描述。

最小长度：1

最大长度：100

trace_id

String

响应id。

最小长度：12

最大长度：12

请求示例

修改名称为“32255”、时区为“xxx”和用户id为“2xxxxxxxxxxxxxxxxxxxxxxxxxcf”的静默规则

https://{endpoint}/v2/{project_id}/alert/mute-rules

{
  "create_time" : 1668147671966,
  "desc" : "",
  "match" : [ [ {
    "key" : "event_severity",
    "operate" : "EQUALS",
    "value" : [ "Info" ]
  } ] ],
  "mute_config" : {
    "ends_at" : 86399,
    "scope" : [ ],
    "starts_at" : 0,
    "type" : "DAILY"
  },
  "name" : "32255",
  "timezone" : "xxx",
  "update_time" : 1668147671966,
  "user_id" : "2xxxxxxxxxxxxxxxxxxxxxxxxxcf"
}

响应示例

状态码：400

BadRequest 非法请求。建议直接修改该请求，不要重试该请求。

{
  "error_code" : "AOM.08012003",
  "error_msg" : "request insertParma probably has error",
  "error_type" : "PARAM_INVALID",
  "trace_id" : ""
}

状态码：401

Unauthorized 在客户端提供认证信息后，返回该状态码，表明服务端指出客户端所提供的认证信息不正确或非法。

{
  "error_code" : "AOM.0403",
  "error_msg" : "auth failed.",
  "error_type" : "AUTH_FAILED",
  "trace_id" : null
}

状态码：403

Forbidden 请求被拒绝访问。返回该状态码，表明请求能够到达服务端，且服务端能够理解用户请求，但是拒绝做更多的事情，因为该请求被设置为拒绝访问，建议直接修改该请求，不要重试该请求。

{
  "error_code" : "AOM.0403",
  "error_msg" : "auth failed.",
  "error_type" : "AUTH_FAILED",
  "trace_id" : null
}

状态码：500

InternalServerError 表明服务端能被请求访问到，但是不能理解用户的请求。

{
  "error_code" : "APM.00000500",
  "error_msg" : "Internal Server Error",
  "trace_id" : ""
}

状态码

状态码

描述

204

No Content 表示请求成功，但没有内容返回。

400

BadRequest 非法请求。建议直接修改该请求，不要重试该请求。

401

Unauthorized 在客户端提供认证信息后，返回该状态码，表明服务端指出客户端所提供的认证信息不正确或非法。

403

Forbidden 请求被拒绝访问。返回该状态码，表明请求能够到达服务端，且服务端能够理解用户请求，但是拒绝做更多的事情，因为该请求被设置为拒绝访问，建议直接修改该请求，不要重试该请求。

500

InternalServerError 表明服务端能被请求访问到，但是不能理解用户的请求。

错误码

请参见错误码。

父主题： 告警