更新时间：2026-08-19 GMT+08:00
更新告警分组状态 - UpdateAlarmGroupStatus
功能介绍
启用或禁用指定的告警分组
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，需具备如下身份策略权限。
授权项
访问级别
资源类型（*为必须）
条件键
别名
依赖的授权项
apm：：updateAdminInfo
Write
-
-
-
-
URI
PUT /v2/alarm-center/group/update-group-status
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| group_id | 是 | Long | 参数解释： 告警分组ID。 约束限制： 不涉及。 取值范围： 大于0的整数。 默认取值： 不涉及 |
| enable | 是 | Boolean | 参数解释： 告警分组状态。 约束限制： 不涉及。 取值范围： true：启用。 false：禁用。 默认取值： 不涉及。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 参数解释： 从IAM服务获取的用户Token。获取方式请参见：获取Token。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 |
响应参数
状态码：200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| ok | String | 参数解释： 操作结果，固定返回“ok”表示成功。 取值范围： 不涉及。 |
请求示例
/v2/alarm-center/group/update-group-status?group_id=3854&enable=true
响应示例
状态码：200
更新告警分组状态成功。
{
"ok" ： "ok"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | OK |
| 400 | Bad Request |
| 403 | Forbidden |
| 429 | Too Many Requests |
错误码
请参见错误码。
父主题： 告警分组管理
