更新时间:2025-09-23 GMT+08:00

添加异常规则

功能介绍

添加异常规则。

调用方法

请参见如何调用API。

URI

POST /v1/{project_id}/clusters/{cluster_id}/workload/rules

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

项目ID。获取方法请参见获取项目ID。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

cluster_id

是

String

参数解释:

集群ID。获取方法请参见获取集群ID。

约束限制:

必须是有效的dws集群ID。

取值范围:

36位UUID。

默认取值:

不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

rule_name

否

String

参数解释:

异常规则名称。

约束限制:

名称不能为空。

取值范围:

不涉及。

默认取值:

不涉及。

except_rules

否

Array of ExceptRule objects

参数解释:

异常规则配置项。

约束限制:

不能为空。

取值范围:

不涉及。

默认取值:

不涉及。

表3 ExceptRule

参数

是否必选

参数类型

描述

rule_key

否

String

参数解释:

规则项名称。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

rule_value

否

String

参数解释:

规则项数值。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

workload_res_code

Integer

参数解释:

错误编码。

取值范围:

不涉及。

workload_res_str

String

参数解释:

查询错误详情。

取值范围:

不涉及。

items

Array of ExceptRuleBo objects

参数解释:

异常规则列表。

取值范围:

不涉及。

count

Integer

参数解释:

异常规则总条数。

取值范围:

大于等于0

表5 ExceptRuleBo

参数

参数类型

描述

name

String

参数解释:

规则名称。

取值范围:

不涉及。

action

String

参数解释:

触发异常规则操作。

取值范围:

不涉及。

queues

Array of strings

参数解释:

异常规则绑定的资源池名称列表。

取值范围:

不涉及。

except_rules

Map<String,String>

参数解释:

异常规则配置项。

取值范围:

不涉及。

请求示例

创建异常规则

POST https://{Endpoint}/v1/89cd04f168b84af6be287f71730fdb4b/clusters/4ca46bf1-5c61-48ff-b4f3-0ad4e5e3ba90/workload/rules

{
  "rule_name" : "rule910_1",
  "except_rules" : [ {
    "rule_key" : "blocktime",
    "rule_value" : "600"
  }, {
    "rule_key" : "elapsedtime",
    "rule_value" : "300"
  }, {
    "rule_key" : "action",
    "rule_value" : "abort"
  } ]
}

响应示例

状态码:200

操作成功。

{
  "workload_res_code" : 0,
  "workload_res_str" : null,
  "items" : [ {
    "name" : "default_cpu_percent",
    "action" : "abort",
    "queues" : [ ],
    "except_rules" : {
      "action" : "abort",
      "cpuavgpercent" : "50",
      "elapsedtime" : "900"
    }
  } ],
  "count" : 3
}

状态码

状态码

描述

200

操作成功。

400

请求错误。

401

鉴权失败。

403

没有操作权限。

404

找不到资源。

500

服务内部错误。

503

服务不可用。