更新时间:2026-01-07 GMT+08:00

获取killOp规则列表

接口说明

获取killOp规则列表。

约束说明

  • 仅支持副本集,集群实例。
  • 仅支持数据库版本3.4版本及以后版本。
  • 仅支持执行节点规格4U及以上。

URI

  • URI格式

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

  • 表1 参数说明

    参数

    是否必选

    参数类型

    描述

    project_id

    String

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

    instance_id

    String

    实例ID。

    表2 Query参数

    参数

    是否必选

    参数类型

    描述

    operation_types

    String

    Sql语句操作类型。
    • insert,表示插入语句。
    • update,表示更新语句。
    • query,表示查询语句。
    • command,表示命令语句。
    • remove,表示删除语句。
    • getmore,表示获取更多数据语句。

    namespaces

    String

    表命名空间。取值格式:库名或者库名.表名。
    • 可为空,表示不做限制。
    • 单独库名,表示对某个库下的所有集合生效。
    • 库名.表名,表示对具体库下的具体的集合生效。

    status

    String

    killOp规则状态。
    • ENABLED,规则生效中。
    • DISABLED,规则禁用中。

    plan_summary

    String

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

    offset

    Integer

    索引位置,偏移量。

    从第一条数据偏移offset条数据后开始查询,默认为0(偏移0条数据,表示从第一条数据开始查询)。取值必须为数字,不能为负数。

    limit

    Integer

    查询个数上限值。
    • 取值范围: 1~100。
    • 不传该参数时,默认查询前100条信息。

请求参数

表3 请求Header参数

名称

类型

IN

是否必选

描述

X-Auth-Token

string

header

用户Token。

  • 请求示例

    无。

响应参数

表4 响应Body参数

参数

参数类型

说明

rules

Array of 表5

列表。

total_count

Integer

总数。

表5 KillOpRule参数

参数

参数类型

说明

id

String

killOp规则ID。

operation_types

String

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

status

String

killOp规则状态。
  • ENABLED,规则生效中。
  • DISABLED,规则禁用中。

namespaces

String

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

client_ips

String

客户端连接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。

secs_running

Integer

单条操作最大运行时长。

取值:不能为负数,可为空,默认为0,表示不做限制。单位:s。最小值为2,最大值为86400。

node_type

String

节点类型。
  • mongos_shard,表示同时在mongos和shard节点生效。
  • mongos,表示只在集群mongos节点生效。
  • shard,表示只在集群shard节点生效。
  • replica,表示只在副本集节点生效。
  • 响应示例
    killOp规则列表:
    { 
      "rules" : [ { 
        "operation_types" : [ "query", "insert" ], 
        "namespaces" : [ "db.collections" ], 
        "client_ips" : [ "172.168.201.144" ], 
        "status" : "ENABLED", 
        "id" : "f6f2cea4-ce40-4d4c-9d2f-61253d215811", 
        "plan_summary" : "COLLSCAN", 
        "max_concurrency" : 0, 
        "secs_running" : 5, 
        "node_type" : "replica" 
      } ], 
      "total_count" : 1 
    }

状态码

详情请参见状态码

错误码

详情请参见错误码