更新

描述

object regexp.update(object/array regularExpressions)

此方法允许更新现有的全局正则表达式。

此方法仅适用于 超级管理员 用户类型。 可以在用户角色设置中撤销调用该方法的权限。有关更多信息,请参阅 用户角色

参数

(object/array)将更新的正则表达式属性。

regexpid为必要配置参数,需要为每一个正则表达式配置,其它属性为可选配置参数。 只有符合要求的属性才会被直接更新,若不符合则原属性将保持不变。

除此之外,根据标准属性,该方式支持以下参数。

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

返回值

根据regexpids的特性,(object) 会返回一个对象,其包含已升级的正则表达式ID。

参考示例

更新文件系统发现的全局正则表达式。

请求:

{
    "jsonrpc": "2.0",
    "method": "regexp.update",
    "params": {
        "regexpid": "1",
        "name": "File system for discovery",
        "test_string": "",
        "expressions": [{
                "expression": "^(btrfs|ext2|ext3|ext4|reiser|xfs|ffs|ufs|jfs|jfs2|vxfs|hfs|apfs|refs|zfs)$",
                "expression_type": "3",
                "exp_delimiter": ",",
                "case_sensitive": "0"
            },
            {
                "expression": "^(ntfs|fat32|fat16)$",
                "expression_type": "3",
                "exp_delimiter": ",",
                "case_sensitive": "0"
            }
        ]
    },
    "id": 1
}

响应:

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

参考来源

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