删除告警分组规则 - DeleteGroupRules
功能介绍
该接口用于删除告警分组规则。
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，需具备如下身份策略权限。
授权项
访问级别
资源类型（*为必须）
条件键
别名
依赖的授权项
aom:routeGroupRule:delete
Write
-
-
-
-
URI
DELETE /v2/{project_id}/alert/group-rules
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_id | 是 | String | 项目ID，可以从控制台获取，也可以从调用API处获取。获取方式请参见：获取项目ID。 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
X-Auth-Token | 是 | String | 从IAM服务获取的用户Token。获取方式请参见：获取Token。 |
Content-Type | 是 | String | 消息体的类型（格式）。指定类型为“application/json”。 |
Enterprise-Project-Id | 否 | String | 企业项目id。 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
[数组元素] | 是 | Array of strings | 待删除的告警分组规则名称数组请求体。 |
响应参数
状态码：204
No Content 表示请求成功，但没有内容返回。
状态码：400
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 参数解释： 非法请求错误码。 取值范围： 不涉及。 |
error_msg | String | 参数解释： 错误信息。 取值范围： 不涉及。 |
error_type | String | 参数解释： 错误类型。 取值范围： 不涉及。 |
trace_id | String | 参数解释： 请求id。 取值范围： 不涉及。 |
状态码：403
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 参数解释： 非法请求错误码。 取值范围： 不涉及。 |
error_msg | String | 参数解释： 错误信息。 取值范围： 不涉及。 |
error_type | String | 参数解释： 错误类型。 取值范围： 不涉及。 |
trace_id | String | 参数解释： 请求id。 取值范围： 不涉及。 |
请求示例
删除告警分组规则名称为test22的分组规则
https://{Endpoint}/v2/{project_id}/alert/group-rules
[ "test22" ] 响应示例
状态码：400
BadRequest 非法请求。建议直接修改该请求，不要重试该请求。
{
"error_code" : "AOM.08002002",
"error_msg" : "The rule [test22] to be deleted does not exist",
"trace_id" : ""
} 状态码：403
Forbidden 请求被拒绝访问。返回该状态码，表明请求能够到达服务端，且服务端能够理解用户请求，但是拒绝做更多的事情，因为该请求被设置为拒绝访问，建议直接修改该请求，不要重试该请求。
{
"error_code" : "AOM.0403",
"error_msg" : "auth failed.",
"error_type" : "AUTH_FAILED",
"trace_id" : null
} 状态码
状态码 | 描述 |
|---|---|
204 | No Content 表示请求成功，但没有内容返回。 |
400 | BadRequest 非法请求。建议直接修改该请求，不要重试该请求。 |
403 | Forbidden 请求被拒绝访问。返回该状态码，表明请求能够到达服务端，且服务端能够理解用户请求，但是拒绝做更多的事情，因为该请求被设置为拒绝访问，建议直接修改该请求，不要重试该请求。 |
错误码
请参见错误码。
