正则表达式.更新

说明

object regexp.update(object/array regularExpressions)

该方式允许用户升级已创建的全局性正则表达式。

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

参数

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

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

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

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

返回值

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

参考示例

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

请求:

{
    "jsonrpc": "2.0",
    "method": "regexp.update",
    "params": {
      "regexpid": "1",
      "name": "File systems 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"
        }
      ]
    },
    "auth": "700ca65537074ec963db7efabda78259",
    "id": 1
}

响应:

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

参考来源

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