文档首页/ 文档数据库服务 DDS/ API参考（联盟区域）/ API v3（推荐）/ 数据库运维/ 创建killOp规则
更新时间：2026-01-07 GMT+08:00
查看PDF
分享

创建killOp规则

接口说明

创建killOp规则。

约束说明

  • 仅支持副本集，集群实例。
  • 仅支持数据库版本3.4版本及以后版本。
  • 仅支持执行节点规格4U及以上。
  • 每个实例最多创建10个killOp规则。
  • 规则创建后为禁用状态。

URI

  • URI格式

    POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/kill-op-rule

  • 表1 路径参数

    参数

    是否必选

    参数类型

    描述

    project_id

    是

    String

    租户在某一Region下的项目ID。

    instance_id

    是

    String

    实例ID。

请求参数

表2 请求Header参数

名称

类型

IN

是否必选

描述

X-Auth-Token

string

header

是

用户Token。
表3 Query参数

参数

是否必选

参数类型

描述

operation_types

是

Array of strings
Sql语句操作类型。最多支持同时选择6种语句类型。同时选择多种类型时，匹配任意一种类型时规则生效。
  • insert，表示插入语句。
  • update，表示更新语句。
  • query，表示查询语句。
  • command，表示命令语句。
  • remove，表示删除语句。
  • getmore，表示获取更多数据语句。

namespaces

否

Array of strings
表命名空间。取值格式：库名或者库名.表名。同时配置多组信息时，匹配任意一组信息时规则生效。
  • 目前仅支持配置一组信息
  • 可为空，表示不做限制。
  • 单独库名，表示对某个库下的所有集合生效。
  • 库名.表名，表示对具体库下的具体的集合生效。

client_ips

否

Array of strings
客户端连接IP。
  • 只支持IPV4。
  • 可为空，表示不做限制。
  • 最多支持配置5个IP，同时配置多个IP时，匹配任意一个IP时规则生效。

plan_summary

否

String
执行计划。默认值空，表示不做限制。
  • COLLSCAN
  • SORT_KEY_GENERATOR
  • SKIP
  • LIMIT
  • GEO_NEAR_2DSPHERE
  • GEO_NEAR_2D
  • AGGREGATE
  • OR

max_concurrency

否

Integer

最大并发数。

  • 取值：不能为负数，可为空，默认为0，表示不做限制，最小值为1，最大值为100000。
  • max_concurrency和secs_running不可同时为0。

secs_running

否

Integer

单条操作最大运行时长。

  • 可为空，默认为0，表示不做限制。单位：s。最小值为2，最大值为86400。
  • secs_running和max_concurrency不可同时为0。

node_type

是

String
节点类型。
  • mongos_shard，表示同时在mongos和shard节点生效。
  • mongos，表示只在集群mongos节点生效。
  • shard，表示只在集群shard节点生效。
  • replica，表示只在副本集节点生效。
  • 请求示例 
    { 
   "operation_types" : [ "query", "insert" ], 
   "namespaces" : [ "db.collections" ], 
   "client_ips" : [ "172.168.201.144" ], 
   "plan_summary" : "COLLSCAN", 
   "max_concurrency" : 0, 
   "secs_running" : 5, 
   "node_type" : "replica" 
 }

响应参数

  • 参数说明

    无。

  • 响应示例

    无。

状态码

详情请参见状态码。

错误码

详情请参见错误码。

父主题： 数据库运维