创建

说明

object regexp.create(object/array regularExpressions)

该方式允许用户创建一个新的全局正则表达式。

该方式仅对超级管理员 用户类型生效。 用户可以在用户角色设置中对该方式的使用权限进行设定修改。 请参考用户角色以获取更多信息。

参数

(object/array) 要创建的正则表达式。

除了 标准属性 之外，该方法还接受以下参数。

参数 类型 说明
expressions array 表达式 选项。

参数行为:
- 必填

返回值

(object) 返回一个对象，其中包含regexpids属性下创建的正则表达式的ID。

示例

创建一个新的全局正则表达式。

请求:

{
    "jsonrpc": "2.0",
    "method": "regexp.create",
    "params": {
        "name": "Storage devices for SNMP discovery",
        "test_string": "/boot",
        "expressions": [{
            "expression": "^(Physical memory|Virtual memory|Memory buffers|Cached memory|Swap space)$",
            "expression_type": "4",
            "case_sensitive": "1"
        }]
    },
    "id": 1
}

响应：

{
    "jsonrpc": "2.0",
    "result": {
        "regexpids": [
            "16"
        ]
    },
    "id": 1
}

参考来源

CRegexp::create() in ui/include/classes/api/services/CRegexp.php.